Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / 19ce2c163b736eb45bbe73407e183c97738755b1 / . / camera / docs / docs.html
blob: 28ea35b86708802e417a0985af4e65e0b3076aec [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">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2852 <blockquote>
2853<p>= 1</p>
2854</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2855 </td>
2856
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2857 <td class="entry_tags">
2858 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2859 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2860 </ul>
2861 </td>
2862
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2863 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2864
2865
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2866 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2867 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2868
2869
2870 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2871 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2872 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2873 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2874 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2875 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2876 <span class="entry_type_container">x</span>
2877
2878 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2879 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2880 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2881 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2882
2883
2884 </td> <!-- entry_type -->
2885
2886 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2887 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
2888each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2889 </td>
2890
2891 <td class="entry_units">
2892 </td>
2893
2894 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2895 <p>For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
2896awbMode,<wbr/> and afMode that the HAL wants to use for that
2897scene mode.<wbr/></p>
2898<p>For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
2899order of increasing index</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2900 </td>
2901
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2902 <td class="entry_tags">
2903 <ul class="entry_tags">
2904 <li><a href="#tag_BC">BC</a></li>
2905 </ul>
2906 </td>
2907
2908 </tr>
2909 <tr class="entries_header">
2910 <th class="th_details" colspan="5">Details</th>
2911 </tr>
2912 <tr class="entry_cont">
2913 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2914 <p>When a scene mode is enabled,<wbr/> the HAL is expected
2915to override aeMode,<wbr/> awbMode,<wbr/> and afMode with its
2916preferred settings for that scene mode.<wbr/></p>
2917<p>To simplify communication with old camera API applications,<wbr/>
2918the service wants this override list in the static metadata.<wbr/>
2919The order of this list matches that of availableSceneModes,<wbr/>
2920with 3 entires for each scene mode.<wbr/> The overrides listed
2921for SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
2922mode,<wbr/> the application-set aeMode,<wbr/> awbMode,<wbr/> and afMode are
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2923used 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]2924AUTO.<wbr/></p>
2925<p>It is recommended that for FACE_<wbr/>PRIORITY,<wbr/> the overrides
2926should be set to 0.<wbr/> As an example,<wbr/> if availableSceneModes is
2927{ FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT },<wbr/> then the service expects
2928this field to have 9 entries; for example { 0 ,<wbr/> 0,<wbr/> 0,<wbr/>
2929ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
2930INCANDESCENT,<wbr/> AUTO }</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2931 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2932 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2933
2934
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2935 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2936 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2937
2938
2939
2940 <!-- end of kind -->
2941 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2942 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2943
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2944 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2945 <tr>
2946 <th class="th_name">Property Name</th>
2947 <th class="th_type">Type</th>
2948 <th class="th_description">Description</th>
2949 <th class="th_units">Units</th>
2950 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2951 <th class="th_tags">Tags</th>
2952 </tr>
2953 </thead>
2954
2955 <tbody>
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2967 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2968 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2969 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2970 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2971 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2972
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2973 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2974
2975
2976 </td> <!-- entry_type -->
2977
2978 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2979 <p>The ID sent with the latest
2980CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2981 </td>
2982
2983 <td class="entry_units">
2984 </td>
2985
2986 <td class="entry_range">
2987 </td>
2988
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2989 <td class="entry_tags">
2990 </td>
2991
2992 </tr>
2993 <tr class="entries_header">
2994 <th class="th_details" colspan="5">Details</th>
2995 </tr>
2996 <tr class="entry_cont">
2997 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2998 <p>Must be 0 if no
2999CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
3000by HAL.<wbr/> Always updated even if AE algorithm ignores the
3001trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3002 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3003 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3004
3005
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3006 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3007 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3008
3009
3010 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3011 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3012 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3013 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3014 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3015 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3016 <span class="entry_type_container">x</span>
3017
3018 <span class="entry_type_array">
3019 5 x area_count
3020 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3021 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3022
3023
3024 </td> <!-- entry_type -->
3025
3026 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3027 <p>List of areas to use for
3028metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3029 </td>
3030
3031 <td class="entry_units">
3032 </td>
3033
3034 <td class="entry_range">
3035 </td>
3036
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3037 <td class="entry_tags">
3038 <ul class="entry_tags">
3039 <li><a href="#tag_BC">BC</a></li>
3040 </ul>
3041 </td>
3042
3043 </tr>
3044 <tr class="entries_header">
3045 <th class="th_details" colspan="5">Details</th>
3046 </tr>
3047 <tr class="entry_cont">
3048 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3049 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3050xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3051specified coordinates.<wbr/></p>
3052<p>The coordinate system is based on the active pixel array,<wbr/>
3053with (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]3054(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3055<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]3056bottom-right pixel in the active pixel array.<wbr/> The weight
3057should be nonnegative.<wbr/></p>
3058<p>If all regions have 0 weight,<wbr/> then no specific metering area
3059needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3060outside 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]3061should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3062used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3063 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3064 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3065
3066
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3067 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3068 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3069
3070
3071 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3072 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3073 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3074 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3075 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3076 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3077
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3078 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3079
3080 <ul class="entry_type_enum">
3081 <li>
3082 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3083 <span class="entry_type_enum_notes">AE is off.<wbr/> When a camera device is opened,<wbr/> it starts in
3084 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3085 </li>
3086 <li>
3087 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3088 <span class="entry_type_enum_notes">AE doesn't yet have a good set of control values
3089 for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3090 </li>
3091 <li>
3092 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3093 <span class="entry_type_enum_notes">AE has a good set of control values for the
3094 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3095 </li>
3096 <li>
3097 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3098 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3099 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3100 </li>
3101 <li>
3102 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3103 <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]3104 needs to be fired for good quality still
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3105 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3106 </li>
3107 <li>
3108 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3109 <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]3110 (through the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3111 trigger_<wbr/>action(CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING)
3112 call),<wbr/> and is currently executing it.<wbr/> Once PRECAPTURE
3113 completes,<wbr/> AE will transition to CONVERGED or
3114 FLASH_<wbr/>REQUIRED as appropriate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3115 </li>
3116 </ul>
3117
3118 </td> <!-- entry_type -->
3119
3120 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3121 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3122 </td>
3123
3124 <td class="entry_units">
3125 </td>
3126
3127 <td class="entry_range">
3128 </td>
3129
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3130 <td class="entry_tags">
3131 </td>
3132
3133 </tr>
3134 <tr class="entries_header">
3135 <th class="th_details" colspan="5">Details</th>
3136 </tr>
3137 <tr class="entry_cont">
3138 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3139 <p>Whenever the AE algorithm state changes,<wbr/> a
3140MSG_<wbr/>AUTOEXPOSURE notification must be send if a
3141notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3142 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3143 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3144
3145
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3146 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3147 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3148
3149
3150 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3151 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3152 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3153 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3154 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3155 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3156
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3157 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3158
3159 <ul class="entry_type_enum">
3160 <li>
3161 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3162 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
3163 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
3164 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3165 </li>
3166 <li>
3167 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3168 <span class="entry_type_enum_notes">
3169 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3170
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3171 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
3172 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3173 the autofocus trigger action is called.<wbr/> When that trigger
3174 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3175 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3176
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3177 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3178 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3179 </li>
3180 <li>
3181 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3182 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
3183 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3184
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3185 When that trigger is activated,<wbr/> AF must transition to
3186 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3187 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3188 position to default,<wbr/> and sets the AF state to
3189 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3190 </li>
3191 <li>
3192 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3193 <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]3194 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3195 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3196
3197 The focusing behavior should be suitable for good quality
3198 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3199 movement and no overshoots.<wbr/> When the AF trigger is not
3200 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3201 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3202 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3203 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3204 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3205 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3206
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3207 Once cancel is received,<wbr/> the algorithm should transition
3208 back to INACTIVE and resume passive scan.<wbr/> Note that this
3209 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3210 ongoing PASSIVE_<wbr/>SCAN must immediately be
3211 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3212 </li>
3213 <li>
3214 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3215 <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]3216 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3217 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3218
3219 The focusing behavior should be suitable for still image
3220 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3221 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3222 algorithm should start in INACTIVE state,<wbr/> and then
3223 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3224 appropriate as it attempts to maintain focus.<wbr/> When the AF
3225 trigger is activated,<wbr/> the algorithm should finish its
3226 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3227 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3228 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3229
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3230 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3231 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3232 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3233 </li>
3234 <li>
3235 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3236 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
3237 trigger is ignored,<wbr/> AF state should always be
3238 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3239 </li>
3240 </ul>
3241
3242 </td> <!-- entry_type -->
3243
3244 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3245 <p>Whether AF is currently enabled,<wbr/> and what
3246mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3247 </td>
3248
3249 <td class="entry_units">
3250 </td>
3251
3252 <td class="entry_range">
3253 </td>
3254
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3255 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3256 <ul class="entry_tags">
3257 <li><a href="#tag_BC">BC</a></li>
3258 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3259 </td>
3260
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3261 </tr>
3262 <tr class="entries_header">
3263 <th class="th_details" colspan="5">Details</th>
3264 </tr>
3265 <tr class="entry_cont">
3266 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3267 <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]3268<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]3269report 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]3270result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3271 </td>
3272 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3273
3274
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3275 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3276 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3277
3278
3279 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3280 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3281 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3282 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3283 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3284 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3285 <span class="entry_type_container">x</span>
3286
3287 <span class="entry_type_array">
3288 5 x area_count
3289 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3290 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3291
3292
3293 </td> <!-- entry_type -->
3294
3295 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3296 <p>List of areas to use for focus
3297estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3298 </td>
3299
3300 <td class="entry_units">
3301 </td>
3302
3303 <td class="entry_range">
3304 </td>
3305
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3306 <td class="entry_tags">
3307 <ul class="entry_tags">
3308 <li><a href="#tag_BC">BC</a></li>
3309 </ul>
3310 </td>
3311
3312 </tr>
3313 <tr class="entries_header">
3314 <th class="th_details" colspan="5">Details</th>
3315 </tr>
3316 <tr class="entry_cont">
3317 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3318 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3319xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3320specified coordinates.<wbr/></p>
3321<p>The coordinate system is based on the active pixel array,<wbr/>
3322with (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]3323(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3324<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]3325bottom-right pixel in the active pixel array.<wbr/> The weight
3326should be nonnegative.<wbr/></p>
3327<p>If all regions have 0 weight,<wbr/> then no specific focus area
3328needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3329outside 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]3330should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3331used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3332 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3333 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3334
3335
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3336 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3337 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3338
3339
3340 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3341 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3342 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3343 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3344 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3345 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3346
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3347 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3348
3349 <ul class="entry_type_enum">
3350 <li>
3351 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3352 <span class="entry_type_enum_notes">AF off or has not yet tried to scan/<wbr/>been asked
3353 to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3354 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3355 </li>
3356 <li>
3357 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3358 <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]3359 currently doing an AF scan initiated by a continuous
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3360 autofocus mode</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3361 </li>
3362 <li>
3363 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3364 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3365 believes it is in focus,<wbr/> but may restart scanning at
3366 any time.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3367 </li>
3368 <li>
3369 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3370 <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]3371 an AF scan because it was triggered by AF
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3372 trigger</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3373 </li>
3374 <li>
3375 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3376 <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]3377 believes it is focused correctly and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3378 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3379 </li>
3380 <li>
3381 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3382 <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]3383 failed to focus successfully and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3384 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3385 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3386 <li>
3387 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3388 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3389 passive scan without finding focus,<wbr/> and may restart
3390 scanning at any time.<wbr/></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3391 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3392 </ul>
3393
3394 </td> <!-- entry_type -->
3395
3396 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3397 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3398 </td>
3399
3400 <td class="entry_units">
3401 </td>
3402
3403 <td class="entry_range">
3404 </td>
3405
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3406 <td class="entry_tags">
3407 </td>
3408
3409 </tr>
3410 <tr class="entries_header">
3411 <th class="th_details" colspan="5">Details</th>
3412 </tr>
3413 <tr class="entry_cont">
3414 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3415 <p>Whenever the AF algorithm state changes,<wbr/> a
3416MSG_<wbr/>AUTOFOCUS notification must be send if a notification
3417callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3418 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3419 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3420
3421
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3422 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3423 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3424
3425
3426 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3427 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3428 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3429 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3430 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3431 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3432
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3433 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3434
3435
3436 </td> <!-- entry_type -->
3437
3438 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3439 <p>The ID sent with the latest
3440CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3441 </td>
3442
3443 <td class="entry_units">
3444 </td>
3445
3446 <td class="entry_range">
3447 </td>
3448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3449 <td class="entry_tags">
3450 </td>
3451
3452 </tr>
3453 <tr class="entries_header">
3454 <th class="th_details" colspan="5">Details</th>
3455 </tr>
3456 <tr class="entry_cont">
3457 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3458 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
3459received yet by HAL.<wbr/> Always updated even if AF algorithm
3460ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3461 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3462 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3463
3464
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3465 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3466 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3467
3468
3469 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3470 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3471 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3472 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3473 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3474 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3475
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3476 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3477
3478 <ul class="entry_type_enum">
3479 <li>
3480 <span class="entry_type_enum_name">OFF</span>
3481 </li>
3482 <li>
3483 <span class="entry_type_enum_name">AUTO</span>
3484 </li>
3485 <li>
3486 <span class="entry_type_enum_name">INCANDESCENT</span>
3487 </li>
3488 <li>
3489 <span class="entry_type_enum_name">FLUORESCENT</span>
3490 </li>
3491 <li>
3492 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
3493 </li>
3494 <li>
3495 <span class="entry_type_enum_name">DAYLIGHT</span>
3496 </li>
3497 <li>
3498 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
3499 </li>
3500 <li>
3501 <span class="entry_type_enum_name">TWILIGHT</span>
3502 </li>
3503 <li>
3504 <span class="entry_type_enum_name">SHADE</span>
3505 </li>
3506 </ul>
3507
3508 </td> <!-- entry_type -->
3509
3510 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3511 <p>Whether AWB is currently setting the color
3512transform fields,<wbr/> and what its illumination target
3513is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3514 </td>
3515
3516 <td class="entry_units">
3517 </td>
3518
3519 <td class="entry_range">
3520 </td>
3521
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3522 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3523 <ul class="entry_tags">
3524 <li><a href="#tag_BC">BC</a></li>
3525 <li><a href="#tag_AWB">AWB</a></li>
3526 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3527 </td>
3528
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3529 </tr>
3530 <tr class="entries_header">
3531 <th class="th_details" colspan="5">Details</th>
3532 </tr>
3533 <tr class="entry_cont">
3534 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3535 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3536<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]3537 </td>
3538 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3539
3540
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3541 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3542 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3543
3544
3545 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3546 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3547 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3548 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3549 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3550 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3551 <span class="entry_type_container">x</span>
3552
3553 <span class="entry_type_array">
3554 5 x area_count
3555 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3556 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3557
3558
3559 </td> <!-- entry_type -->
3560
3561 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3562 <p>List of areas to use for illuminant
3563estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3564 </td>
3565
3566 <td class="entry_units">
3567 </td>
3568
3569 <td class="entry_range">
3570 </td>
3571
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3572 <td class="entry_tags">
3573 <ul class="entry_tags">
3574 <li><a href="#tag_BC">BC</a></li>
3575 </ul>
3576 </td>
3577
3578 </tr>
3579 <tr class="entries_header">
3580 <th class="th_details" colspan="5">Details</th>
3581 </tr>
3582 <tr class="entry_cont">
3583 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3584 <p>Only used in AUTO mode.<wbr/></p>
3585<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3586xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3587specified coordinates.<wbr/></p>
3588<p>The coordinate system is based on the active pixel array,<wbr/>
3589with (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]3590(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3591<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]3592bottom-right pixel in the active pixel array.<wbr/> The weight
3593should be nonnegative.<wbr/></p>
3594<p>If all regions have 0 weight,<wbr/> then no specific metering area
3595needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3596outside 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]3597should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3598used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3599 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3600 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3601
3602
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3603 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3604 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3605
3606
3607 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3608 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3609 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3610 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3611 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3612 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3613
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3614 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3615
3616 <ul class="entry_type_enum">
3617 <li>
3618 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3619 <span class="entry_type_enum_notes">AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
3620 starts in this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3621 </li>
3622 <li>
3623 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3624 <span class="entry_type_enum_notes">AWB doesn't yet have a good set of control
3625 values for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3626 </li>
3627 <li>
3628 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3629 <span class="entry_type_enum_notes">AWB has a good set of control values for the
3630 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3631 </li>
3632 <li>
3633 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3634 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3635 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3636 </li>
3637 </ul>
3638
3639 </td> <!-- entry_type -->
3640
3641 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3642 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3643 </td>
3644
3645 <td class="entry_units">
3646 </td>
3647
3648 <td class="entry_range">
3649 </td>
3650
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3651 <td class="entry_tags">
3652 </td>
3653
3654 </tr>
3655 <tr class="entries_header">
3656 <th class="th_details" colspan="5">Details</th>
3657 </tr>
3658 <tr class="entry_cont">
3659 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3660 <p>Whenever the AWB algorithm state changes,<wbr/> a
3661MSG_<wbr/>AUTOWHITEBALANCE notification must be send if a
3662notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3663 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3664 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3665
3666
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3667 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3668 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3669
3670
3671 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3672 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3673 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3674 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3675 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3676 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3677
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3678 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3679
3680 <ul class="entry_type_enum">
3681 <li>
3682 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3683 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
3684 routines are disabled,<wbr/> no other settings in
3685 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3686 </li>
3687 <li>
3688 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3689 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
3690 Manual control of capture parameters is disabled.<wbr/> All
3691 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
3692 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3693 </li>
3694 <li>
3695 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3696 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
3697 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3698 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3699 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
3700 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3701 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3702 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3703 </li>
3704 </ul>
3705
3706 </td> <!-- entry_type -->
3707
3708 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3709 <p>Overall mode of 3A control
3710routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3711 </td>
3712
3713 <td class="entry_units">
3714 </td>
3715
3716 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3717 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3718 </td>
3719
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3720 <td class="entry_tags">
3721 <ul class="entry_tags">
3722 <li><a href="#tag_BC">BC</a></li>
3723 </ul>
3724 </td>
3725
3726 </tr>
3727 <tr class="entries_header">
3728 <th class="th_details" colspan="5">Details</th>
3729 </tr>
3730 <tr class="entry_cont">
3731 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3732 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
3733by the HAL is disabled.<wbr/> The application must set the fields for
3734capture parameters itself.<wbr/></p>
3735<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3736android.<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]3737<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
3738android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
3739one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
3740as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3741<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]3742 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3743 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3744
3745
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3746 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3747 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3748
3749
3750
3751 <!-- end of kind -->
3752 </tbody>
3753
3754 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3755 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3756
3757
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3758 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3759
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3760 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3761 <tr>
3762 <th class="th_name">Property Name</th>
3763 <th class="th_type">Type</th>
3764 <th class="th_description">Description</th>
3765 <th class="th_units">Units</th>
3766 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3767 <th class="th_tags">Tags</th>
3768 </tr>
3769 </thead>
3770
3771 <tbody>
3772
3773
3774
3775
3776
3777
3778
3779
3780
3781
3782 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3783 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3784 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3785 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3786 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3787 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3788
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3789 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3790
3791 <ul class="entry_type_enum">
3792 <li>
3793 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3794 <span class="entry_type_enum_notes">Minimal or no slowdown of frame rate compared to
3795 Bayer RAW output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3796 </li>
3797 <li>
3798 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3799 <span class="entry_type_enum_notes">High-quality may reduce output frame
3800 rate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3801 </li>
3802 </ul>
3803
3804 </td> <!-- entry_type -->
3805
3806 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3807 <p>Controls the quality of the demosaicing
3808processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3809 </td>
3810
3811 <td class="entry_units">
3812 </td>
3813
3814 <td class="entry_range">
3815 </td>
3816
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3817 <td class="entry_tags">
3818 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3819 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3820 </ul>
3821 </td>
3822
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3823 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3824
3825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3826 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3827 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3828
3829
3830
3831 <!-- end of kind -->
3832 </tbody>
3833
3834 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3835 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3836
3837
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3838 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3839
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3840 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3841 <tr>
3842 <th class="th_name">Property Name</th>
3843 <th class="th_type">Type</th>
3844 <th class="th_description">Description</th>
3845 <th class="th_units">Units</th>
3846 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3847 <th class="th_tags">Tags</th>
3848 </tr>
3849 </thead>
3850
3851 <tbody>
3852
3853
3854
3855
3856
3857
3858
3859
3860
3861
3862 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3863 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3864 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3865 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3866 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3867 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3868
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3869 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3870
3871 <ul class="entry_type_enum">
3872 <li>
3873 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3874 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3875 </li>
3876 <li>
3877 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3878 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
3879 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3880 </li>
3881 <li>
3882 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3883 <span class="entry_type_enum_notes">Frame rate may be reduced by high
3884 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3885 </li>
3886 </ul>
3887
3888 </td> <!-- entry_type -->
3889
3890 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3891 <p>Operation mode for edge
3892enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3893 </td>
3894
3895 <td class="entry_units">
3896 </td>
3897
3898 <td class="entry_range">
3899 </td>
3900
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3901 <td class="entry_tags">
3902 </td>
3903
3904 </tr>
3905 <tr class="entries_header">
3906 <th class="th_details" colspan="5">Details</th>
3907 </tr>
3908 <tr class="entry_cont">
3909 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3910 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
3911enhancement will be applied by the HAL.<wbr/></p>
3912<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
3913will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
3914HAL should use the highest-quality enhancement algorithms,<wbr/>
3915even if it slows down capture rate.<wbr/> FAST means the HAL should
3916not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3917 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3918 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3919
3920
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3921 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3922 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3923
3924
3925 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3926 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3927 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3928 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3929 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3930 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3931
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3932 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3933
3934
3935 </td> <!-- entry_type -->
3936
3937 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3938 <p>Control the amount of edge enhancement
3939applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3940 </td>
3941
3942 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3943 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3944 </td>
3945
3946 <td class="entry_range">
3947 </td>
3948
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3949 <td class="entry_tags">
3950 </td>
3951
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3952 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3953
3954
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3955 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3956 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3957
3958
3959
3960 <!-- end of kind -->
3961 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3962 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3963
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3964 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3965 <tr>
3966 <th class="th_name">Property Name</th>
3967 <th class="th_type">Type</th>
3968 <th class="th_description">Description</th>
3969 <th class="th_units">Units</th>
3970 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3971 <th class="th_tags">Tags</th>
3972 </tr>
3973 </thead>
3974
3975 <tbody>
3976
3977
3978
3979
3980
3981
3982
3983
3984
3985
3986 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3987 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3988 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3989 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3990 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3991 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3992
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3993 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3994
3995 <ul class="entry_type_enum">
3996 <li>
3997 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3998 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3999 </li>
4000 <li>
4001 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4002 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
4003 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4004 </li>
4005 <li>
4006 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4007 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4008 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4009 </li>
4010 </ul>
4011
4012 </td> <!-- entry_type -->
4013
4014 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4015 <p>Operation mode for edge
4016enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4017 </td>
4018
4019 <td class="entry_units">
4020 </td>
4021
4022 <td class="entry_range">
4023 </td>
4024
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4025 <td class="entry_tags">
4026 </td>
4027
4028 </tr>
4029 <tr class="entries_header">
4030 <th class="th_details" colspan="5">Details</th>
4031 </tr>
4032 <tr class="entry_cont">
4033 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4034 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4035enhancement will be applied by the HAL.<wbr/></p>
4036<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
4037will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
4038HAL should use the highest-quality enhancement algorithms,<wbr/>
4039even if it slows down capture rate.<wbr/> FAST means the HAL should
4040not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4041 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4042 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4043
4044
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4045 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4046 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4047
4048
4049
4050 <!-- end of kind -->
4051 </tbody>
4052
4053 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4054 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4055
4056
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4057 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4058
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4059 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4060 <tr>
4061 <th class="th_name">Property Name</th>
4062 <th class="th_type">Type</th>
4063 <th class="th_description">Description</th>
4064 <th class="th_units">Units</th>
4065 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4066 <th class="th_tags">Tags</th>
4067 </tr>
4068 </thead>
4069
4070 <tbody>
4071
4072
4073
4074
4075
4076
4077
4078
4079
4080
4081 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4082 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4083 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4084 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4085 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4086 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4087
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4088 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4089
4090
4091 </td> <!-- entry_type -->
4092
4093 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4094 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4095 </td>
4096
4097 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4098 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4099 </td>
4100
4101 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4102 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4103 </td>
4104
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4105 <td class="entry_tags">
4106 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4107 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4108 </ul>
4109 </td>
4110
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4111 </tr>
4112 <tr class="entries_header">
4113 <th class="th_details" colspan="5">Details</th>
4114 </tr>
4115 <tr class="entry_cont">
4116 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4117 <p>Power for snapshot may use a different scale than
4118for torch mode.<wbr/> Only one entry for torch mode will be
4119used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4120 </td>
4121 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4122
4123
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4124 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4125 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4126
4127
4128 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4129 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4130 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4131 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4132 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4133 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4134
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4135 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4136
4137
4138 </td> <!-- entry_type -->
4139
4140 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4141 <p>Firing time of flash relative to start of
4142exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4143 </td>
4144
4145 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4146 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4147 </td>
4148
4149 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4150 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4151 </td>
4152
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4153 <td class="entry_tags">
4154 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4155 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4156 </ul>
4157 </td>
4158
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4159 </tr>
4160 <tr class="entries_header">
4161 <th class="th_details" colspan="5">Details</th>
4162 </tr>
4163 <tr class="entry_cont">
4164 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4165 <p>Clamped to (0,<wbr/> exposure time - flash
4166duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4167 </td>
4168 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4169
4170
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4171 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4172 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4173
4174
4175 <tr class="entry" id="controls_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4176 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4177 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4178 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4179 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4180 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4181
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4182 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4183
4184 <ul class="entry_type_enum">
4185 <li>
4186 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4187 <span class="entry_type_enum_notes">Do not fire the flash for this
4188 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4189 </li>
4190 <li>
4191 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4192 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4193 for this capture based on firingPower,<wbr/>
4194 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4195 </li>
4196 <li>
4197 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4198 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4199 continuously on,<wbr/> power set by
4200 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4201 </li>
4202 </ul>
4203
4204 </td> <!-- entry_type -->
4205
4206 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4207 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4208 </td>
4209
4210 <td class="entry_units">
4211 </td>
4212
4213 <td class="entry_range">
4214 </td>
4215
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4216 <td class="entry_tags">
4217 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4218 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4219 </ul>
4220 </td>
4221
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4222 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4223
4224
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4225 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4226 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4227
4228
4229
4230 <!-- end of kind -->
4231 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4232 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4233
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4234 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4235 <tr>
4236 <th class="th_name">Property Name</th>
4237 <th class="th_type">Type</th>
4238 <th class="th_description">Description</th>
4239 <th class="th_units">Units</th>
4240 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4241 <th class="th_tags">Tags</th>
4242 </tr>
4243 </thead>
4244
4245 <tbody>
4246
4247
4248
4249
4250
4251
4252
4253
4254
4255
4256
4257
4258 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4259 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4260 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4261 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4262 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4263 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4264
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4265 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4266
4267
4268 </td> <!-- entry_type -->
4269
4270 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4271 <p>Whether this camera has a
4272flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4273 </td>
4274
4275 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4276 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4277 </td>
4278
4279 <td class="entry_range">
4280 </td>
4281
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4282 <td class="entry_tags">
4283 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4284 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4285 </ul>
4286 </td>
4287
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4288 </tr>
4289 <tr class="entries_header">
4290 <th class="th_details" colspan="5">Details</th>
4291 </tr>
4292 <tr class="entry_cont">
4293 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4294 <p>If no flash,<wbr/> none of the flash controls do
4295anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4296 </td>
4297 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4298
4299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4300 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4301 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4302
4303
4304 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4305 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4306 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4307 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4308 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4309 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4310
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4311 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4312
4313
4314 </td> <!-- entry_type -->
4315
4316 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4317 <p>Time taken before flash can fire
4318again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4319 </td>
4320
4321 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4322 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4323 </td>
4324
4325 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4326 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4327 </td>
4328
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4329 <td class="entry_tags">
4330 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4331 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4332 </ul>
4333 </td>
4334
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4335 </tr>
4336 <tr class="entries_header">
4337 <th class="th_details" colspan="5">Details</th>
4338 </tr>
4339 <tr class="entry_cont">
4340 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4341 <p>1 second too long/<wbr/>too short for recharge? Should
4342this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4343 </td>
4344 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4345
4346
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4347 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4348 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4349
4350
4351
4352
4353
4354 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4355 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4356 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4357 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4358 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4359 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4360
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4361 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4362
4363
4364 </td> <!-- entry_type -->
4365
4366 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4367 <p>The x,<wbr/>y whitepoint of the
4368flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4369 </td>
4370
4371 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4372 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4373 </td>
4374
4375 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4376 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4377 </td>
4378
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4379 <td class="entry_tags">
4380 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4381 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4382 </ul>
4383 </td>
4384
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4385 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4386
4387
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4388 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4389 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4390
4391
4392 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4393 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4394 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4395 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4396 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4397 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4398
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4399 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4400
4401
4402 </td> <!-- entry_type -->
4403
4404 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4405 <p>Max energy output of the flash for a full
4406power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4407 </td>
4408
4409 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4410 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4411 </td>
4412
4413 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4414 <blockquote>
4415<p>= 0</p>
4416</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4417 </td>
4418
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4419 <td class="entry_tags">
4420 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4421 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4422 </ul>
4423 </td>
4424
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4425 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4426
4427
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4428 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4429 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4430
4431
4432
4433 <!-- end of kind -->
4434 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4435 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4436
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4437 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4438 <tr>
4439 <th class="th_name">Property Name</th>
4440 <th class="th_type">Type</th>
4441 <th class="th_description">Description</th>
4442 <th class="th_units">Units</th>
4443 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4444 <th class="th_tags">Tags</th>
4445 </tr>
4446 </thead>
4447
4448 <tbody>
4449
4450
4451
4452
4453
4454
4455
4456
4457
4458
4459 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4460 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4461 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4462 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4463 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4464 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4465
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4466 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4467
4468
4469 </td> <!-- entry_type -->
4470
4471 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4472 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4473 </td>
4474
4475 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4476 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4477 </td>
4478
4479 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4480 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4481 </td>
4482
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4483 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4484 <ul class="entry_tags">
4485 <li><a href="#tag_V1">V1</a></li>
4486 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4487 </td>
4488
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4489 </tr>
4490 <tr class="entries_header">
4491 <th class="th_details" colspan="5">Details</th>
4492 </tr>
4493 <tr class="entry_cont">
4494 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4495 <p>Power for snapshot may use a different scale than
4496for torch mode.<wbr/> Only one entry for torch mode will be
4497used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4498 </td>
4499 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4500
4501
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4502 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4503 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4504
4505
4506 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4507 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4508 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4509 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4510 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4511 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4512
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4513 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4514
4515
4516 </td> <!-- entry_type -->
4517
4518 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4519 <p>Firing time of flash relative to start of
4520exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4521 </td>
4522
4523 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4524 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4525 </td>
4526
4527 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4528 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4529 </td>
4530
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4531 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4532 <ul class="entry_tags">
4533 <li><a href="#tag_V1">V1</a></li>
4534 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4535 </td>
4536
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4537 </tr>
4538 <tr class="entries_header">
4539 <th class="th_details" colspan="5">Details</th>
4540 </tr>
4541 <tr class="entry_cont">
4542 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4543 <p>Clamped to (0,<wbr/> exposure time - flash
4544duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4545 </td>
4546 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4547
4548
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4549 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4550 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4551
4552
4553 <tr class="entry" id="dynamic_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4554 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4555 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4556 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4557 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4558 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4559
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4560 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4561
4562 <ul class="entry_type_enum">
4563 <li>
4564 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4565 <span class="entry_type_enum_notes">Do not fire the flash for this
4566 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4567 </li>
4568 <li>
4569 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4570 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4571 for this capture based on firingPower,<wbr/>
4572 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4573 </li>
4574 <li>
4575 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4576 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4577 continuously on,<wbr/> power set by
4578 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4579 </li>
4580 </ul>
4581
4582 </td> <!-- entry_type -->
4583
4584 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4585 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4586 </td>
4587
4588 <td class="entry_units">
4589 </td>
4590
4591 <td class="entry_range">
4592 </td>
4593
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4594 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4595 <ul class="entry_tags">
4596 <li><a href="#tag_BC">BC</a></li>
4597 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4598 </td>
4599
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4600 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4601
4602
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4603 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4604 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4605
4606
4607 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4608 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4609 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4610 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4611 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4612 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4613
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4614 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4615
4616 <ul class="entry_type_enum">
4617 <li>
4618 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4619 <span class="entry_type_enum_notes">No flash on camera</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4620 </li>
4621 <li>
4622 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4623 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4624 charging and cannot be fired</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4625 </li>
4626 <li>
4627 <span class="entry_type_enum_name">READY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4628 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4629 ready to fire</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4630 </li>
4631 <li>
4632 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4633 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash fired
4634 for this capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4635 </li>
4636 </ul>
4637
4638 </td> <!-- entry_type -->
4639
4640 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4641 <p>Current state of the flash
4642unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4643 </td>
4644
4645 <td class="entry_units">
4646 </td>
4647
4648 <td class="entry_range">
4649 </td>
4650
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4651 <td class="entry_tags">
4652 </td>
4653
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4654 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4655
4656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4657 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4658 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4659
4660
4661
4662 <!-- end of kind -->
4663 </tbody>
4664
4665 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4666 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4667
4668
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4669 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4670
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4671 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4672 <tr>
4673 <th class="th_name">Property Name</th>
4674 <th class="th_type">Type</th>
4675 <th class="th_description">Description</th>
4676 <th class="th_units">Units</th>
4677 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4678 <th class="th_tags">Tags</th>
4679 </tr>
4680 </thead>
4681
4682 <tbody>
4683
4684
4685
4686
4687
4688
4689
4690
4691
4692
4693 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4694 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4695 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4696 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4697 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4698 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4699
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4700 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4701
4702 <ul class="entry_type_enum">
4703 <li>
4704 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4705 <span class="entry_type_enum_notes">No geometric correction is
4706 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4707 </li>
4708 <li>
4709 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4710 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
4711 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4712 </li>
4713 <li>
4714 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4715 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4716 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4717 </li>
4718 </ul>
4719
4720 </td> <!-- entry_type -->
4721
4722 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4723 <p>Operating mode of geometric
4724correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4725 </td>
4726
4727 <td class="entry_units">
4728 </td>
4729
4730 <td class="entry_range">
4731 </td>
4732
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4733 <td class="entry_tags">
4734 </td>
4735
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4736 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4737
4738
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4739 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4740 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4741
4742
4743 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4744 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4745 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4746 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4747 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4748 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4749
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4750 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4751
4752
4753 </td> <!-- entry_type -->
4754
4755 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4756 <p>Control the amount of shading correction
4757applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4758 </td>
4759
4760 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4761 unitless: 1-10; 10 is full shading
4762 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4763 </td>
4764
4765 <td class="entry_range">
4766 </td>
4767
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4768 <td class="entry_tags">
4769 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4770 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4771 </ul>
4772 </td>
4773
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4774 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4775
4776
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4777 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4778 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4779
4780
4781
4782 <!-- end of kind -->
4783 </tbody>
4784
4785 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4786 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4787
4788
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4789 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4790
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4791 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4792 <tr>
4793 <th class="th_name">Property Name</th>
4794 <th class="th_type">Type</th>
4795 <th class="th_description">Description</th>
4796 <th class="th_units">Units</th>
4797 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4798 <th class="th_tags">Tags</th>
4799 </tr>
4800 </thead>
4801
4802 <tbody>
4803
4804
4805
4806
4807
4808
4809
4810
4811
4812
4813 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4814 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4815 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4816 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4817 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4818 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4819
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4820 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4821
4822 <ul class="entry_type_enum">
4823 <li>
4824 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4825 <span class="entry_type_enum_notes">No hot pixel correction can be
4826 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4827 </li>
4828 <li>
4829 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4830 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
4831 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4832 </li>
4833 <li>
4834 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4835 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4836 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4837 </li>
4838 </ul>
4839
4840 </td> <!-- entry_type -->
4841
4842 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4843 <p>Set operational mode for hot pixel
4844correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4845 </td>
4846
4847 <td class="entry_units">
4848 </td>
4849
4850 <td class="entry_range">
4851 </td>
4852
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4853 <td class="entry_tags">
4854 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4855 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4856 </ul>
4857 </td>
4858
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4859 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4860
4861
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4862 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4863 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4864
4865
4866
4867 <!-- end of kind -->
4868 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4869 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4870
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4871 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4872 <tr>
4873 <th class="th_name">Property Name</th>
4874 <th class="th_type">Type</th>
4875 <th class="th_description">Description</th>
4876 <th class="th_units">Units</th>
4877 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4878 <th class="th_tags">Tags</th>
4879 </tr>
4880 </thead>
4881
4882 <tbody>
4883
4884
4885
4886
4887
4888
4889
4890
4891
4892
4893
4894
4895 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4896 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4897 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4898 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4899 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4900 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4901 <span class="entry_type_container">x</span>
4902
4903 <span class="entry_type_array">
4904 2 x n
4905 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4906 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4907 <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]4908
4909
4910 </td> <!-- entry_type -->
4911
4912 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4913 <p>Location of hot/<wbr/>defective pixels on
4914sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4915 </td>
4916
4917 <td class="entry_units">
4918 </td>
4919
4920 <td class="entry_range">
4921 </td>
4922
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4923 <td class="entry_tags">
4924 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4925 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4926 </ul>
4927 </td>
4928
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4929 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4930
4931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4932 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4933 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4934
4935
4936
4937
4938
4939
4940 <!-- end of kind -->
4941 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4942 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4943
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4944 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4945 <tr>
4946 <th class="th_name">Property Name</th>
4947 <th class="th_type">Type</th>
4948 <th class="th_description">Description</th>
4949 <th class="th_units">Units</th>
4950 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4951 <th class="th_tags">Tags</th>
4952 </tr>
4953 </thead>
4954
4955 <tbody>
4956
4957
4958
4959
4960
4961
4962
4963
4964
4965
4966 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4967 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4968 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4969 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4970 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4971 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4972
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4973 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4974
4975 <ul class="entry_type_enum">
4976 <li>
4977 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4978 <span class="entry_type_enum_notes">No hot pixel correction can be
4979 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4980 </li>
4981 <li>
4982 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4983 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
4984 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4985 </li>
4986 <li>
4987 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4988 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4989 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4990 </li>
4991 </ul>
4992
4993 </td> <!-- entry_type -->
4994
4995 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4996 <p>Set operational mode for hot pixel
4997correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4998 </td>
4999
5000 <td class="entry_units">
5001 </td>
5002
5003 <td class="entry_range">
5004 </td>
5005
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5006 <td class="entry_tags">
5007 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5008 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5009 </ul>
5010 </td>
5011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5012 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5013
5014
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5015 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5016 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5017
5018
5019
5020 <!-- end of kind -->
5021 </tbody>
5022
5023 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5024 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5025
5026
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5027 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5028
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5029 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5030 <tr>
5031 <th class="th_name">Property Name</th>
5032 <th class="th_type">Type</th>
5033 <th class="th_description">Description</th>
5034 <th class="th_units">Units</th>
5035 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5036 <th class="th_tags">Tags</th>
5037 </tr>
5038 </thead>
5039
5040 <tbody>
5041
5042
5043
5044
5045
5046
5047
5048
5049
5050
5051 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5052 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5053 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5054 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5055 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5056 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5057 <span class="entry_type_container">x</span>
5058
5059 <span class="entry_type_array">
5060 3
5061 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5062 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5063 <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]5064
5065
5066 </td> <!-- entry_type -->
5067
5068 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5069 <p>GPS coordinates to include in output JPEG
5070EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5071 </td>
5072
5073 <td class="entry_units">
5074 </td>
5075
5076 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5077 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5078 </td>
5079
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5080 <td class="entry_tags">
5081 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5082 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5083 </ul>
5084 </td>
5085
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5086 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5087
5088
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5089 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5090 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5091
5092
5093 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5094 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5095 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5096 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5097 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5098 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5099
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5100 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5101
5102
5103 </td> <!-- entry_type -->
5104
5105 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5106 <p>32 characters describing GPS algorithm to
5107include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5108 </td>
5109
5110 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5111 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5112 </td>
5113
5114 <td class="entry_range">
5115 </td>
5116
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5117 <td class="entry_tags">
5118 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5119 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5120 </ul>
5121 </td>
5122
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5123 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5124
5125
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5126 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5127 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5128
5129
5130 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5131 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5132 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5133 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5134 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5135 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5136
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5137 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5138
5139
5140 </td> <!-- entry_type -->
5141
5142 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5143 <p>Time GPS fix was made to include in
5144EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5145 </td>
5146
5147 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5148 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5149 </td>
5150
5151 <td class="entry_range">
5152 </td>
5153
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5154 <td class="entry_tags">
5155 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5156 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5157 </ul>
5158 </td>
5159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5160 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5161
5162
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5163 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5164 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5165
5166
5167 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5168 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5169 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5170 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5171 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5172 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5173
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5174 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5175
5176
5177 </td> <!-- entry_type -->
5178
5179 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5180 <p>Orientation of JPEG image to
5181write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5182 </td>
5183
5184 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5185 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5186 </td>
5187
5188 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5189 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5190 </td>
5191
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5192 <td class="entry_tags">
5193 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5194 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5195 </ul>
5196 </td>
5197
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5198 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5199
5200
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5201 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5202 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5203
5204
5205 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5206 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5207 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5208 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5209 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5210 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5211
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5212 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5213
5214
5215 </td> <!-- entry_type -->
5216
5217 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5218 <p>Compression quality of the final JPEG
5219image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5220 </td>
5221
5222 <td class="entry_units">
5223 </td>
5224
5225 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5226 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5227 </td>
5228
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5229 <td class="entry_tags">
5230 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5231 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5232 </ul>
5233 </td>
5234
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5235 </tr>
5236 <tr class="entries_header">
5237 <th class="th_details" colspan="5">Details</th>
5238 </tr>
5239 <tr class="entry_cont">
5240 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5241 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5242 </td>
5243 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5244
5245
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5246 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5247 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5248
5249
5250 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5251 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5252 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5253 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5254 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5255 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5256
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5257 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5258
5259
5260 </td> <!-- entry_type -->
5261
5262 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5263 <p>Compression quality of JPEG
5264thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5265 </td>
5266
5267 <td class="entry_units">
5268 </td>
5269
5270 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5271 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5272 </td>
5273
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5274 <td class="entry_tags">
5275 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5276 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5277 </ul>
5278 </td>
5279
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5280 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5281
5282
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5283 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5284 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5285
5286
5287 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5288 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5289 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5290 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5291 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5292 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5293 <span class="entry_type_container">x</span>
5294
5295 <span class="entry_type_array">
5296 2
5297 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5298 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5299
5300
5301 </td> <!-- entry_type -->
5302
5303 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5304 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5305 </td>
5306
5307 <td class="entry_units">
5308 </td>
5309
5310 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5311 <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]5312 </td>
5313
5314 <td class="entry_tags">
5315 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5316 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5317 </ul>
5318 </td>
5319
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5320 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5321 <tr class="entries_header">
5322 <th class="th_details" colspan="5">Details</th>
5323 </tr>
5324 <tr class="entry_cont">
5325 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5326 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5327but the captured JPEG must still be a valid image.<wbr/></p>
5328<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5329the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5330 </td>
5331 </tr>
5332
5333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5334 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5335 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5336
5337
5338
5339 <!-- end of kind -->
5340 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5341 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5342
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5343 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5344 <tr>
5345 <th class="th_name">Property Name</th>
5346 <th class="th_type">Type</th>
5347 <th class="th_description">Description</th>
5348 <th class="th_units">Units</th>
5349 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5350 <th class="th_tags">Tags</th>
5351 </tr>
5352 </thead>
5353
5354 <tbody>
5355
5356
5357
5358
5359
5360
5361
5362
5363
5364
5365 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5366 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5367 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5368 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5369 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5370 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5371 <span class="entry_type_container">x</span>
5372
5373 <span class="entry_type_array">
5374 2 x n
5375 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5376 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5377
5378
5379 </td> <!-- entry_type -->
5380
5381 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5382 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5383 </td>
5384
5385 <td class="entry_units">
5386 </td>
5387
5388 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5389 <p>Must include at least one valid resolution,<wbr/> plus
5390(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]5391 </td>
5392
5393 <td class="entry_tags">
5394 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5395 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5396 </ul>
5397 </td>
5398
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5399 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5400 <tr class="entries_header">
5401 <th class="th_details" colspan="5">Details</th>
5402 </tr>
5403 <tr class="entry_cont">
5404 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5405 <p>Below condiditions must be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5406<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5407<li>The sizes must be sorted by increasing pixel area (width x height).<wbr/>
5408If 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]5409<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]5410aspect 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]5411The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5412in a given size list.<wbr/></li>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5413<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]5414one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
5415and vice versa.<wbr/></li>
5416<li>All non (0,<wbr/> 0) sizes must have non-zero widths and heights.<wbr/></li>
5417</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5418 </td>
5419 </tr>
5420
5421
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5422 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5423 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5424
5425
5426 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5427 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5428 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5429 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5430 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5431 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5432
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5433 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5434
5435
5436 </td> <!-- entry_type -->
5437
5438 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5439 <p>Maximum size in bytes for the compressed
5440JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5441 </td>
5442
5443 <td class="entry_units">
5444 </td>
5445
5446 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5447 <p>Must be large enough to fit any JPEG produced by
5448the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5449 </td>
5450
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5451 <td class="entry_tags">
5452 </td>
5453
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5454 </tr>
5455 <tr class="entries_header">
5456 <th class="th_details" colspan="5">Details</th>
5457 </tr>
5458 <tr class="entry_cont">
5459 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5460 <p>This is used for sizing the gralloc buffers for
5461JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5462 </td>
5463 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5464
5465
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5466 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5467 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5468
5469
5470
5471 <!-- end of kind -->
5472 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5473 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5474
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5475 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5476 <tr>
5477 <th class="th_name">Property Name</th>
5478 <th class="th_type">Type</th>
5479 <th class="th_description">Description</th>
5480 <th class="th_units">Units</th>
5481 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5482 <th class="th_tags">Tags</th>
5483 </tr>
5484 </thead>
5485
5486 <tbody>
5487
5488
5489
5490
5491
5492
5493
5494
5495
5496
5497 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5498 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5499 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5500 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5501 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5502 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5503 <span class="entry_type_container">x</span>
5504
5505 <span class="entry_type_array">
5506 3
5507 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5508 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5509 <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]5510
5511
5512 </td> <!-- entry_type -->
5513
5514 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5515 <p>GPS coordinates to include in output JPEG
5516EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5517 </td>
5518
5519 <td class="entry_units">
5520 </td>
5521
5522 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5523 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5524 </td>
5525
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5526 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5527 <ul class="entry_tags">
5528 <li><a href="#tag_BC">BC</a></li>
5529 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5530 </td>
5531
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5532 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5533
5534
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5535 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5536 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5537
5538
5539 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5540 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5541 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5542 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5543 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5544 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5545
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5546 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5547
5548
5549 </td> <!-- entry_type -->
5550
5551 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5552 <p>32 characters describing GPS algorithm to
5553include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5554 </td>
5555
5556 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5557 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5558 </td>
5559
5560 <td class="entry_range">
5561 </td>
5562
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5563 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5564 <ul class="entry_tags">
5565 <li><a href="#tag_BC">BC</a></li>
5566 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5567 </td>
5568
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5569 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5570
5571
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5572 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5573 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5574
5575
5576 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5577 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5578 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5579 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5580 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5581 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5582
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5583 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5584
5585
5586 </td> <!-- entry_type -->
5587
5588 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5589 <p>Time GPS fix was made to include in
5590EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5591 </td>
5592
5593 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5594 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5595 </td>
5596
5597 <td class="entry_range">
5598 </td>
5599
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5600 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5601 <ul class="entry_tags">
5602 <li><a href="#tag_BC">BC</a></li>
5603 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5604 </td>
5605
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5606 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5607
5608
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5609 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5610 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5611
5612
5613 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5614 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5615 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5616 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5617 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5618 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5619
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5620 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5621
5622
5623 </td> <!-- entry_type -->
5624
5625 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5626 <p>Orientation of JPEG image to
5627write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5628 </td>
5629
5630 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5631 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5632 </td>
5633
5634 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5635 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5636 </td>
5637
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5638 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5639 <ul class="entry_tags">
5640 <li><a href="#tag_BC">BC</a></li>
5641 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5642 </td>
5643
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5644 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5645
5646
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5647 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5648 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5649
5650
5651 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5652 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5653 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5654 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5655 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5656 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5657
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5658 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5659
5660
5661 </td> <!-- entry_type -->
5662
5663 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5664 <p>Compression quality of the final JPEG
5665image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5666 </td>
5667
5668 <td class="entry_units">
5669 </td>
5670
5671 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5672 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5673 </td>
5674
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5675 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5676 <ul class="entry_tags">
5677 <li><a href="#tag_BC">BC</a></li>
5678 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5679 </td>
5680
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5681 </tr>
5682 <tr class="entries_header">
5683 <th class="th_details" colspan="5">Details</th>
5684 </tr>
5685 <tr class="entry_cont">
5686 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5687 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5688 </td>
5689 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5690
5691
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5692 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5693 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5694
5695
5696 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5697 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5698 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5699 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5700 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5701 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5702
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5703 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5704
5705
5706 </td> <!-- entry_type -->
5707
5708 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5709 <p>The size of the compressed JPEG image,<wbr/> in
5710bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5711 </td>
5712
5713 <td class="entry_units">
5714 </td>
5715
5716 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5717 <blockquote>
5718<p>= 0</p>
5719</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5720 </td>
5721
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5722 <td class="entry_tags">
5723 </td>
5724
5725 </tr>
5726 <tr class="entries_header">
5727 <th class="th_details" colspan="5">Details</th>
5728 </tr>
5729 <tr class="entry_cont">
5730 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5731 <p>If no JPEG output is produced for the request,<wbr/>
5732this must be 0.<wbr/></p>
5733<p>Otherwise,<wbr/> this describes the real size of the compressed
5734JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5735if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
5736has <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]5737the JPEG stream will be 1000000 bytes,<wbr/> of which the first
5738500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5739 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5740 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5741
5742
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5743 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5744 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5745
5746
5747 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5748 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5749 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5750 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5751 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5752 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5753
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5754 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5755
5756
5757 </td> <!-- entry_type -->
5758
5759 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5760 <p>Compression quality of JPEG
5761thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5762 </td>
5763
5764 <td class="entry_units">
5765 </td>
5766
5767 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5768 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5769 </td>
5770
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5771 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5772 <ul class="entry_tags">
5773 <li><a href="#tag_BC">BC</a></li>
5774 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5775 </td>
5776
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5777 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5778
5779
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5780 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5781 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5782
5783
5784 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5785 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5786 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5787 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5788 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5789 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5790 <span class="entry_type_container">x</span>
5791
5792 <span class="entry_type_array">
5793 2
5794 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5795 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5796
5797
5798 </td> <!-- entry_type -->
5799
5800 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5801 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5802 </td>
5803
5804 <td class="entry_units">
5805 </td>
5806
5807 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5808 <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]5809 </td>
5810
5811 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5812 <ul class="entry_tags">
5813 <li><a href="#tag_BC">BC</a></li>
5814 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5815 </td>
5816
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5817 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5818 <tr class="entries_header">
5819 <th class="th_details" colspan="5">Details</th>
5820 </tr>
5821 <tr class="entry_cont">
5822 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5823 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5824but the captured JPEG must still be a valid image.<wbr/></p>
5825<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5826the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5827 </td>
5828 </tr>
5829
5830
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5831 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5832 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5833
5834
5835
5836 <!-- end of kind -->
5837 </tbody>
5838
5839 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5840 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5841
5842
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5843 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5844
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5845 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5846 <tr>
5847 <th class="th_name">Property Name</th>
5848 <th class="th_type">Type</th>
5849 <th class="th_description">Description</th>
5850 <th class="th_units">Units</th>
5851 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5852 <th class="th_tags">Tags</th>
5853 </tr>
5854 </thead>
5855
5856 <tbody>
5857
5858
5859
5860
5861
5862
5863
5864
5865
5866
5867 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5868 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5869 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5870 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5871 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5872 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5873
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5874 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5875
5876
5877 </td> <!-- entry_type -->
5878
5879 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5880 <p>Size of the lens aperture</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5881 </td>
5882
5883 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5884 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5885 </td>
5886
5887 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5888 <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]5889 </td>
5890
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5891 <td class="entry_tags">
5892 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5893 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5894 </ul>
5895 </td>
5896
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5897 </tr>
5898 <tr class="entries_header">
5899 <th class="th_details" colspan="5">Details</th>
5900 </tr>
5901 <tr class="entry_cont">
5902 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5903 <p>Will not be supported on most devices.<wbr/> Can only
5904pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5905 </td>
5906 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5907
5908
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5909 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5910 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5911
5912
5913 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5914 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5915 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5916 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5917 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5918 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5919
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5920 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5921
5922
5923 </td> <!-- entry_type -->
5924
5925 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5926 <p>State of lens neutral density
5927filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5928 </td>
5929
5930 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5931 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5932 </td>
5933
5934 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5935 <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]5936 </td>
5937
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5938 <td class="entry_tags">
5939 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5940 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5941 </ul>
5942 </td>
5943
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5944 </tr>
5945 <tr class="entries_header">
5946 <th class="th_details" colspan="5">Details</th>
5947 </tr>
5948 <tr class="entry_cont">
5949 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5950 <p>Will not be supported on most devices.<wbr/> Can only
5951pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5952 </td>
5953 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5954
5955
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5956 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5957 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5958
5959
5960 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5961 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5962 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5963 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5964 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5965 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5966
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5967 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5968
5969
5970 </td> <!-- entry_type -->
5971
5972 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5973 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5974 </td>
5975
5976 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5977 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5978 </td>
5979
5980 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5981 <blockquote>
5982<p>0</p>
5983</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5984 </td>
5985
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5986 <td class="entry_tags">
5987 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5988 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5989 </ul>
5990 </td>
5991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5992 </tr>
5993 <tr class="entries_header">
5994 <th class="th_details" colspan="5">Details</th>
5995 </tr>
5996 <tr class="entry_cont">
5997 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5998 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5999 </td>
6000 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6001
6002
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6003 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6004 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6005
6006
6007 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6008 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6009 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6010 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6011 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6012 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6013
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6014 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6015
6016
6017 </td> <!-- entry_type -->
6018
6019 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6020 <p>Distance to plane of sharpest focus,<wbr/>
6021measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6022 </td>
6023
6024 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6025 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6026 </td>
6027
6028 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6029 <blockquote>
6030<p>= 0</p>
6031</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6032 </td>
6033
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6034 <td class="entry_tags">
6035 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6036 <li><a href="#tag_BC">BC</a></li>
6037 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6038 </ul>
6039 </td>
6040
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6041 </tr>
6042 <tr class="entries_header">
6043 <th class="th_details" colspan="5">Details</th>
6044 </tr>
6045 <tr class="entry_cont">
6046 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6047 <p>0 = infinity focus.<wbr/> Used value should be clamped
6048to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6049 </td>
6050 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6051
6052
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6053 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6054 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6055
6056
6057 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6058 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6059 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6060 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6061 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6062 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6063
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6064 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6065
6066 <ul class="entry_type_enum">
6067 <li>
6068 <span class="entry_type_enum_name">OFF</span>
6069 </li>
6070 <li>
6071 <span class="entry_type_enum_name">ON</span>
6072 <span class="entry_type_enum_optional">optional</span>
6073 </li>
6074 </ul>
6075
6076 </td> <!-- entry_type -->
6077
6078 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6079 <p>Whether optical image stabilization is
6080enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6081 </td>
6082
6083 <td class="entry_units">
6084 </td>
6085
6086 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6087 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6088 </td>
6089
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6090 <td class="entry_tags">
6091 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6092 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6093 </ul>
6094 </td>
6095
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6096 </tr>
6097 <tr class="entries_header">
6098 <th class="th_details" colspan="5">Details</th>
6099 </tr>
6100 <tr class="entry_cont">
6101 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6102 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6103 </td>
6104 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6105
6106
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6107 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6108 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6109
6110
6111
6112 <!-- end of kind -->
6113 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6114 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6115
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6116 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6117 <tr>
6118 <th class="th_name">Property Name</th>
6119 <th class="th_type">Type</th>
6120 <th class="th_description">Description</th>
6121 <th class="th_units">Units</th>
6122 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6123 <th class="th_tags">Tags</th>
6124 </tr>
6125 </thead>
6126
6127 <tbody>
6128
6129
6130
6131
6132
6133
6134
6135
6136
6137
6138
6139
6140 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6141 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6142 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6143 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6144 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6145 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6146 <span class="entry_type_container">x</span>
6147
6148 <span class="entry_type_array">
6149 n
6150 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6151 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6152
6153
6154 </td> <!-- entry_type -->
6155
6156 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6157 <p>List of supported aperture
6158values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6159 </td>
6160
6161 <td class="entry_units">
6162 </td>
6163
6164 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6165 <p>one entry required,<wbr/> &gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6166 </td>
6167
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6168 <td class="entry_tags">
6169 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6170 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6171 </ul>
6172 </td>
6173
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6174 </tr>
6175 <tr class="entries_header">
6176 <th class="th_details" colspan="5">Details</th>
6177 </tr>
6178 <tr class="entry_cont">
6179 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6180 <p>If variable aperture not available,<wbr/> only setting
6181should be for the fixed aperture</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6182 </td>
6183 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6184
6185
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6186 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6187 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6188
6189
6190 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6191 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6192 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6193 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6194 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6195 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6196 <span class="entry_type_container">x</span>
6197
6198 <span class="entry_type_array">
6199 n
6200 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6201 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6202
6203
6204 </td> <!-- entry_type -->
6205
6206 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6207 <p>List of supported ND filter
6208values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6209 </td>
6210
6211 <td class="entry_units">
6212 </td>
6213
6214 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6215 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6216 </td>
6217
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6218 <td class="entry_tags">
6219 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6220 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6221 </ul>
6222 </td>
6223
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6224 </tr>
6225 <tr class="entries_header">
6226 <th class="th_details" colspan="5">Details</th>
6227 </tr>
6228 <tr class="entry_cont">
6229 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6230 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6231lists the available exposure index values for dimming
6232(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6233light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6234 </td>
6235 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6236
6237
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6238 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6239 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6240
6241
6242 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6243 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6244 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6245 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6246 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6247 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6248 <span class="entry_type_container">x</span>
6249
6250 <span class="entry_type_array">
6251 n
6252 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6253 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6254 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6255
6256
6257 </td> <!-- entry_type -->
6258
6259 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6260 <p>If fitted with optical zoom,<wbr/> what focal
6261lengths are available.<wbr/> If not,<wbr/> the static focal
6262length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6263 </td>
6264
6265 <td class="entry_units">
6266 </td>
6267
6268 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6269 <blockquote>
6270<p>0</p>
6271</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6272 </td>
6273
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6274 <td class="entry_tags">
6275 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6276 <li><a href="#tag_BC">BC</a></li>
6277 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6278 </ul>
6279 </td>
6280
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6281 </tr>
6282 <tr class="entries_header">
6283 <th class="th_details" colspan="5">Details</th>
6284 </tr>
6285 <tr class="entry_cont">
6286 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6287 <p>If optical zoom not supported,<wbr/> only one value
6288should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6289 </td>
6290 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6291
6292
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6293 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6294 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6295
6296
6297 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6298 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6299 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6300 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6301 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6302 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6303 <span class="entry_type_container">x</span>
6304
6305 <span class="entry_type_array">
6306 n
6307 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6308 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6309 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6310
6311
6312 </td> <!-- entry_type -->
6313
6314 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6315 <p>List of supported optical image
6316stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6317 </td>
6318
6319 <td class="entry_units">
6320 </td>
6321
6322 <td class="entry_range">
6323 </td>
6324
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6325 <td class="entry_tags">
6326 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6327 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6328 </ul>
6329 </td>
6330
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6331 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6332
6333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6334 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6335 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6336
6337
6338 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6339 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6340 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6341 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6342 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6343 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6344 <span class="entry_type_container">x</span>
6345
6346 <span class="entry_type_array">
6347 2 x 3 x n x m
6348 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6349 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6350 <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]6351
6352
6353 </td> <!-- entry_type -->
6354
6355 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6356 <p>A low-resolution map for correction of
6357geometric distortions and chromatic aberrations,<wbr/> per
6358color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6359 </td>
6360
6361 <td class="entry_units">
6362 </td>
6363
6364 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6365 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6366 </td>
6367
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6368 <td class="entry_tags">
6369 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6370 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6371 </ul>
6372 </td>
6373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6374 </tr>
6375 <tr class="entries_header">
6376 <th class="th_details" colspan="5">Details</th>
6377 </tr>
6378 <tr class="entry_cont">
6379 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6380 <p>[DNG wants a function instead].<wbr/> What's easiest
6381for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
6382j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
6383j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
6384entry 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]6385 </td>
6386 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6387
6388
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6389 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6390 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6391
6392
6393 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6394 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6395 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6396 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6397 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6398 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6399 <span class="entry_type_container">x</span>
6400
6401 <span class="entry_type_array">
6402 2
6403 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6404 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6405 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6406
6407
6408 </td> <!-- entry_type -->
6409
6410 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6411 <p>Dimensions of geometric correction
6412map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6413 </td>
6414
6415 <td class="entry_units">
6416 </td>
6417
6418 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6419 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6420 </td>
6421
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6422 <td class="entry_tags">
6423 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6424 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6425 </ul>
6426 </td>
6427
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6428 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6429
6430
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6431 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6432 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6433
6434
6435 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6436 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6437 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6438 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6439 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6440 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6441
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6442 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6443
6444
6445 </td> <!-- entry_type -->
6446
6447 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6448 <p>Hyperfocal distance for this lens; set to
64490 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6450 </td>
6451
6452 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6453 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6454 </td>
6455
6456 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6457 <blockquote>
6458<p>= 0</p>
6459</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6460 </td>
6461
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6462 <td class="entry_tags">
6463 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6464 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6465 </ul>
6466 </td>
6467
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6468 </tr>
6469 <tr class="entries_header">
6470 <th class="th_details" colspan="5">Details</th>
6471 </tr>
6472 <tr class="entry_cont">
6473 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6474 <p>The hyperfocal distance is used for the old
6475API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6476 </td>
6477 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6478
6479
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6480 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6481 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6482
6483
6484 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6485 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6486 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6487 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6488 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6489 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6490
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6491 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6492
6493
6494 </td> <!-- entry_type -->
6495
6496 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6497 <p>Shortest distance from frontmost surface
6498of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6499 </td>
6500
6501 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6502 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6503 </td>
6504
6505 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6506 <blockquote>
6507<p>= 0</p>
6508</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6509 </td>
6510
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6511 <td class="entry_tags">
6512 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6513 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6514 </ul>
6515 </td>
6516
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6517 </tr>
6518 <tr class="entries_header">
6519 <th class="th_details" colspan="5">Details</th>
6520 </tr>
6521 <tr class="entry_cont">
6522 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6523 <p>If the lens is fixed-focus,<wbr/> this should be
65240</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6525 </td>
6526 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6527
6528
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6529 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6530 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6531
6532
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6533 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6534 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6535 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6536 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6537 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6538 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6539 <span class="entry_type_container">x</span>
6540
6541 <span class="entry_type_array">
6542 2
6543 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6544 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6545 <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]6546
6547
6548 </td> <!-- entry_type -->
6549
6550 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6551 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6552 </td>
6553
6554 <td class="entry_units">
6555 </td>
6556
6557 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6558 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6559 </td>
6560
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6561 <td class="entry_tags">
6562 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6563 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6564 </ul>
6565 </td>
6566
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6567 </tr>
6568 <tr class="entries_header">
6569 <th class="th_details" colspan="5">Details</th>
6570 </tr>
6571 <tr class="entry_cont">
6572 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6573 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
6574must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6575 </td>
6576 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6577
6578
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6579 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6580 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6581
6582
6583
6584
6585
6586 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6587 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6588 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6589 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6590 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6591 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6592
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6593 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6594
6595 <ul class="entry_type_enum">
6596 <li>
6597 <span class="entry_type_enum_name">FRONT</span>
6598 </li>
6599 <li>
6600 <span class="entry_type_enum_name">BACK</span>
6601 </li>
6602 </ul>
6603
6604 </td> <!-- entry_type -->
6605
6606 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6607 <p>Direction the camera faces relative to
6608device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6609 </td>
6610
6611 <td class="entry_units">
6612 </td>
6613
6614 <td class="entry_range">
6615 </td>
6616
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6617 <td class="entry_tags">
6618 </td>
6619
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6620 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6621
6622
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6623 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6624 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6625
6626
6627 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6628 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6629 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6630 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6631 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6632 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6633 <span class="entry_type_container">x</span>
6634
6635 <span class="entry_type_array">
6636 2
6637 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6638 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6639 <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]6640
6641
6642 </td> <!-- entry_type -->
6643
6644 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6645 <p>Relative angle of camera optical axis to the
6646perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6647 </td>
6648
6649 <td class="entry_units">
6650 </td>
6651
6652 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6653 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6654 </td>
6655
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6656 <td class="entry_tags">
6657 <ul class="entry_tags">
6658 <li><a href="#tag_ADV">ADV</a></li>
6659 </ul>
6660 </td>
6661
6662 </tr>
6663 <tr class="entries_header">
6664 <th class="th_details" colspan="5">Details</th>
6665 </tr>
6666 <tr class="entry_cont">
6667 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6668 <p>Examples:</p>
6669<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6670is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6671<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6672device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6673<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
6674the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6675<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6676direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6677 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6678 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6679
6680
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6681 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6682 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6683
6684
6685 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6686 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6687 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6688 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6689 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6690 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6691 <span class="entry_type_container">x</span>
6692
6693 <span class="entry_type_array">
6694 3, location in mm, in the sensor coordinate
6695 system
6696 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6697 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6698
6699
6700 </td> <!-- entry_type -->
6701
6702 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6703 <p>Coordinates of camera optical axis on
6704device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6705 </td>
6706
6707 <td class="entry_units">
6708 </td>
6709
6710 <td class="entry_range">
6711 </td>
6712
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6713 <td class="entry_tags">
6714 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6715 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6716 </ul>
6717 </td>
6718
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6719 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6720
6721
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6722 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6723 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6724
6725
6726
6727 <!-- end of kind -->
6728 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6729 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6730
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6731 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6732 <tr>
6733 <th class="th_name">Property Name</th>
6734 <th class="th_type">Type</th>
6735 <th class="th_description">Description</th>
6736 <th class="th_units">Units</th>
6737 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6738 <th class="th_tags">Tags</th>
6739 </tr>
6740 </thead>
6741
6742 <tbody>
6743
6744
6745
6746
6747
6748
6749
6750
6751
6752
6753 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6754 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6755 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6756 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6757 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6758 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6759
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6760 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6761
6762
6763 </td> <!-- entry_type -->
6764
6765 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6766 <p>Size of the lens aperture</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6767 </td>
6768
6769 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6770 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6771 </td>
6772
6773 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6774 <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]6775 </td>
6776
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6777 <td class="entry_tags">
6778 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6779 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6780 </ul>
6781 </td>
6782
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6783 </tr>
6784 <tr class="entries_header">
6785 <th class="th_details" colspan="5">Details</th>
6786 </tr>
6787 <tr class="entry_cont">
6788 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6789 <p>Will not be supported on most devices.<wbr/> Can only
6790pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6791 </td>
6792 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6793
6794
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6795 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6796 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6797
6798
6799 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6800 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6801 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6802 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6803 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6804 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6805
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6806 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6807
6808
6809 </td> <!-- entry_type -->
6810
6811 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6812 <p>State of lens neutral density
6813filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6814 </td>
6815
6816 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6817 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6818 </td>
6819
6820 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6821 <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]6822 </td>
6823
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6824 <td class="entry_tags">
6825 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6826 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6827 </ul>
6828 </td>
6829
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6830 </tr>
6831 <tr class="entries_header">
6832 <th class="th_details" colspan="5">Details</th>
6833 </tr>
6834 <tr class="entry_cont">
6835 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6836 <p>Will not be supported on most devices.<wbr/> Can only
6837pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6838 </td>
6839 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6840
6841
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6842 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6843 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6844
6845
6846 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6847 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6848 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6849 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6850 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6851 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6852
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6853 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6854
6855
6856 </td> <!-- entry_type -->
6857
6858 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6859 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6860 </td>
6861
6862 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6863 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6864 </td>
6865
6866 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6867 <blockquote>
6868<p>0</p>
6869</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6870 </td>
6871
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6872 <td class="entry_tags">
6873 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6874 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6875 </ul>
6876 </td>
6877
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6878 </tr>
6879 <tr class="entries_header">
6880 <th class="th_details" colspan="5">Details</th>
6881 </tr>
6882 <tr class="entry_cont">
6883 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6884 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6885 </td>
6886 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6887
6888
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6889 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6890 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6891
6892
6893 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6894 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6895 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6896 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6897 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6898 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6899
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6900 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6901
6902
6903 </td> <!-- entry_type -->
6904
6905 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6906 <p>Distance to plane of sharpest focus,<wbr/>
6907measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6908 </td>
6909
6910 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6911 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6912 </td>
6913
6914 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6915 <blockquote>
6916<p>= 0</p>
6917</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6918 </td>
6919
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6920 <td class="entry_tags">
6921 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6922 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6923 </ul>
6924 </td>
6925
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6926 </tr>
6927 <tr class="entries_header">
6928 <th class="th_details" colspan="5">Details</th>
6929 </tr>
6930 <tr class="entry_cont">
6931 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6932 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6933 </td>
6934 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6935
6936
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6937 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6938 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6939
6940
6941 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6942 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6943 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6944 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6945 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6946 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]6947 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6948
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]6949 <span class="entry_type_array">
6950 2
6951 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6952 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6953 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6954
6955
6956 </td> <!-- entry_type -->
6957
6958 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6959 <p>The range of scene distances that are in
6960sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6961 </td>
6962
6963 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6964 pair of focus distances in diopters: (near,<wbr/>
6965 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6966 </td>
6967
6968 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6969 <blockquote>
6970<p>=0</p>
6971</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6972 </td>
6973
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6974 <td class="entry_tags">
6975 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6976 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6977 </ul>
6978 </td>
6979
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6980 </tr>
6981 <tr class="entries_header">
6982 <th class="th_details" colspan="5">Details</th>
6983 </tr>
6984 <tr class="entry_cont">
6985 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6986 <p>If variable focus not supported,<wbr/> can still report
6987fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6988 </td>
6989 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6990
6991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6992 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6993 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6994
6995
6996 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6997 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6998 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6999 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7000 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7001 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7002
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7003 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7004
7005 <ul class="entry_type_enum">
7006 <li>
7007 <span class="entry_type_enum_name">OFF</span>
7008 </li>
7009 <li>
7010 <span class="entry_type_enum_name">ON</span>
7011 <span class="entry_type_enum_optional">optional</span>
7012 </li>
7013 </ul>
7014
7015 </td> <!-- entry_type -->
7016
7017 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7018 <p>Whether optical image stabilization is
7019enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7020 </td>
7021
7022 <td class="entry_units">
7023 </td>
7024
7025 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7026 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7027 </td>
7028
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7029 <td class="entry_tags">
7030 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7031 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7032 </ul>
7033 </td>
7034
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7035 </tr>
7036 <tr class="entries_header">
7037 <th class="th_details" colspan="5">Details</th>
7038 </tr>
7039 <tr class="entry_cont">
7040 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7041 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7042 </td>
7043 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7044
7045
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7046 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7047 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7048
7049
7050 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7051 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7052 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7053 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7054 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7055 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7056
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7057 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7058
7059 <ul class="entry_type_enum">
7060 <li>
7061 <span class="entry_type_enum_name">STATIONARY</span>
7062 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7063 <li>
7064 <span class="entry_type_enum_name">MOVING</span>
7065 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7066 </ul>
7067
7068 </td> <!-- entry_type -->
7069
7070 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7071 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7072 </td>
7073
7074 <td class="entry_units">
7075 </td>
7076
7077 <td class="entry_range">
7078 </td>
7079
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7080 <td class="entry_tags">
7081 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7082 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7083 </ul>
7084 </td>
7085
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7086 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7087
7088
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7089 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7090 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7091
7092
7093
7094 <!-- end of kind -->
7095 </tbody>
7096
7097 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7098 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7099
7100
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7101 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7102
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7103 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7104 <tr>
7105 <th class="th_name">Property Name</th>
7106 <th class="th_type">Type</th>
7107 <th class="th_description">Description</th>
7108 <th class="th_units">Units</th>
7109 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7110 <th class="th_tags">Tags</th>
7111 </tr>
7112 </thead>
7113
7114 <tbody>
7115
7116
7117
7118
7119
7120
7121
7122
7123
7124
7125 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7126 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7127 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7128 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7129 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7130 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7131
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7132 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7133
7134 <ul class="entry_type_enum">
7135 <li>
7136 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7137 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7138 </li>
7139 <li>
7140 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7141 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7142 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7143 </li>
7144 <li>
7145 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7146 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7147 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7148 </li>
7149 </ul>
7150
7151 </td> <!-- entry_type -->
7152
7153 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7154 <p>Mode of operation for the noise reduction
7155algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7156 </td>
7157
7158 <td class="entry_units">
7159 </td>
7160
7161 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7162 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7163 </td>
7164
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7165 <td class="entry_tags">
7166 <ul class="entry_tags">
7167 <li><a href="#tag_V1">V1</a></li>
7168 </ul>
7169 </td>
7170
7171 </tr>
7172 <tr class="entries_header">
7173 <th class="th_details" colspan="5">Details</th>
7174 </tr>
7175 <tr class="entry_cont">
7176 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7177 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7178will be applied by the HAL.<wbr/></p>
7179<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7180will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7181should use the highest-quality noise filtering algorithms,<wbr/>
7182even if it slows down capture rate.<wbr/> FAST means the HAL should not
7183slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7184 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7185 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7186
7187
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7188 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7189 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7190
7191
7192 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7193 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7194 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7195 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7196 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7197 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7198
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7199 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7200
7201
7202 </td> <!-- entry_type -->
7203
7204 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7205 <p>Control the amount of noise reduction
7206applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7207 </td>
7208
7209 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7210 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7211 </td>
7212
7213 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7214 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7215 </td>
7216
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7217 <td class="entry_tags">
7218 </td>
7219
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7220 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7221
7222
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7223 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7224 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7225
7226
7227
7228 <!-- end of kind -->
7229 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7230 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7231
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7232 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7233 <tr>
7234 <th class="th_name">Property Name</th>
7235 <th class="th_type">Type</th>
7236 <th class="th_description">Description</th>
7237 <th class="th_units">Units</th>
7238 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7239 <th class="th_tags">Tags</th>
7240 </tr>
7241 </thead>
7242
7243 <tbody>
7244
7245
7246
7247
7248
7249
7250
7251
7252
7253
7254 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7255 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7256 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7257 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7258 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7259 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7260
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7261 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7262
7263 <ul class="entry_type_enum">
7264 <li>
7265 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7266 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7267 </li>
7268 <li>
7269 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7270 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7271 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7272 </li>
7273 <li>
7274 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7275 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7276 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7277 </li>
7278 </ul>
7279
7280 </td> <!-- entry_type -->
7281
7282 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7283 <p>Mode of operation for the noise reduction
7284algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7285 </td>
7286
7287 <td class="entry_units">
7288 </td>
7289
7290 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7291 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7292 </td>
7293
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7294 <td class="entry_tags">
7295 <ul class="entry_tags">
7296 <li><a href="#tag_V1">V1</a></li>
7297 </ul>
7298 </td>
7299
7300 </tr>
7301 <tr class="entries_header">
7302 <th class="th_details" colspan="5">Details</th>
7303 </tr>
7304 <tr class="entry_cont">
7305 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7306 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7307will be applied by the HAL.<wbr/></p>
7308<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7309will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7310should use the highest-quality noise filtering algorithms,<wbr/>
7311even if it slows down capture rate.<wbr/> FAST means the HAL should not
7312slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7313 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7314 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7315
7316
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7317 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7318 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7319
7320
7321
7322 <!-- end of kind -->
7323 </tbody>
7324
7325 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7326 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7327
7328
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7329 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7330
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7331 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7332 <tr>
7333 <th class="th_name">Property Name</th>
7334 <th class="th_type">Type</th>
7335 <th class="th_description">Description</th>
7336 <th class="th_units">Units</th>
7337 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7338 <th class="th_tags">Tags</th>
7339 </tr>
7340 </thead>
7341
7342 <tbody>
7343
7344
7345
7346
7347
7348
7349
7350
7351
7352
7353 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7354 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7355 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7356 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7357 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7358 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7359
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7360 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7361
7362
7363 </td> <!-- entry_type -->
7364
7365 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7366 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7367scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7368region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
7369and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7370 </td>
7371
7372 <td class="entry_units">
7373 </td>
7374
7375 <td class="entry_range">
7376 </td>
7377
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7378 <td class="entry_tags">
7379 </td>
7380
7381 </tr>
7382 <tr class="entries_header">
7383 <th class="th_details" colspan="5">Details</th>
7384 </tr>
7385 <tr class="entry_cont">
7386 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7387 <p>Normalized coordinates refer to those in the
7388(-1000,<wbr/>1000) range mentioned in the
7389android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7390<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7391sensor array-relative coordinates for all region data.<wbr/> Does
7392not need to be listed in static metadata.<wbr/> Support will be
7393removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7394 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7395 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7396
7397
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7398 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7399 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7400
7401
7402 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7403 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7404 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7405 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7406 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7407 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7408
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7409 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7410
7411
7412 </td> <!-- entry_type -->
7413
7414 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7415 <p>If set to 1,<wbr/> then the camera service always
7416switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
7417trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7418 </td>
7419
7420 <td class="entry_units">
7421 </td>
7422
7423 <td class="entry_range">
7424 </td>
7425
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7426 <td class="entry_tags">
7427 </td>
7428
7429 </tr>
7430 <tr class="entries_header">
7431 <th class="th_details" colspan="5">Details</th>
7432 </tr>
7433 <tr class="entry_cont">
7434 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7435 <p>HAL implementations should implement AF trigger
7436modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
7437CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
7438not need to be listed in static metadata.<wbr/> Support will be
7439removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7440 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7441 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7442
7443
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7444 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7445 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7446
7447
7448 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7449 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7450 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7451 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7452 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7453 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7454
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7455 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7456
7457
7458 </td> <!-- entry_type -->
7459
7460 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7461 <p>If set to 1,<wbr/> the camera service uses
7462CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
7463HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
7464shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7465 </td>
7466
7467 <td class="entry_units">
7468 </td>
7469
7470 <td class="entry_range">
7471 </td>
7472
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7473 <td class="entry_tags">
7474 </td>
7475
7476 </tr>
7477 <tr class="entries_header">
7478 <th class="th_details" colspan="5">Details</th>
7479 </tr>
7480 <tr class="entry_cont">
7481 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7482 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7483to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7484zero-shutter-lag,<wbr/> instead of relying on an explicit
7485format setting.<wbr/> Does not need to be listed in static
7486metadata.<wbr/> Support will be removed in future versions of
7487camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7488 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7489 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7490
7491
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7492 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7493 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7494
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7495
7496 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7497 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7498 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7499 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7500 <td class="entry_type">
7501 <span class="entry_type_name">byte</span>
7502
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7503 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7504
7505
7506 </td> <!-- entry_type -->
7507
7508 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7509 <p>If set to 1,<wbr/> the HAL will always split result
7510metadata for a single capture into multiple buffers,<wbr/>
7511returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7512 </td>
7513
7514 <td class="entry_units">
7515 </td>
7516
7517 <td class="entry_range">
7518 </td>
7519
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7520 <td class="entry_tags">
7521 </td>
7522
7523 </tr>
7524 <tr class="entries_header">
7525 <th class="th_details" colspan="5">Details</th>
7526 </tr>
7527 <tr class="entry_cont">
7528 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7529 <p>Does not need to be listed in static
7530metadata.<wbr/> Support for partial results will be reworked in
7531future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7532working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7533consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7534 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7535 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7536
7537
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7538 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7539 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7540
7541
7542
7543 <!-- end of kind -->
7544 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7545 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7546
7547 <thead class="entries_header">
7548 <tr>
7549 <th class="th_name">Property Name</th>
7550 <th class="th_type">Type</th>
7551 <th class="th_description">Description</th>
7552 <th class="th_units">Units</th>
7553 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7554 <th class="th_tags">Tags</th>
7555 </tr>
7556 </thead>
7557
7558 <tbody>
7559
7560
7561
7562
7563
7564
7565
7566
7567
7568
7569 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7570 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7571 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7572 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7573 <td class="entry_type">
7574 <span class="entry_type_name entry_type_name_enum">byte</span>
7575
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7576 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7577
7578 <ul class="entry_type_enum">
7579 <li>
7580 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7581 <span class="entry_type_enum_notes">The last or only metadata result buffer
7582 for this capture.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7583 </li>
7584 <li>
7585 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7586 <span class="entry_type_enum_notes">A partial buffer of result metadata for this
7587 capture.<wbr/> More result buffers for this capture will be sent
7588 by the HAL,<wbr/> the last of which will be marked
7589 FINAL.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7590 </li>
7591 </ul>
7592
7593 </td> <!-- entry_type -->
7594
7595 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7596 <p>Whether a result given to the framework is the
7597final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7598subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7599values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7600 </td>
7601
7602 <td class="entry_units">
7603 </td>
7604
7605 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7606 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7607 </td>
7608
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7609 <td class="entry_tags">
7610 </td>
7611
7612 </tr>
7613 <tr class="entries_header">
7614 <th class="th_details" colspan="5">Details</th>
7615 </tr>
7616 <tr class="entry_cont">
7617 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7618 <p>The entries in the result metadata buffers for a
7619single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7620FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7621requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
7622always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
7623before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
7624in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
7625capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
7626only 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]7627 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7628 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7629
7630
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7631 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7632 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7633
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7634
7635
7636 <!-- end of kind -->
7637 </tbody>
7638
7639 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7640 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7641
7642
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7643 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7644
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7645 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7646 <tr>
7647 <th class="th_name">Property Name</th>
7648 <th class="th_type">Type</th>
7649 <th class="th_description">Description</th>
7650 <th class="th_units">Units</th>
7651 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7652 <th class="th_tags">Tags</th>
7653 </tr>
7654 </thead>
7655
7656 <tbody>
7657
7658
7659
7660
7661
7662
7663
7664
7665
7666
7667 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7668 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7669 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7670 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7671 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7672 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7673
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7674 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7675
7676
7677 </td> <!-- entry_type -->
7678
7679 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7680 <p>A frame counter set by the framework.<wbr/> Must
7681be maintained unchanged in output frame.<wbr/> This value monotonically
7682increases with every new result (that is,<wbr/> each new result has a unique
7683frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7684 </td>
7685
7686 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7687 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7688 </td>
7689
7690 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7691 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7692 </td>
7693
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7694 <td class="entry_tags">
7695 </td>
7696
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7697 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7698
7699
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7700 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7701 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7702
7703
7704 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7705 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7706 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7707 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7708 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7709 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7710
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7711 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7712
7713
7714 </td> <!-- entry_type -->
7715
7716 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7717 <p>An application-specified ID for the current
7718request.<wbr/> Must be maintained unchanged in output
7719frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7720 </td>
7721
7722 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7723 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7724 </td>
7725
7726 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7727 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7728 </td>
7729
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7730 <td class="entry_tags">
7731 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7732 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7733 </ul>
7734 </td>
7735
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7736 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7737
7738
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7739 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7740 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7741
7742
7743 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7744 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7745 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7746 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7747 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7748 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7749 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7750
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7751 <span class="entry_type_array">
7752 n
7753 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7754 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7755
7756
7757 </td> <!-- entry_type -->
7758
7759 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7760 <p>List which camera reprocess stream is used
7761for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7762 </td>
7763
7764 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7765 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7766 </td>
7767
7768 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7769 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
7770reprocess stream ID.<wbr/></p>
7771<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
7772reprocess streams may be included in a single request; they
7773must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7774 </td>
7775
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7776 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7777 <ul class="entry_tags">
7778 <li><a href="#tag_HAL2">HAL2</a></li>
7779 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7780 </td>
7781
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7782 </tr>
7783 <tr class="entries_header">
7784 <th class="th_details" colspan="5">Details</th>
7785 </tr>
7786 <tr class="entry_cont">
7787 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7788 <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]7789REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7790 </td>
7791 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7792
7793
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7794 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7795 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7796
7797
7798 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7799 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7800 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7801 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7802 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7803 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7804
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7805 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7806
7807 <ul class="entry_type_enum">
7808 <li>
7809 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7810 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
7811 for application-bound buffer data.<wbr/> If no
7812 application-bound streams exist,<wbr/> no frame should be
7813 placed in the output frame queue.<wbr/> If such streams
7814 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7815 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7816 information.<wbr/> Timestamp information should still be
7817 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7818 </li>
7819 <li>
7820 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7821 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7822 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7823 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7824 </li>
7825 </ul>
7826
7827 </td> <!-- entry_type -->
7828
7829 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7830 <p>How much metadata to produce on
7831output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7832 </td>
7833
7834 <td class="entry_units">
7835 </td>
7836
7837 <td class="entry_range">
7838 </td>
7839
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7840 <td class="entry_tags">
7841 </td>
7842
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7843 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7844
7845
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7846 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7847 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7848
7849
7850 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7851 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7852 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7853 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7854 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7855 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7856 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7857
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7858 <span class="entry_type_array">
7859 n
7860 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7861 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7862
7863
7864 </td> <!-- entry_type -->
7865
7866 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7867 <p>Lists which camera output streams image data
7868from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7869 </td>
7870
7871 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7872 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7873 </td>
7874
7875 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7876 <p>List must only include streams that have been
7877created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7878 </td>
7879
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7880 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7881 <ul class="entry_tags">
7882 <li><a href="#tag_HAL2">HAL2</a></li>
7883 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7884 </td>
7885
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7886 </tr>
7887 <tr class="entries_header">
7888 <th class="th_details" colspan="5">Details</th>
7889 </tr>
7890 <tr class="entry_cont">
7891 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7892 <p>If no output streams are listed,<wbr/> then the image
7893data should simply be discarded.<wbr/> The image data must
7894still be captured for metadata and statistics production,<wbr/>
7895and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7896 </td>
7897 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7898
7899
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7900 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7901 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7902
7903
7904 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7905 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7906 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7907 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7908 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7909 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7910
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7911 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7912
7913 <ul class="entry_type_enum">
7914 <li>
7915 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7916 <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]7917 and process it according to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7918 settings</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7919 </li>
7920 <li>
7921 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7922 <span class="entry_type_enum_notes">Process previously captured data; the
7923 android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
7924 source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
7925 needed for reprocessing with [RP]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7926 </li>
7927 </ul>
7928
7929 </td> <!-- entry_type -->
7930
7931 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7932 <p>The type of the request; either CAPTURE or
7933REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7934 </td>
7935
7936 <td class="entry_units">
7937 </td>
7938
7939 <td class="entry_range">
7940 </td>
7941
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7942 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7943 <ul class="entry_tags">
7944 <li><a href="#tag_HAL2">HAL2</a></li>
7945 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7946 </td>
7947
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7948 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7949
7950
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7951 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7952 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7953
7954
7955
7956 <!-- end of kind -->
7957 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7958 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7959
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7960 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7961 <tr>
7962 <th class="th_name">Property Name</th>
7963 <th class="th_type">Type</th>
7964 <th class="th_description">Description</th>
7965 <th class="th_units">Units</th>
7966 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7967 <th class="th_tags">Tags</th>
7968 </tr>
7969 </thead>
7970
7971 <tbody>
7972
7973
7974
7975
7976
7977
7978
7979
7980
7981
7982 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7983 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7984 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7985 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7986 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7987 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7988 <span class="entry_type_container">x</span>
7989
7990 <span class="entry_type_array">
7991 3
7992 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7993 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7994
7995
7996 </td> <!-- entry_type -->
7997
7998 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7999 <p>How many output streams can be allocated at
8000the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8001 </td>
8002
8003 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8004 The number of raw sensor streams; the number of
8005 processed,<wbr/> uncompressed streams; and the number of
8006 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8007 </td>
8008
8009 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8010 <blockquote>
8011<p>=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
8012for processed,<wbr/> uncompressed streams</p>
8013</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8014 </td>
8015
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8016 <td class="entry_tags">
8017 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8018 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8019 </ul>
8020 </td>
8021
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8022 </tr>
8023 <tr class="entries_header">
8024 <th class="th_details" colspan="5">Details</th>
8025 </tr>
8026 <tr class="entry_cont">
8027 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8028 <p>Video snapshot with preview callbacks requires 3
8029processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8030one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8031 </td>
8032 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8033
8034
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8035 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8036 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8037
8038
8039 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8040 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8041 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8042 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8043 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8044 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8045 <span class="entry_type_container">x</span>
8046
8047 <span class="entry_type_array">
8048 1
8049 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8050 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8051
8052
8053 </td> <!-- entry_type -->
8054
8055 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8056 <p>How many reprocessing streams of any type
8057can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8058 </td>
8059
8060 <td class="entry_units">
8061 </td>
8062
8063 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8064 <blockquote>
8065<p>= 1</p>
8066</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8067 </td>
8068
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8069 <td class="entry_tags">
8070 </td>
8071
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8072 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8073
8074
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8075 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8076 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8077
8078
8079
8080 <!-- end of kind -->
8081 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8082 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8083
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8084 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8085 <tr>
8086 <th class="th_name">Property Name</th>
8087 <th class="th_type">Type</th>
8088 <th class="th_description">Description</th>
8089 <th class="th_units">Units</th>
8090 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8091 <th class="th_tags">Tags</th>
8092 </tr>
8093 </thead>
8094
8095 <tbody>
8096
8097
8098
8099
8100
8101
8102
8103
8104
8105
8106 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8107 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8108 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8109 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8110 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8111 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8112
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8113 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8114
8115
8116 </td> <!-- entry_type -->
8117
8118 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8119 <p>A frame counter set by the framework.<wbr/> This value monotonically
8120increases with every new result (that is,<wbr/> each new result has a unique
8121frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8122 </td>
8123
8124 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8125 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8126 </td>
8127
8128 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8129 <blockquote>
8130<p>0</p>
8131</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8132 </td>
8133
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8134 <td class="entry_tags">
8135 </td>
8136
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8137 </tr>
8138 <tr class="entries_header">
8139 <th class="th_details" colspan="5">Details</th>
8140 </tr>
8141 <tr class="entry_cont">
8142 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8143 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8144 </td>
8145 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8146
8147
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8148 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8149 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8150
8151
8152 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8153 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8154 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8155 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8156 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8157 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8158
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8159 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8160
8161
8162 </td> <!-- entry_type -->
8163
8164 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8165 <p>An application-specified ID for the current
8166request.<wbr/> Must be maintained unchanged in output
8167frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8168 </td>
8169
8170 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8171 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8172 </td>
8173
8174 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8175 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8176 </td>
8177
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8178 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8179 <ul class="entry_tags">
8180 <li><a href="#tag_V1">V1</a></li>
8181 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8182 </td>
8183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8184 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8185
8186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8187 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8188 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8189
8190
8191 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8192 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8193 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8194 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8195 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8196 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8197
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8198 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8199
8200 <ul class="entry_type_enum">
8201 <li>
8202 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8203 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
8204 for application-bound buffer data.<wbr/> If no
8205 application-bound streams exist,<wbr/> no frame should be
8206 placed in the output frame queue.<wbr/> If such streams
8207 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8208 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8209 information.<wbr/> Timestamp information should still be
8210 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8211 </li>
8212 <li>
8213 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8214 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8215 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8216 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8217 </li>
8218 </ul>
8219
8220 </td> <!-- entry_type -->
8221
8222 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8223 <p>How much metadata to produce on
8224output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8225 </td>
8226
8227 <td class="entry_units">
8228 </td>
8229
8230 <td class="entry_range">
8231 </td>
8232
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8233 <td class="entry_tags">
8234 </td>
8235
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8236 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8237
8238
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8239 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8240 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8241
8242
8243 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8244 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8245 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8246 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8247 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8248 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8249 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8250
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8251 <span class="entry_type_array">
8252 n
8253 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8254 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8255
8256
8257 </td> <!-- entry_type -->
8258
8259 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8260 <p>Lists which camera output streams image data
8261from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8262 </td>
8263
8264 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8265 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8266 </td>
8267
8268 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8269 <p>List must only include streams that have been
8270created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8271 </td>
8272
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8273 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8274 <ul class="entry_tags">
8275 <li><a href="#tag_HAL2">HAL2</a></li>
8276 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8277 </td>
8278
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8279 </tr>
8280 <tr class="entries_header">
8281 <th class="th_details" colspan="5">Details</th>
8282 </tr>
8283 <tr class="entry_cont">
8284 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8285 <p>If no output streams are listed,<wbr/> then the image
8286data should simply be discarded.<wbr/> The image data must
8287still be captured for metadata and statistics production,<wbr/>
8288and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8289 </td>
8290 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8291
8292
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8293 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8294 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8295
8296
8297
8298 <!-- end of kind -->
8299 </tbody>
8300
8301 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8302 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8303
8304
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8305 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8306
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8307 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8308 <tr>
8309 <th class="th_name">Property Name</th>
8310 <th class="th_type">Type</th>
8311 <th class="th_description">Description</th>
8312 <th class="th_units">Units</th>
8313 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8314 <th class="th_tags">Tags</th>
8315 </tr>
8316 </thead>
8317
8318 <tbody>
8319
8320
8321
8322
8323
8324
8325
8326
8327
8328
8329 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8330 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8331 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8332 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8333 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8334 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8335 <span class="entry_type_container">x</span>
8336
8337 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8338 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8339 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8340 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8341
8342
8343 </td> <!-- entry_type -->
8344
8345 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8346 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8347<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8348(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8349output.<wbr/> Each stream must use this rectangle to produce its
8350output,<wbr/> cropping to a smaller region if necessary to
8351maintain the stream's aspect ratio.<wbr/></p>
8352<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8353 </td>
8354
8355 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8356 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8357 in pixels; (0,<wbr/>0) is top-left corner of
8358 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8359 </td>
8360
8361 <td class="entry_range">
8362 </td>
8363
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8364 <td class="entry_tags">
8365 <ul class="entry_tags">
8366 <li><a href="#tag_BC">BC</a></li>
8367 </ul>
8368 </td>
8369
8370 </tr>
8371 <tr class="entries_header">
8372 <th class="th_details" colspan="5">Details</th>
8373 </tr>
8374 <tr class="entry_cont">
8375 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8376 <p>Any additional per-stream cropping must be done to
8377maximize the final pixel area of the stream.<wbr/></p>
8378<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8379ratio,<wbr/> then 4:3 streams should use the exact crop
8380region.<wbr/> 16:9 streams should further crop vertically
8381(letterbox).<wbr/></p>
8382<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8383outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8384streams should match exactly.<wbr/> These additional crops must
8385be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8386<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8387times,<wbr/> no matter what the relative aspect ratios of the
8388crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8389corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8390larger than active pixel array.<wbr/> Width and height may be
8391rounded to nearest larger supportable width,<wbr/> especially
8392for raw output,<wbr/> where only a few fixed scales may be
8393possible.<wbr/> The width and height of the crop region cannot
8394be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8395android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8396activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8397respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8398 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8399 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8400
8401
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8402 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8403 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8404
8405
8406
8407 <!-- end of kind -->
8408 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8409 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8410
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8411 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8412 <tr>
8413 <th class="th_name">Property Name</th>
8414 <th class="th_type">Type</th>
8415 <th class="th_description">Description</th>
8416 <th class="th_units">Units</th>
8417 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8418 <th class="th_tags">Tags</th>
8419 </tr>
8420 </thead>
8421
8422 <tbody>
8423
8424
8425
8426
8427
8428
8429
8430
8431
8432
8433 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8434 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8435 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8436 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8437 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8438 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8439 <span class="entry_type_container">x</span>
8440
8441 <span class="entry_type_array">
8442 n
8443 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]8444 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8445 <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]8446
8447 <ul class="entry_type_enum">
8448 <li>
8449 <span class="entry_type_enum_name">RAW_SENSOR</span>
8450 <span class="entry_type_enum_value">0x20</span>
8451 </li>
8452 <li>
8453 <span class="entry_type_enum_name">YV12</span>
8454 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8455 <span class="entry_type_enum_notes">YCrCb 4:2:0 Planar</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8456 </li>
8457 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8458 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8459 <span class="entry_type_enum_value">0x11</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8460 <span class="entry_type_enum_notes">NV21</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8461 </li>
8462 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8463 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
8464 <span class="entry_type_enum_value">0x22</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8465 <span class="entry_type_enum_notes">Hal Implementation Defined</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8466 </li>
8467 <li>
8468 <span class="entry_type_enum_name">YCbCr_420_888</span>
8469 <span class="entry_type_enum_value">0x23</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8470 <span class="entry_type_enum_notes">Flexible YUV420 Format</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8471 </li>
8472 <li>
8473 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8474 <span class="entry_type_enum_value">0x21</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8475 <span class="entry_type_enum_notes">JPEG</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8476 </li>
8477 </ul>
8478
8479 </td> <!-- entry_type -->
8480
8481 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8482 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8483 </td>
8484
8485 <td class="entry_units">
8486 </td>
8487
8488 <td class="entry_range">
8489 </td>
8490
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8491 <td class="entry_tags">
8492 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8493 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8494 </ul>
8495 </td>
8496
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8497 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8498
8499
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8500 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8501 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8502
8503
8504 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8505 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8506 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8507 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8508 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8509 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8510 <span class="entry_type_container">x</span>
8511
8512 <span class="entry_type_array">
8513 n
8514 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8515 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8516
8517
8518 </td> <!-- entry_type -->
8519
8520 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8521 <p>The minimum frame duration that is supported
8522for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8523correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8524stream is active and captured in a burst,<wbr/> with all
8525processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8526 </td>
8527
8528 <td class="entry_units">
8529 </td>
8530
8531 <td class="entry_range">
8532 </td>
8533
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8534 <td class="entry_tags">
8535 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8536 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8537 </ul>
8538 </td>
8539
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8540 </tr>
8541 <tr class="entries_header">
8542 <th class="th_details" colspan="5">Details</th>
8543 </tr>
8544 <tr class="entry_cont">
8545 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8546 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8547frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8548durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8549 </td>
8550 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8551
8552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8553 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8554 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8555
8556
8557 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8558 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8559 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8560 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8561 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8562 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8563 <span class="entry_type_container">x</span>
8564
8565 <span class="entry_type_array">
8566 n x 2
8567 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8568 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8569
8570
8571 </td> <!-- entry_type -->
8572
8573 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8574 <p>The resolutions available for output from
8575the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8576 </td>
8577
8578 <td class="entry_units">
8579 </td>
8580
8581 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8582 <p>Must include: - sensor maximum resolution Should
8583include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8584 </td>
8585
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8586 <td class="entry_tags">
8587 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8588 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8589 </ul>
8590 </td>
8591
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8592 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8593
8594
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8595 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8596 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8597
8598
8599 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8600 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8601 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8602 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8603 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8604 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8605
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8606 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8607
8608
8609 </td> <!-- entry_type -->
8610
8611 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8612 <p>The maximum ratio between active area width
8613and crop region width,<wbr/> or between active area height and
8614crop region height,<wbr/> if the crop region height is larger
8615than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8616 </td>
8617
8618 <td class="entry_units">
8619 </td>
8620
8621 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8622 <blockquote>
8623<p>=1</p>
8624</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8625 </td>
8626
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8627 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8628 <ul class="entry_tags">
8629 <li><a href="#tag_BC">BC</a></li>
8630 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8631 </td>
8632
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8633 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8634
8635
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8636 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8637 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8638
8639
8640 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8641 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8642 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8643 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8644 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8645 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8646 <span class="entry_type_container">x</span>
8647
8648 <span class="entry_type_array">
8649 n
8650 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8651 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8652
8653
8654 </td> <!-- entry_type -->
8655
8656 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8657 <p>The minimum frame duration that is supported
8658for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8659correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8660stream is active,<wbr/> with all processing set to
8661FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8662 </td>
8663
8664 <td class="entry_units">
8665 </td>
8666
8667 <td class="entry_range">
8668 </td>
8669
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8670 <td class="entry_tags">
8671 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8672 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8673 </ul>
8674 </td>
8675
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8676 </tr>
8677 <tr class="entries_header">
8678 <th class="th_details" colspan="5">Details</th>
8679 </tr>
8680 <tr class="entry_cont">
8681 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8682 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8683frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8684durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8685 </td>
8686 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8687
8688
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8689 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8690 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8691
8692
8693 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8694 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8695 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8696 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8697 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8698 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8699 <span class="entry_type_container">x</span>
8700
8701 <span class="entry_type_array">
8702 n x 2
8703 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8704 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8705
8706
8707 </td> <!-- entry_type -->
8708
8709 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8710 <p>The resolutions available for use with
8711processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
8712platform opaque YUV/<wbr/>RGB streams to the GPU or video
8713encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8714 </td>
8715
8716 <td class="entry_units">
8717 </td>
8718
8719 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8720 <p>Must include: - sensor maximum resolution -
8721standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
8722resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8723 </td>
8724
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8725 <td class="entry_tags">
8726 <ul class="entry_tags">
8727 <li><a href="#tag_BC">BC</a></li>
8728 </ul>
8729 </td>
8730
8731 </tr>
8732 <tr class="entries_header">
8733 <th class="th_details" colspan="5">Details</th>
8734 </tr>
8735 <tr class="entry_cont">
8736 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8737 <p>The actual supported resolution list may be limited by
8738consumer end points for different use cases.<wbr/> For example,<wbr/> for
8739recording use case,<wbr/> the largest supported resolution may be
8740limited by max supported size from encoder,<wbr/> for preview use
8741case,<wbr/> the largest supported resolution may be limited by max
8742resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8743 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8744 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8745
8746
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8747 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8748 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8749
8750
8751 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8752 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8753 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8754 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8755 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8756 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8757 <span class="entry_type_container">x</span>
8758
8759 <span class="entry_type_array">
8760 n
8761 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8762 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8763
8764
8765 </td> <!-- entry_type -->
8766
8767 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8768 <p>The minimum frame duration that is supported
8769for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8770correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8771is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8772 </td>
8773
8774 <td class="entry_units">
8775 </td>
8776
8777 <td class="entry_range">
8778 </td>
8779
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8780 <td class="entry_tags">
8781 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8782 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8783 </ul>
8784 </td>
8785
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8786 </tr>
8787 <tr class="entries_header">
8788 <th class="th_details" colspan="5">Details</th>
8789 </tr>
8790 <tr class="entry_cont">
8791 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8792 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8793frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8794durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8795 </td>
8796 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8797
8798
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8799 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8800 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8801
8802
8803 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8804 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8805 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8806 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8807 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8808 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8809 <span class="entry_type_container">x</span>
8810
8811 <span class="entry_type_array">
8812 n x 2
8813 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8814 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8815
8816
8817 </td> <!-- entry_type -->
8818
8819 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8820 <p>The resolutions available for use with raw
8821sensor output streams,<wbr/> listed as width,<wbr/>
8822height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8823 </td>
8824
8825 <td class="entry_units">
8826 </td>
8827
8828 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8829 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8830 </td>
8831
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8832 <td class="entry_tags">
8833 </td>
8834
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8835 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8836
8837
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8838 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8839 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8840
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8841
8842
8843 <!-- end of kind -->
8844 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8845 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8846
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8847 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8848 <tr>
8849 <th class="th_name">Property Name</th>
8850 <th class="th_type">Type</th>
8851 <th class="th_description">Description</th>
8852 <th class="th_units">Units</th>
8853 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8854 <th class="th_tags">Tags</th>
8855 </tr>
8856 </thead>
8857
8858 <tbody>
8859
8860
8861
8862
8863
8864
8865
8866
8867
8868
8869 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8870 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8871 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8872 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8873 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8874 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8875 <span class="entry_type_container">x</span>
8876
8877 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8878 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8879 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8880 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8881
8882
8883 </td> <!-- entry_type -->
8884
8885 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8886 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8887<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8888(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8889output.<wbr/> Each stream must use this rectangle to produce its
8890output,<wbr/> cropping to a smaller region if necessary to
8891maintain the stream's aspect ratio.<wbr/></p>
8892<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8893 </td>
8894
8895 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8896 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8897 in pixels; (0,<wbr/>0) is top-left corner of
8898 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8899 </td>
8900
8901 <td class="entry_range">
8902 </td>
8903
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8904 <td class="entry_tags">
8905 <ul class="entry_tags">
8906 <li><a href="#tag_BC">BC</a></li>
8907 </ul>
8908 </td>
8909
8910 </tr>
8911 <tr class="entries_header">
8912 <th class="th_details" colspan="5">Details</th>
8913 </tr>
8914 <tr class="entry_cont">
8915 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8916 <p>Any additional per-stream cropping must be done to
8917maximize the final pixel area of the stream.<wbr/></p>
8918<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8919ratio,<wbr/> then 4:3 streams should use the exact crop
8920region.<wbr/> 16:9 streams should further crop vertically
8921(letterbox).<wbr/></p>
8922<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8923outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8924streams should match exactly.<wbr/> These additional crops must
8925be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8926<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8927times,<wbr/> no matter what the relative aspect ratios of the
8928crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8929corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8930larger than active pixel array.<wbr/> Width and height may be
8931rounded to nearest larger supportable width,<wbr/> especially
8932for raw output,<wbr/> where only a few fixed scales may be
8933possible.<wbr/> The width and height of the crop region cannot
8934be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8935android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8936activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8937respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8938 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8939 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8940
8941
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8942 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8943 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8944
8945
8946
8947 <!-- end of kind -->
8948 </tbody>
8949
8950 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8951 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8952
8953
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8954 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8955
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8956 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8957 <tr>
8958 <th class="th_name">Property Name</th>
8959 <th class="th_type">Type</th>
8960 <th class="th_description">Description</th>
8961 <th class="th_units">Units</th>
8962 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8963 <th class="th_tags">Tags</th>
8964 </tr>
8965 </thead>
8966
8967 <tbody>
8968
8969
8970
8971
8972
8973
8974
8975
8976
8977
8978 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8979 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8980 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8981 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8982 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8983 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8984
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8985 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8986
8987
8988 </td> <!-- entry_type -->
8989
8990 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8991 <p>Duration each pixel is exposed to
8992light.<wbr/></p>
8993<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
8994duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8995 </td>
8996
8997 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8998 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8999 </td>
9000
9001 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9002 <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]9003 </td>
9004
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9005 <td class="entry_tags">
9006 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9007 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9008 </ul>
9009 </td>
9010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9011 </tr>
9012 <tr class="entries_header">
9013 <th class="th_details" colspan="5">Details</th>
9014 </tr>
9015 <tr class="entry_cont">
9016 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9017 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9018 </td>
9019 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9020
9021
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9022 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9023 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9024
9025
9026 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9027 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9028 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9029 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9030 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9031 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9032
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9033 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9034
9035
9036 </td> <!-- entry_type -->
9037
9038 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9039 <p>Duration from start of frame exposure to
9040start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9041 </td>
9042
9043 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9044 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9045 </td>
9046
9047 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9048 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9049android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9050 </td>
9051
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9052 <td class="entry_tags">
9053 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9054 <li><a href="#tag_V1">V1</a></li>
9055 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9056 </ul>
9057 </td>
9058
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9059 </tr>
9060 <tr class="entries_header">
9061 <th class="th_details" colspan="5">Details</th>
9062 </tr>
9063 <tr class="entry_cont">
9064 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9065 <p>Exposure time has priority,<wbr/> so duration is set to
9066max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9067 </td>
9068 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9069
9070
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9071 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9072 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9073
9074
9075 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9076 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9077 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9078 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9079 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9080 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9081
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9082 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9083
9084
9085 </td> <!-- entry_type -->
9086
9087 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9088 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9089implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9090below 'maximum analog sensitivity'.<wbr/></p>
9091<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9092gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9093 </td>
9094
9095 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9096 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9097 </td>
9098
9099 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9100 <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]9101 </td>
9102
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9103 <td class="entry_tags">
9104 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9105 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9106 </ul>
9107 </td>
9108
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9109 </tr>
9110 <tr class="entries_header">
9111 <th class="th_details" colspan="5">Details</th>
9112 </tr>
9113 <tr class="entry_cont">
9114 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9115 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9116 </td>
9117 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9118
9119
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9120 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9121 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9122
9123
9124
9125 <!-- end of kind -->
9126 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9127 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9128
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9129 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9130 <tr>
9131 <th class="th_name">Property Name</th>
9132 <th class="th_type">Type</th>
9133 <th class="th_description">Description</th>
9134 <th class="th_units">Units</th>
9135 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9136 <th class="th_tags">Tags</th>
9137 </tr>
9138 </thead>
9139
9140 <tbody>
9141
9142
9143
9144
9145
9146
9147
9148
9149
9150
9151
9152
9153 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9154 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9155 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9156 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9157 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9158 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9159 <span class="entry_type_container">x</span>
9160
9161 <span class="entry_type_array">
9162 4
9163 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9164 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9165 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9166
9167
9168 </td> <!-- entry_type -->
9169
9170 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9171 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9172active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9173pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9174 </td>
9175
9176 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9177 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9178 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9179 </td>
9180
9181 <td class="entry_range">
9182 </td>
9183
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9184 <td class="entry_tags">
9185 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9186 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9187 </ul>
9188 </td>
9189
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9190 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9191
9192
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9193 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9194 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9195
9196
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9197 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9198 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9199 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9200 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9201 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9202 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9203 <span class="entry_type_container">x</span>
9204
9205 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9206 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9207 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9208 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9209 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9210
9211
9212 </td> <!-- entry_type -->
9213
9214 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9215 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9216 </td>
9217
9218 <td class="entry_units">
9219 </td>
9220
9221 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9222 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9223 </td>
9224
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9225 <td class="entry_tags">
9226 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9227 <li><a href="#tag_BC">BC</a></li>
9228 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9229 </ul>
9230 </td>
9231
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9232 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9233
9234
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9235 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9236 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9237
9238
9239 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9240 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9241 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9242 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9243 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9244 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9245
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9246 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9247
9248 <ul class="entry_type_enum">
9249 <li>
9250 <span class="entry_type_enum_name">RGGB</span>
9251 </li>
9252 <li>
9253 <span class="entry_type_enum_name">GRBG</span>
9254 </li>
9255 <li>
9256 <span class="entry_type_enum_name">GBRG</span>
9257 </li>
9258 <li>
9259 <span class="entry_type_enum_name">BGGR</span>
9260 </li>
9261 <li>
9262 <span class="entry_type_enum_name">RGB</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9263 <span class="entry_type_enum_notes">Sensor is not Bayer; output has 3 16-bit
9264 values for each pixel,<wbr/> instead of just 1 16-bit value
9265 per pixel.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9266 </li>
9267 </ul>
9268
9269 </td> <!-- entry_type -->
9270
9271 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9272 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9273represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9274the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9275 </td>
9276
9277 <td class="entry_units">
9278 </td>
9279
9280 <td class="entry_range">
9281 </td>
9282
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9283 <td class="entry_tags">
9284 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9285 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9286 </ul>
9287 </td>
9288
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9289 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9290
9291
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9292 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9293 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9294
9295
9296 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9297 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9298 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9299 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9300 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9301 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9302 <span class="entry_type_container">x</span>
9303
9304 <span class="entry_type_array">
9305 2
9306 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9307 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9308 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9309
9310
9311 </td> <!-- entry_type -->
9312
9313 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9314 <p>Range of valid exposure
9315times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9316 </td>
9317
9318 <td class="entry_units">
9319 </td>
9320
9321 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9322 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
9323sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9324 </td>
9325
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9326 <td class="entry_tags">
9327 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9328 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9329 </ul>
9330 </td>
9331
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9332 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9333
9334
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9335 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9336 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9337
9338
9339 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9340 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9341 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9342 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9343 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9344 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9345
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9346 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9347
9348
9349 </td> <!-- entry_type -->
9350
9351 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9352 <p>Maximum possible frame duration (minimum frame
9353rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9354 </td>
9355
9356 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9357 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9358 </td>
9359
9360 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9361 <blockquote>
9362<p>= 30e9</p>
9363</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9364 </td>
9365
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9366 <td class="entry_tags">
9367 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9368 <li><a href="#tag_BC">BC</a></li>
9369 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9370 </ul>
9371 </td>
9372
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9373 </tr>
9374 <tr class="entries_header">
9375 <th class="th_details" colspan="5">Details</th>
9376 </tr>
9377 <tr class="entry_cont">
9378 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9379 <p>Minimum duration is a function of resolution,<wbr/>
9380processing settings.<wbr/> See
9381android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
9382android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9383<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]9384 </td>
9385 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9386
9387
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9388 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9389 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9390
9391
9392 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9393 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9394 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9395 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9396 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9397 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9398 <span class="entry_type_container">x</span>
9399
9400 <span class="entry_type_array">
9401 2
9402 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]9403 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9404 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9405
9406
9407 </td> <!-- entry_type -->
9408
9409 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9410 <p>The physical dimensions of the full pixel
9411array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9412 </td>
9413
9414 <td class="entry_units">
9415 </td>
9416
9417 <td class="entry_range">
9418 </td>
9419
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9420 <td class="entry_tags">
9421 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9422 <li><a href="#tag_V1">V1</a></li>
9423 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9424 </ul>
9425 </td>
9426
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9427 </tr>
9428 <tr class="entries_header">
9429 <th class="th_details" colspan="5">Details</th>
9430 </tr>
9431 <tr class="entry_cont">
9432 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9433 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9434 </td>
9435 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9436
9437
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9438 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9439 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9440
9441
9442 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9443 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9444 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9445 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9446 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9447 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9448 <span class="entry_type_container">x</span>
9449
9450 <span class="entry_type_array">
9451 2
9452 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9453 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9454
9455
9456 </td> <!-- entry_type -->
9457
9458 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9459 <p>Dimensions of full pixel array,<wbr/> possibly
9460including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9461 </td>
9462
9463 <td class="entry_units">
9464 </td>
9465
9466 <td class="entry_range">
9467 </td>
9468
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9469 <td class="entry_tags">
9470 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9471 <li><a href="#tag_DNG">DNG</a></li>
9472 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9473 </ul>
9474 </td>
9475
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9476 </tr>
9477 <tr class="entries_header">
9478 <th class="th_details" colspan="5">Details</th>
9479 </tr>
9480 <tr class="entry_cont">
9481 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9482 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9483match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9484android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9485 </td>
9486 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9487
9488
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9489 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9490 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9491
9492
9493 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9494 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9495 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9496 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9497 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9498 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9499
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9500 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9501
9502
9503 </td> <!-- entry_type -->
9504
9505 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9506 <p>Maximum raw value output by
9507sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9508 </td>
9509
9510 <td class="entry_units">
9511 </td>
9512
9513 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9514 <blockquote>
9515<p>1024 (10-bit output)</p>
9516</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9517 </td>
9518
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9519 <td class="entry_tags">
9520 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9521 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9522 </ul>
9523 </td>
9524
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9525 </tr>
9526 <tr class="entries_header">
9527 <th class="th_details" colspan="5">Details</th>
9528 </tr>
9529 <tr class="entry_cont">
9530 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9531 <p>Defines sensor bit depth (10-14 bits is
9532expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9533 </td>
9534 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9535
9536
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9537 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9538 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9539
9540
9541
9542
9543
9544 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9545 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9546 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9547 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9548 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9549 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9550
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9551 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9552
9553
9554 </td> <!-- entry_type -->
9555
9556 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9557 <p>Gain factor from electrons to raw units when
9558ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9559 </td>
9560
9561 <td class="entry_units">
9562 </td>
9563
9564 <td class="entry_range">
9565 </td>
9566
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9567 <td class="entry_tags">
9568 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9569 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9570 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9571 </ul>
9572 </td>
9573
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9574 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9575
9576
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9577 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9578 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9579
9580
9581 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9582 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9583 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9584 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9585 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9586 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9587 <span class="entry_type_container">x</span>
9588
9589 <span class="entry_type_array">
9590 4
9591 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9592 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9593 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9594
9595
9596 </td> <!-- entry_type -->
9597
9598 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9599 <p>A fixed black level offset for each of the
9600Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9601 </td>
9602
9603 <td class="entry_units">
9604 </td>
9605
9606 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9607 <blockquote>
9608<p>= 0 each</p>
9609</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9610 </td>
9611
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9612 <td class="entry_tags">
9613 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9614 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9615 </ul>
9616 </td>
9617
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9618 </tr>
9619 <tr class="entries_header">
9620 <th class="th_details" colspan="5">Details</th>
9621 </tr>
9622 <tr class="entry_cont">
9623 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9624 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
9625tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9626 </td>
9627 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9628
9629
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9630 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9631 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9632
9633
9634 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9635 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9636 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9637 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9638 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9639 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9640 <span class="entry_type_container">x</span>
9641
9642 <span class="entry_type_array">
9643 9
9644 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9645 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9646 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9647
9648
9649 </td> <!-- entry_type -->
9650
9651 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9652 <p>Per-device calibration on top of color space
9653transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9654 </td>
9655
9656 <td class="entry_units">
9657 </td>
9658
9659 <td class="entry_range">
9660 </td>
9661
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9662 <td class="entry_tags">
9663 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9664 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9665 </ul>
9666 </td>
9667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9668 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9669
9670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9671 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9672 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9673
9674
9675 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9676 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9677 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9678 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9679 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9680 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9681 <span class="entry_type_container">x</span>
9682
9683 <span class="entry_type_array">
9684 9
9685 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9686 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9687 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9688
9689
9690 </td> <!-- entry_type -->
9691
9692 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9693 <p>Per-device calibration on top of color space
9694transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9695 </td>
9696
9697 <td class="entry_units">
9698 </td>
9699
9700 <td class="entry_range">
9701 </td>
9702
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9703 <td class="entry_tags">
9704 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9705 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9706 </ul>
9707 </td>
9708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9709 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9710
9711
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9712 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9713 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9714
9715
9716 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9717 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9718 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9719 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9720 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9721 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9722 <span class="entry_type_container">x</span>
9723
9724 <span class="entry_type_array">
9725 9
9726 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9727 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9728 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9729
9730
9731 </td> <!-- entry_type -->
9732
9733 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9734 <p>Linear mapping from XYZ (D50) color space to
9735reference linear sensor color,<wbr/> for first reference
9736illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9737 </td>
9738
9739 <td class="entry_units">
9740 </td>
9741
9742 <td class="entry_range">
9743 </td>
9744
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9745 <td class="entry_tags">
9746 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9747 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9748 </ul>
9749 </td>
9750
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9751 </tr>
9752 <tr class="entries_header">
9753 <th class="th_details" colspan="5">Details</th>
9754 </tr>
9755 <tr class="entry_cont">
9756 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9757 <p>Use as follows XYZ = inv(transform) * clip( (raw -
9758black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
9759At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9760 </td>
9761 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9762
9763
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9764 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9765 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9766
9767
9768 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9769 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9770 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9771 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9772 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9773 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9774 <span class="entry_type_container">x</span>
9775
9776 <span class="entry_type_array">
9777 9
9778 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9779 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9780 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9781
9782
9783 </td> <!-- entry_type -->
9784
9785 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9786 <p>Linear mapping from XYZ (D50) color space to
9787reference linear sensor color,<wbr/> for second reference
9788illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9789 </td>
9790
9791 <td class="entry_units">
9792 </td>
9793
9794 <td class="entry_range">
9795 </td>
9796
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9797 <td class="entry_tags">
9798 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9799 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9800 </ul>
9801 </td>
9802
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9803 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9804
9805
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9806 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9807 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9808
9809
9810 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9811 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9812 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9813 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9814 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9815 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9816 <span class="entry_type_container">x</span>
9817
9818 <span class="entry_type_array">
9819 9
9820 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9821 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9822 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9823
9824
9825 </td> <!-- entry_type -->
9826
9827 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9828 <p>Used by DNG for better WB
9829adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9830 </td>
9831
9832 <td class="entry_units">
9833 </td>
9834
9835 <td class="entry_range">
9836 </td>
9837
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9838 <td class="entry_tags">
9839 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9840 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9841 </ul>
9842 </td>
9843
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9844 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9845
9846
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9847 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9848 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9849
9850
9851 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9852 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9853 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9854 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9855 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9856 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9857 <span class="entry_type_container">x</span>
9858
9859 <span class="entry_type_array">
9860 9
9861 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9862 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9863 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
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>Used by DNG for better WB
9870adaptation</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_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9882 </ul>
9883 </td>
9884
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9885 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9886
9887
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9888 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9889 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9890
9891
9892 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9893 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9894 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9895 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9896 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9897 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9898
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9899 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9900
9901
9902 </td> <!-- entry_type -->
9903
9904 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9905 <p>Maximum sensitivity that is implemented
9906purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9907 </td>
9908
9909 <td class="entry_units">
9910 </td>
9911
9912 <td class="entry_range">
9913 </td>
9914
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9915 <td class="entry_tags">
9916 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9917 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9918 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9919 </ul>
9920 </td>
9921
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9922 </tr>
9923 <tr class="entries_header">
9924 <th class="th_details" colspan="5">Details</th>
9925 </tr>
9926 <tr class="entry_cont">
9927 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9928 <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]9929equal to this,<wbr/> all applied gain must be analog.<wbr/> For
9930values above this,<wbr/> it can be a mix of analog and
9931digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9932 </td>
9933 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9934
9935
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9936 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9937 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9938
9939
9940 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9941 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9942 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9943 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9944 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9945 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9946 <span class="entry_type_container">x</span>
9947
9948 <span class="entry_type_array">
9949 2
9950 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9951 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9952 <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]9953
9954
9955 </td> <!-- entry_type -->
9956
9957 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9958 <p>Estimation of sensor noise
9959characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9960 </td>
9961
9962 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9963 var(raw pixel value) = electrons * (baseGainFactor
9964 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
9965 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9966 </td>
9967
9968 <td class="entry_range">
9969 </td>
9970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9971 <td class="entry_tags">
9972 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9973 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9974 </ul>
9975 </td>
9976
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9977 </tr>
9978 <tr class="entries_header">
9979 <th class="th_details" colspan="5">Details</th>
9980 </tr>
9981 <tr class="entry_cont">
9982 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9983 <p>A represents sensor read noise before analog
9984amplification; B represents noise from A/<wbr/>D conversion and
9985other circuits after amplification.<wbr/> Both noise sources
9986are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
9987across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9988 </td>
9989 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9990
9991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9992 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9993 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9994
9995
9996 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9997 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9998 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9999 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10000 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10001 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10002
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10003 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10004
10005
10006 </td> <!-- entry_type -->
10007
10008 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10009 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10010image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10011screen in its native orientation.<wbr/> Also defines the
10012direction of rolling shutter readout,<wbr/> which is from top
10013to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10014 </td>
10015
10016 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10017 degrees clockwise rotation,<wbr/> only multiples of
10018 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10019 </td>
10020
10021 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10022 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10023 </td>
10024
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10025 <td class="entry_tags">
10026 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10027 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10028 </ul>
10029 </td>
10030
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10031 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10032
10033
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10034 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10035 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10036
10037
10038 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10039 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10040 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10041 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10042 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10043 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10044
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10045 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10046
10047 <ul class="entry_type_enum">
10048 <li>
10049 <span class="entry_type_enum_name">DAYLIGHT</span>
10050 <span class="entry_type_enum_value">1</span>
10051 </li>
10052 <li>
10053 <span class="entry_type_enum_name">FLUORESCENT</span>
10054 <span class="entry_type_enum_value">2</span>
10055 </li>
10056 <li>
10057 <span class="entry_type_enum_name">TUNGSTEN</span>
10058 <span class="entry_type_enum_value">3</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10059 <span class="entry_type_enum_notes">Incandescent light</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10060 </li>
10061 <li>
10062 <span class="entry_type_enum_name">FLASH</span>
10063 <span class="entry_type_enum_value">4</span>
10064 </li>
10065 <li>
10066 <span class="entry_type_enum_name">FINE_WEATHER</span>
10067 <span class="entry_type_enum_value">9</span>
10068 </li>
10069 <li>
10070 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10071 <span class="entry_type_enum_value">10</span>
10072 </li>
10073 <li>
10074 <span class="entry_type_enum_name">SHADE</span>
10075 <span class="entry_type_enum_value">11</span>
10076 </li>
10077 <li>
10078 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10079 <span class="entry_type_enum_value">12</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10080 <span class="entry_type_enum_notes">D 5700 - 7100K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10081 </li>
10082 <li>
10083 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10084 <span class="entry_type_enum_value">13</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10085 <span class="entry_type_enum_notes">N 4600 - 5400K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10086 </li>
10087 <li>
10088 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10089 <span class="entry_type_enum_value">14</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10090 <span class="entry_type_enum_notes">W 3900 - 4500K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10091 </li>
10092 <li>
10093 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10094 <span class="entry_type_enum_value">15</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10095 <span class="entry_type_enum_notes">WW 3200 - 3700K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10096 </li>
10097 <li>
10098 <span class="entry_type_enum_name">STANDARD_A</span>
10099 <span class="entry_type_enum_value">17</span>
10100 </li>
10101 <li>
10102 <span class="entry_type_enum_name">STANDARD_B</span>
10103 <span class="entry_type_enum_value">18</span>
10104 </li>
10105 <li>
10106 <span class="entry_type_enum_name">STANDARD_C</span>
10107 <span class="entry_type_enum_value">19</span>
10108 </li>
10109 <li>
10110 <span class="entry_type_enum_name">D55</span>
10111 <span class="entry_type_enum_value">20</span>
10112 </li>
10113 <li>
10114 <span class="entry_type_enum_name">D65</span>
10115 <span class="entry_type_enum_value">21</span>
10116 </li>
10117 <li>
10118 <span class="entry_type_enum_name">D75</span>
10119 <span class="entry_type_enum_value">22</span>
10120 </li>
10121 <li>
10122 <span class="entry_type_enum_name">D50</span>
10123 <span class="entry_type_enum_value">23</span>
10124 </li>
10125 <li>
10126 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10127 <span class="entry_type_enum_value">24</span>
10128 </li>
10129 </ul>
10130
10131 </td> <!-- entry_type -->
10132
10133 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10134 <p>Light source used to define transform
101351</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10136 </td>
10137
10138 <td class="entry_units">
10139 </td>
10140
10141 <td class="entry_range">
10142 </td>
10143
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10144 <td class="entry_tags">
10145 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10146 <li><a href="#tag_DNG">DNG</a></li>
10147 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10148 </ul>
10149 </td>
10150
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10151 </tr>
10152 <tr class="entries_header">
10153 <th class="th_details" colspan="5">Details</th>
10154 </tr>
10155 <tr class="entry_cont">
10156 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10157 <p>[EXIF LightSource tag] Must all these be
10158supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10159 </td>
10160 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10161
10162
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10163 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10164 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10165
10166
10167 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10168 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10169 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10170 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10171 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10172 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10173
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10174 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10175
10176
10177 </td> <!-- entry_type -->
10178
10179 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10180 <p>Light source used to define transform
101812</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10182 </td>
10183
10184 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10185 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10186 </td>
10187
10188 <td class="entry_range">
10189 </td>
10190
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10191 <td class="entry_tags">
10192 </td>
10193
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10194 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10195
10196
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10197 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10198 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10199
10200
10201
10202 <!-- end of kind -->
10203 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10204 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10205
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10206 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10207 <tr>
10208 <th class="th_name">Property Name</th>
10209 <th class="th_type">Type</th>
10210 <th class="th_description">Description</th>
10211 <th class="th_units">Units</th>
10212 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10213 <th class="th_tags">Tags</th>
10214 </tr>
10215 </thead>
10216
10217 <tbody>
10218
10219
10220
10221
10222
10223
10224
10225
10226
10227
10228 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10229 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10230 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10231 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10232 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10233 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10234
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10235 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10236
10237
10238 </td> <!-- entry_type -->
10239
10240 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10241 <p>Duration each pixel is exposed to
10242light.<wbr/></p>
10243<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
10244duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10245 </td>
10246
10247 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10248 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10249 </td>
10250
10251 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10252 <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]10253 </td>
10254
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10255 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10256 <ul class="entry_tags">
10257 <li><a href="#tag_V1">V1</a></li>
10258 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10259 </td>
10260
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10261 </tr>
10262 <tr class="entries_header">
10263 <th class="th_details" colspan="5">Details</th>
10264 </tr>
10265 <tr class="entry_cont">
10266 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10267 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10268 </td>
10269 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10270
10271
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10272 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10273 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10274
10275
10276 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10277 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10278 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10279 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10280 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10281 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10282
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10283 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10284
10285
10286 </td> <!-- entry_type -->
10287
10288 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10289 <p>Duration from start of frame exposure to
10290start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10291 </td>
10292
10293 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10294 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10295 </td>
10296
10297 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10298 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
10299android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10300 </td>
10301
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10302 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10303 <ul class="entry_tags">
10304 <li><a href="#tag_V1">V1</a></li>
10305 <li><a href="#tag_BC">BC</a></li>
10306 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10307 </td>
10308
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10309 </tr>
10310 <tr class="entries_header">
10311 <th class="th_details" colspan="5">Details</th>
10312 </tr>
10313 <tr class="entry_cont">
10314 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10315 <p>Exposure time has priority,<wbr/> so duration is set to
10316max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10317 </td>
10318 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10319
10320
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10321 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10322 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10323
10324
10325 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10326 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10327 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10328 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10329 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10330 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10331
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10332 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10333
10334
10335 </td> <!-- entry_type -->
10336
10337 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10338 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10339implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10340below 'maximum analog sensitivity'.<wbr/></p>
10341<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10342gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10343 </td>
10344
10345 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10346 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10347 </td>
10348
10349 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10350 <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]10351 </td>
10352
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10353 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10354 <ul class="entry_tags">
10355 <li><a href="#tag_V1">V1</a></li>
10356 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10357 </td>
10358
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10359 </tr>
10360 <tr class="entries_header">
10361 <th class="th_details" colspan="5">Details</th>
10362 </tr>
10363 <tr class="entry_cont">
10364 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10365 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10366 </td>
10367 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10368
10369
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10370 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10371 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10372
10373
10374 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10375 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10376 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10377 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10378 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10379 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10380
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10381 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10382
10383
10384 </td> <!-- entry_type -->
10385
10386 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10387 <p>Time at start of exposure of first
10388row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10389 </td>
10390
10391 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10392 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10393 </td>
10394
10395 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10396 <blockquote>
10397<p>0</p>
10398</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10399 </td>
10400
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10401 <td class="entry_tags">
10402 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10403 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10404 </ul>
10405 </td>
10406
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10407 </tr>
10408 <tr class="entries_header">
10409 <th class="th_details" colspan="5">Details</th>
10410 </tr>
10411 <tr class="entry_cont">
10412 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10413 <p>Monotonic,<wbr/> should be synced to other timestamps in
10414system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10415 </td>
10416 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10417
10418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10419 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10420 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10421
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10422
10423 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10424 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10425 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10426 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10427 <td class="entry_type">
10428 <span class="entry_type_name">float</span>
10429
10430 <span class="entry_type_visibility"> [public]</span>
10431
10432
10433 </td> <!-- entry_type -->
10434
10435 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10436 <p>The temperature of the sensor,<wbr/> sampled at the time
10437exposure began for this frame.<wbr/></p>
10438<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
10439somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10440 </td>
10441
10442 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10443 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10444 </td>
10445
10446 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10447 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10448 </td>
10449
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10450 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10451 <ul class="entry_tags">
10452 <li><a href="#tag_FULL">FULL</a></li>
10453 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10454 </td>
10455
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10456 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10457
10458
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10459 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10460 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10461
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10462
10463
10464 <!-- end of kind -->
10465 </tbody>
10466
10467 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10468 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10469
10470
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10471 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10472
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10473 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10474 <tr>
10475 <th class="th_name">Property Name</th>
10476 <th class="th_type">Type</th>
10477 <th class="th_description">Description</th>
10478 <th class="th_units">Units</th>
10479 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10480 <th class="th_tags">Tags</th>
10481 </tr>
10482 </thead>
10483
10484 <tbody>
10485
10486
10487
10488
10489
10490
10491
10492
10493
10494
10495 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10496 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10497 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10498 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10499 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10500 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10501
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10502 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10503
10504 <ul class="entry_type_enum">
10505 <li>
10506 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10507 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10508 </li>
10509 <li>
10510 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10511 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10512 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10513 </li>
10514 <li>
10515 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10516 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10517 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10518 </li>
10519 </ul>
10520
10521 </td> <!-- entry_type -->
10522
10523 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10524 <p>Quality of lens shading correction applied
10525to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10526 </td>
10527
10528 <td class="entry_units">
10529 </td>
10530
10531 <td class="entry_range">
10532 </td>
10533
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10534 <td class="entry_tags">
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 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10545 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10546 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10547 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10548 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10549 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10550
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10551 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10552
10553
10554 </td> <!-- entry_type -->
10555
10556 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10557 <p>Control the amount of shading correction
10558applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10559 </td>
10560
10561 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10562 unitless: 1-10; 10 is full shading
10563 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10564 </td>
10565
10566 <td class="entry_range">
10567 </td>
10568
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10569 <td class="entry_tags">
10570 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10571 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10572 </ul>
10573 </td>
10574
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10575 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10576
10577
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10578 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10579 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10580
10581
10582
10583 <!-- end of kind -->
10584 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10585 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10586
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10587 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10588 <tr>
10589 <th class="th_name">Property Name</th>
10590 <th class="th_type">Type</th>
10591 <th class="th_description">Description</th>
10592 <th class="th_units">Units</th>
10593 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10594 <th class="th_tags">Tags</th>
10595 </tr>
10596 </thead>
10597
10598 <tbody>
10599
10600
10601
10602
10603
10604
10605
10606
10607
10608
10609 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10610 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10611 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10612 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10613 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10614 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10615
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10616 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10617
10618 <ul class="entry_type_enum">
10619 <li>
10620 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10621 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10622 </li>
10623 <li>
10624 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10625 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10626 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10627 </li>
10628 <li>
10629 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10630 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10631 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10632 </li>
10633 </ul>
10634
10635 </td> <!-- entry_type -->
10636
10637 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10638 <p>Quality of lens shading correction applied
10639to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10640 </td>
10641
10642 <td class="entry_units">
10643 </td>
10644
10645 <td class="entry_range">
10646 </td>
10647
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10648 <td class="entry_tags">
10649 </td>
10650
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10651 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10652
10653
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10654 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10655 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10656
10657
10658
10659 <!-- end of kind -->
10660 </tbody>
10661
10662 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10663 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10664
10665
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10666 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10667
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10668 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10669 <tr>
10670 <th class="th_name">Property Name</th>
10671 <th class="th_type">Type</th>
10672 <th class="th_description">Description</th>
10673 <th class="th_units">Units</th>
10674 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10675 <th class="th_tags">Tags</th>
10676 </tr>
10677 </thead>
10678
10679 <tbody>
10680
10681
10682
10683
10684
10685
10686
10687
10688
10689
10690 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10691 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10692 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10693 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10694 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10695 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10696
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10697 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10698
10699 <ul class="entry_type_enum">
10700 <li>
10701 <span class="entry_type_enum_name">OFF</span>
10702 </li>
10703 <li>
10704 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10705 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
10706 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10707 </li>
10708 <li>
10709 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10710 <span class="entry_type_enum_notes">Optional Return all face
10711 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10712 </li>
10713 </ul>
10714
10715 </td> <!-- entry_type -->
10716
10717 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10718 <p>State of the face detector
10719unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10720 </td>
10721
10722 <td class="entry_units">
10723 </td>
10724
10725 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10726 <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]10727 </td>
10728
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10729 <td class="entry_tags">
10730 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10731 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10732 </ul>
10733 </td>
10734
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10735 </tr>
10736 <tr class="entries_header">
10737 <th class="th_details" colspan="5">Details</th>
10738 </tr>
10739 <tr class="entry_cont">
10740 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10741 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10742should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10743fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10744<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]10745 </td>
10746 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10747
10748
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10749 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10750 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10751
10752
10753 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10754 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10755 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10756 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10757 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10758 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10759
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10760 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10761
10762 <ul class="entry_type_enum">
10763 <li>
10764 <span class="entry_type_enum_name">OFF</span>
10765 </li>
10766 <li>
10767 <span class="entry_type_enum_name">ON</span>
10768 </li>
10769 </ul>
10770
10771 </td> <!-- entry_type -->
10772
10773 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10774 <p>Operating mode for histogram
10775generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10776 </td>
10777
10778 <td class="entry_units">
10779 </td>
10780
10781 <td class="entry_range">
10782 </td>
10783
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10784 <td class="entry_tags">
10785 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10786 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10787 </ul>
10788 </td>
10789
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10790 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10791
10792
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10793 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10794 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10795
10796
10797 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10798 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10799 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10800 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10801 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10802 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10803
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10804 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10805
10806 <ul class="entry_type_enum">
10807 <li>
10808 <span class="entry_type_enum_name">OFF</span>
10809 </li>
10810 <li>
10811 <span class="entry_type_enum_name">ON</span>
10812 </li>
10813 </ul>
10814
10815 </td> <!-- entry_type -->
10816
10817 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10818 <p>Operating mode for sharpness map
10819generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10820 </td>
10821
10822 <td class="entry_units">
10823 </td>
10824
10825 <td class="entry_range">
10826 </td>
10827
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10828 <td class="entry_tags">
10829 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10830 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10831 </ul>
10832 </td>
10833
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10834 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10835
10836
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10837 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10838 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10839
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10840
10841 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10842 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10843 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10844 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10845 <td class="entry_type">
10846 <span class="entry_type_name entry_type_name_enum">byte</span>
10847
10848 <span class="entry_type_visibility"> [public]</span>
10849
10850 <ul class="entry_type_enum">
10851 <li>
10852 <span class="entry_type_enum_name">OFF</span>
10853 </li>
10854 <li>
10855 <span class="entry_type_enum_name">ON</span>
10856 </li>
10857 </ul>
10858
10859 </td> <!-- entry_type -->
10860
10861 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10862 <p>Whether the HAL needs to output the lens
10863shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10864 </td>
10865
10866 <td class="entry_units">
10867 </td>
10868
10869 <td class="entry_range">
10870 </td>
10871
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10872 <td class="entry_tags">
10873 </td>
10874
10875 </tr>
10876 <tr class="entries_header">
10877 <th class="th_details" colspan="5">Details</th>
10878 </tr>
10879 <tr class="entry_cont">
10880 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10881 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10882<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]10883the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10884 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10885 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10886
10887
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10888 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10889 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10890
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10891
10892
10893 <!-- end of kind -->
10894 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10895 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10896
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10897 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10898 <tr>
10899 <th class="th_name">Property Name</th>
10900 <th class="th_type">Type</th>
10901 <th class="th_description">Description</th>
10902 <th class="th_units">Units</th>
10903 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10904 <th class="th_tags">Tags</th>
10905 </tr>
10906 </thead>
10907
10908 <tbody>
10909
10910
10911
10912
10913
10914
10915
10916
10917
10918
10919
10920
10921 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10922 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10923 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10924 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10925 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10926 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10927 <span class="entry_type_container">x</span>
10928
10929 <span class="entry_type_array">
10930 n
10931 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10932 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10933 <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]10934
10935
10936 </td> <!-- entry_type -->
10937
10938 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10939 <p>Which face detection modes are available,<wbr/>
10940if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10941 </td>
10942
10943 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10944 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10945 OFF
10946 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10947 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10948 </td>
10949
10950 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10951 </td>
10952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10953 <td class="entry_tags">
10954 </td>
10955
10956 </tr>
10957 <tr class="entries_header">
10958 <th class="th_details" colspan="5">Details</th>
10959 </tr>
10960 <tr class="entry_cont">
10961 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10962 <p>OFF means face detection is disabled,<wbr/> it must
10963be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10964<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10965<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
10966<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]10967<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10968<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
10969<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]10970 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10971 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10972
10973
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10974 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10975 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10976
10977
10978 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10979 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10980 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10981 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10982 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10983 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10984
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10985 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10986
10987
10988 </td> <!-- entry_type -->
10989
10990 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10991 <p>Number of histogram buckets
10992supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10993 </td>
10994
10995 <td class="entry_units">
10996 </td>
10997
10998 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10999 <blockquote>
11000<p>= 64</p>
11001</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11002 </td>
11003
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11004 <td class="entry_tags">
11005 </td>
11006
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11007 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11008
11009
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11010 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11011 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11012
11013
11014 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11015 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11016 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11017 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11018 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11019 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11020
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11021 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11022
11023
11024 </td> <!-- entry_type -->
11025
11026 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11027 <p>Maximum number of simultaneously detectable
11028faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11029 </td>
11030
11031 <td class="entry_units">
11032 </td>
11033
11034 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11035 <blockquote>
11036<p>= 4 if availableFaceDetectionModes lists
11037modes besides OFF,<wbr/> otherwise 0</p>
11038</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11039 </td>
11040
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11041 <td class="entry_tags">
11042 </td>
11043
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11044 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11045
11046
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11047 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11048 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11049
11050
11051 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11052 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11053 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11054 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11055 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11056 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11057
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11058 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11059
11060
11061 </td> <!-- entry_type -->
11062
11063 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11064 <p>Maximum value possible for a histogram
11065bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11066 </td>
11067
11068 <td class="entry_units">
11069 </td>
11070
11071 <td class="entry_range">
11072 </td>
11073
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11074 <td class="entry_tags">
11075 </td>
11076
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11077 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11078
11079
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11080 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11081 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11082
11083
11084 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11085 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11086 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11087 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11088 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11089 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11090
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11091 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11092
11093
11094 </td> <!-- entry_type -->
11095
11096 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11097 <p>Maximum value possible for a sharpness map
11098region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11099 </td>
11100
11101 <td class="entry_units">
11102 </td>
11103
11104 <td class="entry_range">
11105 </td>
11106
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11107 <td class="entry_tags">
11108 </td>
11109
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11110 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11111
11112
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11113 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11114 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11115
11116
11117 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11118 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11119 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11120 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11121 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11122 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11123 <span class="entry_type_container">x</span>
11124
11125 <span class="entry_type_array">
11126 2
11127 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11128 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11129 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11130
11131
11132 </td> <!-- entry_type -->
11133
11134 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11135 <p>Dimensions of the sharpness
11136map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11137 </td>
11138
11139 <td class="entry_units">
11140 </td>
11141
11142 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11143 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11144 </td>
11145
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11146 <td class="entry_tags">
11147 </td>
11148
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11149 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11150
11151
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11152 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11153 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11154
11155
11156
11157
11158
11159
11160 <!-- end of kind -->
11161 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11162 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11163
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11164 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11165 <tr>
11166 <th class="th_name">Property Name</th>
11167 <th class="th_type">Type</th>
11168 <th class="th_description">Description</th>
11169 <th class="th_units">Units</th>
11170 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11171 <th class="th_tags">Tags</th>
11172 </tr>
11173 </thead>
11174
11175 <tbody>
11176
11177
11178
11179
11180
11181
11182
11183
11184
11185
11186 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11187 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11188 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11189 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11190 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11191 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11192
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11193 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11194
11195 <ul class="entry_type_enum">
11196 <li>
11197 <span class="entry_type_enum_name">OFF</span>
11198 </li>
11199 <li>
11200 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11201 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
11202 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11203 </li>
11204 <li>
11205 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11206 <span class="entry_type_enum_notes">Optional Return all face
11207 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11208 </li>
11209 </ul>
11210
11211 </td> <!-- entry_type -->
11212
11213 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11214 <p>State of the face detector
11215unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11216 </td>
11217
11218 <td class="entry_units">
11219 </td>
11220
11221 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11222 <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]11223 </td>
11224
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11225 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11226 <ul class="entry_tags">
11227 <li><a href="#tag_BC">BC</a></li>
11228 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11229 </td>
11230
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11231 </tr>
11232 <tr class="entries_header">
11233 <th class="th_details" colspan="5">Details</th>
11234 </tr>
11235 <tr class="entry_cont">
11236 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11237 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11238should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11239fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11240<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]11241 </td>
11242 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11243
11244
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11245 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11246 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11247
11248
11249 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11250 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11251 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11252 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11253 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11254 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11255 <span class="entry_type_container">x</span>
11256
11257 <span class="entry_type_array">
11258 n
11259 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11260 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11261
11262
11263 </td> <!-- entry_type -->
11264
11265 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11266 <p>List of unique IDs for detected
11267faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11268 </td>
11269
11270 <td class="entry_units">
11271 </td>
11272
11273 <td class="entry_range">
11274 </td>
11275
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11276 <td class="entry_tags">
11277 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11278 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11279 </ul>
11280 </td>
11281
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11282 </tr>
11283 <tr class="entries_header">
11284 <th class="th_details" colspan="5">Details</th>
11285 </tr>
11286 <tr class="entry_cont">
11287 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11288 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11289 </td>
11290 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11291
11292
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11293 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11294 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11295
11296
11297 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11298 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11299 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11300 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11301 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11302 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11303 <span class="entry_type_container">x</span>
11304
11305 <span class="entry_type_array">
11306 n x 6
11307 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11308 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11309 <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]11310
11311
11312 </td> <!-- entry_type -->
11313
11314 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11315 <p>List of landmarks for detected
11316faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11317 </td>
11318
11319 <td class="entry_units">
11320 </td>
11321
11322 <td class="entry_range">
11323 </td>
11324
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11325 <td class="entry_tags">
11326 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11327 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11328 </ul>
11329 </td>
11330
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11331 </tr>
11332 <tr class="entries_header">
11333 <th class="th_details" colspan="5">Details</th>
11334 </tr>
11335 <tr class="entry_cont">
11336 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11337 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11338 </td>
11339 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11340
11341
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11342 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11343 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11344
11345
11346 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11347 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11348 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11349 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11350 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11351 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11352 <span class="entry_type_container">x</span>
11353
11354 <span class="entry_type_array">
11355 n x 4
11356 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11357 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11358 <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]11359
11360
11361 </td> <!-- entry_type -->
11362
11363 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11364 <p>List of the bounding rectangles for detected
11365faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11366 </td>
11367
11368 <td class="entry_units">
11369 </td>
11370
11371 <td class="entry_range">
11372 </td>
11373
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11374 <td class="entry_tags">
11375 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11376 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11377 </ul>
11378 </td>
11379
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11380 </tr>
11381 <tr class="entries_header">
11382 <th class="th_details" colspan="5">Details</th>
11383 </tr>
11384 <tr class="entry_cont">
11385 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11386 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11387 </td>
11388 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11389
11390
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11391 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11392 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11393
11394
11395 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11396 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11397 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11398 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11399 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11400 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11401 <span class="entry_type_container">x</span>
11402
11403 <span class="entry_type_array">
11404 n
11405 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11406 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11407
11408
11409 </td> <!-- entry_type -->
11410
11411 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11412 <p>List of the face confidence scores for
11413detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11414 </td>
11415
11416 <td class="entry_units">
11417 </td>
11418
11419 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11420 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11421 </td>
11422
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11423 <td class="entry_tags">
11424 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11425 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11426 </ul>
11427 </td>
11428
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11429 </tr>
11430 <tr class="entries_header">
11431 <th class="th_details" colspan="5">Details</th>
11432 </tr>
11433 <tr class="entry_cont">
11434 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11435 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
11436meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11437 </td>
11438 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11439
11440
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11441 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11442 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11443
11444
11445 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11446 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11447 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11448 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11449 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11450 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11451 <span class="entry_type_container">x</span>
11452
11453 <span class="entry_type_array">
11454 n x 3
11455 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11456 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11457 <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]11458
11459
11460 </td> <!-- entry_type -->
11461
11462 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11463 <p>A 3-channel histogram based on the raw
11464sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11465 </td>
11466
11467 <td class="entry_units">
11468 </td>
11469
11470 <td class="entry_range">
11471 </td>
11472
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11473 <td class="entry_tags">
11474 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11475 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11476 </ul>
11477 </td>
11478
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11479 </tr>
11480 <tr class="entries_header">
11481 <th class="th_details" colspan="5">Details</th>
11482 </tr>
11483 <tr class="entry_cont">
11484 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11485 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11486(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]11487(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
11488supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11489 </td>
11490 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11491
11492
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11493 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11494 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11495
11496
11497 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11498 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11499 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11500 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11501 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11502 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11503
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11504 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11505
11506 <ul class="entry_type_enum">
11507 <li>
11508 <span class="entry_type_enum_name">OFF</span>
11509 </li>
11510 <li>
11511 <span class="entry_type_enum_name">ON</span>
11512 </li>
11513 </ul>
11514
11515 </td> <!-- entry_type -->
11516
11517 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11518 <p>Operating mode for histogram
11519generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11520 </td>
11521
11522 <td class="entry_units">
11523 </td>
11524
11525 <td class="entry_range">
11526 </td>
11527
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11528 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11529 <ul class="entry_tags">
11530 <li><a href="#tag_V1">V1</a></li>
11531 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11532 </td>
11533
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11534 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11535
11536
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11537 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11538 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11539
11540
11541 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11542 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11543 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11544 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11545 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11546 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11547 <span class="entry_type_container">x</span>
11548
11549 <span class="entry_type_array">
11550 n x m x 3
11551 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11552 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11553 <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]11554
11555
11556 </td> <!-- entry_type -->
11557
11558 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11559 <p>A 3-channel sharpness map,<wbr/> based on the raw
11560sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11561 </td>
11562
11563 <td class="entry_units">
11564 </td>
11565
11566 <td class="entry_range">
11567 </td>
11568
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11569 <td class="entry_tags">
11570 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11571 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11572 </ul>
11573 </td>
11574
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11575 </tr>
11576 <tr class="entries_header">
11577 <th class="th_details" colspan="5">Details</th>
11578 </tr>
11579 <tr class="entry_cont">
11580 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11581 <p>If only a monochrome sharpness map is supported,<wbr/>
11582all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11583 </td>
11584 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11585
11586
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11587 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11588 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11589
11590
11591 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11592 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11593 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11594 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11595 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11596 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11597
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11598 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11599
11600 <ul class="entry_type_enum">
11601 <li>
11602 <span class="entry_type_enum_name">OFF</span>
11603 </li>
11604 <li>
11605 <span class="entry_type_enum_name">ON</span>
11606 </li>
11607 </ul>
11608
11609 </td> <!-- entry_type -->
11610
11611 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11612 <p>Operating mode for sharpness map
11613generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11614 </td>
11615
11616 <td class="entry_units">
11617 </td>
11618
11619 <td class="entry_range">
11620 </td>
11621
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11622 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11623 <ul class="entry_tags">
11624 <li><a href="#tag_V1">V1</a></li>
11625 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11626 </td>
11627
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11628 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11629
11630
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11631 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11632 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11633
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11634
11635 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11636 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11637 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11638 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11639 <td class="entry_type">
11640 <span class="entry_type_name">float</span>
11641 <span class="entry_type_container">x</span>
11642
11643 <span class="entry_type_array">
11644 4 x n x m
11645 </span>
11646 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11647 <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]11648
11649
11650 </td> <!-- entry_type -->
11651
11652 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11653 <p>The shading map is a low-resolution floating-point map
11654that lists the coefficients used to correct for vignetting,<wbr/> for each
11655Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11656 </td>
11657
11658 <td class="entry_units">
11659 </td>
11660
11661 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11662 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11663 </td>
11664
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11665 <td class="entry_tags">
11666 </td>
11667
11668 </tr>
11669 <tr class="entries_header">
11670 <th class="th_details" colspan="5">Details</th>
11671 </tr>
11672 <tr class="entry_cont">
11673 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11674 <p>The least shaded section of the image should have a gain factor
11675of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11676<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]11677must take into account the colorCorrection settings.<wbr/></p>
11678<p>The shading map is for the entire active pixel array,<wbr/> and is not
11679affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11680entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11681pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
11682map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
11683(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
11684pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
11685The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
11686<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
11687channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
11688The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11689is 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]11690<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
11691and must be smaller than 64x64.<wbr/></p>
11692<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11693<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
11694<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]11695[ 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/>
11696 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/>
11697 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/>
11698 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/>
11699 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/>
11700 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]11701</code></pre>
11702<p>The low-resolution scaling map images for each channel are
11703(displayed using nearest-neighbor interpolation):</p>
11704<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
11705<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
11706<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
11707<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]11708<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11709image 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]11710<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]11711 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11712 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11713
11714
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11715 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11716 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11717
11718
11719 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11720 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11721 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11722 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11723 <td class="entry_type">
11724 <span class="entry_type_name">float</span>
11725 <span class="entry_type_container">x</span>
11726
11727 <span class="entry_type_array">
11728 4
11729 </span>
11730 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11731 <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]11732
11733
11734 </td> <!-- entry_type -->
11735
11736 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11737 <p>The best-fit color channel gains calculated
11738by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11739 </td>
11740
11741 <td class="entry_units">
11742 </td>
11743
11744 <td class="entry_range">
11745 </td>
11746
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11747 <td class="entry_tags">
11748 </td>
11749
11750 </tr>
11751 <tr class="entries_header">
11752 <th class="th_details" colspan="5">Details</th>
11753 </tr>
11754 <tr class="entry_cont">
11755 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11756 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11757since statistics processing on data from a new frame
11758typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11759applied to that frame.<wbr/></p>
11760<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11761see <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]11762<p>This value should always be calculated by the AWB block,<wbr/>
11763regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11764 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11765 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11766
11767
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11768 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11769 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11770
11771
11772 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11773 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11774 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11775 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11776 <td class="entry_type">
11777 <span class="entry_type_name">rational</span>
11778 <span class="entry_type_container">x</span>
11779
11780 <span class="entry_type_array">
11781 3 x 3
11782 </span>
11783 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11784 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11785
11786
11787 </td> <!-- entry_type -->
11788
11789 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11790 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11791calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11792output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11793 </td>
11794
11795 <td class="entry_units">
11796 </td>
11797
11798 <td class="entry_range">
11799 </td>
11800
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11801 <td class="entry_tags">
11802 </td>
11803
11804 </tr>
11805 <tr class="entries_header">
11806 <th class="th_details" colspan="5">Details</th>
11807 </tr>
11808 <tr class="entry_cont">
11809 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11810 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11811statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11812for the next frame.<wbr/> These are the values the HAL believes
11813are the best fit for the current output frame.<wbr/> This may
11814be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11815statistics processing on data from a new frame typically
11816completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11817that frame.<wbr/></p>
11818<p>These estimates must be provided for all frames,<wbr/> even if
11819capture settings and color transforms are set by the application.<wbr/></p>
11820<p>This value should always be calculated by the AWB block,<wbr/>
11821regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11822 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11823 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11824
11825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11826 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11827 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11828
11829
11830 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11831 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11832 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11833 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11834 <td class="entry_type">
11835 <span class="entry_type_name entry_type_name_enum">byte</span>
11836
11837 <span class="entry_type_visibility"> [public]</span>
11838
11839 <ul class="entry_type_enum">
11840 <li>
11841 <span class="entry_type_enum_name">NONE</span>
11842 </li>
11843 <li>
11844 <span class="entry_type_enum_name">50HZ</span>
11845 </li>
11846 <li>
11847 <span class="entry_type_enum_name">60HZ</span>
11848 </li>
11849 </ul>
11850
11851 </td> <!-- entry_type -->
11852
11853 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11854 <p>The HAL estimated scene illumination lighting
11855frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11856 </td>
11857
11858 <td class="entry_units">
11859 </td>
11860
11861 <td class="entry_range">
11862 </td>
11863
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11864 <td class="entry_tags">
11865 </td>
11866
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11867 </tr>
11868 <tr class="entries_header">
11869 <th class="th_details" colspan="5">Details</th>
11870 </tr>
11871 <tr class="entry_cont">
11872 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11873 <p>Report NONE if there doesn't appear to be flickering
11874illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11875 </td>
11876 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11877
11878
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11879 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11880 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11881
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11882
11883
11884 <!-- end of kind -->
11885 </tbody>
11886
11887 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11888 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11889
11890
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11891 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11892
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11893 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11894 <tr>
11895 <th class="th_name">Property Name</th>
11896 <th class="th_type">Type</th>
11897 <th class="th_description">Description</th>
11898 <th class="th_units">Units</th>
11899 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11900 <th class="th_tags">Tags</th>
11901 </tr>
11902 </thead>
11903
11904 <tbody>
11905
11906
11907
11908
11909
11910
11911
11912
11913
11914
11915 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11916 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11917 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11918 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11919 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]11920 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11921 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11922
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11923 <span class="entry_type_array">
11924 n x 2
11925 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11926 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11927 <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]11928
11929
11930 </td> <!-- entry_type -->
11931
11932 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11933 <p>Table mapping blue input values to output
11934values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11935 </td>
11936
11937 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11938 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11939 </td>
11940
11941 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11942 <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]11943 </td>
11944
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11945 <td class="entry_tags">
11946 </td>
11947
11948 </tr>
11949 <tr class="entries_header">
11950 <th class="th_details" colspan="5">Details</th>
11951 </tr>
11952 <tr class="entry_cont">
11953 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11954 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11955channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
11956<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]11957 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11958 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11959
11960
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11961 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11962 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11963
11964
11965 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11966 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11967 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11968 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11969 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]11970 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11971 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11972
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11973 <span class="entry_type_array">
11974 n x 2
11975 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11976 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11977 <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]11978
11979
11980 </td> <!-- entry_type -->
11981
11982 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11983 <p>Table mapping green input values to output
11984values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11985 </td>
11986
11987 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11988 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11989 </td>
11990
11991 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11992 <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]11993 </td>
11994
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11995 <td class="entry_tags">
11996 </td>
11997
11998 </tr>
11999 <tr class="entries_header">
12000 <th class="th_details" colspan="5">Details</th>
12001 </tr>
12002 <tr class="entry_cont">
12003 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12004 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12005channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12006<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]12007 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12008 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12009
12010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12011 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12012 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12013
12014
12015 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12016 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12017 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12018 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12019 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12020 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12021 <span class="entry_type_container">x</span>
12022
12023 <span class="entry_type_array">
12024 n x 2
12025 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12026 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12027 <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]12028
12029
12030 </td> <!-- entry_type -->
12031
12032 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12033 <p>Table mapping red input values to output
12034values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12035 </td>
12036
12037 <td class="entry_units">
12038 </td>
12039
12040 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12041 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12042 </td>
12043
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12044 <td class="entry_tags">
12045 <ul class="entry_tags">
12046 <li><a href="#tag_DNG">DNG</a></li>
12047 </ul>
12048 </td>
12049
12050 </tr>
12051 <tr class="entries_header">
12052 <th class="th_details" colspan="5">Details</th>
12053 </tr>
12054 <tr class="entry_cont">
12055 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12056 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12057channel,<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]12058<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12059the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12060are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12061between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12062<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12063defined points.<wbr/> The points will be listed in increasing
12064order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
120650.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12066for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
120670.<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]12068 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12069 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12070
12071
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12072 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12073 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12074
12075
12076 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12077 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12078 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12079 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12080 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12081 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12082
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12083 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12084
12085 <ul class="entry_type_enum">
12086 <li>
12087 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12088 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12089 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12090 </li>
12091 <li>
12092 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12093 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12094 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12095 </li>
12096 <li>
12097 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12098 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12099 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12100 </li>
12101 </ul>
12102
12103 </td> <!-- entry_type -->
12104
12105 <td class="entry_description">
12106 </td>
12107
12108 <td class="entry_units">
12109 </td>
12110
12111 <td class="entry_range">
12112 </td>
12113
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12114 <td class="entry_tags">
12115 </td>
12116
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12117 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12118
12119
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12120 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12121 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12122
12123
12124
12125 <!-- end of kind -->
12126 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12127 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12128
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12129 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12130 <tr>
12131 <th class="th_name">Property Name</th>
12132 <th class="th_type">Type</th>
12133 <th class="th_description">Description</th>
12134 <th class="th_units">Units</th>
12135 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12136 <th class="th_tags">Tags</th>
12137 </tr>
12138 </thead>
12139
12140 <tbody>
12141
12142
12143
12144
12145
12146
12147
12148
12149
12150
12151 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12152 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12153 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12154 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12155 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12156 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12157
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12158 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12159
12160
12161 </td> <!-- entry_type -->
12162
12163 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12164 <p>Maximum number of supported points in the
12165tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12166 </td>
12167
12168 <td class="entry_units">
12169 </td>
12170
12171 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12172 <blockquote>
12173<p>= 128</p>
12174</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12175 </td>
12176
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12177 <td class="entry_tags">
12178 </td>
12179
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12180 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12181
12182
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12183 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12184 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12185
12186
12187
12188 <!-- end of kind -->
12189 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12190 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12191
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12192 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12193 <tr>
12194 <th class="th_name">Property Name</th>
12195 <th class="th_type">Type</th>
12196 <th class="th_description">Description</th>
12197 <th class="th_units">Units</th>
12198 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12199 <th class="th_tags">Tags</th>
12200 </tr>
12201 </thead>
12202
12203 <tbody>
12204
12205
12206
12207
12208
12209
12210
12211
12212
12213
12214 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12215 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12216 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12217 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12218 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12219 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12220 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12221
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12222 <span class="entry_type_array">
12223 n x 2
12224 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12225 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12226 <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]12227
12228
12229 </td> <!-- entry_type -->
12230
12231 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12232 <p>Table mapping blue input values to output
12233values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12234 </td>
12235
12236 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12237 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12238 </td>
12239
12240 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12241 <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]12242 </td>
12243
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12244 <td class="entry_tags">
12245 </td>
12246
12247 </tr>
12248 <tr class="entries_header">
12249 <th class="th_details" colspan="5">Details</th>
12250 </tr>
12251 <tr class="entry_cont">
12252 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12253 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12254channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12255<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]12256 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12257 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12258
12259
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12260 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12261 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12262
12263
12264 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12265 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12266 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12267 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12268 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12269 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12270 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12271
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12272 <span class="entry_type_array">
12273 n x 2
12274 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12275 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12276 <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]12277
12278
12279 </td> <!-- entry_type -->
12280
12281 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12282 <p>Table mapping green input values to output
12283values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12284 </td>
12285
12286 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12287 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12288 </td>
12289
12290 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12291 <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]12292 </td>
12293
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12294 <td class="entry_tags">
12295 </td>
12296
12297 </tr>
12298 <tr class="entries_header">
12299 <th class="th_details" colspan="5">Details</th>
12300 </tr>
12301 <tr class="entry_cont">
12302 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12303 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12304channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12305<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]12306 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12307 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12308
12309
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12310 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12311 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12312
12313
12314 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12315 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12316 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12317 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12318 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12319 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12320 <span class="entry_type_container">x</span>
12321
12322 <span class="entry_type_array">
12323 n x 2
12324 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12325 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12326 <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]12327
12328
12329 </td> <!-- entry_type -->
12330
12331 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12332 <p>Table mapping red input values to output
12333values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12334 </td>
12335
12336 <td class="entry_units">
12337 </td>
12338
12339 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12340 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12341 </td>
12342
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12343 <td class="entry_tags">
12344 <ul class="entry_tags">
12345 <li><a href="#tag_DNG">DNG</a></li>
12346 </ul>
12347 </td>
12348
12349 </tr>
12350 <tr class="entries_header">
12351 <th class="th_details" colspan="5">Details</th>
12352 </tr>
12353 <tr class="entry_cont">
12354 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12355 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12356channel,<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]12357<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12358the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12359are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12360between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12361<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12362defined points.<wbr/> The points will be listed in increasing
12363order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
123640.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12365for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
123660.<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]12367 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12368 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12369
12370
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12371 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12372 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12373
12374
12375 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12376 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12377 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12378 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12379 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12380 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12381
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12382 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12383
12384 <ul class="entry_type_enum">
12385 <li>
12386 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12387 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12388 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12389 </li>
12390 <li>
12391 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12392 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12393 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12394 </li>
12395 <li>
12396 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12397 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12398 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12399 </li>
12400 </ul>
12401
12402 </td> <!-- entry_type -->
12403
12404 <td class="entry_description">
12405 </td>
12406
12407 <td class="entry_units">
12408 </td>
12409
12410 <td class="entry_range">
12411 </td>
12412
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12413 <td class="entry_tags">
12414 </td>
12415
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12416 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12417
12418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12419 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12420 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12421
12422
12423
12424 <!-- end of kind -->
12425 </tbody>
12426
12427 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12428 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12429
12430
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12431 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12432
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12433 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12434 <tr>
12435 <th class="th_name">Property Name</th>
12436 <th class="th_type">Type</th>
12437 <th class="th_description">Description</th>
12438 <th class="th_units">Units</th>
12439 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12440 <th class="th_tags">Tags</th>
12441 </tr>
12442 </thead>
12443
12444 <tbody>
12445
12446
12447
12448
12449
12450
12451
12452
12453
12454
12455 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12456 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12457 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12458 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12459 <td class="entry_type">
12460 <span class="entry_type_name entry_type_name_enum">byte</span>
12461
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12462 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12463
12464 <ul class="entry_type_enum">
12465 <li>
12466 <span class="entry_type_enum_name">OFF</span>
12467 </li>
12468 <li>
12469 <span class="entry_type_enum_name">ON</span>
12470 </li>
12471 </ul>
12472
12473 </td> <!-- entry_type -->
12474
12475 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12476 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12477that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12478Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12479disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12480any untrusted applications.<wbr/></p>
12481<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12482transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12483data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12484<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]12485doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12486 </td>
12487
12488 <td class="entry_units">
12489 </td>
12490
12491 <td class="entry_range">
12492 </td>
12493
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12494 <td class="entry_tags">
12495 </td>
12496
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12497 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12498
12499
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12500 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12501 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12502
12503
12504
12505 <!-- end of kind -->
12506 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12507 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12508
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12509 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12510 <tr>
12511 <th class="th_name">Property Name</th>
12512 <th class="th_type">Type</th>
12513 <th class="th_description">Description</th>
12514 <th class="th_units">Units</th>
12515 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12516 <th class="th_tags">Tags</th>
12517 </tr>
12518 </thead>
12519
12520 <tbody>
12521
12522
12523
12524
12525
12526
12527
12528
12529
12530
12531 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12532 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12533 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12534 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12535 <td class="entry_type">
12536 <span class="entry_type_name entry_type_name_enum">byte</span>
12537
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12538 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12539
12540 <ul class="entry_type_enum">
12541 <li>
12542 <span class="entry_type_enum_name">OFF</span>
12543 </li>
12544 <li>
12545 <span class="entry_type_enum_name">ON</span>
12546 </li>
12547 </ul>
12548
12549 </td> <!-- entry_type -->
12550
12551 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12552 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12553that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12554Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12555disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12556any untrusted applications.<wbr/></p>
12557<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12558transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12559data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12560<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]12561doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12562 </td>
12563
12564 <td class="entry_units">
12565 </td>
12566
12567 <td class="entry_range">
12568 </td>
12569
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12570 <td class="entry_tags">
12571 </td>
12572
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12573 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12574
12575
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12576 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12577 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12578
12579
12580
12581 <!-- end of kind -->
12582 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12583 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12584
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12585 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12586 <tr>
12587 <th class="th_name">Property Name</th>
12588 <th class="th_type">Type</th>
12589 <th class="th_description">Description</th>
12590 <th class="th_units">Units</th>
12591 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12592 <th class="th_tags">Tags</th>
12593 </tr>
12594 </thead>
12595
12596 <tbody>
12597
12598
12599
12600
12601
12602
12603
12604
12605
12606
12607 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12608 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12609 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12610 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12611 <td class="entry_type">
12612 <span class="entry_type_name entry_type_name_enum">byte</span>
12613 <span class="entry_type_container">x</span>
12614
12615 <span class="entry_type_array">
12616 n
12617 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12618 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12619
12620 <ul class="entry_type_enum">
12621 <li>
12622 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12623 <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]12624 </li>
12625 </ul>
12626
12627 </td> <!-- entry_type -->
12628
12629 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12630 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12631 </td>
12632
12633 <td class="entry_units">
12634 </td>
12635
12636 <td class="entry_range">
12637 </td>
12638
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12639 <td class="entry_tags">
12640 </td>
12641
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12642 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12643
12644
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12645 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12646 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12647
12648
12649
12650 <!-- end of kind -->
12651 </tbody>
12652
12653 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12654 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12655
12656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12657 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12658
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12659 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12660 <tr>
12661 <th class="th_name">Property Name</th>
12662 <th class="th_type">Type</th>
12663 <th class="th_description">Description</th>
12664 <th class="th_units">Units</th>
12665 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12666 <th class="th_tags">Tags</th>
12667 </tr>
12668 </thead>
12669
12670 <tbody>
12671
12672
12673
12674
12675
12676
12677
12678
12679
12680
12681 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12682 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12683 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12684 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12685 <td class="entry_type">
12686 <span class="entry_type_name entry_type_name_enum">byte</span>
12687
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12688 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12689
12690 <ul class="entry_type_enum">
12691 <li>
12692 <span class="entry_type_enum_name">LIMITED</span>
12693 </li>
12694 <li>
12695 <span class="entry_type_enum_name">FULL</span>
12696 </li>
12697 </ul>
12698
12699 </td> <!-- entry_type -->
12700
12701 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12702 <p>The camera 3 HAL device can implement one of two possible
12703operational modes; limited and full.<wbr/> Full support is
12704expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12705hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12706camera HAL device v1 implementation,<wbr/> and is expected from
12707older or inexpensive devices.<wbr/> Full is a strict superset of
12708limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
12709<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]12710 </td>
12711
12712 <td class="entry_units">
12713 </td>
12714
12715 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12716 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12717 </td>
12718
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12719 <td class="entry_tags">
12720 </td>
12721
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12722 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12723
12724
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12725 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12726 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12727
12728
12729
12730 <!-- end of kind -->
12731 </tbody>
12732
12733 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12734 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12735
12736
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12737 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12738
12739 <thead class="entries_header">
12740 <tr>
12741 <th class="th_name">Property Name</th>
12742 <th class="th_type">Type</th>
12743 <th class="th_description">Description</th>
12744 <th class="th_units">Units</th>
12745 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12746 <th class="th_tags">Tags</th>
12747 </tr>
12748 </thead>
12749
12750 <tbody>
12751
12752
12753
12754
12755
12756
12757
12758
12759
12760
12761 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12762 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12763 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12764 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12765 <td class="entry_type">
12766 <span class="entry_type_name entry_type_name_enum">byte</span>
12767
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12768 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12769
12770 <ul class="entry_type_enum">
12771 <li>
12772 <span class="entry_type_enum_name">OFF</span>
12773 </li>
12774 <li>
12775 <span class="entry_type_enum_name">ON</span>
12776 </li>
12777 </ul>
12778
12779 </td> <!-- entry_type -->
12780
12781 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12782 <p>Whether black-level compensation is locked
12783to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12784 </td>
12785
12786 <td class="entry_units">
12787 </td>
12788
12789 <td class="entry_range">
12790 </td>
12791
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12792 <td class="entry_tags">
12793 <ul class="entry_tags">
12794 <li><a href="#tag_HAL2">HAL2</a></li>
12795 </ul>
12796 </td>
12797
12798 </tr>
12799 <tr class="entries_header">
12800 <th class="th_details" colspan="5">Details</th>
12801 </tr>
12802 <tr class="entry_cont">
12803 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12804 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12805compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12806OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12807<p>Since changes to certain capture parameters (such as
12808exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12809compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12810the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12811metadata.<wbr/></p>
12812<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12813<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12814<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12815<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12816<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12817<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12818<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12819<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12820</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12821<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12822device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12823result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12824<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12825<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12826<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12827<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12828<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
12829<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12830<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12831</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12832<p>This indicates to the application that on frame 4,<wbr/> black
12833levels were reset due to exposure value changes,<wbr/> and pixel
12834values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12835<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12836possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12837other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12838or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12839 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12840 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12841
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12842 <tr class="entries_header">
12843 <th class="th_details" colspan="5">HAL Implementation Details</th>
12844 </tr>
12845 <tr class="entry_cont">
12846 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12847 <p>If for some reason black level locking is no longer possible
12848(for example,<wbr/> the analog gain has changed,<wbr/> which forces
12849black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12850override this request (and it must report 'OFF' when this
12851does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12852possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12853 </td>
12854 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12855
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12856 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12857 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12858
12859
12860
12861 <!-- end of kind -->
12862 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12863 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12864
12865 <thead class="entries_header">
12866 <tr>
12867 <th class="th_name">Property Name</th>
12868 <th class="th_type">Type</th>
12869 <th class="th_description">Description</th>
12870 <th class="th_units">Units</th>
12871 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12872 <th class="th_tags">Tags</th>
12873 </tr>
12874 </thead>
12875
12876 <tbody>
12877
12878
12879
12880
12881
12882
12883
12884
12885
12886
12887 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12888 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12889 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12890 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12891 <td class="entry_type">
12892 <span class="entry_type_name entry_type_name_enum">byte</span>
12893
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12894 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12895
12896 <ul class="entry_type_enum">
12897 <li>
12898 <span class="entry_type_enum_name">OFF</span>
12899 </li>
12900 <li>
12901 <span class="entry_type_enum_name">ON</span>
12902 </li>
12903 </ul>
12904
12905 </td> <!-- entry_type -->
12906
12907 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12908 <p>Whether black-level compensation is locked
12909to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12910 </td>
12911
12912 <td class="entry_units">
12913 </td>
12914
12915 <td class="entry_range">
12916 </td>
12917
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12918 <td class="entry_tags">
12919 <ul class="entry_tags">
12920 <li><a href="#tag_HAL2">HAL2</a></li>
12921 </ul>
12922 </td>
12923
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12924 </tr>
12925 <tr class="entries_header">
12926 <th class="th_details" colspan="5">Details</th>
12927 </tr>
12928 <tr class="entry_cont">
12929 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12930 <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]12931ON 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]12932a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12933perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12934 </td>
12935 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12936
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12937 <tr class="entries_header">
12938 <th class="th_details" colspan="5">HAL Implementation Details</th>
12939 </tr>
12940 <tr class="entry_cont">
12941 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12942 <p>If for some reason black level locking is no longer possible
12943(for example,<wbr/> the analog gain has changed,<wbr/> which forces
12944black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12945override this request (and it must report 'OFF' when this
12946does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12947possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12948 </td>
12949 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12950
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12951 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12952 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12953
12954
12955
12956 <!-- end of kind -->
12957 </tbody>
12958
12959 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12960<!-- </namespace> -->
12961 </table>
12962
12963 <div class="tags" id="tag_index">
12964 <h2>Tags</h2>
12965 <ul>
12966 <li id="tag_AWB">AWB -
12967 Needed for auto white balance
12968
12969 <ul class="tags_entries">
12970 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
12971 </ul>
12972 </li> <!-- tag_AWB -->
12973 <li id="tag_BC">BC -
12974 Needed for backwards compatibility with old Java API
12975
12976 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame^]12977 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12978 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
12979 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
12980 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
12981 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
12982 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]12983 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12984 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
12985 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]12986 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12987 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
12988 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
12989 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
12990 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
12991 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
12992 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
12993 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
12994 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
12995 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
12996 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
12997 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
12998 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
12999 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
13000 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
13001 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
13002 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
13003 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
13004 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
13005 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
13006 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
13007 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
13008 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
13009 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
13010 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
13011 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
13012 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
13013 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
13014 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</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.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
13017 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
13018 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
13019 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
13020 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
13021 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
13022 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]13023 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13024 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
13025 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
13026 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13027 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13028 <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]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.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13032 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
13033 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
13034 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
13035 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
13036 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
13037 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
13038 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
13039 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
13040 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
13041 </ul>
13042 </li> <!-- tag_BC -->
13043 <li id="tag_V1">V1 -
13044 New features for first camera 2 release (API1)
13045
13046 <ul class="tags_entries">
13047 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13048 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13049 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13050 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13051 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13052 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13053 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13054 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13055 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13056 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13057 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13058 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13059 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13060 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13061 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13062 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13063 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13064 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13065 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13066 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13067 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13068 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13069 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13070 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13071 <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]13072 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13073 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13074 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13075 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13076 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13077 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13078 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13079 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13080 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13081 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13082 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13083 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13084 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13085 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13086 </ul>
13087 </li> <!-- tag_V1 -->
13088 <li id="tag_ADV">ADV - None
13089 <ul class="tags_entries">
13090 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13091 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13092 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13093 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13094 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13095 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13096 </ul>
13097 </li> <!-- tag_ADV -->
13098 <li id="tag_DNG">DNG -
13099 Needed for DNG file support
13100
13101 <ul class="tags_entries">
13102 <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]13103 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13104 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13105 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13106 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13107 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13108 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13109 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13110 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13111 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13112 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13113 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13114 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13115 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13116 </ul>
13117 </li> <!-- tag_DNG -->
13118 <li id="tag_EXIF">EXIF - None
13119 <ul class="tags_entries">
13120 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13121 </ul>
13122 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13123 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13124 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13125
13126 <ul class="tags_entries">
13127 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13128 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13129 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13130 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13131 </ul>
13132 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13133 <li id="tag_FULL">FULL -
13134 Entry is required for full hardware level devices, and optional for other hardware levels
13135
13136 <ul class="tags_entries">
13137 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13138 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13139 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13140 </ul>
13141 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13142 </ul>
13143 </div>
13144
13145 [ <a href="#">top</a> ]
13146
13147</body>
13148</html>