Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / 1b58d3818f2439a0e4c50dc0b8661e995bf29574 / . / camera / docs / docs.html
blob: 30eac353422db3ca47be00e7d02ced1e0a5bc628 [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>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]171 <li><a href="#dynamic_android.control.aeMode">android.control.aeMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]172 <li><a href="#dynamic_android.control.aeRegions">android.control.aeRegions</a></li>
173 <li><a href="#dynamic_android.control.aeState">android.control.aeState</a></li>
174 <li><a href="#dynamic_android.control.afMode">android.control.afMode</a></li>
175 <li><a href="#dynamic_android.control.afRegions">android.control.afRegions</a></li>
176 <li><a href="#dynamic_android.control.afState">android.control.afState</a></li>
177 <li><a href="#dynamic_android.control.afTriggerId">android.control.afTriggerId</a></li>
178 <li><a href="#dynamic_android.control.awbMode">android.control.awbMode</a></li>
179 <li><a href="#dynamic_android.control.awbRegions">android.control.awbRegions</a></li>
180 <li><a href="#dynamic_android.control.awbState">android.control.awbState</a></li>
181 <li><a href="#dynamic_android.control.mode">android.control.mode</a></li>
182 </ul>
183 </li>
184 </ul> <!-- toc_section -->
185 </li>
186 <li>
187 <span class="toc_section_header"><a href="#section_demosaic">demosaic</a></span>
188 <ul class="toc_section">
189 <li>
190 <span class="toc_kind_header">controls</span>
191 <ul class="toc_section">
192 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a></li>
193 </ul>
194 </li>
195 </ul> <!-- toc_section -->
196 </li>
197 <li>
198 <span class="toc_section_header"><a href="#section_edge">edge</a></span>
199 <ul class="toc_section">
200 <li>
201 <span class="toc_kind_header">controls</span>
202 <ul class="toc_section">
203 <li><a href="#controls_android.edge.mode">android.edge.mode</a></li>
204 <li><a href="#controls_android.edge.strength">android.edge.strength</a></li>
205 </ul>
206 </li>
207 <li>
208 <span class="toc_kind_header">dynamic</span>
209 <ul class="toc_section">
210 <li><a href="#dynamic_android.edge.mode">android.edge.mode</a></li>
211 </ul>
212 </li>
213 </ul> <!-- toc_section -->
214 </li>
215 <li>
216 <span class="toc_section_header"><a href="#section_flash">flash</a></span>
217 <ul class="toc_section">
218 <li>
219 <span class="toc_kind_header">controls</span>
220 <ul class="toc_section">
221 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a></li>
222 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a></li>
223 <li><a href="#controls_android.flash.mode">android.flash.mode</a></li>
224 </ul>
225 </li>
226 <li>
227 <span class="toc_kind_header">static</span>
228 <ul class="toc_section">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]229
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]230 <li><a href="#static_android.flash.info.available">android.flash.info.available</a></li>
231 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]232
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]233 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a></li>
234 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a></li>
235 </ul>
236 </li>
237 <li>
238 <span class="toc_kind_header">dynamic</span>
239 <ul class="toc_section">
240 <li><a href="#dynamic_android.flash.firingPower">android.flash.firingPower</a></li>
241 <li><a href="#dynamic_android.flash.firingTime">android.flash.firingTime</a></li>
242 <li><a href="#dynamic_android.flash.mode">android.flash.mode</a></li>
243 <li><a href="#dynamic_android.flash.state">android.flash.state</a></li>
244 </ul>
245 </li>
246 </ul> <!-- toc_section -->
247 </li>
248 <li>
249 <span class="toc_section_header"><a href="#section_geometric">geometric</a></span>
250 <ul class="toc_section">
251 <li>
252 <span class="toc_kind_header">controls</span>
253 <ul class="toc_section">
254 <li><a href="#controls_android.geometric.mode">android.geometric.mode</a></li>
255 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a></li>
256 </ul>
257 </li>
258 </ul> <!-- toc_section -->
259 </li>
260 <li>
261 <span class="toc_section_header"><a href="#section_hotPixel">hotPixel</a></span>
262 <ul class="toc_section">
263 <li>
264 <span class="toc_kind_header">controls</span>
265 <ul class="toc_section">
266 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a></li>
267 </ul>
268 </li>
269 <li>
270 <span class="toc_kind_header">static</span>
271 <ul class="toc_section">
272
273 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a></li>
274
275 </ul>
276 </li>
277 <li>
278 <span class="toc_kind_header">dynamic</span>
279 <ul class="toc_section">
280 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a></li>
281 </ul>
282 </li>
283 </ul> <!-- toc_section -->
284 </li>
285 <li>
286 <span class="toc_section_header"><a href="#section_jpeg">jpeg</a></span>
287 <ul class="toc_section">
288 <li>
289 <span class="toc_kind_header">controls</span>
290 <ul class="toc_section">
291 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
292 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
293 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
294 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a></li>
295 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a></li>
296 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
297 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
298 </ul>
299 </li>
300 <li>
301 <span class="toc_kind_header">static</span>
302 <ul class="toc_section">
303 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a></li>
304 <li><a href="#static_android.jpeg.maxSize">android.jpeg.maxSize</a></li>
305 </ul>
306 </li>
307 <li>
308 <span class="toc_kind_header">dynamic</span>
309 <ul class="toc_section">
310 <li><a href="#dynamic_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
311 <li><a href="#dynamic_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
312 <li><a href="#dynamic_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
313 <li><a href="#dynamic_android.jpeg.orientation">android.jpeg.orientation</a></li>
314 <li><a href="#dynamic_android.jpeg.quality">android.jpeg.quality</a></li>
315 <li><a href="#dynamic_android.jpeg.size">android.jpeg.size</a></li>
316 <li><a href="#dynamic_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
317 <li><a href="#dynamic_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
318 </ul>
319 </li>
320 </ul> <!-- toc_section -->
321 </li>
322 <li>
323 <span class="toc_section_header"><a href="#section_lens">lens</a></span>
324 <ul class="toc_section">
325 <li>
326 <span class="toc_kind_header">controls</span>
327 <ul class="toc_section">
328 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a></li>
329 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a></li>
330 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a></li>
331 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a></li>
332 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
333 </ul>
334 </li>
335 <li>
336 <span class="toc_kind_header">static</span>
337 <ul class="toc_section">
338
339 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a></li>
340 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a></li>
341 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a></li>
342 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a></li>
343 <li><a href="#static_android.lens.info.geometricCorrectionMap">android.lens.info.geometricCorrectionMap</a></li>
344 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a></li>
345 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a></li>
346 <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]347 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a></li>
348
349 <li><a href="#static_android.lens.facing">android.lens.facing</a></li>
350 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a></li>
351 <li><a href="#static_android.lens.position">android.lens.position</a></li>
352 </ul>
353 </li>
354 <li>
355 <span class="toc_kind_header">dynamic</span>
356 <ul class="toc_section">
357 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a></li>
358 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a></li>
359 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a></li>
360 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a></li>
361 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a></li>
362 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
363 <li><a href="#dynamic_android.lens.state">android.lens.state</a></li>
364 </ul>
365 </li>
366 </ul> <!-- toc_section -->
367 </li>
368 <li>
369 <span class="toc_section_header"><a href="#section_noiseReduction">noiseReduction</a></span>
370 <ul class="toc_section">
371 <li>
372 <span class="toc_kind_header">controls</span>
373 <ul class="toc_section">
374 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
375 <li><a href="#controls_android.noiseReduction.strength">android.noiseReduction.strength</a></li>
376 </ul>
377 </li>
378 <li>
379 <span class="toc_kind_header">dynamic</span>
380 <ul class="toc_section">
381 <li><a href="#dynamic_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
382 </ul>
383 </li>
384 </ul> <!-- toc_section -->
385 </li>
386 <li>
387 <span class="toc_section_header"><a href="#section_quirks">quirks</a></span>
388 <ul class="toc_section">
389 <li>
390 <span class="toc_kind_header">static</span>
391 <ul class="toc_section">
392 <li><a href="#static_android.quirks.meteringCropRegion">android.quirks.meteringCropRegion</a></li>
393 <li><a href="#static_android.quirks.triggerAfWithAuto">android.quirks.triggerAfWithAuto</a></li>
394 <li><a href="#static_android.quirks.useZslFormat">android.quirks.useZslFormat</a></li>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]395 <li><a href="#static_android.quirks.usePartialResult">android.quirks.usePartialResult</a></li>
396 </ul>
397 </li>
398 <li>
399 <span class="toc_kind_header">dynamic</span>
400 <ul class="toc_section">
401 <li><a href="#dynamic_android.quirks.partialResult">android.quirks.partialResult</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]402 </ul>
403 </li>
404 </ul> <!-- toc_section -->
405 </li>
406 <li>
407 <span class="toc_section_header"><a href="#section_request">request</a></span>
408 <ul class="toc_section">
409 <li>
410 <span class="toc_kind_header">controls</span>
411 <ul class="toc_section">
412 <li><a href="#controls_android.request.frameCount">android.request.frameCount</a></li>
413 <li><a href="#controls_android.request.id">android.request.id</a></li>
414 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a></li>
415 <li><a href="#controls_android.request.metadataMode">android.request.metadataMode</a></li>
416 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a></li>
417 <li><a href="#controls_android.request.type">android.request.type</a></li>
418 </ul>
419 </li>
420 <li>
421 <span class="toc_kind_header">static</span>
422 <ul class="toc_section">
423 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a></li>
424 <li><a href="#static_android.request.maxNumReprocessStreams">android.request.maxNumReprocessStreams</a></li>
425 </ul>
426 </li>
427 <li>
428 <span class="toc_kind_header">dynamic</span>
429 <ul class="toc_section">
430 <li><a href="#dynamic_android.request.frameCount">android.request.frameCount</a></li>
431 <li><a href="#dynamic_android.request.id">android.request.id</a></li>
432 <li><a href="#dynamic_android.request.metadataMode">android.request.metadataMode</a></li>
433 <li><a href="#dynamic_android.request.outputStreams">android.request.outputStreams</a></li>
434 </ul>
435 </li>
436 </ul> <!-- toc_section -->
437 </li>
438 <li>
439 <span class="toc_section_header"><a href="#section_scaler">scaler</a></span>
440 <ul class="toc_section">
441 <li>
442 <span class="toc_kind_header">controls</span>
443 <ul class="toc_section">
444 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
445 </ul>
446 </li>
447 <li>
448 <span class="toc_kind_header">static</span>
449 <ul class="toc_section">
450 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a></li>
451 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a></li>
452 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a></li>
453 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a></li>
454 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a></li>
455 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a></li>
456 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a></li>
457 <li><a href="#static_android.scaler.availableRawSizes">android.scaler.availableRawSizes</a></li>
458 </ul>
459 </li>
460 <li>
461 <span class="toc_kind_header">dynamic</span>
462 <ul class="toc_section">
463 <li><a href="#dynamic_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
464 </ul>
465 </li>
466 </ul> <!-- toc_section -->
467 </li>
468 <li>
469 <span class="toc_section_header"><a href="#section_sensor">sensor</a></span>
470 <ul class="toc_section">
471 <li>
472 <span class="toc_kind_header">controls</span>
473 <ul class="toc_section">
474 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
475 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
476 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
477 </ul>
478 </li>
479 <li>
480 <span class="toc_kind_header">static</span>
481 <ul class="toc_section">
482
483 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]484 <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]485 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a></li>
486 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a></li>
487 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a></li>
488 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a></li>
489 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a></li>
490 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a></li>
491
492 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a></li>
493 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a></li>
494 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a></li>
495 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a></li>
496 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a></li>
497 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a></li>
498 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a></li>
499 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a></li>
500 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a></li>
501 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a></li>
502 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a></li>
503 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a></li>
504 <li><a href="#static_android.sensor.referenceIlluminant2">android.sensor.referenceIlluminant2</a></li>
505 </ul>
506 </li>
507 <li>
508 <span class="toc_kind_header">dynamic</span>
509 <ul class="toc_section">
510 <li><a href="#dynamic_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
511 <li><a href="#dynamic_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
512 <li><a href="#dynamic_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
513 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a></li>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]514 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]515 </ul>
516 </li>
517 </ul> <!-- toc_section -->
518 </li>
519 <li>
520 <span class="toc_section_header"><a href="#section_shading">shading</a></span>
521 <ul class="toc_section">
522 <li>
523 <span class="toc_kind_header">controls</span>
524 <ul class="toc_section">
525 <li><a href="#controls_android.shading.mode">android.shading.mode</a></li>
526 <li><a href="#controls_android.shading.strength">android.shading.strength</a></li>
527 </ul>
528 </li>
529 <li>
530 <span class="toc_kind_header">dynamic</span>
531 <ul class="toc_section">
532 <li><a href="#dynamic_android.shading.mode">android.shading.mode</a></li>
533 </ul>
534 </li>
535 </ul> <!-- toc_section -->
536 </li>
537 <li>
538 <span class="toc_section_header"><a href="#section_statistics">statistics</a></span>
539 <ul class="toc_section">
540 <li>
541 <span class="toc_kind_header">controls</span>
542 <ul class="toc_section">
543 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
544 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
545 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]546 <li><a href="#controls_android.statistics.lensShadingMapMode">android.statistics.lensShadingMapMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]547 </ul>
548 </li>
549 <li>
550 <span class="toc_kind_header">static</span>
551 <ul class="toc_section">
552
553 <li><a href="#static_android.statistics.info.availableFaceDetectModes">android.statistics.info.availableFaceDetectModes</a></li>
554 <li><a href="#static_android.statistics.info.histogramBucketCount">android.statistics.info.histogramBucketCount</a></li>
555 <li><a href="#static_android.statistics.info.maxFaceCount">android.statistics.info.maxFaceCount</a></li>
556 <li><a href="#static_android.statistics.info.maxHistogramCount">android.statistics.info.maxHistogramCount</a></li>
557 <li><a href="#static_android.statistics.info.maxSharpnessMapValue">android.statistics.info.maxSharpnessMapValue</a></li>
558 <li><a href="#static_android.statistics.info.sharpnessMapSize">android.statistics.info.sharpnessMapSize</a></li>
559
560 </ul>
561 </li>
562 <li>
563 <span class="toc_kind_header">dynamic</span>
564 <ul class="toc_section">
565 <li><a href="#dynamic_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
566 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a></li>
567 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a></li>
568 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a></li>
569 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a></li>
570 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a></li>
571 <li><a href="#dynamic_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
572 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a></li>
573 <li><a href="#dynamic_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]574 <li><a href="#dynamic_android.statistics.lensShadingMap">android.statistics.lensShadingMap</a></li>
575 <li><a href="#dynamic_android.statistics.predictedColorGains">android.statistics.predictedColorGains</a></li>
576 <li><a href="#dynamic_android.statistics.predictedColorTransform">android.statistics.predictedColorTransform</a></li>
577 <li><a href="#dynamic_android.statistics.sceneFlicker">android.statistics.sceneFlicker</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]578 </ul>
579 </li>
580 </ul> <!-- toc_section -->
581 </li>
582 <li>
583 <span class="toc_section_header"><a href="#section_tonemap">tonemap</a></span>
584 <ul class="toc_section">
585 <li>
586 <span class="toc_kind_header">controls</span>
587 <ul class="toc_section">
588 <li><a href="#controls_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
589 <li><a href="#controls_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
590 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
591 <li><a href="#controls_android.tonemap.mode">android.tonemap.mode</a></li>
592 </ul>
593 </li>
594 <li>
595 <span class="toc_kind_header">static</span>
596 <ul class="toc_section">
597 <li><a href="#static_android.tonemap.maxCurvePoints">android.tonemap.maxCurvePoints</a></li>
598 </ul>
599 </li>
600 <li>
601 <span class="toc_kind_header">dynamic</span>
602 <ul class="toc_section">
603 <li><a href="#dynamic_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
604 <li><a href="#dynamic_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
605 <li><a href="#dynamic_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
606 <li><a href="#dynamic_android.tonemap.mode">android.tonemap.mode</a></li>
607 </ul>
608 </li>
609 </ul> <!-- toc_section -->
610 </li>
611 <li>
612 <span class="toc_section_header"><a href="#section_led">led</a></span>
613 <ul class="toc_section">
614 <li>
615 <span class="toc_kind_header">controls</span>
616 <ul class="toc_section">
617 <li><a href="#controls_android.led.transmit">android.led.transmit</a></li>
618 </ul>
619 </li>
620 <li>
621 <span class="toc_kind_header">dynamic</span>
622 <ul class="toc_section">
623 <li><a href="#dynamic_android.led.transmit">android.led.transmit</a></li>
624 </ul>
625 </li>
626 <li>
627 <span class="toc_kind_header">static</span>
628 <ul class="toc_section">
629 <li><a href="#static_android.led.availableLeds">android.led.availableLeds</a></li>
630 </ul>
631 </li>
632 </ul> <!-- toc_section -->
633 </li>
634 <li>
635 <span class="toc_section_header"><a href="#section_info">info</a></span>
636 <ul class="toc_section">
637 <li>
638 <span class="toc_kind_header">static</span>
639 <ul class="toc_section">
640 <li><a href="#static_android.info.supportedHardwareLevel">android.info.supportedHardwareLevel</a></li>
641 </ul>
642 </li>
643 </ul> <!-- toc_section -->
644 </li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]645 <li>
646 <span class="toc_section_header"><a href="#section_blackLevel">blackLevel</a></span>
647 <ul class="toc_section">
648 <li>
649 <span class="toc_kind_header">controls</span>
650 <ul class="toc_section">
651 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a></li>
652 </ul>
653 </li>
654 <li>
655 <span class="toc_kind_header">dynamic</span>
656 <ul class="toc_section">
657 <li><a href="#dynamic_android.blackLevel.lock">android.blackLevel.lock</a></li>
658 </ul>
659 </li>
660 </ul> <!-- toc_section -->
661 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]662 </ul>
663
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]664
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]665 <h1>Properties</h1>
666 <table class="properties">
667
668 <thead class="thead_dummy">
669 <tr>
670 <th class="th_name">Property Name</th>
671 <th class="th_type">Type</th>
672 <th class="th_description">Description</th>
673 <th class="th_units">Units</th>
674 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]675 <th class="th_tags">Tags</th>
676 </tr>
677 </thead> <!-- so that the first occurrence of thead is not
678 above the first occurrence of tr -->
679<!-- <namespace name="android"> -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]680 <tr><td colspan="6" id="section_colorCorrection" class="section">colorCorrection</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]681
682
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]683 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]684
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]685 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]686 <tr>
687 <th class="th_name">Property Name</th>
688 <th class="th_type">Type</th>
689 <th class="th_description">Description</th>
690 <th class="th_units">Units</th>
691 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]692 <th class="th_tags">Tags</th>
693 </tr>
694 </thead>
695
696 <tbody>
697
698
699
700
701
702
703
704
705
706
707 <tr class="entry" id="controls_android.colorCorrection.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]708 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]709 android.<wbr/>color<wbr/>Correction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]710 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]711 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]712 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]713
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]714 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]715
716 <ul class="entry_type_enum">
717 <li>
718 <span class="entry_type_enum_name">TRANSFORM_MATRIX</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]719 <span class="entry_type_enum_notes">Use the android.<wbr/>color<wbr/>Correction.<wbr/>transform matrix
720 and android.<wbr/>color<wbr/>Correction.<wbr/>gains to do color conversion</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]721 </li>
722 <li>
723 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]724 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
725 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]726 </li>
727 <li>
728 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]729 <span class="entry_type_enum_notes">Frame rate may be reduced by high
730 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]731 </li>
732 </ul>
733
734 </td> <!-- entry_type -->
735
736 <td class="entry_description">
737 </td>
738
739 <td class="entry_units">
740 </td>
741
742 <td class="entry_range">
743 </td>
744
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]745 <td class="entry_tags">
746 </td>
747
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]748 </tr>
749 <tr class="entries_header">
750 <th class="th_details" colspan="5">Details</th>
751 </tr>
752 <tr class="entry_cont">
753 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]754 <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]755should be ignored.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]756 </td>
757 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]758
759
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]760 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
761 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]762
763
764 <tr class="entry" id="controls_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]765 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]766 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]767 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]768 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]769 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]770 <span class="entry_type_container">x</span>
771
772 <span class="entry_type_array">
773 3 x 3
774 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]775 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]776 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]777
778
779 </td> <!-- entry_type -->
780
781 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]782 <p>A color transform matrix to use to transform
783from sensor RGB color space to output linear sRGB color space</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]784 </td>
785
786 <td class="entry_units">
787 </td>
788
789 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]790 <p>Output values are expected to be in the range
791(0,<wbr/>1)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]792 </td>
793
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]794 <td class="entry_tags">
795 </td>
796
797 </tr>
798 <tr class="entries_header">
799 <th class="th_details" colspan="5">Details</th>
800 </tr>
801 <tr class="entry_cont">
802 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]803 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]804<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]805directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]806<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]807<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]808for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]809reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]810 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]811 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]812
813
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]814 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
815 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]816
817
818 <tr class="entry" id="controls_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]819 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]820 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]821 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]822 <td class="entry_type">
823 <span class="entry_type_name">float</span>
824 <span class="entry_type_container">x</span>
825
826 <span class="entry_type_array">
827 4
828 </span>
829 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]830 <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]831
832
833 </td> <!-- entry_type -->
834
835 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]836 <p>Gains applying to Bayer color channels for
837white-balance</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]838 </td>
839
840 <td class="entry_units">
841 </td>
842
843 <td class="entry_range">
844 </td>
845
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]846 <td class="entry_tags">
847 </td>
848
849 </tr>
850 <tr class="entries_header">
851 <th class="th_details" colspan="5">Details</th>
852 </tr>
853 <tr class="entry_cont">
854 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]855 <p>The 4-channel white-balance gains are defined in
856the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
857for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
858is the gain for greenpixels on the odd rows.<wbr/> if a HAL
859does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
860it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
861G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]862<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]863<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]864directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]865<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]866<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]867the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]868 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]869 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]870
871
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]872 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
873 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]874
875
876
877 <!-- end of kind -->
878 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]879 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]880
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]881 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]882 <tr>
883 <th class="th_name">Property Name</th>
884 <th class="th_type">Type</th>
885 <th class="th_description">Description</th>
886 <th class="th_units">Units</th>
887 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]888 <th class="th_tags">Tags</th>
889 </tr>
890 </thead>
891
892 <tbody>
893
894
895
896
897
898
899
900
901
902
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]903 <tr class="entry" id="dynamic_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]904 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]905 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]906 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]907 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]908 <span class="entry_type_name">rational</span>
909 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]910
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]911 <span class="entry_type_array">
912 3 x 3
913 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]914 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]915 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]916
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]917
918 </td> <!-- entry_type -->
919
920 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]921 <p>A color transform matrix to use to transform
922from sensor RGB color space to output linear sRGB color space</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]923 </td>
924
925 <td class="entry_units">
926 </td>
927
928 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]929 <p>Output values are expected to be in the range
930(0,<wbr/>1)</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]931 </td>
932
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]933 <td class="entry_tags">
934 </td>
935
936 </tr>
937 <tr class="entries_header">
938 <th class="th_details" colspan="5">Details</th>
939 </tr>
940 <tr class="entry_cont">
941 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]942 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]943<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]944directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]945<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]946<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]947for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]948reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]949 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]950 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]951
952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]953 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
954 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]955
956
957 <tr class="entry" id="dynamic_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]958 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]959 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]960 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]961 <td class="entry_type">
962 <span class="entry_type_name">float</span>
963 <span class="entry_type_container">x</span>
964
965 <span class="entry_type_array">
966 4
967 </span>
968 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]969 <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]970
971
972 </td> <!-- entry_type -->
973
974 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]975 <p>Gains applying to Bayer color channels for
976white-balance</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]977 </td>
978
979 <td class="entry_units">
980 </td>
981
982 <td class="entry_range">
983 </td>
984
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]985 <td class="entry_tags">
986 </td>
987
988 </tr>
989 <tr class="entries_header">
990 <th class="th_details" colspan="5">Details</th>
991 </tr>
992 <tr class="entry_cont">
993 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]994 <p>The 4-channel white-balance gains are defined in
995the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
996for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
997is the gain for greenpixels on the odd rows.<wbr/> if a HAL
998does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
999it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
1000G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1001<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1002<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]1003directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1004<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]1005<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1006the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1007 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1008 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1009
1010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1011 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1012 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1013
1014
1015
1016 <!-- end of kind -->
1017 </tbody>
1018
1019 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1020 <tr><td colspan="6" id="section_control" class="section">control</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1021
1022
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1023 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1024
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1025 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1026 <tr>
1027 <th class="th_name">Property Name</th>
1028 <th class="th_type">Type</th>
1029 <th class="th_description">Description</th>
1030 <th class="th_units">Units</th>
1031 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1032 <th class="th_tags">Tags</th>
1033 </tr>
1034 </thead>
1035
1036 <tbody>
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047 <tr class="entry" id="controls_android.control.aeAntibandingMode">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1048 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1049 android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1050 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1051 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1052 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1053
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1054 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1055
1056 <ul class="entry_type_enum">
1057 <li>
1058 <span class="entry_type_enum_name">OFF</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1059 <span class="entry_type_enum_notes">
1060 The camera device will not adjust exposure duration to
1061 avoid banding problems.<wbr/>
1062 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1063 </li>
1064 <li>
1065 <span class="entry_type_enum_name">50HZ</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1066 <span class="entry_type_enum_notes">
1067 The camera device will adjust exposure duration to
1068 avoid banding problems with 50Hz illumination sources.<wbr/>
1069 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1070 </li>
1071 <li>
1072 <span class="entry_type_enum_name">60HZ</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1073 <span class="entry_type_enum_notes">
1074 The camera device will adjust exposure duration to
1075 avoid banding problems with 60Hz illumination
1076 sources.<wbr/>
1077 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1078 </li>
1079 <li>
1080 <span class="entry_type_enum_name">AUTO</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1081 <span class="entry_type_enum_notes">
1082 The camera device will automatically adapt its
1083 antibanding routine to the current illumination
1084 conditions.<wbr/> This is the default.<wbr/>
1085 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1086 </li>
1087 </ul>
1088
1089 </td> <!-- entry_type -->
1090
1091 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1092 <p>The desired setting for the camera device's auto-exposure
1093algorithm's antibanding compensation.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1094 </td>
1095
1096 <td class="entry_units">
1097 </td>
1098
1099 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1100 <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]1101 </td>
1102
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1103 <td class="entry_tags">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1104 <ul class="entry_tags">
1105 <li><a href="#tag_BC">BC</a></li>
1106 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1107 </td>
1108
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1109 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1110 <tr class="entries_header">
1111 <th class="th_details" colspan="5">Details</th>
1112 </tr>
1113 <tr class="entry_cont">
1114 <td class="entry_details" colspan="5">
1115 <p>Some kinds of lighting fixtures,<wbr/> such as some fluorescent
1116lights,<wbr/> flicker at the rate of the power supply frequency
1117(60Hz or 50Hz,<wbr/> depending on country).<wbr/> While this is
1118typically not noticeable to a person,<wbr/> it can be visible to
1119a camera device.<wbr/> If a camera sets its exposure time to the
1120wrong value,<wbr/> the flicker may become visible in the
1121viewfinder as flicker or in a final captured image,<wbr/> as a
1122set of variable-brightness bands across the image.<wbr/></p>
1123<p>Therefore,<wbr/> the auto-exposure routines of camera devices
1124include antibanding routines that ensure that the chosen
1125exposure value will not cause such banding.<wbr/> The choice of
1126exposure time depends on the rate of flicker,<wbr/> which the
1127camera device can detect automatically,<wbr/> or the expected
1128rate can be selected by the application using this
1129control.<wbr/></p>
1130<p>A given camera device may not support all of the possible
1131options for the antibanding mode.<wbr/> The
1132<a href="#static_android.control.aeAvailableAntibandingModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes</a> key contains
1133the available modes for a given camera device.<wbr/></p>
1134<p>The default mode is AUTO,<wbr/> which must be supported by all
1135camera devices.<wbr/></p>
1136<p>If manual exposure control is enabled (by setting
1137<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/>
1138then this setting has no effect,<wbr/> and the application must
1139ensure it selects exposure times that do not cause banding
1140issues.<wbr/> The <a href="#dynamic_android.statistics.sceneFlicker">android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker</a> key can assist
1141the application in this.<wbr/></p>
1142 </td>
1143 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1144
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1145 <tr class="entries_header">
1146 <th class="th_details" colspan="5">HAL Implementation Details</th>
1147 </tr>
1148 <tr class="entry_cont">
1149 <td class="entry_details" colspan="5">
1150 <p>For all capture request templates,<wbr/> this field must be set
1151to AUTO.<wbr/> AUTO is the only mode that must supported;
1152OFF,<wbr/> 50HZ,<wbr/> 60HZ are all optional.<wbr/></p>
1153<p>If manual exposure control is enabled (by setting
1154<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/>
1155then the exposure values provided by the application must not be
1156adjusted for antibanding.<wbr/></p>
1157 </td>
1158 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1160 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1161 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1162
1163
1164 <tr class="entry" id="controls_android.control.aeExposureCompensation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1165 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1166 android.<wbr/>control.<wbr/>ae<wbr/>Exposure<wbr/>Compensation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1167 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1168 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1169 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1170
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1171 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1172
1173
1174 </td> <!-- entry_type -->
1175
1176 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1177 <p>Adjustment to AE target image
1178brightness</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1179 </td>
1180
1181 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1182 count of positive/<wbr/>negative EV steps
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1183 </td>
1184
1185 <td class="entry_range">
1186 </td>
1187
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1188 <td class="entry_tags">
1189 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1190 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1191 </ul>
1192 </td>
1193
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1194 </tr>
1195 <tr class="entries_header">
1196 <th class="th_details" colspan="5">Details</th>
1197 </tr>
1198 <tr class="entry_cont">
1199 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1200 <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]1201exposure compensation of +2 EV; -3 will mean an exposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1202compensation of -1</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1203 </td>
1204 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1205
1206
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1207 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1208 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1209
1210
1211 <tr class="entry" id="controls_android.control.aeLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1212 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1213 android.<wbr/>control.<wbr/>ae<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1214 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1215 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1216 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1217
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1218 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1219
1220 <ul class="entry_type_enum">
1221 <li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1222 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1223 <span class="entry_type_enum_notes">Autoexposure lock is disabled; the AE algorithm
1224 is free to update its parameters.<wbr/></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1225 </li>
1226 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1227 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1228 <span class="entry_type_enum_notes">Autoexposure lock is enabled; the AE algorithm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1229 must not update the exposure and sensitivity parameters
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1230 while the lock is active</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1231 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1232 </ul>
1233
1234 </td> <!-- entry_type -->
1235
1236 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1237 <p>Whether AE is currently locked to its latest
1238calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1239 </td>
1240
1241 <td class="entry_units">
1242 </td>
1243
1244 <td class="entry_range">
1245 </td>
1246
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1247 <td class="entry_tags">
1248 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1249 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1250 </ul>
1251 </td>
1252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1253 </tr>
1254 <tr class="entries_header">
1255 <th class="th_details" colspan="5">Details</th>
1256 </tr>
1257 <tr class="entry_cont">
1258 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1259 <p>Note that even when AE is locked,<wbr/> the flash may be
1260fired if the AE mode is ON_<wbr/>AUTO_<wbr/>FLASH /<wbr/> ON_<wbr/>ALWAYS_<wbr/>FLASH /<wbr/>
1261ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1262 </td>
1263 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1264
1265
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1266 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1267 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1268
1269
1270 <tr class="entry" id="controls_android.control.aeMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1271 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1272 android.<wbr/>control.<wbr/>ae<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1273 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1274 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1275 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1276
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1277 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1278
1279 <ul class="entry_type_enum">
1280 <li>
1281 <span class="entry_type_enum_name">OFF</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1282 <span class="entry_type_enum_notes">
1283 The camera device's autoexposure routine is disabled;
1284 the application-selected android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
1285 android.<wbr/>sensor.<wbr/>sensitivity and
1286 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are used by the camera
1287 device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
1288 a flash unit for this camera device.<wbr/>
1289 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1290 </li>
1291 <li>
1292 <span class="entry_type_enum_name">ON</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1293 <span class="entry_type_enum_notes">
1294 The camera device's autoexposure routine is active,<wbr/>
1295 with no flash control.<wbr/> The application's values for
1296 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
1297 android.<wbr/>sensor.<wbr/>sensitivity,<wbr/> and
1298 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are ignored.<wbr/> The
1299 application has control over the various
1300 android.<wbr/>flash.<wbr/>* fields.<wbr/>
1301 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1302 </li>
1303 <li>
1304 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1305 <span class="entry_type_enum_notes">
1306 Like ON,<wbr/> except that the camera device also controls
1307 the camera's flash unit,<wbr/> firing it in low-light
1308 conditions.<wbr/> The flash may be fired during a
1309 precapture sequence (triggered by
1310 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and may be fired
1311 for captures for which the
1312 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
1313 STILL_<wbr/>CAPTURE
1314 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1315 </li>
1316 <li>
1317 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1318 <span class="entry_type_enum_notes">
1319 Like ON,<wbr/> except that the camera device also controls
1320 the camera's flash unit,<wbr/> always firing it for still
1321 captures.<wbr/> The flash may be fired during a precapture
1322 sequence (triggered by
1323 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and will always
1324 be fired for captures for which the
1325 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
1326 STILL_<wbr/>CAPTURE
1327 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1328 </li>
1329 <li>
1330 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1331 <span class="entry_type_enum_notes">
1332 Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
1333 reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
1334 a red eye reduction flash will fire during the
1335 precapture sequence.<wbr/>
1336 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1337 </li>
1338 </ul>
1339
1340 </td> <!-- entry_type -->
1341
1342 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1343 <p>The desired mode for the camera device's
1344auto-exposure routine.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1345 </td>
1346
1347 <td class="entry_units">
1348 </td>
1349
1350 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1351 <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]1352 </td>
1353
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1354 <td class="entry_tags">
1355 <ul class="entry_tags">
1356 <li><a href="#tag_BC">BC</a></li>
1357 </ul>
1358 </td>
1359
1360 </tr>
1361 <tr class="entries_header">
1362 <th class="th_details" colspan="5">Details</th>
1363 </tr>
1364 <tr class="entry_cont">
1365 <td class="entry_details" colspan="5">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1366 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
1367AUTO.<wbr/></p>
1368<p>When set to any of the ON modes,<wbr/> the camera device's
1369auto-exposure routine is enabled,<wbr/> overriding the
1370application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
1371and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1372<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
1373<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
1374is selected,<wbr/> the camera device's flash unit controls are
1375also overridden.<wbr/></p>
1376<p>The FLASH modes are only available if the camera device
1377has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
1378<p>If flash TORCH mode is desired,<wbr/> this field must be set to
1379ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
1380<p>When set to any of the ON modes,<wbr/> the values chosen by the
1381camera device auto-exposure routine for the overridden
1382fields for a given capture will be available in its
1383CaptureResult.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1384 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1385 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1386
1387
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1388 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1389 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1390
1391
1392 <tr class="entry" id="controls_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1393 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1394 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1395 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1396 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1397 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1398 <span class="entry_type_container">x</span>
1399
1400 <span class="entry_type_array">
1401 5 x area_count
1402 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1403 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1404
1405
1406 </td> <!-- entry_type -->
1407
1408 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1409 <p>List of areas to use for
1410metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1411 </td>
1412
1413 <td class="entry_units">
1414 </td>
1415
1416 <td class="entry_range">
1417 </td>
1418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1419 <td class="entry_tags">
1420 <ul class="entry_tags">
1421 <li><a href="#tag_BC">BC</a></li>
1422 </ul>
1423 </td>
1424
1425 </tr>
1426 <tr class="entries_header">
1427 <th class="th_details" colspan="5">Details</th>
1428 </tr>
1429 <tr class="entry_cont">
1430 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1431 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1432xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1433specified coordinates.<wbr/></p>
1434<p>The coordinate system is based on the active pixel array,<wbr/>
1435with (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]1436(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1437<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]1438bottom-right pixel in the active pixel array.<wbr/> The weight
1439should be nonnegative.<wbr/></p>
1440<p>If all regions have 0 weight,<wbr/> then no specific metering area
1441needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1442outside 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]1443should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1444used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1445 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1446 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1447
1448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1449 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1450 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1451
1452
1453 <tr class="entry" id="controls_android.control.aeTargetFpsRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1454 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1455 android.<wbr/>control.<wbr/>ae<wbr/>Target<wbr/>Fps<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1456 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1457 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1458 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1459 <span class="entry_type_container">x</span>
1460
1461 <span class="entry_type_array">
1462 2
1463 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1464 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1465
1466
1467 </td> <!-- entry_type -->
1468
1469 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1470 <p>Range over which fps can be adjusted to
1471maintain exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1472 </td>
1473
1474 <td class="entry_units">
1475 </td>
1476
1477 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1478 <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]1479 </td>
1480
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1481 <td class="entry_tags">
1482 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1483 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1484 </ul>
1485 </td>
1486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1487 </tr>
1488 <tr class="entries_header">
1489 <th class="th_details" colspan="5">Details</th>
1490 </tr>
1491 <tr class="entry_cont">
1492 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1493 <p>Only constrains AE algorithm,<wbr/> not manual control
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1494of <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]1495 </td>
1496 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1497
1498
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1499 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1500 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1501
1502
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1503 <tr class="entry" id="controls_android.control.aePrecaptureTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1504 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1505 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1506 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1507 <td class="entry_type">
1508 <span class="entry_type_name entry_type_name_enum">byte</span>
1509
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1510 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1511
1512 <ul class="entry_type_enum">
1513 <li>
1514 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1515 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1516 </li>
1517 <li>
1518 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1519 <span class="entry_type_enum_notes">The precapture metering sequence
1520 must be started.<wbr/> The exact effect of the precapture
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1521 trigger depends on the current AE mode and
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1522 state.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1523 </li>
1524 </ul>
1525
1526 </td> <!-- entry_type -->
1527
1528 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1529 <p>Whether the HAL must trigger precapture
1530metering.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1531 </td>
1532
1533 <td class="entry_units">
1534 </td>
1535
1536 <td class="entry_range">
1537 </td>
1538
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1539 <td class="entry_tags">
1540 <ul class="entry_tags">
1541 <li><a href="#tag_BC">BC</a></li>
1542 </ul>
1543 </td>
1544
1545 </tr>
1546 <tr class="entries_header">
1547 <th class="th_details" colspan="5">Details</th>
1548 </tr>
1549 <tr class="entry_cont">
1550 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1551 <p>This entry is normally set to IDLE,<wbr/> or is not
1552included at all in the request settings.<wbr/> When included and
1553set to START,<wbr/> the HAL must trigger the autoexposure
1554precapture metering sequence.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1555<p>The effect of AE precapture trigger depends on the current
1556AE mode and state; see the camera HAL device v3 header for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1557details.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1558 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1559 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1560
1561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1562 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1563 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1564
1565
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1566 <tr class="entry" id="controls_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1567 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1568 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1569 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1570 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1571 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1572
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1573 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1574
1575 <ul class="entry_type_enum">
1576 <li>
1577 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1578 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
1579 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
1580 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1581 </li>
1582 <li>
1583 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1584 <span class="entry_type_enum_notes">
1585 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1586
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1587 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
1588 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
1589 the autofocus trigger action is called.<wbr/> When that trigger
1590 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
1591 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1592
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1593 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
1594 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1595 </li>
1596 <li>
1597 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1598 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
1599 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1600
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1601 When that trigger is activated,<wbr/> AF must transition to
1602 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
1603 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
1604 position to default,<wbr/> and sets the AF state to
1605 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1606 </li>
1607 <li>
1608 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1609 <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]1610 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1611 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1612
1613 The focusing behavior should be suitable for good quality
1614 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1615 movement and no overshoots.<wbr/> When the AF trigger is not
1616 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
1617 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
1618 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1619 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1620 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1621 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1622
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1623 Once cancel is received,<wbr/> the algorithm should transition
1624 back to INACTIVE and resume passive scan.<wbr/> Note that this
1625 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
1626 ongoing PASSIVE_<wbr/>SCAN must immediately be
1627 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1628 </li>
1629 <li>
1630 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1631 <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]1632 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1633 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1634
1635 The focusing behavior should be suitable for still image
1636 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1637 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
1638 algorithm should start in INACTIVE state,<wbr/> and then
1639 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
1640 appropriate as it attempts to maintain focus.<wbr/> When the AF
1641 trigger is activated,<wbr/> the algorithm should finish its
1642 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
1643 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1644 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1645
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1646 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1647 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1648 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1649 </li>
1650 <li>
1651 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1652 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
1653 trigger is ignored,<wbr/> AF state should always be
1654 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1655 </li>
1656 </ul>
1657
1658 </td> <!-- entry_type -->
1659
1660 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1661 <p>Whether AF is currently enabled,<wbr/> and what
1662mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1663 </td>
1664
1665 <td class="entry_units">
1666 </td>
1667
1668 <td class="entry_range">
1669 </td>
1670
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1671 <td class="entry_tags">
1672 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1673 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1674 </ul>
1675 </td>
1676
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1677 </tr>
1678 <tr class="entries_header">
1679 <th class="th_details" colspan="5">Details</th>
1680 </tr>
1681 <tr class="entry_cont">
1682 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1683 <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]1684<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]1685report 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]1686result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1687 </td>
1688 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1689
1690
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1691 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1692 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1693
1694
1695 <tr class="entry" id="controls_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1696 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1697 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1698 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1699 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1700 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1701 <span class="entry_type_container">x</span>
1702
1703 <span class="entry_type_array">
1704 5 x area_count
1705 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1706 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1707
1708
1709 </td> <!-- entry_type -->
1710
1711 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1712 <p>List of areas to use for focus
1713estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1714 </td>
1715
1716 <td class="entry_units">
1717 </td>
1718
1719 <td class="entry_range">
1720 </td>
1721
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1722 <td class="entry_tags">
1723 <ul class="entry_tags">
1724 <li><a href="#tag_BC">BC</a></li>
1725 </ul>
1726 </td>
1727
1728 </tr>
1729 <tr class="entries_header">
1730 <th class="th_details" colspan="5">Details</th>
1731 </tr>
1732 <tr class="entry_cont">
1733 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1734 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1735xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1736specified coordinates.<wbr/></p>
1737<p>The coordinate system is based on the active pixel array,<wbr/>
1738with (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]1739(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1740<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]1741bottom-right pixel in the active pixel array.<wbr/> The weight
1742should be nonnegative.<wbr/></p>
1743<p>If all regions have 0 weight,<wbr/> then no specific focus area
1744needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1745outside 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]1746should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1747used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1748 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1749 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1750
1751
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1752 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1753 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1754
1755
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1756 <tr class="entry" id="controls_android.control.afTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1757 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1758 android.<wbr/>control.<wbr/>af<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1759 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1760 <td class="entry_type">
1761 <span class="entry_type_name entry_type_name_enum">byte</span>
1762
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1763 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1764
1765 <ul class="entry_type_enum">
1766 <li>
1767 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1768 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1769 </li>
1770 <li>
1771 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1772 <span class="entry_type_enum_notes">Autofocus must trigger now.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1773 </li>
1774 <li>
1775 <span class="entry_type_enum_name">CANCEL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1776 <span class="entry_type_enum_notes">Autofocus must return to initial
1777 state,<wbr/> and cancel any active trigger.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1778 </li>
1779 </ul>
1780
1781 </td> <!-- entry_type -->
1782
1783 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1784 <p>Whether the HAL must trigger autofocus.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1785 </td>
1786
1787 <td class="entry_units">
1788 </td>
1789
1790 <td class="entry_range">
1791 </td>
1792
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1793 <td class="entry_tags">
1794 <ul class="entry_tags">
1795 <li><a href="#tag_BC">BC</a></li>
1796 </ul>
1797 </td>
1798
1799 </tr>
1800 <tr class="entries_header">
1801 <th class="th_details" colspan="5">Details</th>
1802 </tr>
1803 <tr class="entry_cont">
1804 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1805 <p>This entry is normally set to IDLE,<wbr/> or is not
1806included at all in the request settings.<wbr/></p>
1807<p>When included and set to START,<wbr/> the HAL must trigger the
1808autofocus algorithm.<wbr/> The effect of AF trigger depends on the
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1809current AF mode and state; see the camera HAL device v3
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1810header for details.<wbr/> When set to CANCEL,<wbr/> the HAL must cancel
1811any active trigger,<wbr/> and return to initial AF state.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1812 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1813 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1814
1815
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1816 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1817 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1818
1819
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1820 <tr class="entry" id="controls_android.control.awbLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1821 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1822 android.<wbr/>control.<wbr/>awb<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1823 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1824 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1825 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1826
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1827 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1828
1829 <ul class="entry_type_enum">
1830 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1831 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1832 <span class="entry_type_enum_notes">Auto-whitebalance lock is disabled; the AWB
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1833 algorithm is free to update its parameters if in AUTO
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1834 mode.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1835 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1836 <li>
1837 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1838 <span class="entry_type_enum_notes">Auto-whitebalance lock is enabled; the AWB
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1839 algorithm must not update the exposure and sensitivity
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1840 parameters while the lock is active</span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1841 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1842 </ul>
1843
1844 </td> <!-- entry_type -->
1845
1846 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1847 <p>Whether AWB is currently locked to its
1848latest calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1849 </td>
1850
1851 <td class="entry_units">
1852 </td>
1853
1854 <td class="entry_range">
1855 </td>
1856
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1857 <td class="entry_tags">
1858 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1859 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1860 </ul>
1861 </td>
1862
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1863 </tr>
1864 <tr class="entries_header">
1865 <th class="th_details" colspan="5">Details</th>
1866 </tr>
1867 <tr class="entry_cont">
1868 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1869 <p>Note that AWB lock is only meaningful for AUTO
1870mode; in other modes,<wbr/> AWB is already fixed to a specific
1871setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1872 </td>
1873 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1874
1875
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1876 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1877 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1878
1879
1880 <tr class="entry" id="controls_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1881 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1882 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1883 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1884 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1885 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1886
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1887 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1888
1889 <ul class="entry_type_enum">
1890 <li>
1891 <span class="entry_type_enum_name">OFF</span>
1892 </li>
1893 <li>
1894 <span class="entry_type_enum_name">AUTO</span>
1895 </li>
1896 <li>
1897 <span class="entry_type_enum_name">INCANDESCENT</span>
1898 </li>
1899 <li>
1900 <span class="entry_type_enum_name">FLUORESCENT</span>
1901 </li>
1902 <li>
1903 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
1904 </li>
1905 <li>
1906 <span class="entry_type_enum_name">DAYLIGHT</span>
1907 </li>
1908 <li>
1909 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
1910 </li>
1911 <li>
1912 <span class="entry_type_enum_name">TWILIGHT</span>
1913 </li>
1914 <li>
1915 <span class="entry_type_enum_name">SHADE</span>
1916 </li>
1917 </ul>
1918
1919 </td> <!-- entry_type -->
1920
1921 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1922 <p>Whether AWB is currently setting the color
1923transform fields,<wbr/> and what its illumination target
1924is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1925 </td>
1926
1927 <td class="entry_units">
1928 </td>
1929
1930 <td class="entry_range">
1931 </td>
1932
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1933 <td class="entry_tags">
1934 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1935 <li><a href="#tag_BC">BC</a></li>
1936 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1937 </ul>
1938 </td>
1939
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1940 </tr>
1941 <tr class="entries_header">
1942 <th class="th_details" colspan="5">Details</th>
1943 </tr>
1944 <tr class="entry_cont">
1945 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1946 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1947<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]1948 </td>
1949 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1950
1951
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1952 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1953 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1954
1955
1956 <tr class="entry" id="controls_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1957 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1958 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1959 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1960 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1961 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1962 <span class="entry_type_container">x</span>
1963
1964 <span class="entry_type_array">
1965 5 x area_count
1966 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1967 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1968
1969
1970 </td> <!-- entry_type -->
1971
1972 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1973 <p>List of areas to use for illuminant
1974estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1975 </td>
1976
1977 <td class="entry_units">
1978 </td>
1979
1980 <td class="entry_range">
1981 </td>
1982
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1983 <td class="entry_tags">
1984 <ul class="entry_tags">
1985 <li><a href="#tag_BC">BC</a></li>
1986 </ul>
1987 </td>
1988
1989 </tr>
1990 <tr class="entries_header">
1991 <th class="th_details" colspan="5">Details</th>
1992 </tr>
1993 <tr class="entry_cont">
1994 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1995 <p>Only used in AUTO mode.<wbr/></p>
1996<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1997xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1998specified coordinates.<wbr/></p>
1999<p>The coordinate system is based on the active pixel array,<wbr/>
2000with (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]2001(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
2002<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]2003bottom-right pixel in the active pixel array.<wbr/> The weight
2004should be nonnegative.<wbr/></p>
2005<p>If all regions have 0 weight,<wbr/> then no specific metering area
2006needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2007outside 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]2008should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2009used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2010 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2011 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2012
2013
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2014 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2015 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2016
2017
2018 <tr class="entry" id="controls_android.control.captureIntent">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2019 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2020 android.<wbr/>control.<wbr/>capture<wbr/>Intent
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2021 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2022 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2023 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2024
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2025 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2026
2027 <ul class="entry_type_enum">
2028 <li>
2029 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2030 <span class="entry_type_enum_notes">This request doesn't fall into the other
2031 categories.<wbr/> Default to preview-like
2032 behavior.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2033 </li>
2034 <li>
2035 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2036 <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]2037 precapture trigger may be used to start off a metering
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2038 w/<wbr/>flash sequence</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2039 </li>
2040 <li>
2041 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2042 <span class="entry_type_enum_notes">This request is for a still capture-type
2043 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2044 </li>
2045 <li>
2046 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2047 <span class="entry_type_enum_notes">This request is for a video recording
2048 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2049 </li>
2050 <li>
2051 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2052 <span class="entry_type_enum_notes">This request is for a video snapshot (still
2053 image while recording video) usecase</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2054 </li>
2055 <li>
2056 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2057 <span class="entry_type_enum_notes">This request is for a ZSL usecase; the
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2058 application will stream full-resolution images and
2059 reprocess one or several later for a final
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2060 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2061 </li>
2062 </ul>
2063
2064 </td> <!-- entry_type -->
2065
2066 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2067 <p>Information to 3A routines about the purpose
2068of this capture,<wbr/> to help decide optimal 3A
2069strategy</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2070 </td>
2071
2072 <td class="entry_units">
2073 </td>
2074
2075 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2076 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2077 </td>
2078
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2079 <td class="entry_tags">
2080 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2081 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2082 </ul>
2083 </td>
2084
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2085 </tr>
2086 <tr class="entries_header">
2087 <th class="th_details" colspan="5">Details</th>
2088 </tr>
2089 <tr class="entry_cont">
2090 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2091 <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]2092 </td>
2093 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2094
2095
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2096 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2097 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2098
2099
2100 <tr class="entry" id="controls_android.control.effectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2101 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2102 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2103 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2104 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2105 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2106
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2107 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2108
2109 <ul class="entry_type_enum">
2110 <li>
2111 <span class="entry_type_enum_name">OFF</span>
2112 </li>
2113 <li>
2114 <span class="entry_type_enum_name">MONO</span>
2115 <span class="entry_type_enum_optional">optional</span>
2116 </li>
2117 <li>
2118 <span class="entry_type_enum_name">NEGATIVE</span>
2119 <span class="entry_type_enum_optional">optional</span>
2120 </li>
2121 <li>
2122 <span class="entry_type_enum_name">SOLARIZE</span>
2123 <span class="entry_type_enum_optional">optional</span>
2124 </li>
2125 <li>
2126 <span class="entry_type_enum_name">SEPIA</span>
2127 <span class="entry_type_enum_optional">optional</span>
2128 </li>
2129 <li>
2130 <span class="entry_type_enum_name">POSTERIZE</span>
2131 <span class="entry_type_enum_optional">optional</span>
2132 </li>
2133 <li>
2134 <span class="entry_type_enum_name">WHITEBOARD</span>
2135 <span class="entry_type_enum_optional">optional</span>
2136 </li>
2137 <li>
2138 <span class="entry_type_enum_name">BLACKBOARD</span>
2139 <span class="entry_type_enum_optional">optional</span>
2140 </li>
2141 <li>
2142 <span class="entry_type_enum_name">AQUA</span>
2143 <span class="entry_type_enum_optional">optional</span>
2144 </li>
2145 </ul>
2146
2147 </td> <!-- entry_type -->
2148
2149 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2150 <p>Whether any special color effect is in use.<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2151Only 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]2152 </td>
2153
2154 <td class="entry_units">
2155 </td>
2156
2157 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2158 <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]2159 </td>
2160
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2161 <td class="entry_tags">
2162 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2163 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2164 </ul>
2165 </td>
2166
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2167 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2168
2169
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2170 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2171 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2172
2173
2174 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2175 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2176 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2177 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2178 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2179 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2180
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2181 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2182
2183 <ul class="entry_type_enum">
2184 <li>
2185 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2186 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
2187 routines are disabled,<wbr/> no other settings in
2188 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2189 </li>
2190 <li>
2191 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2192 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
2193 Manual control of capture parameters is disabled.<wbr/> All
2194 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2195 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2196 </li>
2197 <li>
2198 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2199 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
2200 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2201 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2202 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2203 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2204 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2205 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2206 </li>
2207 </ul>
2208
2209 </td> <!-- entry_type -->
2210
2211 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2212 <p>Overall mode of 3A control
2213routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2214 </td>
2215
2216 <td class="entry_units">
2217 </td>
2218
2219 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2220 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2221 </td>
2222
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2223 <td class="entry_tags">
2224 <ul class="entry_tags">
2225 <li><a href="#tag_BC">BC</a></li>
2226 </ul>
2227 </td>
2228
2229 </tr>
2230 <tr class="entries_header">
2231 <th class="th_details" colspan="5">Details</th>
2232 </tr>
2233 <tr class="entry_cont">
2234 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2235 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
2236by the HAL is disabled.<wbr/> The application must set the fields for
2237capture parameters itself.<wbr/></p>
2238<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2239android.<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]2240<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
2241android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
2242one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
2243as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2244<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]2245 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2246 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2247
2248
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2249 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2250 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2251
2252
2253 <tr class="entry" id="controls_android.control.sceneMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2254 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2255 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2256 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2257 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2258 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2259
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2260 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2261
2262 <ul class="entry_type_enum">
2263 <li>
2264 <span class="entry_type_enum_name">UNSUPPORTED</span>
2265 <span class="entry_type_enum_value">0</span>
2266 </li>
2267 <li>
2268 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2269 <span class="entry_type_enum_notes">if face detection support exists Use face
2270 detection data to drive 3A routines.<wbr/> If face detection
2271 statistics are disabled,<wbr/> should still operate correctly
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2272 (but not return face detection statistics to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2273 framework).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2274
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2275 Unlike the other scene modes,<wbr/> aeMode,<wbr/> awbMode,<wbr/> and afMode
2276 remain active when FACE_<wbr/>PRIORITY is set.<wbr/> This is due to
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2277 compatibility concerns with the old camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2278 API</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2279 </li>
2280 <li>
2281 <span class="entry_type_enum_name">ACTION</span>
2282 <span class="entry_type_enum_optional">optional</span>
2283 </li>
2284 <li>
2285 <span class="entry_type_enum_name">PORTRAIT</span>
2286 <span class="entry_type_enum_optional">optional</span>
2287 </li>
2288 <li>
2289 <span class="entry_type_enum_name">LANDSCAPE</span>
2290 <span class="entry_type_enum_optional">optional</span>
2291 </li>
2292 <li>
2293 <span class="entry_type_enum_name">NIGHT</span>
2294 <span class="entry_type_enum_optional">optional</span>
2295 </li>
2296 <li>
2297 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2298 <span class="entry_type_enum_optional">optional</span>
2299 </li>
2300 <li>
2301 <span class="entry_type_enum_name">THEATRE</span>
2302 <span class="entry_type_enum_optional">optional</span>
2303 </li>
2304 <li>
2305 <span class="entry_type_enum_name">BEACH</span>
2306 <span class="entry_type_enum_optional">optional</span>
2307 </li>
2308 <li>
2309 <span class="entry_type_enum_name">SNOW</span>
2310 <span class="entry_type_enum_optional">optional</span>
2311 </li>
2312 <li>
2313 <span class="entry_type_enum_name">SUNSET</span>
2314 <span class="entry_type_enum_optional">optional</span>
2315 </li>
2316 <li>
2317 <span class="entry_type_enum_name">STEADYPHOTO</span>
2318 <span class="entry_type_enum_optional">optional</span>
2319 </li>
2320 <li>
2321 <span class="entry_type_enum_name">FIREWORKS</span>
2322 <span class="entry_type_enum_optional">optional</span>
2323 </li>
2324 <li>
2325 <span class="entry_type_enum_name">SPORTS</span>
2326 <span class="entry_type_enum_optional">optional</span>
2327 </li>
2328 <li>
2329 <span class="entry_type_enum_name">PARTY</span>
2330 <span class="entry_type_enum_optional">optional</span>
2331 </li>
2332 <li>
2333 <span class="entry_type_enum_name">CANDLELIGHT</span>
2334 <span class="entry_type_enum_optional">optional</span>
2335 </li>
2336 <li>
2337 <span class="entry_type_enum_name">BARCODE</span>
2338 <span class="entry_type_enum_optional">optional</span>
2339 </li>
2340 </ul>
2341
2342 </td> <!-- entry_type -->
2343
2344 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2345 <p>Which scene mode is active when
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2346<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]2347 </td>
2348
2349 <td class="entry_units">
2350 </td>
2351
2352 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2353 <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]2354 </td>
2355
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2356 <td class="entry_tags">
2357 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2358 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2359 </ul>
2360 </td>
2361
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2362 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2363
2364
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2365 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2366 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2367
2368
2369 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2370 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2371 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2372 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2373 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2374 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2375
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2376 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2377
2378 <ul class="entry_type_enum">
2379 <li>
2380 <span class="entry_type_enum_name">OFF</span>
2381 </li>
2382 <li>
2383 <span class="entry_type_enum_name">ON</span>
2384 </li>
2385 </ul>
2386
2387 </td> <!-- entry_type -->
2388
2389 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2390 <p>Whether video stabilization is
2391active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2392 </td>
2393
2394 <td class="entry_units">
2395 </td>
2396
2397 <td class="entry_range">
2398 </td>
2399
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2400 <td class="entry_tags">
2401 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2402 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2403 </ul>
2404 </td>
2405
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2406 </tr>
2407 <tr class="entries_header">
2408 <th class="th_details" colspan="5">Details</th>
2409 </tr>
2410 <tr class="entry_cont">
2411 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2412 <p>If enabled,<wbr/> video stabilization can modify the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2413<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]2414stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2415 </td>
2416 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2417
2418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2419 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2420 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2421
2422
2423
2424 <!-- end of kind -->
2425 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2426 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2427
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2428 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2429 <tr>
2430 <th class="th_name">Property Name</th>
2431 <th class="th_type">Type</th>
2432 <th class="th_description">Description</th>
2433 <th class="th_units">Units</th>
2434 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2435 <th class="th_tags">Tags</th>
2436 </tr>
2437 </thead>
2438
2439 <tbody>
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2451 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2452 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2453 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2454 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2455 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2456 <span class="entry_type_container">x</span>
2457
2458 <span class="entry_type_array">
2459 n
2460 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2461 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2462 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2463
2464
2465 </td> <!-- entry_type -->
2466
2467 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2468 <p>The set of auto-exposure antibanding modes that are
2469supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2470 </td>
2471
2472 <td class="entry_units">
2473 </td>
2474
2475 <td class="entry_range">
2476 </td>
2477
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2478 <td class="entry_tags">
2479 </td>
2480
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2481 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2482 <tr class="entries_header">
2483 <th class="th_details" colspan="5">Details</th>
2484 </tr>
2485 <tr class="entry_cont">
2486 <td class="entry_details" colspan="5">
2487 <p>Not all of the auto-exposure anti-banding modes may be
2488supported by a given camera device.<wbr/> This field lists the
2489valid anti-banding modes that the application may request
2490for this camera device; they must include AUTO.<wbr/></p>
2491 </td>
2492 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2493
2494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2495 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2496 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2497
2498
2499 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2500 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2501 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2502 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2503 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2504 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2505 <span class="entry_type_container">x</span>
2506
2507 <span class="entry_type_array">
2508 n
2509 </span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2510 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2511 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2512
2513
2514 </td> <!-- entry_type -->
2515
2516 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2517 <p>The set of auto-exposure modes that are supported by this
2518camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2519 </td>
2520
2521 <td class="entry_units">
2522 </td>
2523
2524 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2525 </td>
2526
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2527 <td class="entry_tags">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2528 <ul class="entry_tags">
2529 <li><a href="#tag_BC">BC</a></li>
2530 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2531 </td>
2532
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2533 </tr>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2534 <tr class="entries_header">
2535 <th class="th_details" colspan="5">Details</th>
2536 </tr>
2537 <tr class="entry_cont">
2538 <td class="entry_details" colspan="5">
2539 <p>Not all the auto-exposure modes may be supported by a
2540given camera device,<wbr/> especially if no flash unit is
2541available.<wbr/> This entry lists the valid modes for
2542<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> for this camera device.<wbr/></p>
2543<p>All camera devices support ON,<wbr/> and all camera devices with
2544flash units support ON_<wbr/>AUTO_<wbr/>FLASH and
2545ON_<wbr/>ALWAYS_<wbr/>FLASH.<wbr/></p>
2546<p>Full-capability camera devices always support OFF mode,<wbr/>
2547which enables application control of camera exposure time,<wbr/>
2548sensitivity,<wbr/> and frame duration.<wbr/></p>
2549 </td>
2550 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2551
2552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2553 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2554 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2555
2556
2557 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2558 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2559 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2560 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2561 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2562 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2563 <span class="entry_type_container">x</span>
2564
2565 <span class="entry_type_array">
2566 2 x n
2567 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2568 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2569 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2570
2571
2572 </td> <!-- entry_type -->
2573
2574 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2575 <p>List of frame rate ranges supported by the
2576AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2577 </td>
2578
2579 <td class="entry_units">
2580 </td>
2581
2582 <td class="entry_range">
2583 </td>
2584
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2585 <td class="entry_tags">
2586 </td>
2587
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2588 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2589
2590
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2591 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2592 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2593
2594
2595 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2596 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2597 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2598 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2599 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2600 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2601 <span class="entry_type_container">x</span>
2602
2603 <span class="entry_type_array">
2604 2
2605 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2606 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2607
2608
2609 </td> <!-- entry_type -->
2610
2611 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2612 <p>Maximum and minimum exposure compensation
2613setting,<wbr/> in counts of
2614android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2615 </td>
2616
2617 <td class="entry_units">
2618 </td>
2619
2620 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2621 <p>At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2622size)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2623 </td>
2624
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2625 <td class="entry_tags">
2626 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2627 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2628 </ul>
2629 </td>
2630
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2631 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2632
2633
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2634 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2635 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2636
2637
2638 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2639 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2640 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2641 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2642 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2643 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2644
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2645 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2646
2647
2648 </td> <!-- entry_type -->
2649
2650 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2651 <p>Smallest step by which exposure compensation
2652can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2653 </td>
2654
2655 <td class="entry_units">
2656 </td>
2657
2658 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2659 <p>&lt;= 1/<wbr/>2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2660 </td>
2661
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2662 <td class="entry_tags">
2663 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2664 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2665 </ul>
2666 </td>
2667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2668 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2669
2670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2671 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2672 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2673
2674
2675 <tr class="entry" id="static_android.control.afAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2676 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2677 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2678 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2679 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2680 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2681 <span class="entry_type_container">x</span>
2682
2683 <span class="entry_type_array">
2684 n
2685 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2686 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2687 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2688
2689
2690 </td> <!-- entry_type -->
2691
2692 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2693 <p>List of AF modes that can be
2694selected</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2695 </td>
2696
2697 <td class="entry_units">
2698 </td>
2699
2700 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2701 <p>OFF must be included.<wbr/> AUTO must be supported if
2702lens allows for changing focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2703 </td>
2704
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2705 <td class="entry_tags">
2706 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2707 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2708 </ul>
2709 </td>
2710
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2711 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2712
2713
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2714 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2715 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2716
2717
2718 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2719 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2720 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2721 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2722 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2723 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2724 <span class="entry_type_container">x</span>
2725
2726 <span class="entry_type_array">
2727 n
2728 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2729 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2730 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2731
2732
2733 </td> <!-- entry_type -->
2734
2735 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2736 <p>what subset of the full color effect enum
2737list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2738 </td>
2739
2740 <td class="entry_units">
2741 </td>
2742
2743 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2744 <p>OFF must be listed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2745 </td>
2746
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2747 <td class="entry_tags">
2748 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2749 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2750 </ul>
2751 </td>
2752
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2753 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2754
2755
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2756 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2757 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2758
2759
2760 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2761 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2762 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2763 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2764 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2765 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2766 <span class="entry_type_container">x</span>
2767
2768 <span class="entry_type_array">
2769 n
2770 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2771 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2772 <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]2773
2774
2775 </td> <!-- entry_type -->
2776
2777 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2778 <p>what subset of the scene mode enum list is
2779supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2780 </td>
2781
2782 <td class="entry_units">
2783 </td>
2784
2785 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2786 <p>SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2787detection is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2788 </td>
2789
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2790 <td class="entry_tags">
2791 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2792 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2793 </ul>
2794 </td>
2795
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2796 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2797
2798
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2799 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2800 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2801
2802
2803 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2804 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2805 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2806 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2807 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2808 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2809 <span class="entry_type_container">x</span>
2810
2811 <span class="entry_type_array">
2812 n
2813 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2814 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2815 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2816
2817
2818 </td> <!-- entry_type -->
2819
2820 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2821 <p>List of video stabilization modes that can
2822be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2823 </td>
2824
2825 <td class="entry_units">
2826 </td>
2827
2828 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2829 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2830 </td>
2831
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2832 <td class="entry_tags">
2833 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2834 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2835 </ul>
2836 </td>
2837
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2838 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2839
2840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2841 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2842 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2843
2844
2845 <tr class="entry" id="static_android.control.awbAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2846 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2847 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2848 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2849 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2850 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2851 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2852
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2853 <span class="entry_type_array">
2854 n
2855 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2856 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2857 <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]2858
2859
2860 </td> <!-- entry_type -->
2861
2862 <td class="entry_description">
2863 </td>
2864
2865 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2866 </td>
2867
2868 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2869 <p>OFF,<wbr/> AUTO must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2870 </td>
2871
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2872 <td class="entry_tags">
2873 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2874 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2875 </ul>
2876 </td>
2877
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2878 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2879
2880
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2881 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2882 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2883
2884
2885 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2886 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2887 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2888 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2889 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2890 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2891
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2892 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2893
2894
2895 </td> <!-- entry_type -->
2896
2897 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2898 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
2899regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2900 </td>
2901
2902 <td class="entry_units">
2903 </td>
2904
2905 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]2906 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2907 </td>
2908
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2909 <td class="entry_tags">
2910 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2911 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2912 </ul>
2913 </td>
2914
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2915 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2916
2917
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2918 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2919 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2920
2921
2922 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2923 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2924 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2925 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2926 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2927 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2928 <span class="entry_type_container">x</span>
2929
2930 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2931 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2932 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2933 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2934
2935
2936 </td> <!-- entry_type -->
2937
2938 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2939 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
2940each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2941 </td>
2942
2943 <td class="entry_units">
2944 </td>
2945
2946 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2947 <p>For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
2948awbMode,<wbr/> and afMode that the HAL wants to use for that
2949scene mode.<wbr/></p>
2950<p>For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
2951order of increasing index</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2952 </td>
2953
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2954 <td class="entry_tags">
2955 <ul class="entry_tags">
2956 <li><a href="#tag_BC">BC</a></li>
2957 </ul>
2958 </td>
2959
2960 </tr>
2961 <tr class="entries_header">
2962 <th class="th_details" colspan="5">Details</th>
2963 </tr>
2964 <tr class="entry_cont">
2965 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2966 <p>When a scene mode is enabled,<wbr/> the HAL is expected
2967to override aeMode,<wbr/> awbMode,<wbr/> and afMode with its
2968preferred settings for that scene mode.<wbr/></p>
2969<p>To simplify communication with old camera API applications,<wbr/>
2970the service wants this override list in the static metadata.<wbr/>
2971The order of this list matches that of availableSceneModes,<wbr/>
2972with 3 entires for each scene mode.<wbr/> The overrides listed
2973for SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
2974mode,<wbr/> the application-set aeMode,<wbr/> awbMode,<wbr/> and afMode are
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2975used 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]2976AUTO.<wbr/></p>
2977<p>It is recommended that for FACE_<wbr/>PRIORITY,<wbr/> the overrides
2978should be set to 0.<wbr/> As an example,<wbr/> if availableSceneModes is
2979{ FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT },<wbr/> then the service expects
2980this field to have 9 entries; for example { 0 ,<wbr/> 0,<wbr/> 0,<wbr/>
2981ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
2982INCANDESCENT,<wbr/> AUTO }</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2983 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2984 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2985
2986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2987 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2988 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2989
2990
2991
2992 <!-- end of kind -->
2993 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2994 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2995
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2996 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2997 <tr>
2998 <th class="th_name">Property Name</th>
2999 <th class="th_type">Type</th>
3000 <th class="th_description">Description</th>
3001 <th class="th_units">Units</th>
3002 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3003 <th class="th_tags">Tags</th>
3004 </tr>
3005 </thead>
3006
3007 <tbody>
3008
3009
3010
3011
3012
3013
3014
3015
3016
3017
3018 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3019 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3020 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3021 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3022 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3023 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3024
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3025 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3026
3027
3028 </td> <!-- entry_type -->
3029
3030 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3031 <p>The ID sent with the latest
3032CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3033 </td>
3034
3035 <td class="entry_units">
3036 </td>
3037
3038 <td class="entry_range">
3039 </td>
3040
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3041 <td class="entry_tags">
3042 </td>
3043
3044 </tr>
3045 <tr class="entries_header">
3046 <th class="th_details" colspan="5">Details</th>
3047 </tr>
3048 <tr class="entry_cont">
3049 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3050 <p>Must be 0 if no
3051CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
3052by HAL.<wbr/> Always updated even if AE algorithm ignores the
3053trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3054 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3055 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3056
3057
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3058 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3059 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3060
3061
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3062 <tr class="entry" id="dynamic_android.control.aeMode">
3063 <td class="entry_name" rowspan="3">
3064 android.<wbr/>control.<wbr/>ae<wbr/>Mode
3065 </td>
3066 <td class="entry_type">
3067 <span class="entry_type_name entry_type_name_enum">byte</span>
3068
3069 <span class="entry_type_visibility"> [public]</span>
3070
3071 <ul class="entry_type_enum">
3072 <li>
3073 <span class="entry_type_enum_name">OFF</span>
3074 <span class="entry_type_enum_notes">
3075 The camera device's autoexposure routine is disabled;
3076 the application-selected android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
3077 android.<wbr/>sensor.<wbr/>sensitivity and
3078 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are used by the camera
3079 device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
3080 a flash unit for this camera device.<wbr/>
3081 </span>
3082 </li>
3083 <li>
3084 <span class="entry_type_enum_name">ON</span>
3085 <span class="entry_type_enum_notes">
3086 The camera device's autoexposure routine is active,<wbr/>
3087 with no flash control.<wbr/> The application's values for
3088 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
3089 android.<wbr/>sensor.<wbr/>sensitivity,<wbr/> and
3090 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are ignored.<wbr/> The
3091 application has control over the various
3092 android.<wbr/>flash.<wbr/>* fields.<wbr/>
3093 </span>
3094 </li>
3095 <li>
3096 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
3097 <span class="entry_type_enum_notes">
3098 Like ON,<wbr/> except that the camera device also controls
3099 the camera's flash unit,<wbr/> firing it in low-light
3100 conditions.<wbr/> The flash may be fired during a
3101 precapture sequence (triggered by
3102 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and may be fired
3103 for captures for which the
3104 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
3105 STILL_<wbr/>CAPTURE
3106 </span>
3107 </li>
3108 <li>
3109 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
3110 <span class="entry_type_enum_notes">
3111 Like ON,<wbr/> except that the camera device also controls
3112 the camera's flash unit,<wbr/> always firing it for still
3113 captures.<wbr/> The flash may be fired during a precapture
3114 sequence (triggered by
3115 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and will always
3116 be fired for captures for which the
3117 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
3118 STILL_<wbr/>CAPTURE
3119 </span>
3120 </li>
3121 <li>
3122 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
3123 <span class="entry_type_enum_notes">
3124 Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
3125 reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
3126 a red eye reduction flash will fire during the
3127 precapture sequence.<wbr/>
3128 </span>
3129 </li>
3130 </ul>
3131
3132 </td> <!-- entry_type -->
3133
3134 <td class="entry_description">
3135 <p>The desired mode for the camera device's
3136auto-exposure routine.<wbr/></p>
3137 </td>
3138
3139 <td class="entry_units">
3140 </td>
3141
3142 <td class="entry_range">
3143 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
3144 </td>
3145
3146 <td class="entry_tags">
3147 <ul class="entry_tags">
3148 <li><a href="#tag_BC">BC</a></li>
3149 </ul>
3150 </td>
3151
3152 </tr>
3153 <tr class="entries_header">
3154 <th class="th_details" colspan="5">Details</th>
3155 </tr>
3156 <tr class="entry_cont">
3157 <td class="entry_details" colspan="5">
3158 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
3159AUTO.<wbr/></p>
3160<p>When set to any of the ON modes,<wbr/> the camera device's
3161auto-exposure routine is enabled,<wbr/> overriding the
3162application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
3163and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3164<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3165<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
3166is selected,<wbr/> the camera device's flash unit controls are
3167also overridden.<wbr/></p>
3168<p>The FLASH modes are only available if the camera device
3169has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
3170<p>If flash TORCH mode is desired,<wbr/> this field must be set to
3171ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
3172<p>When set to any of the ON modes,<wbr/> the values chosen by the
3173camera device auto-exposure routine for the overridden
3174fields for a given capture will be available in its
3175CaptureResult.<wbr/></p>
3176 </td>
3177 </tr>
3178
3179
3180 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3181 <!-- end of entry -->
3182
3183
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3184 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3185 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3186 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3187 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3188 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3189 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3190 <span class="entry_type_container">x</span>
3191
3192 <span class="entry_type_array">
3193 5 x area_count
3194 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3195 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3196
3197
3198 </td> <!-- entry_type -->
3199
3200 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3201 <p>List of areas to use for
3202metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3203 </td>
3204
3205 <td class="entry_units">
3206 </td>
3207
3208 <td class="entry_range">
3209 </td>
3210
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3211 <td class="entry_tags">
3212 <ul class="entry_tags">
3213 <li><a href="#tag_BC">BC</a></li>
3214 </ul>
3215 </td>
3216
3217 </tr>
3218 <tr class="entries_header">
3219 <th class="th_details" colspan="5">Details</th>
3220 </tr>
3221 <tr class="entry_cont">
3222 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3223 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3224xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3225specified coordinates.<wbr/></p>
3226<p>The coordinate system is based on the active pixel array,<wbr/>
3227with (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]3228(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3229<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]3230bottom-right pixel in the active pixel array.<wbr/> The weight
3231should be nonnegative.<wbr/></p>
3232<p>If all regions have 0 weight,<wbr/> then no specific metering area
3233needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3234outside 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]3235should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3236used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3237 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3238 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3239
3240
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3241 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3242 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3243
3244
3245 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3246 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3247 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3248 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3249 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3250 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3251
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3252 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3253
3254 <ul class="entry_type_enum">
3255 <li>
3256 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3257 <span class="entry_type_enum_notes">AE is off.<wbr/> When a camera device is opened,<wbr/> it starts in
3258 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3259 </li>
3260 <li>
3261 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3262 <span class="entry_type_enum_notes">AE doesn't yet have a good set of control values
3263 for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3264 </li>
3265 <li>
3266 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3267 <span class="entry_type_enum_notes">AE has a good set of control values for the
3268 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3269 </li>
3270 <li>
3271 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3272 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3273 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3274 </li>
3275 <li>
3276 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3277 <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]3278 needs to be fired for good quality still
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3279 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3280 </li>
3281 <li>
3282 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3283 <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]3284 (through the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3285 trigger_<wbr/>action(CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING)
3286 call),<wbr/> and is currently executing it.<wbr/> Once PRECAPTURE
3287 completes,<wbr/> AE will transition to CONVERGED or
3288 FLASH_<wbr/>REQUIRED as appropriate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3289 </li>
3290 </ul>
3291
3292 </td> <!-- entry_type -->
3293
3294 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3295 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3296 </td>
3297
3298 <td class="entry_units">
3299 </td>
3300
3301 <td class="entry_range">
3302 </td>
3303
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3304 <td class="entry_tags">
3305 </td>
3306
3307 </tr>
3308 <tr class="entries_header">
3309 <th class="th_details" colspan="5">Details</th>
3310 </tr>
3311 <tr class="entry_cont">
3312 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3313 <p>Whenever the AE algorithm state changes,<wbr/> a
3314MSG_<wbr/>AUTOEXPOSURE notification must be send if a
3315notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3316 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3317 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3318
3319
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3320 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3321 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3322
3323
3324 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3325 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3326 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3327 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3328 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3329 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3330
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3331 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3332
3333 <ul class="entry_type_enum">
3334 <li>
3335 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3336 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
3337 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
3338 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3339 </li>
3340 <li>
3341 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3342 <span class="entry_type_enum_notes">
3343 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3344
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3345 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
3346 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3347 the autofocus trigger action is called.<wbr/> When that trigger
3348 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3349 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3350
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3351 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3352 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3353 </li>
3354 <li>
3355 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3356 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
3357 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3358
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3359 When that trigger is activated,<wbr/> AF must transition to
3360 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3361 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3362 position to default,<wbr/> and sets the AF state to
3363 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3364 </li>
3365 <li>
3366 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3367 <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]3368 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3369 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3370
3371 The focusing behavior should be suitable for good quality
3372 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3373 movement and no overshoots.<wbr/> When the AF trigger is not
3374 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3375 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3376 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3377 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3378 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3379 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3380
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3381 Once cancel is received,<wbr/> the algorithm should transition
3382 back to INACTIVE and resume passive scan.<wbr/> Note that this
3383 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3384 ongoing PASSIVE_<wbr/>SCAN must immediately be
3385 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3386 </li>
3387 <li>
3388 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3389 <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]3390 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3391 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3392
3393 The focusing behavior should be suitable for still image
3394 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3395 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3396 algorithm should start in INACTIVE state,<wbr/> and then
3397 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3398 appropriate as it attempts to maintain focus.<wbr/> When the AF
3399 trigger is activated,<wbr/> the algorithm should finish its
3400 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3401 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3402 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3403
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3404 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3405 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3406 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3407 </li>
3408 <li>
3409 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3410 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
3411 trigger is ignored,<wbr/> AF state should always be
3412 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3413 </li>
3414 </ul>
3415
3416 </td> <!-- entry_type -->
3417
3418 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3419 <p>Whether AF is currently enabled,<wbr/> and what
3420mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3421 </td>
3422
3423 <td class="entry_units">
3424 </td>
3425
3426 <td class="entry_range">
3427 </td>
3428
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3429 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3430 <ul class="entry_tags">
3431 <li><a href="#tag_BC">BC</a></li>
3432 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3433 </td>
3434
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3435 </tr>
3436 <tr class="entries_header">
3437 <th class="th_details" colspan="5">Details</th>
3438 </tr>
3439 <tr class="entry_cont">
3440 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3441 <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]3442<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]3443report 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]3444result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3445 </td>
3446 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3447
3448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3449 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3450 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3451
3452
3453 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3454 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3455 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3456 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3457 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3458 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3459 <span class="entry_type_container">x</span>
3460
3461 <span class="entry_type_array">
3462 5 x area_count
3463 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3464 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3465
3466
3467 </td> <!-- entry_type -->
3468
3469 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3470 <p>List of areas to use for focus
3471estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3472 </td>
3473
3474 <td class="entry_units">
3475 </td>
3476
3477 <td class="entry_range">
3478 </td>
3479
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3480 <td class="entry_tags">
3481 <ul class="entry_tags">
3482 <li><a href="#tag_BC">BC</a></li>
3483 </ul>
3484 </td>
3485
3486 </tr>
3487 <tr class="entries_header">
3488 <th class="th_details" colspan="5">Details</th>
3489 </tr>
3490 <tr class="entry_cont">
3491 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3492 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3493xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3494specified coordinates.<wbr/></p>
3495<p>The coordinate system is based on the active pixel array,<wbr/>
3496with (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]3497(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3498<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]3499bottom-right pixel in the active pixel array.<wbr/> The weight
3500should be nonnegative.<wbr/></p>
3501<p>If all regions have 0 weight,<wbr/> then no specific focus area
3502needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3503outside 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]3504should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3505used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3506 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3507 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3508
3509
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3510 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3511 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3512
3513
3514 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3515 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3516 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3517 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3518 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3519 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3520
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3521 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3522
3523 <ul class="entry_type_enum">
3524 <li>
3525 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3526 <span class="entry_type_enum_notes">AF off or has not yet tried to scan/<wbr/>been asked
3527 to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3528 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3529 </li>
3530 <li>
3531 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3532 <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]3533 currently doing an AF scan initiated by a continuous
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3534 autofocus mode</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3535 </li>
3536 <li>
3537 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3538 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3539 believes it is in focus,<wbr/> but may restart scanning at
3540 any time.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3541 </li>
3542 <li>
3543 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3544 <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]3545 an AF scan because it was triggered by AF
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3546 trigger</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3547 </li>
3548 <li>
3549 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3550 <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]3551 believes it is focused correctly and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3552 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3553 </li>
3554 <li>
3555 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3556 <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]3557 failed to focus successfully and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3558 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3559 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3560 <li>
3561 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3562 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3563 passive scan without finding focus,<wbr/> and may restart
3564 scanning at any time.<wbr/></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3565 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3566 </ul>
3567
3568 </td> <!-- entry_type -->
3569
3570 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3571 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3572 </td>
3573
3574 <td class="entry_units">
3575 </td>
3576
3577 <td class="entry_range">
3578 </td>
3579
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3580 <td class="entry_tags">
3581 </td>
3582
3583 </tr>
3584 <tr class="entries_header">
3585 <th class="th_details" colspan="5">Details</th>
3586 </tr>
3587 <tr class="entry_cont">
3588 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3589 <p>Whenever the AF algorithm state changes,<wbr/> a
3590MSG_<wbr/>AUTOFOCUS notification must be send if a notification
3591callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3592 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3593 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3594
3595
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3596 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3597 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3598
3599
3600 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3601 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3602 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3603 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3604 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3605 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3606
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3607 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3608
3609
3610 </td> <!-- entry_type -->
3611
3612 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3613 <p>The ID sent with the latest
3614CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3615 </td>
3616
3617 <td class="entry_units">
3618 </td>
3619
3620 <td class="entry_range">
3621 </td>
3622
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3623 <td class="entry_tags">
3624 </td>
3625
3626 </tr>
3627 <tr class="entries_header">
3628 <th class="th_details" colspan="5">Details</th>
3629 </tr>
3630 <tr class="entry_cont">
3631 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3632 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
3633received yet by HAL.<wbr/> Always updated even if AF algorithm
3634ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3635 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3636 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3637
3638
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3639 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3640 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3641
3642
3643 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3644 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3645 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3646 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3647 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3648 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3649
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3650 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3651
3652 <ul class="entry_type_enum">
3653 <li>
3654 <span class="entry_type_enum_name">OFF</span>
3655 </li>
3656 <li>
3657 <span class="entry_type_enum_name">AUTO</span>
3658 </li>
3659 <li>
3660 <span class="entry_type_enum_name">INCANDESCENT</span>
3661 </li>
3662 <li>
3663 <span class="entry_type_enum_name">FLUORESCENT</span>
3664 </li>
3665 <li>
3666 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
3667 </li>
3668 <li>
3669 <span class="entry_type_enum_name">DAYLIGHT</span>
3670 </li>
3671 <li>
3672 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
3673 </li>
3674 <li>
3675 <span class="entry_type_enum_name">TWILIGHT</span>
3676 </li>
3677 <li>
3678 <span class="entry_type_enum_name">SHADE</span>
3679 </li>
3680 </ul>
3681
3682 </td> <!-- entry_type -->
3683
3684 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3685 <p>Whether AWB is currently setting the color
3686transform fields,<wbr/> and what its illumination target
3687is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3688 </td>
3689
3690 <td class="entry_units">
3691 </td>
3692
3693 <td class="entry_range">
3694 </td>
3695
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3696 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3697 <ul class="entry_tags">
3698 <li><a href="#tag_BC">BC</a></li>
3699 <li><a href="#tag_AWB">AWB</a></li>
3700 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3701 </td>
3702
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3703 </tr>
3704 <tr class="entries_header">
3705 <th class="th_details" colspan="5">Details</th>
3706 </tr>
3707 <tr class="entry_cont">
3708 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3709 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3710<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]3711 </td>
3712 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3713
3714
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3715 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3716 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3717
3718
3719 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3720 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3721 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3722 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3723 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3724 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3725 <span class="entry_type_container">x</span>
3726
3727 <span class="entry_type_array">
3728 5 x area_count
3729 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3730 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3731
3732
3733 </td> <!-- entry_type -->
3734
3735 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3736 <p>List of areas to use for illuminant
3737estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3738 </td>
3739
3740 <td class="entry_units">
3741 </td>
3742
3743 <td class="entry_range">
3744 </td>
3745
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3746 <td class="entry_tags">
3747 <ul class="entry_tags">
3748 <li><a href="#tag_BC">BC</a></li>
3749 </ul>
3750 </td>
3751
3752 </tr>
3753 <tr class="entries_header">
3754 <th class="th_details" colspan="5">Details</th>
3755 </tr>
3756 <tr class="entry_cont">
3757 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3758 <p>Only used in AUTO mode.<wbr/></p>
3759<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3760xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3761specified coordinates.<wbr/></p>
3762<p>The coordinate system is based on the active pixel array,<wbr/>
3763with (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]3764(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3765<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]3766bottom-right pixel in the active pixel array.<wbr/> The weight
3767should be nonnegative.<wbr/></p>
3768<p>If all regions have 0 weight,<wbr/> then no specific metering area
3769needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3770outside 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]3771should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3772used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3773 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3774 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3775
3776
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3777 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3778 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3779
3780
3781 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3782 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3783 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3784 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3785 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3786 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3787
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3788 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3789
3790 <ul class="entry_type_enum">
3791 <li>
3792 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3793 <span class="entry_type_enum_notes">AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
3794 starts in this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3795 </li>
3796 <li>
3797 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3798 <span class="entry_type_enum_notes">AWB doesn't yet have a good set of control
3799 values for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3800 </li>
3801 <li>
3802 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3803 <span class="entry_type_enum_notes">AWB has a good set of control values for the
3804 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3805 </li>
3806 <li>
3807 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3808 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3809 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3810 </li>
3811 </ul>
3812
3813 </td> <!-- entry_type -->
3814
3815 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3816 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3817 </td>
3818
3819 <td class="entry_units">
3820 </td>
3821
3822 <td class="entry_range">
3823 </td>
3824
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3825 <td class="entry_tags">
3826 </td>
3827
3828 </tr>
3829 <tr class="entries_header">
3830 <th class="th_details" colspan="5">Details</th>
3831 </tr>
3832 <tr class="entry_cont">
3833 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3834 <p>Whenever the AWB algorithm state changes,<wbr/> a
3835MSG_<wbr/>AUTOWHITEBALANCE notification must be send if a
3836notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3837 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3838 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3839
3840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3841 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3842 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3843
3844
3845 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3846 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3847 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3848 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3849 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3850 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3851
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3852 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3853
3854 <ul class="entry_type_enum">
3855 <li>
3856 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3857 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
3858 routines are disabled,<wbr/> no other settings in
3859 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3860 </li>
3861 <li>
3862 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3863 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
3864 Manual control of capture parameters is disabled.<wbr/> All
3865 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
3866 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3867 </li>
3868 <li>
3869 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3870 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
3871 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3872 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3873 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
3874 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3875 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3876 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3877 </li>
3878 </ul>
3879
3880 </td> <!-- entry_type -->
3881
3882 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3883 <p>Overall mode of 3A control
3884routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3885 </td>
3886
3887 <td class="entry_units">
3888 </td>
3889
3890 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3891 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3892 </td>
3893
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3894 <td class="entry_tags">
3895 <ul class="entry_tags">
3896 <li><a href="#tag_BC">BC</a></li>
3897 </ul>
3898 </td>
3899
3900 </tr>
3901 <tr class="entries_header">
3902 <th class="th_details" colspan="5">Details</th>
3903 </tr>
3904 <tr class="entry_cont">
3905 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3906 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
3907by the HAL is disabled.<wbr/> The application must set the fields for
3908capture parameters itself.<wbr/></p>
3909<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3910android.<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]3911<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
3912android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
3913one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
3914as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3915<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]3916 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3917 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3918
3919
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3920 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3921 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3922
3923
3924
3925 <!-- end of kind -->
3926 </tbody>
3927
3928 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3929 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3930
3931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3932 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3933
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3934 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3935 <tr>
3936 <th class="th_name">Property Name</th>
3937 <th class="th_type">Type</th>
3938 <th class="th_description">Description</th>
3939 <th class="th_units">Units</th>
3940 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3941 <th class="th_tags">Tags</th>
3942 </tr>
3943 </thead>
3944
3945 <tbody>
3946
3947
3948
3949
3950
3951
3952
3953
3954
3955
3956 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3957 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3958 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3959 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3960 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3961 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3962
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3963 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3964
3965 <ul class="entry_type_enum">
3966 <li>
3967 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3968 <span class="entry_type_enum_notes">Minimal or no slowdown of frame rate compared to
3969 Bayer RAW output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3970 </li>
3971 <li>
3972 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3973 <span class="entry_type_enum_notes">High-quality may reduce output frame
3974 rate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3975 </li>
3976 </ul>
3977
3978 </td> <!-- entry_type -->
3979
3980 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3981 <p>Controls the quality of the demosaicing
3982processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3983 </td>
3984
3985 <td class="entry_units">
3986 </td>
3987
3988 <td class="entry_range">
3989 </td>
3990
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3991 <td class="entry_tags">
3992 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3993 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3994 </ul>
3995 </td>
3996
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3997 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3998
3999
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4000 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4001 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4002
4003
4004
4005 <!-- end of kind -->
4006 </tbody>
4007
4008 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4009 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4010
4011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4012 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4013
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4014 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4015 <tr>
4016 <th class="th_name">Property Name</th>
4017 <th class="th_type">Type</th>
4018 <th class="th_description">Description</th>
4019 <th class="th_units">Units</th>
4020 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4021 <th class="th_tags">Tags</th>
4022 </tr>
4023 </thead>
4024
4025 <tbody>
4026
4027
4028
4029
4030
4031
4032
4033
4034
4035
4036 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4037 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4038 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4039 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4040 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4041 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4042
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4043 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4044
4045 <ul class="entry_type_enum">
4046 <li>
4047 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4048 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4049 </li>
4050 <li>
4051 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4052 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
4053 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4054 </li>
4055 <li>
4056 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4057 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4058 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4059 </li>
4060 </ul>
4061
4062 </td> <!-- entry_type -->
4063
4064 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4065 <p>Operation mode for edge
4066enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4067 </td>
4068
4069 <td class="entry_units">
4070 </td>
4071
4072 <td class="entry_range">
4073 </td>
4074
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4075 <td class="entry_tags">
4076 </td>
4077
4078 </tr>
4079 <tr class="entries_header">
4080 <th class="th_details" colspan="5">Details</th>
4081 </tr>
4082 <tr class="entry_cont">
4083 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4084 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4085enhancement will be applied by the HAL.<wbr/></p>
4086<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
4087will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
4088HAL should use the highest-quality enhancement algorithms,<wbr/>
4089even if it slows down capture rate.<wbr/> FAST means the HAL should
4090not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4091 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4092 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4093
4094
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4095 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4096 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4097
4098
4099 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4100 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4101 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4102 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4103 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4104 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4105
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4106 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4107
4108
4109 </td> <!-- entry_type -->
4110
4111 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4112 <p>Control the amount of edge enhancement
4113applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4114 </td>
4115
4116 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4117 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4118 </td>
4119
4120 <td class="entry_range">
4121 </td>
4122
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4123 <td class="entry_tags">
4124 </td>
4125
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4126 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4127
4128
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4129 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4130 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4131
4132
4133
4134 <!-- end of kind -->
4135 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4136 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4137
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4138 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4139 <tr>
4140 <th class="th_name">Property Name</th>
4141 <th class="th_type">Type</th>
4142 <th class="th_description">Description</th>
4143 <th class="th_units">Units</th>
4144 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4145 <th class="th_tags">Tags</th>
4146 </tr>
4147 </thead>
4148
4149 <tbody>
4150
4151
4152
4153
4154
4155
4156
4157
4158
4159
4160 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4161 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4162 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4163 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4164 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4165 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4166
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4167 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4168
4169 <ul class="entry_type_enum">
4170 <li>
4171 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4172 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4173 </li>
4174 <li>
4175 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4176 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
4177 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4178 </li>
4179 <li>
4180 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4181 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4182 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4183 </li>
4184 </ul>
4185
4186 </td> <!-- entry_type -->
4187
4188 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4189 <p>Operation mode for edge
4190enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4191 </td>
4192
4193 <td class="entry_units">
4194 </td>
4195
4196 <td class="entry_range">
4197 </td>
4198
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4199 <td class="entry_tags">
4200 </td>
4201
4202 </tr>
4203 <tr class="entries_header">
4204 <th class="th_details" colspan="5">Details</th>
4205 </tr>
4206 <tr class="entry_cont">
4207 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4208 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4209enhancement will be applied by the HAL.<wbr/></p>
4210<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
4211will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
4212HAL should use the highest-quality enhancement algorithms,<wbr/>
4213even if it slows down capture rate.<wbr/> FAST means the HAL should
4214not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4215 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4216 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4217
4218
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4219 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4220 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4221
4222
4223
4224 <!-- end of kind -->
4225 </tbody>
4226
4227 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4228 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4229
4230
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4231 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4232
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4233 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4234 <tr>
4235 <th class="th_name">Property Name</th>
4236 <th class="th_type">Type</th>
4237 <th class="th_description">Description</th>
4238 <th class="th_units">Units</th>
4239 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4240 <th class="th_tags">Tags</th>
4241 </tr>
4242 </thead>
4243
4244 <tbody>
4245
4246
4247
4248
4249
4250
4251
4252
4253
4254
4255 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4256 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4257 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4258 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4259 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4260 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4261
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4262 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4263
4264
4265 </td> <!-- entry_type -->
4266
4267 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4268 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4269 </td>
4270
4271 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4272 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4273 </td>
4274
4275 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4276 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4277 </td>
4278
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4279 <td class="entry_tags">
4280 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4281 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4282 </ul>
4283 </td>
4284
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4285 </tr>
4286 <tr class="entries_header">
4287 <th class="th_details" colspan="5">Details</th>
4288 </tr>
4289 <tr class="entry_cont">
4290 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4291 <p>Power for snapshot may use a different scale than
4292for torch mode.<wbr/> Only one entry for torch mode will be
4293used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4294 </td>
4295 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4296
4297
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4298 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4299 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4300
4301
4302 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4303 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4304 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4305 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4306 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4307 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4308
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4309 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4310
4311
4312 </td> <!-- entry_type -->
4313
4314 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4315 <p>Firing time of flash relative to start of
4316exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4317 </td>
4318
4319 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4320 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4321 </td>
4322
4323 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4324 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4325 </td>
4326
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4327 <td class="entry_tags">
4328 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4329 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4330 </ul>
4331 </td>
4332
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4333 </tr>
4334 <tr class="entries_header">
4335 <th class="th_details" colspan="5">Details</th>
4336 </tr>
4337 <tr class="entry_cont">
4338 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4339 <p>Clamped to (0,<wbr/> exposure time - flash
4340duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4341 </td>
4342 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4343
4344
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4345 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4346 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4347
4348
4349 <tr class="entry" id="controls_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4350 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4351 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4352 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4353 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4354 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4355
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4356 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4357
4358 <ul class="entry_type_enum">
4359 <li>
4360 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4361 <span class="entry_type_enum_notes">Do not fire the flash for this
4362 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4363 </li>
4364 <li>
4365 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4366 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4367 for this capture based on firingPower,<wbr/>
4368 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4369 </li>
4370 <li>
4371 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4372 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4373 continuously on,<wbr/> power set by
4374 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4375 </li>
4376 </ul>
4377
4378 </td> <!-- entry_type -->
4379
4380 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4381 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4382 </td>
4383
4384 <td class="entry_units">
4385 </td>
4386
4387 <td class="entry_range">
4388 </td>
4389
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4390 <td class="entry_tags">
4391 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4392 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4393 </ul>
4394 </td>
4395
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4396 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4397
4398
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4399 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4400 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4401
4402
4403
4404 <!-- end of kind -->
4405 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4406 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4407
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4408 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4409 <tr>
4410 <th class="th_name">Property Name</th>
4411 <th class="th_type">Type</th>
4412 <th class="th_description">Description</th>
4413 <th class="th_units">Units</th>
4414 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4415 <th class="th_tags">Tags</th>
4416 </tr>
4417 </thead>
4418
4419 <tbody>
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4433 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4434 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4435 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4436 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4437 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4438
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4439 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4440
4441
4442 </td> <!-- entry_type -->
4443
4444 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4445 <p>Whether this camera has a
4446flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4447 </td>
4448
4449 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4450 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4451 </td>
4452
4453 <td class="entry_range">
4454 </td>
4455
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4456 <td class="entry_tags">
4457 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4458 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4459 </ul>
4460 </td>
4461
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4462 </tr>
4463 <tr class="entries_header">
4464 <th class="th_details" colspan="5">Details</th>
4465 </tr>
4466 <tr class="entry_cont">
4467 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4468 <p>If no flash,<wbr/> none of the flash controls do
4469anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4470 </td>
4471 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4472
4473
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4474 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4475 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4476
4477
4478 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4479 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4480 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4481 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4482 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4483 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4484
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4485 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4486
4487
4488 </td> <!-- entry_type -->
4489
4490 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4491 <p>Time taken before flash can fire
4492again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4493 </td>
4494
4495 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4496 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4497 </td>
4498
4499 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4500 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4501 </td>
4502
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4503 <td class="entry_tags">
4504 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4505 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4506 </ul>
4507 </td>
4508
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4509 </tr>
4510 <tr class="entries_header">
4511 <th class="th_details" colspan="5">Details</th>
4512 </tr>
4513 <tr class="entry_cont">
4514 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4515 <p>1 second too long/<wbr/>too short for recharge? Should
4516this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4517 </td>
4518 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4519
4520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4521 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4522 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4523
4524
4525
4526
4527
4528 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4529 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4530 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4531 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4532 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4533 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4534
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4535 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4536
4537
4538 </td> <!-- entry_type -->
4539
4540 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4541 <p>The x,<wbr/>y whitepoint of the
4542flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4543 </td>
4544
4545 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4546 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4547 </td>
4548
4549 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4550 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4551 </td>
4552
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4553 <td class="entry_tags">
4554 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4555 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4556 </ul>
4557 </td>
4558
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4559 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4560
4561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4562 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4563 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4564
4565
4566 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4567 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4568 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4569 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4570 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4571 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4572
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4573 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4574
4575
4576 </td> <!-- entry_type -->
4577
4578 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4579 <p>Max energy output of the flash for a full
4580power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4581 </td>
4582
4583 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4584 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4585 </td>
4586
4587 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]4588 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4589 </td>
4590
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4591 <td class="entry_tags">
4592 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4593 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4594 </ul>
4595 </td>
4596
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4597 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4598
4599
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4600 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4601 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4602
4603
4604
4605 <!-- end of kind -->
4606 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4607 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4608
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4609 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4610 <tr>
4611 <th class="th_name">Property Name</th>
4612 <th class="th_type">Type</th>
4613 <th class="th_description">Description</th>
4614 <th class="th_units">Units</th>
4615 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4616 <th class="th_tags">Tags</th>
4617 </tr>
4618 </thead>
4619
4620 <tbody>
4621
4622
4623
4624
4625
4626
4627
4628
4629
4630
4631 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4632 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4633 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4634 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4635 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4636 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4637
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4638 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4639
4640
4641 </td> <!-- entry_type -->
4642
4643 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4644 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4645 </td>
4646
4647 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4648 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4649 </td>
4650
4651 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4652 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4653 </td>
4654
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4655 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4656 <ul class="entry_tags">
4657 <li><a href="#tag_V1">V1</a></li>
4658 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4659 </td>
4660
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4661 </tr>
4662 <tr class="entries_header">
4663 <th class="th_details" colspan="5">Details</th>
4664 </tr>
4665 <tr class="entry_cont">
4666 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4667 <p>Power for snapshot may use a different scale than
4668for torch mode.<wbr/> Only one entry for torch mode will be
4669used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4670 </td>
4671 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4672
4673
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4674 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4675 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4676
4677
4678 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4679 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4680 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4681 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4682 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4683 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4684
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4685 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4686
4687
4688 </td> <!-- entry_type -->
4689
4690 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4691 <p>Firing time of flash relative to start of
4692exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4693 </td>
4694
4695 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4696 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4697 </td>
4698
4699 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4700 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4701 </td>
4702
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4703 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4704 <ul class="entry_tags">
4705 <li><a href="#tag_V1">V1</a></li>
4706 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4707 </td>
4708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4709 </tr>
4710 <tr class="entries_header">
4711 <th class="th_details" colspan="5">Details</th>
4712 </tr>
4713 <tr class="entry_cont">
4714 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4715 <p>Clamped to (0,<wbr/> exposure time - flash
4716duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4717 </td>
4718 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4719
4720
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4721 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4722 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4723
4724
4725 <tr class="entry" id="dynamic_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4726 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4727 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4728 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4729 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4730 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4731
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4732 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4733
4734 <ul class="entry_type_enum">
4735 <li>
4736 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4737 <span class="entry_type_enum_notes">Do not fire the flash for this
4738 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4739 </li>
4740 <li>
4741 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4742 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4743 for this capture based on firingPower,<wbr/>
4744 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4745 </li>
4746 <li>
4747 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4748 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4749 continuously on,<wbr/> power set by
4750 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4751 </li>
4752 </ul>
4753
4754 </td> <!-- entry_type -->
4755
4756 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4757 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4758 </td>
4759
4760 <td class="entry_units">
4761 </td>
4762
4763 <td class="entry_range">
4764 </td>
4765
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4766 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4767 <ul class="entry_tags">
4768 <li><a href="#tag_BC">BC</a></li>
4769 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4770 </td>
4771
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4772 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4773
4774
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4775 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4776 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4777
4778
4779 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4780 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4781 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4782 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4783 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4784 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4785
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4786 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4787
4788 <ul class="entry_type_enum">
4789 <li>
4790 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4791 <span class="entry_type_enum_notes">No flash on camera</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4792 </li>
4793 <li>
4794 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4795 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4796 charging and cannot be fired</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4797 </li>
4798 <li>
4799 <span class="entry_type_enum_name">READY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4800 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4801 ready to fire</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4802 </li>
4803 <li>
4804 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4805 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash fired
4806 for this capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4807 </li>
4808 </ul>
4809
4810 </td> <!-- entry_type -->
4811
4812 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4813 <p>Current state of the flash
4814unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4815 </td>
4816
4817 <td class="entry_units">
4818 </td>
4819
4820 <td class="entry_range">
4821 </td>
4822
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4823 <td class="entry_tags">
4824 </td>
4825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4826 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4827
4828
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4829 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4830 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4831
4832
4833
4834 <!-- end of kind -->
4835 </tbody>
4836
4837 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4838 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4839
4840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4841 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4842
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4843 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4844 <tr>
4845 <th class="th_name">Property Name</th>
4846 <th class="th_type">Type</th>
4847 <th class="th_description">Description</th>
4848 <th class="th_units">Units</th>
4849 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4850 <th class="th_tags">Tags</th>
4851 </tr>
4852 </thead>
4853
4854 <tbody>
4855
4856
4857
4858
4859
4860
4861
4862
4863
4864
4865 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4866 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4867 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4868 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4869 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4870 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4871
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4872 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4873
4874 <ul class="entry_type_enum">
4875 <li>
4876 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4877 <span class="entry_type_enum_notes">No geometric correction is
4878 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4879 </li>
4880 <li>
4881 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4882 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
4883 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4884 </li>
4885 <li>
4886 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4887 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4888 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4889 </li>
4890 </ul>
4891
4892 </td> <!-- entry_type -->
4893
4894 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4895 <p>Operating mode of geometric
4896correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4897 </td>
4898
4899 <td class="entry_units">
4900 </td>
4901
4902 <td class="entry_range">
4903 </td>
4904
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4905 <td class="entry_tags">
4906 </td>
4907
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4908 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4909
4910
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4911 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4912 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4913
4914
4915 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4916 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4917 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4918 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4919 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4920 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4921
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4922 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4923
4924
4925 </td> <!-- entry_type -->
4926
4927 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4928 <p>Control the amount of shading correction
4929applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4930 </td>
4931
4932 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4933 unitless: 1-10; 10 is full shading
4934 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4935 </td>
4936
4937 <td class="entry_range">
4938 </td>
4939
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4940 <td class="entry_tags">
4941 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4942 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4943 </ul>
4944 </td>
4945
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4946 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4947
4948
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4949 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4950 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4951
4952
4953
4954 <!-- end of kind -->
4955 </tbody>
4956
4957 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4958 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4959
4960
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4961 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4962
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4963 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4964 <tr>
4965 <th class="th_name">Property Name</th>
4966 <th class="th_type">Type</th>
4967 <th class="th_description">Description</th>
4968 <th class="th_units">Units</th>
4969 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4970 <th class="th_tags">Tags</th>
4971 </tr>
4972 </thead>
4973
4974 <tbody>
4975
4976
4977
4978
4979
4980
4981
4982
4983
4984
4985 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4986 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4987 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4988 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4989 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4990 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4991
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4992 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4993
4994 <ul class="entry_type_enum">
4995 <li>
4996 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4997 <span class="entry_type_enum_notes">No hot pixel correction can be
4998 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4999 </li>
5000 <li>
5001 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5002 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
5003 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5004 </li>
5005 <li>
5006 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5007 <span class="entry_type_enum_notes">Frame rate may be reduced by high
5008 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5009 </li>
5010 </ul>
5011
5012 </td> <!-- entry_type -->
5013
5014 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5015 <p>Set operational mode for hot pixel
5016correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5017 </td>
5018
5019 <td class="entry_units">
5020 </td>
5021
5022 <td class="entry_range">
5023 </td>
5024
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5025 <td class="entry_tags">
5026 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5027 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5028 </ul>
5029 </td>
5030
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5031 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5032
5033
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5034 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5035 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5036
5037
5038
5039 <!-- end of kind -->
5040 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5041 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5042
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5043 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5044 <tr>
5045 <th class="th_name">Property Name</th>
5046 <th class="th_type">Type</th>
5047 <th class="th_description">Description</th>
5048 <th class="th_units">Units</th>
5049 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5050 <th class="th_tags">Tags</th>
5051 </tr>
5052 </thead>
5053
5054 <tbody>
5055
5056
5057
5058
5059
5060
5061
5062
5063
5064
5065
5066
5067 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5068 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5069 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5070 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5071 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5072 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5073 <span class="entry_type_container">x</span>
5074
5075 <span class="entry_type_array">
5076 2 x n
5077 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5078 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5079 <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]5080
5081
5082 </td> <!-- entry_type -->
5083
5084 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5085 <p>Location of hot/<wbr/>defective pixels on
5086sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5087 </td>
5088
5089 <td class="entry_units">
5090 </td>
5091
5092 <td class="entry_range">
5093 </td>
5094
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5095 <td class="entry_tags">
5096 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5097 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5098 </ul>
5099 </td>
5100
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5101 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5102
5103
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5104 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5105 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5106
5107
5108
5109
5110
5111
5112 <!-- end of kind -->
5113 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5114 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5115
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5116 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5117 <tr>
5118 <th class="th_name">Property Name</th>
5119 <th class="th_type">Type</th>
5120 <th class="th_description">Description</th>
5121 <th class="th_units">Units</th>
5122 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5123 <th class="th_tags">Tags</th>
5124 </tr>
5125 </thead>
5126
5127 <tbody>
5128
5129
5130
5131
5132
5133
5134
5135
5136
5137
5138 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5139 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5140 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5141 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5142 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5143 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5144
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5145 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5146
5147 <ul class="entry_type_enum">
5148 <li>
5149 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5150 <span class="entry_type_enum_notes">No hot pixel correction can be
5151 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5152 </li>
5153 <li>
5154 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5155 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
5156 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5157 </li>
5158 <li>
5159 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5160 <span class="entry_type_enum_notes">Frame rate may be reduced by high
5161 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5162 </li>
5163 </ul>
5164
5165 </td> <!-- entry_type -->
5166
5167 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5168 <p>Set operational mode for hot pixel
5169correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5170 </td>
5171
5172 <td class="entry_units">
5173 </td>
5174
5175 <td class="entry_range">
5176 </td>
5177
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5178 <td class="entry_tags">
5179 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5180 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5181 </ul>
5182 </td>
5183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5184 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5185
5186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5187 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5188 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5189
5190
5191
5192 <!-- end of kind -->
5193 </tbody>
5194
5195 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5196 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5197
5198
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5199 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5200
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5201 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5202 <tr>
5203 <th class="th_name">Property Name</th>
5204 <th class="th_type">Type</th>
5205 <th class="th_description">Description</th>
5206 <th class="th_units">Units</th>
5207 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5208 <th class="th_tags">Tags</th>
5209 </tr>
5210 </thead>
5211
5212 <tbody>
5213
5214
5215
5216
5217
5218
5219
5220
5221
5222
5223 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5224 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5225 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5226 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5227 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5228 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5229 <span class="entry_type_container">x</span>
5230
5231 <span class="entry_type_array">
5232 3
5233 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5234 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5235 <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]5236
5237
5238 </td> <!-- entry_type -->
5239
5240 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5241 <p>GPS coordinates to include in output JPEG
5242EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5243 </td>
5244
5245 <td class="entry_units">
5246 </td>
5247
5248 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5249 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5250 </td>
5251
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5252 <td class="entry_tags">
5253 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5254 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5255 </ul>
5256 </td>
5257
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5258 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5259
5260
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5261 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5262 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5263
5264
5265 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5266 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5267 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5268 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5269 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5270 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5271
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5272 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5273
5274
5275 </td> <!-- entry_type -->
5276
5277 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5278 <p>32 characters describing GPS algorithm to
5279include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5280 </td>
5281
5282 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5283 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5284 </td>
5285
5286 <td class="entry_range">
5287 </td>
5288
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5289 <td class="entry_tags">
5290 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5291 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5292 </ul>
5293 </td>
5294
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5295 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5296
5297
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5298 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5299 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5300
5301
5302 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5303 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5304 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5305 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5306 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5307 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5308
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5309 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5310
5311
5312 </td> <!-- entry_type -->
5313
5314 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5315 <p>Time GPS fix was made to include in
5316EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5317 </td>
5318
5319 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5320 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5321 </td>
5322
5323 <td class="entry_range">
5324 </td>
5325
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5326 <td class="entry_tags">
5327 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5328 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5329 </ul>
5330 </td>
5331
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5332 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5333
5334
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5335 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5336 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5337
5338
5339 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5340 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5341 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5342 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5343 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5344 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5345
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5346 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5347
5348
5349 </td> <!-- entry_type -->
5350
5351 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5352 <p>Orientation of JPEG image to
5353write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5354 </td>
5355
5356 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5357 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5358 </td>
5359
5360 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5361 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5362 </td>
5363
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5364 <td class="entry_tags">
5365 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5366 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5367 </ul>
5368 </td>
5369
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5370 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5371
5372
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5373 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5374 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5375
5376
5377 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5378 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5379 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5380 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5381 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5382 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5383
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5384 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5385
5386
5387 </td> <!-- entry_type -->
5388
5389 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5390 <p>Compression quality of the final JPEG
5391image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5392 </td>
5393
5394 <td class="entry_units">
5395 </td>
5396
5397 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5398 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5399 </td>
5400
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5401 <td class="entry_tags">
5402 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5403 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5404 </ul>
5405 </td>
5406
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5407 </tr>
5408 <tr class="entries_header">
5409 <th class="th_details" colspan="5">Details</th>
5410 </tr>
5411 <tr class="entry_cont">
5412 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5413 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5414 </td>
5415 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5416
5417
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5418 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5419 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5420
5421
5422 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5423 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5424 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5425 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5426 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5427 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5428
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5429 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5430
5431
5432 </td> <!-- entry_type -->
5433
5434 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5435 <p>Compression quality of JPEG
5436thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5437 </td>
5438
5439 <td class="entry_units">
5440 </td>
5441
5442 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5443 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5444 </td>
5445
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5446 <td class="entry_tags">
5447 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5448 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5449 </ul>
5450 </td>
5451
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5452 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5453
5454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5455 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5456 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5457
5458
5459 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5460 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5461 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5462 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5463 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5464 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5465 <span class="entry_type_container">x</span>
5466
5467 <span class="entry_type_array">
5468 2
5469 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5470 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5471
5472
5473 </td> <!-- entry_type -->
5474
5475 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5476 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5477 </td>
5478
5479 <td class="entry_units">
5480 </td>
5481
5482 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5483 <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]5484 </td>
5485
5486 <td class="entry_tags">
5487 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5488 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5489 </ul>
5490 </td>
5491
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5492 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5493 <tr class="entries_header">
5494 <th class="th_details" colspan="5">Details</th>
5495 </tr>
5496 <tr class="entry_cont">
5497 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5498 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5499but the captured JPEG must still be a valid image.<wbr/></p>
5500<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5501the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5502 </td>
5503 </tr>
5504
5505
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5506 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5507 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5508
5509
5510
5511 <!-- end of kind -->
5512 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5513 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5514
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5515 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5516 <tr>
5517 <th class="th_name">Property Name</th>
5518 <th class="th_type">Type</th>
5519 <th class="th_description">Description</th>
5520 <th class="th_units">Units</th>
5521 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5522 <th class="th_tags">Tags</th>
5523 </tr>
5524 </thead>
5525
5526 <tbody>
5527
5528
5529
5530
5531
5532
5533
5534
5535
5536
5537 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5538 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5539 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5540 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5541 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5542 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5543 <span class="entry_type_container">x</span>
5544
5545 <span class="entry_type_array">
5546 2 x n
5547 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5548 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5549
5550
5551 </td> <!-- entry_type -->
5552
5553 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5554 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5555 </td>
5556
5557 <td class="entry_units">
5558 </td>
5559
5560 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5561 <p>Must include at least one valid resolution,<wbr/> plus
5562(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]5563 </td>
5564
5565 <td class="entry_tags">
5566 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5567 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5568 </ul>
5569 </td>
5570
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5571 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5572 <tr class="entries_header">
5573 <th class="th_details" colspan="5">Details</th>
5574 </tr>
5575 <tr class="entry_cont">
5576 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5577 <p>Below condiditions must be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5578<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5579<li>The sizes must be sorted by increasing pixel area (width x height).<wbr/>
5580If 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]5581<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]5582aspect 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]5583The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5584in a given size list.<wbr/></li>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5585<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]5586one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
5587and vice versa.<wbr/></li>
5588<li>All non (0,<wbr/> 0) sizes must have non-zero widths and heights.<wbr/></li>
5589</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5590 </td>
5591 </tr>
5592
5593
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5594 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5595 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5596
5597
5598 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5599 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5600 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5601 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5602 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5603 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5604
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5605 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5606
5607
5608 </td> <!-- entry_type -->
5609
5610 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5611 <p>Maximum size in bytes for the compressed
5612JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5613 </td>
5614
5615 <td class="entry_units">
5616 </td>
5617
5618 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5619 <p>Must be large enough to fit any JPEG produced by
5620the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5621 </td>
5622
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5623 <td class="entry_tags">
5624 </td>
5625
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5626 </tr>
5627 <tr class="entries_header">
5628 <th class="th_details" colspan="5">Details</th>
5629 </tr>
5630 <tr class="entry_cont">
5631 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5632 <p>This is used for sizing the gralloc buffers for
5633JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5634 </td>
5635 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5636
5637
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5638 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5639 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5640
5641
5642
5643 <!-- end of kind -->
5644 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5645 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5646
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5647 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5648 <tr>
5649 <th class="th_name">Property Name</th>
5650 <th class="th_type">Type</th>
5651 <th class="th_description">Description</th>
5652 <th class="th_units">Units</th>
5653 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5654 <th class="th_tags">Tags</th>
5655 </tr>
5656 </thead>
5657
5658 <tbody>
5659
5660
5661
5662
5663
5664
5665
5666
5667
5668
5669 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5670 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5671 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5672 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5673 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5674 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5675 <span class="entry_type_container">x</span>
5676
5677 <span class="entry_type_array">
5678 3
5679 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5680 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5681 <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]5682
5683
5684 </td> <!-- entry_type -->
5685
5686 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5687 <p>GPS coordinates to include in output JPEG
5688EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5689 </td>
5690
5691 <td class="entry_units">
5692 </td>
5693
5694 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5695 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5696 </td>
5697
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5698 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5699 <ul class="entry_tags">
5700 <li><a href="#tag_BC">BC</a></li>
5701 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5702 </td>
5703
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5704 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5705
5706
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5707 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5708 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5709
5710
5711 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5712 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5713 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5714 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5715 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5716 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5717
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5718 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5719
5720
5721 </td> <!-- entry_type -->
5722
5723 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5724 <p>32 characters describing GPS algorithm to
5725include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5726 </td>
5727
5728 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5729 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5730 </td>
5731
5732 <td class="entry_range">
5733 </td>
5734
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5735 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5736 <ul class="entry_tags">
5737 <li><a href="#tag_BC">BC</a></li>
5738 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5739 </td>
5740
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5741 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5742
5743
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5744 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5745 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5746
5747
5748 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5749 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5750 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5751 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5752 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5753 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5754
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5755 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5756
5757
5758 </td> <!-- entry_type -->
5759
5760 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5761 <p>Time GPS fix was made to include in
5762EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5763 </td>
5764
5765 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5766 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5767 </td>
5768
5769 <td class="entry_range">
5770 </td>
5771
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5772 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5773 <ul class="entry_tags">
5774 <li><a href="#tag_BC">BC</a></li>
5775 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5776 </td>
5777
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5778 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5779
5780
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5781 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5782 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5783
5784
5785 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5786 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5787 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5788 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5789 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5790 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5791
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5792 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5793
5794
5795 </td> <!-- entry_type -->
5796
5797 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5798 <p>Orientation of JPEG image to
5799write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5800 </td>
5801
5802 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5803 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5804 </td>
5805
5806 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5807 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5808 </td>
5809
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5810 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5811 <ul class="entry_tags">
5812 <li><a href="#tag_BC">BC</a></li>
5813 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5814 </td>
5815
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5816 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5817
5818
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5819 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5820 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5821
5822
5823 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5824 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5825 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5826 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5827 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5828 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5829
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5830 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5831
5832
5833 </td> <!-- entry_type -->
5834
5835 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5836 <p>Compression quality of the final JPEG
5837image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5838 </td>
5839
5840 <td class="entry_units">
5841 </td>
5842
5843 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5844 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5845 </td>
5846
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5847 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5848 <ul class="entry_tags">
5849 <li><a href="#tag_BC">BC</a></li>
5850 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5851 </td>
5852
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5853 </tr>
5854 <tr class="entries_header">
5855 <th class="th_details" colspan="5">Details</th>
5856 </tr>
5857 <tr class="entry_cont">
5858 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5859 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5860 </td>
5861 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5862
5863
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5864 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5865 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5866
5867
5868 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5869 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5870 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5871 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5872 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5873 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5874
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5875 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5876
5877
5878 </td> <!-- entry_type -->
5879
5880 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5881 <p>The size of the compressed JPEG image,<wbr/> in
5882bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5883 </td>
5884
5885 <td class="entry_units">
5886 </td>
5887
5888 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]5889 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5890 </td>
5891
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5892 <td class="entry_tags">
5893 </td>
5894
5895 </tr>
5896 <tr class="entries_header">
5897 <th class="th_details" colspan="5">Details</th>
5898 </tr>
5899 <tr class="entry_cont">
5900 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5901 <p>If no JPEG output is produced for the request,<wbr/>
5902this must be 0.<wbr/></p>
5903<p>Otherwise,<wbr/> this describes the real size of the compressed
5904JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5905if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
5906has <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]5907the JPEG stream will be 1000000 bytes,<wbr/> of which the first
5908500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5909 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5910 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5911
5912
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5913 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5914 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5915
5916
5917 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5918 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5919 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5920 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5921 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5922 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5923
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5924 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5925
5926
5927 </td> <!-- entry_type -->
5928
5929 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5930 <p>Compression quality of JPEG
5931thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5932 </td>
5933
5934 <td class="entry_units">
5935 </td>
5936
5937 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5938 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5939 </td>
5940
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5941 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5942 <ul class="entry_tags">
5943 <li><a href="#tag_BC">BC</a></li>
5944 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5945 </td>
5946
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5947 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5948
5949
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5950 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5951 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5952
5953
5954 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5955 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5956 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5957 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5958 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5959 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5960 <span class="entry_type_container">x</span>
5961
5962 <span class="entry_type_array">
5963 2
5964 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5965 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5966
5967
5968 </td> <!-- entry_type -->
5969
5970 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5971 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5972 </td>
5973
5974 <td class="entry_units">
5975 </td>
5976
5977 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5978 <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]5979 </td>
5980
5981 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5982 <ul class="entry_tags">
5983 <li><a href="#tag_BC">BC</a></li>
5984 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5985 </td>
5986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5987 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5988 <tr class="entries_header">
5989 <th class="th_details" colspan="5">Details</th>
5990 </tr>
5991 <tr class="entry_cont">
5992 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5993 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5994but the captured JPEG must still be a valid image.<wbr/></p>
5995<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5996the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5997 </td>
5998 </tr>
5999
6000
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6001 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6002 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6003
6004
6005
6006 <!-- end of kind -->
6007 </tbody>
6008
6009 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6010 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6011
6012
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6013 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6014
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6015 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6016 <tr>
6017 <th class="th_name">Property Name</th>
6018 <th class="th_type">Type</th>
6019 <th class="th_description">Description</th>
6020 <th class="th_units">Units</th>
6021 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6022 <th class="th_tags">Tags</th>
6023 </tr>
6024 </thead>
6025
6026 <tbody>
6027
6028
6029
6030
6031
6032
6033
6034
6035
6036
6037 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6038 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6039 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6040 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6041 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6042 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6043
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6044 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6045
6046
6047 </td> <!-- entry_type -->
6048
6049 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame^]6050 <p>The ratio of lens focal length to the effective
6051aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6052 </td>
6053
6054 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6055 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6056 </td>
6057
6058 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6059 <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]6060 </td>
6061
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6062 <td class="entry_tags">
6063 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6064 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6065 </ul>
6066 </td>
6067
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6068 </tr>
6069 <tr class="entries_header">
6070 <th class="th_details" colspan="5">Details</th>
6071 </tr>
6072 <tr class="entry_cont">
6073 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame^]6074 <p>This will only be supported on the camera devices that
6075have variable aperture lens.<wbr/> The aperture value can only be
6076one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
6077<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
6078this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
6079<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
6080to achieve manual exposure control.<wbr/></p>
6081<p>The requested aperture value may take several frames to reach the
6082requested value; the camera device will report the current (intermediate)
6083aperture size in capture result metadata while the aperture is changing.<wbr/></p>
6084<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
6085the ON modes,<wbr/> this will be overridden by the camera device
6086auto-exposure algorithm,<wbr/> the overridden values are then provided
6087back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6088 </td>
6089 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6090
6091
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6092 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6093 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6094
6095
6096 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6097 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6098 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6099 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6100 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6101 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6102
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6103 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6104
6105
6106 </td> <!-- entry_type -->
6107
6108 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6109 <p>State of lens neutral density
6110filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6111 </td>
6112
6113 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6114 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6115 </td>
6116
6117 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6118 <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]6119 </td>
6120
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6121 <td class="entry_tags">
6122 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6123 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6124 </ul>
6125 </td>
6126
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6127 </tr>
6128 <tr class="entries_header">
6129 <th class="th_details" colspan="5">Details</th>
6130 </tr>
6131 <tr class="entry_cont">
6132 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6133 <p>Will not be supported on most devices.<wbr/> Can only
6134pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6135 </td>
6136 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6137
6138
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6139 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6140 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6141
6142
6143 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6144 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6145 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6146 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6147 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6148 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6149
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6150 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6151
6152
6153 </td> <!-- entry_type -->
6154
6155 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6156 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6157 </td>
6158
6159 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6160 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6161 </td>
6162
6163 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6164 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6165 </td>
6166
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6167 <td class="entry_tags">
6168 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6169 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6170 </ul>
6171 </td>
6172
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6173 </tr>
6174 <tr class="entries_header">
6175 <th class="th_details" colspan="5">Details</th>
6176 </tr>
6177 <tr class="entry_cont">
6178 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6179 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6180 </td>
6181 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6182
6183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6184 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6185 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6186
6187
6188 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6189 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6190 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6191 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6192 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6193 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6194
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6195 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6196
6197
6198 </td> <!-- entry_type -->
6199
6200 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6201 <p>Distance to plane of sharpest focus,<wbr/>
6202measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6203 </td>
6204
6205 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6206 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6207 </td>
6208
6209 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6210 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6211 </td>
6212
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6213 <td class="entry_tags">
6214 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6215 <li><a href="#tag_BC">BC</a></li>
6216 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6217 </ul>
6218 </td>
6219
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6220 </tr>
6221 <tr class="entries_header">
6222 <th class="th_details" colspan="5">Details</th>
6223 </tr>
6224 <tr class="entry_cont">
6225 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6226 <p>0 = infinity focus.<wbr/> Used value should be clamped
6227to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6228 </td>
6229 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6230
6231
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6232 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6233 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6234
6235
6236 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6237 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6238 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6239 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6240 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6241 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6242
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6243 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6244
6245 <ul class="entry_type_enum">
6246 <li>
6247 <span class="entry_type_enum_name">OFF</span>
6248 </li>
6249 <li>
6250 <span class="entry_type_enum_name">ON</span>
6251 <span class="entry_type_enum_optional">optional</span>
6252 </li>
6253 </ul>
6254
6255 </td> <!-- entry_type -->
6256
6257 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6258 <p>Whether optical image stabilization is
6259enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6260 </td>
6261
6262 <td class="entry_units">
6263 </td>
6264
6265 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6266 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6267 </td>
6268
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6269 <td class="entry_tags">
6270 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6271 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6272 </ul>
6273 </td>
6274
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6275 </tr>
6276 <tr class="entries_header">
6277 <th class="th_details" colspan="5">Details</th>
6278 </tr>
6279 <tr class="entry_cont">
6280 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6281 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6282 </td>
6283 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6284
6285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6286 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6287 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6288
6289
6290
6291 <!-- end of kind -->
6292 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6293 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6294
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6295 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6296 <tr>
6297 <th class="th_name">Property Name</th>
6298 <th class="th_type">Type</th>
6299 <th class="th_description">Description</th>
6300 <th class="th_units">Units</th>
6301 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6302 <th class="th_tags">Tags</th>
6303 </tr>
6304 </thead>
6305
6306 <tbody>
6307
6308
6309
6310
6311
6312
6313
6314
6315
6316
6317
6318
6319 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6320 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6321 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6322 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6323 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6324 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6325 <span class="entry_type_container">x</span>
6326
6327 <span class="entry_type_array">
6328 n
6329 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6330 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6331
6332
6333 </td> <!-- entry_type -->
6334
6335 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6336 <p>List of supported aperture
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame^]6337values.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6338 </td>
6339
6340 <td class="entry_units">
6341 </td>
6342
6343 <td class="entry_range">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame^]6344 <p>one entry required,<wbr/> &amp;&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6345 </td>
6346
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6347 <td class="entry_tags">
6348 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6349 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6350 </ul>
6351 </td>
6352
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6353 </tr>
6354 <tr class="entries_header">
6355 <th class="th_details" colspan="5">Details</th>
6356 </tr>
6357 <tr class="entry_cont">
6358 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame^]6359 <p>If the camera device doesn't support variable apertures,<wbr/>
6360listed value will be the fixed aperture.<wbr/></p>
6361<p>If the camera device supports variable apertures,<wbr/> the aperture value
6362in this list will be sorted in ascending order.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6363 </td>
6364 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6365
6366
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6367 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6368 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6369
6370
6371 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6372 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6373 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6374 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6375 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6376 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6377 <span class="entry_type_container">x</span>
6378
6379 <span class="entry_type_array">
6380 n
6381 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6382 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6383
6384
6385 </td> <!-- entry_type -->
6386
6387 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6388 <p>List of supported ND filter
6389values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6390 </td>
6391
6392 <td class="entry_units">
6393 </td>
6394
6395 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6396 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6397 </td>
6398
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6399 <td class="entry_tags">
6400 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6401 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6402 </ul>
6403 </td>
6404
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6405 </tr>
6406 <tr class="entries_header">
6407 <th class="th_details" colspan="5">Details</th>
6408 </tr>
6409 <tr class="entry_cont">
6410 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6411 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6412lists the available exposure index values for dimming
6413(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6414light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6415 </td>
6416 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6417
6418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6419 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6420 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6421
6422
6423 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6424 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6425 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6426 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6427 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6428 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6429 <span class="entry_type_container">x</span>
6430
6431 <span class="entry_type_array">
6432 n
6433 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6434 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6435 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6436
6437
6438 </td> <!-- entry_type -->
6439
6440 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6441 <p>If fitted with optical zoom,<wbr/> what focal
6442lengths are available.<wbr/> If not,<wbr/> the static focal
6443length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6444 </td>
6445
6446 <td class="entry_units">
6447 </td>
6448
6449 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6450 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6451 </td>
6452
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6453 <td class="entry_tags">
6454 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6455 <li><a href="#tag_BC">BC</a></li>
6456 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6457 </ul>
6458 </td>
6459
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6460 </tr>
6461 <tr class="entries_header">
6462 <th class="th_details" colspan="5">Details</th>
6463 </tr>
6464 <tr class="entry_cont">
6465 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6466 <p>If optical zoom not supported,<wbr/> only one value
6467should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6468 </td>
6469 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6470
6471
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6472 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6473 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6474
6475
6476 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6477 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6478 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6479 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6480 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6481 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6482 <span class="entry_type_container">x</span>
6483
6484 <span class="entry_type_array">
6485 n
6486 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6487 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6488 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6489
6490
6491 </td> <!-- entry_type -->
6492
6493 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6494 <p>List of supported optical image
6495stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6496 </td>
6497
6498 <td class="entry_units">
6499 </td>
6500
6501 <td class="entry_range">
6502 </td>
6503
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6504 <td class="entry_tags">
6505 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6506 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6507 </ul>
6508 </td>
6509
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6510 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6511
6512
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6513 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6514 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6515
6516
6517 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6518 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6519 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6520 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6521 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6522 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6523 <span class="entry_type_container">x</span>
6524
6525 <span class="entry_type_array">
6526 2 x 3 x n x m
6527 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6528 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6529 <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]6530
6531
6532 </td> <!-- entry_type -->
6533
6534 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6535 <p>A low-resolution map for correction of
6536geometric distortions and chromatic aberrations,<wbr/> per
6537color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6538 </td>
6539
6540 <td class="entry_units">
6541 </td>
6542
6543 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6544 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6545 </td>
6546
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6547 <td class="entry_tags">
6548 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6549 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6550 </ul>
6551 </td>
6552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6553 </tr>
6554 <tr class="entries_header">
6555 <th class="th_details" colspan="5">Details</th>
6556 </tr>
6557 <tr class="entry_cont">
6558 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6559 <p>[DNG wants a function instead].<wbr/> What's easiest
6560for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
6561j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
6562j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
6563entry 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]6564 </td>
6565 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6566
6567
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6568 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6569 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6570
6571
6572 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6573 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6574 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6575 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6576 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6577 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6578 <span class="entry_type_container">x</span>
6579
6580 <span class="entry_type_array">
6581 2
6582 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6583 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6584 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6585
6586
6587 </td> <!-- entry_type -->
6588
6589 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6590 <p>Dimensions of geometric correction
6591map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6592 </td>
6593
6594 <td class="entry_units">
6595 </td>
6596
6597 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6598 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6599 </td>
6600
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6601 <td class="entry_tags">
6602 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6603 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6604 </ul>
6605 </td>
6606
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6607 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6608
6609
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6610 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6611 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6612
6613
6614 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6615 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6616 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6617 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6618 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6619 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6620
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6621 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6622
6623
6624 </td> <!-- entry_type -->
6625
6626 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6627 <p>Hyperfocal distance for this lens; set to
66280 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6629 </td>
6630
6631 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6632 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6633 </td>
6634
6635 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6636 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6637 </td>
6638
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6639 <td class="entry_tags">
6640 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6641 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6642 </ul>
6643 </td>
6644
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6645 </tr>
6646 <tr class="entries_header">
6647 <th class="th_details" colspan="5">Details</th>
6648 </tr>
6649 <tr class="entry_cont">
6650 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6651 <p>The hyperfocal distance is used for the old
6652API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6653 </td>
6654 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6655
6656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6657 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6658 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6659
6660
6661 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6662 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6663 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6664 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6665 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6666 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6667
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6668 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6669
6670
6671 </td> <!-- entry_type -->
6672
6673 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6674 <p>Shortest distance from frontmost surface
6675of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6676 </td>
6677
6678 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6679 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6680 </td>
6681
6682 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6683 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6684 </td>
6685
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6686 <td class="entry_tags">
6687 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6688 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6689 </ul>
6690 </td>
6691
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6692 </tr>
6693 <tr class="entries_header">
6694 <th class="th_details" colspan="5">Details</th>
6695 </tr>
6696 <tr class="entry_cont">
6697 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6698 <p>If the lens is fixed-focus,<wbr/> this should be
66990</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6700 </td>
6701 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6702
6703
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6704 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6705 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6706
6707
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6708 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6709 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6710 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6711 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6712 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6713 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6714 <span class="entry_type_container">x</span>
6715
6716 <span class="entry_type_array">
6717 2
6718 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6719 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6720 <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]6721
6722
6723 </td> <!-- entry_type -->
6724
6725 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6726 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6727 </td>
6728
6729 <td class="entry_units">
6730 </td>
6731
6732 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6733 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6734 </td>
6735
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6736 <td class="entry_tags">
6737 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6738 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6739 </ul>
6740 </td>
6741
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6742 </tr>
6743 <tr class="entries_header">
6744 <th class="th_details" colspan="5">Details</th>
6745 </tr>
6746 <tr class="entry_cont">
6747 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6748 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
6749must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6750 </td>
6751 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6752
6753
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6754 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6755 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6756
6757
6758
6759
6760
6761 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6762 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6763 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6764 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6765 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6766 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6767
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6768 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6769
6770 <ul class="entry_type_enum">
6771 <li>
6772 <span class="entry_type_enum_name">FRONT</span>
6773 </li>
6774 <li>
6775 <span class="entry_type_enum_name">BACK</span>
6776 </li>
6777 </ul>
6778
6779 </td> <!-- entry_type -->
6780
6781 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6782 <p>Direction the camera faces relative to
6783device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6784 </td>
6785
6786 <td class="entry_units">
6787 </td>
6788
6789 <td class="entry_range">
6790 </td>
6791
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6792 <td class="entry_tags">
6793 </td>
6794
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6795 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6796
6797
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6798 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6799 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6800
6801
6802 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6803 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6804 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6805 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6806 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6807 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6808 <span class="entry_type_container">x</span>
6809
6810 <span class="entry_type_array">
6811 2
6812 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6813 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6814 <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]6815
6816
6817 </td> <!-- entry_type -->
6818
6819 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6820 <p>Relative angle of camera optical axis to the
6821perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6822 </td>
6823
6824 <td class="entry_units">
6825 </td>
6826
6827 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6828 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6829 </td>
6830
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6831 <td class="entry_tags">
6832 <ul class="entry_tags">
6833 <li><a href="#tag_ADV">ADV</a></li>
6834 </ul>
6835 </td>
6836
6837 </tr>
6838 <tr class="entries_header">
6839 <th class="th_details" colspan="5">Details</th>
6840 </tr>
6841 <tr class="entry_cont">
6842 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6843 <p>Examples:</p>
6844<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6845is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6846<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6847device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6848<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
6849the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6850<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6851direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6852 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6853 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6854
6855
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6856 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6857 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6858
6859
6860 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6861 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6862 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6863 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6864 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6865 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6866 <span class="entry_type_container">x</span>
6867
6868 <span class="entry_type_array">
6869 3, location in mm, in the sensor coordinate
6870 system
6871 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6872 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6873
6874
6875 </td> <!-- entry_type -->
6876
6877 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6878 <p>Coordinates of camera optical axis on
6879device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6880 </td>
6881
6882 <td class="entry_units">
6883 </td>
6884
6885 <td class="entry_range">
6886 </td>
6887
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6888 <td class="entry_tags">
6889 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6890 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6891 </ul>
6892 </td>
6893
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6894 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6895
6896
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6897 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6898 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6899
6900
6901
6902 <!-- end of kind -->
6903 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6904 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6905
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6906 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6907 <tr>
6908 <th class="th_name">Property Name</th>
6909 <th class="th_type">Type</th>
6910 <th class="th_description">Description</th>
6911 <th class="th_units">Units</th>
6912 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6913 <th class="th_tags">Tags</th>
6914 </tr>
6915 </thead>
6916
6917 <tbody>
6918
6919
6920
6921
6922
6923
6924
6925
6926
6927
6928 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6929 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6930 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6931 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6932 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6933 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6934
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6935 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6936
6937
6938 </td> <!-- entry_type -->
6939
6940 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame^]6941 <p>The ratio of lens focal length to the effective
6942aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6943 </td>
6944
6945 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6946 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6947 </td>
6948
6949 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6950 <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]6951 </td>
6952
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6953 <td class="entry_tags">
6954 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6955 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6956 </ul>
6957 </td>
6958
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6959 </tr>
6960 <tr class="entries_header">
6961 <th class="th_details" colspan="5">Details</th>
6962 </tr>
6963 <tr class="entry_cont">
6964 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame^]6965 <p>This will only be supported on the camera devices that
6966have variable aperture lens.<wbr/> The aperture value can only be
6967one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
6968<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
6969this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
6970<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
6971to achieve manual exposure control.<wbr/></p>
6972<p>The requested aperture value may take several frames to reach the
6973requested value; the camera device will report the current (intermediate)
6974aperture size in capture result metadata while the aperture is changing.<wbr/></p>
6975<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
6976the ON modes,<wbr/> this will be overridden by the camera device
6977auto-exposure algorithm,<wbr/> the overridden values are then provided
6978back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6979 </td>
6980 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6981
6982
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6983 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6984 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6985
6986
6987 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6988 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6989 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6990 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6991 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6992 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6993
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6994 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6995
6996
6997 </td> <!-- entry_type -->
6998
6999 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7000 <p>State of lens neutral density
7001filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7002 </td>
7003
7004 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7005 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7006 </td>
7007
7008 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7009 <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]7010 </td>
7011
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7012 <td class="entry_tags">
7013 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7014 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7015 </ul>
7016 </td>
7017
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7018 </tr>
7019 <tr class="entries_header">
7020 <th class="th_details" colspan="5">Details</th>
7021 </tr>
7022 <tr class="entry_cont">
7023 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7024 <p>Will not be supported on most devices.<wbr/> Can only
7025pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7026 </td>
7027 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7028
7029
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7030 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7031 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7032
7033
7034 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7035 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7036 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7037 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7038 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7039 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7040
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7041 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7042
7043
7044 </td> <!-- entry_type -->
7045
7046 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7047 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7048 </td>
7049
7050 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7051 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7052 </td>
7053
7054 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7055 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7056 </td>
7057
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7058 <td class="entry_tags">
7059 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7060 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7061 </ul>
7062 </td>
7063
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7064 </tr>
7065 <tr class="entries_header">
7066 <th class="th_details" colspan="5">Details</th>
7067 </tr>
7068 <tr class="entry_cont">
7069 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7070 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7071 </td>
7072 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7073
7074
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7075 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7076 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7077
7078
7079 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7080 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7081 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7082 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7083 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7084 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7085
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7086 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7087
7088
7089 </td> <!-- entry_type -->
7090
7091 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7092 <p>Distance to plane of sharpest focus,<wbr/>
7093measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7094 </td>
7095
7096 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7097 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7098 </td>
7099
7100 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7101 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7102 </td>
7103
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7104 <td class="entry_tags">
7105 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7106 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7107 </ul>
7108 </td>
7109
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7110 </tr>
7111 <tr class="entries_header">
7112 <th class="th_details" colspan="5">Details</th>
7113 </tr>
7114 <tr class="entry_cont">
7115 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7116 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7117 </td>
7118 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7119
7120
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7121 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7122 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7123
7124
7125 <tr class="entry" id="dynamic_android.lens.focusRange">
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/>lens.<wbr/>focus<wbr/>Range
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">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7131 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7132
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7133 <span class="entry_type_array">
7134 2
7135 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7136 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7137 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7138
7139
7140 </td> <!-- entry_type -->
7141
7142 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7143 <p>The range of scene distances that are in
7144sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7145 </td>
7146
7147 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7148 pair of focus distances in diopters: (near,<wbr/>
7149 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7150 </td>
7151
7152 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7153 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7154 </td>
7155
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7156 <td class="entry_tags">
7157 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7158 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7159 </ul>
7160 </td>
7161
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7162 </tr>
7163 <tr class="entries_header">
7164 <th class="th_details" colspan="5">Details</th>
7165 </tr>
7166 <tr class="entry_cont">
7167 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7168 <p>If variable focus not supported,<wbr/> can still report
7169fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7170 </td>
7171 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7172
7173
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7174 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7175 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7176
7177
7178 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7179 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7180 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7181 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7182 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7183 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7184
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7185 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7186
7187 <ul class="entry_type_enum">
7188 <li>
7189 <span class="entry_type_enum_name">OFF</span>
7190 </li>
7191 <li>
7192 <span class="entry_type_enum_name">ON</span>
7193 <span class="entry_type_enum_optional">optional</span>
7194 </li>
7195 </ul>
7196
7197 </td> <!-- entry_type -->
7198
7199 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7200 <p>Whether optical image stabilization is
7201enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7202 </td>
7203
7204 <td class="entry_units">
7205 </td>
7206
7207 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7208 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7209 </td>
7210
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7211 <td class="entry_tags">
7212 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7213 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7214 </ul>
7215 </td>
7216
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7217 </tr>
7218 <tr class="entries_header">
7219 <th class="th_details" colspan="5">Details</th>
7220 </tr>
7221 <tr class="entry_cont">
7222 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7223 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7224 </td>
7225 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7226
7227
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7228 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7229 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7230
7231
7232 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7233 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7234 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7235 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7236 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7237 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7238
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7239 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7240
7241 <ul class="entry_type_enum">
7242 <li>
7243 <span class="entry_type_enum_name">STATIONARY</span>
7244 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7245 <li>
7246 <span class="entry_type_enum_name">MOVING</span>
7247 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7248 </ul>
7249
7250 </td> <!-- entry_type -->
7251
7252 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7253 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7254 </td>
7255
7256 <td class="entry_units">
7257 </td>
7258
7259 <td class="entry_range">
7260 </td>
7261
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7262 <td class="entry_tags">
7263 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7264 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7265 </ul>
7266 </td>
7267
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7268 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7269
7270
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7271 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7272 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7273
7274
7275
7276 <!-- end of kind -->
7277 </tbody>
7278
7279 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7280 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7281
7282
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7283 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7284
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7285 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7286 <tr>
7287 <th class="th_name">Property Name</th>
7288 <th class="th_type">Type</th>
7289 <th class="th_description">Description</th>
7290 <th class="th_units">Units</th>
7291 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7292 <th class="th_tags">Tags</th>
7293 </tr>
7294 </thead>
7295
7296 <tbody>
7297
7298
7299
7300
7301
7302
7303
7304
7305
7306
7307 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7308 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7309 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7310 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7311 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7312 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7313
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7314 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7315
7316 <ul class="entry_type_enum">
7317 <li>
7318 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7319 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7320 </li>
7321 <li>
7322 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7323 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7324 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7325 </li>
7326 <li>
7327 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7328 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7329 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7330 </li>
7331 </ul>
7332
7333 </td> <!-- entry_type -->
7334
7335 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7336 <p>Mode of operation for the noise reduction
7337algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7338 </td>
7339
7340 <td class="entry_units">
7341 </td>
7342
7343 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7344 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7345 </td>
7346
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7347 <td class="entry_tags">
7348 <ul class="entry_tags">
7349 <li><a href="#tag_V1">V1</a></li>
7350 </ul>
7351 </td>
7352
7353 </tr>
7354 <tr class="entries_header">
7355 <th class="th_details" colspan="5">Details</th>
7356 </tr>
7357 <tr class="entry_cont">
7358 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7359 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7360will be applied by the HAL.<wbr/></p>
7361<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7362will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7363should use the highest-quality noise filtering algorithms,<wbr/>
7364even if it slows down capture rate.<wbr/> FAST means the HAL should not
7365slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7366 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7367 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7368
7369
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7370 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7371 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7372
7373
7374 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7375 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7376 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7377 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7378 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7379 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7380
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7381 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7382
7383
7384 </td> <!-- entry_type -->
7385
7386 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7387 <p>Control the amount of noise reduction
7388applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7389 </td>
7390
7391 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7392 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7393 </td>
7394
7395 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7396 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7397 </td>
7398
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7399 <td class="entry_tags">
7400 </td>
7401
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7402 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7403
7404
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7405 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7406 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7407
7408
7409
7410 <!-- end of kind -->
7411 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7412 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7413
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7414 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7415 <tr>
7416 <th class="th_name">Property Name</th>
7417 <th class="th_type">Type</th>
7418 <th class="th_description">Description</th>
7419 <th class="th_units">Units</th>
7420 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7421 <th class="th_tags">Tags</th>
7422 </tr>
7423 </thead>
7424
7425 <tbody>
7426
7427
7428
7429
7430
7431
7432
7433
7434
7435
7436 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7437 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7438 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7439 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7440 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7441 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7442
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7443 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7444
7445 <ul class="entry_type_enum">
7446 <li>
7447 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7448 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7449 </li>
7450 <li>
7451 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7452 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7453 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7454 </li>
7455 <li>
7456 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7457 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7458 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7459 </li>
7460 </ul>
7461
7462 </td> <!-- entry_type -->
7463
7464 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7465 <p>Mode of operation for the noise reduction
7466algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7467 </td>
7468
7469 <td class="entry_units">
7470 </td>
7471
7472 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7473 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7474 </td>
7475
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7476 <td class="entry_tags">
7477 <ul class="entry_tags">
7478 <li><a href="#tag_V1">V1</a></li>
7479 </ul>
7480 </td>
7481
7482 </tr>
7483 <tr class="entries_header">
7484 <th class="th_details" colspan="5">Details</th>
7485 </tr>
7486 <tr class="entry_cont">
7487 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7488 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7489will be applied by the HAL.<wbr/></p>
7490<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7491will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7492should use the highest-quality noise filtering algorithms,<wbr/>
7493even if it slows down capture rate.<wbr/> FAST means the HAL should not
7494slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7495 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7496 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7497
7498
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7499 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7500 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7501
7502
7503
7504 <!-- end of kind -->
7505 </tbody>
7506
7507 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7508 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7509
7510
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7511 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7512
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7513 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7514 <tr>
7515 <th class="th_name">Property Name</th>
7516 <th class="th_type">Type</th>
7517 <th class="th_description">Description</th>
7518 <th class="th_units">Units</th>
7519 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7520 <th class="th_tags">Tags</th>
7521 </tr>
7522 </thead>
7523
7524 <tbody>
7525
7526
7527
7528
7529
7530
7531
7532
7533
7534
7535 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7536 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7537 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7538 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7539 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7540 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7541
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7542 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7543
7544
7545 </td> <!-- entry_type -->
7546
7547 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7548 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7549scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7550region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
7551and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7552 </td>
7553
7554 <td class="entry_units">
7555 </td>
7556
7557 <td class="entry_range">
7558 </td>
7559
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7560 <td class="entry_tags">
7561 </td>
7562
7563 </tr>
7564 <tr class="entries_header">
7565 <th class="th_details" colspan="5">Details</th>
7566 </tr>
7567 <tr class="entry_cont">
7568 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7569 <p>Normalized coordinates refer to those in the
7570(-1000,<wbr/>1000) range mentioned in the
7571android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7572<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7573sensor array-relative coordinates for all region data.<wbr/> Does
7574not need to be listed in static metadata.<wbr/> Support will be
7575removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7576 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7577 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7578
7579
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7580 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7581 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7582
7583
7584 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7585 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7586 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7587 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7588 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7589 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7590
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7591 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7592
7593
7594 </td> <!-- entry_type -->
7595
7596 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7597 <p>If set to 1,<wbr/> then the camera service always
7598switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
7599trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7600 </td>
7601
7602 <td class="entry_units">
7603 </td>
7604
7605 <td class="entry_range">
7606 </td>
7607
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7608 <td class="entry_tags">
7609 </td>
7610
7611 </tr>
7612 <tr class="entries_header">
7613 <th class="th_details" colspan="5">Details</th>
7614 </tr>
7615 <tr class="entry_cont">
7616 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7617 <p>HAL implementations should implement AF trigger
7618modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
7619CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
7620not need to be listed in static metadata.<wbr/> Support will be
7621removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7622 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7623 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7624
7625
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7626 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7627 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7628
7629
7630 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7631 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7632 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7633 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7634 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7635 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7636
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7637 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7638
7639
7640 </td> <!-- entry_type -->
7641
7642 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7643 <p>If set to 1,<wbr/> the camera service uses
7644CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
7645HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
7646shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7647 </td>
7648
7649 <td class="entry_units">
7650 </td>
7651
7652 <td class="entry_range">
7653 </td>
7654
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7655 <td class="entry_tags">
7656 </td>
7657
7658 </tr>
7659 <tr class="entries_header">
7660 <th class="th_details" colspan="5">Details</th>
7661 </tr>
7662 <tr class="entry_cont">
7663 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7664 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7665to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7666zero-shutter-lag,<wbr/> instead of relying on an explicit
7667format setting.<wbr/> Does not need to be listed in static
7668metadata.<wbr/> Support will be removed in future versions of
7669camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7670 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7671 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7672
7673
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7674 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7675 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7676
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7677
7678 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7679 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7680 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7681 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7682 <td class="entry_type">
7683 <span class="entry_type_name">byte</span>
7684
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7685 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7686
7687
7688 </td> <!-- entry_type -->
7689
7690 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7691 <p>If set to 1,<wbr/> the HAL will always split result
7692metadata for a single capture into multiple buffers,<wbr/>
7693returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7694 </td>
7695
7696 <td class="entry_units">
7697 </td>
7698
7699 <td class="entry_range">
7700 </td>
7701
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7702 <td class="entry_tags">
7703 </td>
7704
7705 </tr>
7706 <tr class="entries_header">
7707 <th class="th_details" colspan="5">Details</th>
7708 </tr>
7709 <tr class="entry_cont">
7710 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7711 <p>Does not need to be listed in static
7712metadata.<wbr/> Support for partial results will be reworked in
7713future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7714working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7715consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7716 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7717 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7718
7719
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7720 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7721 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7722
7723
7724
7725 <!-- end of kind -->
7726 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7727 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7728
7729 <thead class="entries_header">
7730 <tr>
7731 <th class="th_name">Property Name</th>
7732 <th class="th_type">Type</th>
7733 <th class="th_description">Description</th>
7734 <th class="th_units">Units</th>
7735 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7736 <th class="th_tags">Tags</th>
7737 </tr>
7738 </thead>
7739
7740 <tbody>
7741
7742
7743
7744
7745
7746
7747
7748
7749
7750
7751 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7752 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7753 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7754 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7755 <td class="entry_type">
7756 <span class="entry_type_name entry_type_name_enum">byte</span>
7757
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7758 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7759
7760 <ul class="entry_type_enum">
7761 <li>
7762 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7763 <span class="entry_type_enum_notes">The last or only metadata result buffer
7764 for this capture.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7765 </li>
7766 <li>
7767 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7768 <span class="entry_type_enum_notes">A partial buffer of result metadata for this
7769 capture.<wbr/> More result buffers for this capture will be sent
7770 by the HAL,<wbr/> the last of which will be marked
7771 FINAL.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7772 </li>
7773 </ul>
7774
7775 </td> <!-- entry_type -->
7776
7777 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7778 <p>Whether a result given to the framework is the
7779final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7780subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7781values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7782 </td>
7783
7784 <td class="entry_units">
7785 </td>
7786
7787 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7788 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7789 </td>
7790
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7791 <td class="entry_tags">
7792 </td>
7793
7794 </tr>
7795 <tr class="entries_header">
7796 <th class="th_details" colspan="5">Details</th>
7797 </tr>
7798 <tr class="entry_cont">
7799 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7800 <p>The entries in the result metadata buffers for a
7801single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7802FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7803requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
7804always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
7805before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
7806in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
7807capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
7808only 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]7809 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7810 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7811
7812
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7813 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7814 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7815
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7816
7817
7818 <!-- end of kind -->
7819 </tbody>
7820
7821 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7822 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7823
7824
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7825 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7826
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7827 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7828 <tr>
7829 <th class="th_name">Property Name</th>
7830 <th class="th_type">Type</th>
7831 <th class="th_description">Description</th>
7832 <th class="th_units">Units</th>
7833 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7834 <th class="th_tags">Tags</th>
7835 </tr>
7836 </thead>
7837
7838 <tbody>
7839
7840
7841
7842
7843
7844
7845
7846
7847
7848
7849 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7850 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7851 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7852 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7853 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7854 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7855
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7856 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7857
7858
7859 </td> <!-- entry_type -->
7860
7861 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7862 <p>A frame counter set by the framework.<wbr/> Must
7863be maintained unchanged in output frame.<wbr/> This value monotonically
7864increases with every new result (that is,<wbr/> each new result has a unique
7865frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7866 </td>
7867
7868 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7869 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7870 </td>
7871
7872 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7873 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7874 </td>
7875
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7876 <td class="entry_tags">
7877 </td>
7878
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7879 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7880
7881
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7882 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7883 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7884
7885
7886 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7887 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7888 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7889 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7890 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7891 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7892
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7893 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7894
7895
7896 </td> <!-- entry_type -->
7897
7898 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7899 <p>An application-specified ID for the current
7900request.<wbr/> Must be maintained unchanged in output
7901frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7902 </td>
7903
7904 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7905 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7906 </td>
7907
7908 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7909 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7910 </td>
7911
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7912 <td class="entry_tags">
7913 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7914 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7915 </ul>
7916 </td>
7917
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7918 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7919
7920
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7921 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7922 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7923
7924
7925 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7926 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7927 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7928 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7929 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7930 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7931 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7932
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7933 <span class="entry_type_array">
7934 n
7935 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7936 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7937
7938
7939 </td> <!-- entry_type -->
7940
7941 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7942 <p>List which camera reprocess stream is used
7943for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7944 </td>
7945
7946 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7947 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7948 </td>
7949
7950 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7951 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
7952reprocess stream ID.<wbr/></p>
7953<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
7954reprocess streams may be included in a single request; they
7955must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7956 </td>
7957
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7958 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7959 <ul class="entry_tags">
7960 <li><a href="#tag_HAL2">HAL2</a></li>
7961 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7962 </td>
7963
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7964 </tr>
7965 <tr class="entries_header">
7966 <th class="th_details" colspan="5">Details</th>
7967 </tr>
7968 <tr class="entry_cont">
7969 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7970 <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]7971REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7972 </td>
7973 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7974
7975
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7976 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7977 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7978
7979
7980 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7981 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7982 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7983 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7984 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7985 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7986
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7987 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7988
7989 <ul class="entry_type_enum">
7990 <li>
7991 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7992 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
7993 for application-bound buffer data.<wbr/> If no
7994 application-bound streams exist,<wbr/> no frame should be
7995 placed in the output frame queue.<wbr/> If such streams
7996 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7997 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7998 information.<wbr/> Timestamp information should still be
7999 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8000 </li>
8001 <li>
8002 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8003 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8004 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8005 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8006 </li>
8007 </ul>
8008
8009 </td> <!-- entry_type -->
8010
8011 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8012 <p>How much metadata to produce on
8013output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8014 </td>
8015
8016 <td class="entry_units">
8017 </td>
8018
8019 <td class="entry_range">
8020 </td>
8021
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8022 <td class="entry_tags">
8023 </td>
8024
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8025 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8026
8027
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8028 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8029 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8030
8031
8032 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8033 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8034 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8035 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8036 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8037 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8038 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8039
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8040 <span class="entry_type_array">
8041 n
8042 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8043 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8044
8045
8046 </td> <!-- entry_type -->
8047
8048 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8049 <p>Lists which camera output streams image data
8050from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8051 </td>
8052
8053 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8054 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8055 </td>
8056
8057 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8058 <p>List must only include streams that have been
8059created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8060 </td>
8061
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8062 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8063 <ul class="entry_tags">
8064 <li><a href="#tag_HAL2">HAL2</a></li>
8065 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8066 </td>
8067
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8068 </tr>
8069 <tr class="entries_header">
8070 <th class="th_details" colspan="5">Details</th>
8071 </tr>
8072 <tr class="entry_cont">
8073 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8074 <p>If no output streams are listed,<wbr/> then the image
8075data should simply be discarded.<wbr/> The image data must
8076still be captured for metadata and statistics production,<wbr/>
8077and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8078 </td>
8079 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8080
8081
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8082 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8083 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8084
8085
8086 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8087 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8088 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8089 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8090 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8091 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8092
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8093 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8094
8095 <ul class="entry_type_enum">
8096 <li>
8097 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8098 <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]8099 and process it according to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8100 settings</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8101 </li>
8102 <li>
8103 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8104 <span class="entry_type_enum_notes">Process previously captured data; the
8105 android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
8106 source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
8107 needed for reprocessing with [RP]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8108 </li>
8109 </ul>
8110
8111 </td> <!-- entry_type -->
8112
8113 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8114 <p>The type of the request; either CAPTURE or
8115REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8116 </td>
8117
8118 <td class="entry_units">
8119 </td>
8120
8121 <td class="entry_range">
8122 </td>
8123
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8124 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8125 <ul class="entry_tags">
8126 <li><a href="#tag_HAL2">HAL2</a></li>
8127 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8128 </td>
8129
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8130 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8131
8132
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8133 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8134 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8135
8136
8137
8138 <!-- end of kind -->
8139 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8140 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8141
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8142 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8143 <tr>
8144 <th class="th_name">Property Name</th>
8145 <th class="th_type">Type</th>
8146 <th class="th_description">Description</th>
8147 <th class="th_units">Units</th>
8148 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8149 <th class="th_tags">Tags</th>
8150 </tr>
8151 </thead>
8152
8153 <tbody>
8154
8155
8156
8157
8158
8159
8160
8161
8162
8163
8164 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8165 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8166 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8167 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8168 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8169 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8170 <span class="entry_type_container">x</span>
8171
8172 <span class="entry_type_array">
8173 3
8174 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8175 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8176
8177
8178 </td> <!-- entry_type -->
8179
8180 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8181 <p>How many output streams can be allocated at
8182the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8183 </td>
8184
8185 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8186 The number of raw sensor streams; the number of
8187 processed,<wbr/> uncompressed streams; and the number of
8188 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8189 </td>
8190
8191 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8192 <p>&gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8193for processed,<wbr/> uncompressed streams</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8194 </td>
8195
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8196 <td class="entry_tags">
8197 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8198 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8199 </ul>
8200 </td>
8201
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8202 </tr>
8203 <tr class="entries_header">
8204 <th class="th_details" colspan="5">Details</th>
8205 </tr>
8206 <tr class="entry_cont">
8207 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8208 <p>Video snapshot with preview callbacks requires 3
8209processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8210one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8211 </td>
8212 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8213
8214
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8215 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8216 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8217
8218
8219 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8220 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8221 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8222 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8223 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8224 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8225 <span class="entry_type_container">x</span>
8226
8227 <span class="entry_type_array">
8228 1
8229 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8230 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8231
8232
8233 </td> <!-- entry_type -->
8234
8235 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8236 <p>How many reprocessing streams of any type
8237can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8238 </td>
8239
8240 <td class="entry_units">
8241 </td>
8242
8243 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8244 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8245 </td>
8246
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8247 <td class="entry_tags">
8248 </td>
8249
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8250 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8251
8252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8253 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8254 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8255
8256
8257
8258 <!-- end of kind -->
8259 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8260 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8261
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8262 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8263 <tr>
8264 <th class="th_name">Property Name</th>
8265 <th class="th_type">Type</th>
8266 <th class="th_description">Description</th>
8267 <th class="th_units">Units</th>
8268 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8269 <th class="th_tags">Tags</th>
8270 </tr>
8271 </thead>
8272
8273 <tbody>
8274
8275
8276
8277
8278
8279
8280
8281
8282
8283
8284 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8285 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8286 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8287 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8288 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8289 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8290
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8291 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8292
8293
8294 </td> <!-- entry_type -->
8295
8296 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8297 <p>A frame counter set by the framework.<wbr/> This value monotonically
8298increases with every new result (that is,<wbr/> each new result has a unique
8299frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8300 </td>
8301
8302 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8303 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8304 </td>
8305
8306 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8307 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8308 </td>
8309
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8310 <td class="entry_tags">
8311 </td>
8312
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8313 </tr>
8314 <tr class="entries_header">
8315 <th class="th_details" colspan="5">Details</th>
8316 </tr>
8317 <tr class="entry_cont">
8318 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8319 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8320 </td>
8321 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8322
8323
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8324 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8325 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8326
8327
8328 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8329 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8330 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8331 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8332 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8333 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8334
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8335 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8336
8337
8338 </td> <!-- entry_type -->
8339
8340 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8341 <p>An application-specified ID for the current
8342request.<wbr/> Must be maintained unchanged in output
8343frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8344 </td>
8345
8346 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8347 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8348 </td>
8349
8350 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8351 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8352 </td>
8353
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8354 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8355 <ul class="entry_tags">
8356 <li><a href="#tag_V1">V1</a></li>
8357 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8358 </td>
8359
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8360 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8361
8362
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8363 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8364 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8365
8366
8367 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8368 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8369 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8370 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8371 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8372 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8373
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8374 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8375
8376 <ul class="entry_type_enum">
8377 <li>
8378 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8379 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
8380 for application-bound buffer data.<wbr/> If no
8381 application-bound streams exist,<wbr/> no frame should be
8382 placed in the output frame queue.<wbr/> If such streams
8383 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8384 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8385 information.<wbr/> Timestamp information should still be
8386 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8387 </li>
8388 <li>
8389 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8390 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8391 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8392 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8393 </li>
8394 </ul>
8395
8396 </td> <!-- entry_type -->
8397
8398 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8399 <p>How much metadata to produce on
8400output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8401 </td>
8402
8403 <td class="entry_units">
8404 </td>
8405
8406 <td class="entry_range">
8407 </td>
8408
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8409 <td class="entry_tags">
8410 </td>
8411
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8412 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8413
8414
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8415 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8416 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8417
8418
8419 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8420 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8421 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8422 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8423 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8424 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8425 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8426
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8427 <span class="entry_type_array">
8428 n
8429 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8430 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8431
8432
8433 </td> <!-- entry_type -->
8434
8435 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8436 <p>Lists which camera output streams image data
8437from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8438 </td>
8439
8440 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8441 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8442 </td>
8443
8444 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8445 <p>List must only include streams that have been
8446created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8447 </td>
8448
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8449 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8450 <ul class="entry_tags">
8451 <li><a href="#tag_HAL2">HAL2</a></li>
8452 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8453 </td>
8454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8455 </tr>
8456 <tr class="entries_header">
8457 <th class="th_details" colspan="5">Details</th>
8458 </tr>
8459 <tr class="entry_cont">
8460 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8461 <p>If no output streams are listed,<wbr/> then the image
8462data should simply be discarded.<wbr/> The image data must
8463still be captured for metadata and statistics production,<wbr/>
8464and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8465 </td>
8466 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8467
8468
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8469 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8470 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8471
8472
8473
8474 <!-- end of kind -->
8475 </tbody>
8476
8477 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8478 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8479
8480
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8481 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8482
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8483 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8484 <tr>
8485 <th class="th_name">Property Name</th>
8486 <th class="th_type">Type</th>
8487 <th class="th_description">Description</th>
8488 <th class="th_units">Units</th>
8489 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8490 <th class="th_tags">Tags</th>
8491 </tr>
8492 </thead>
8493
8494 <tbody>
8495
8496
8497
8498
8499
8500
8501
8502
8503
8504
8505 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8506 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8507 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8508 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8509 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8510 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8511 <span class="entry_type_container">x</span>
8512
8513 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8514 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8515 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8516 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8517
8518
8519 </td> <!-- entry_type -->
8520
8521 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8522 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8523<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8524(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8525output.<wbr/> Each stream must use this rectangle to produce its
8526output,<wbr/> cropping to a smaller region if necessary to
8527maintain the stream's aspect ratio.<wbr/></p>
8528<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8529 </td>
8530
8531 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8532 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8533 in pixels; (0,<wbr/>0) is top-left corner of
8534 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8535 </td>
8536
8537 <td class="entry_range">
8538 </td>
8539
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8540 <td class="entry_tags">
8541 <ul class="entry_tags">
8542 <li><a href="#tag_BC">BC</a></li>
8543 </ul>
8544 </td>
8545
8546 </tr>
8547 <tr class="entries_header">
8548 <th class="th_details" colspan="5">Details</th>
8549 </tr>
8550 <tr class="entry_cont">
8551 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8552 <p>Any additional per-stream cropping must be done to
8553maximize the final pixel area of the stream.<wbr/></p>
8554<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8555ratio,<wbr/> then 4:3 streams should use the exact crop
8556region.<wbr/> 16:9 streams should further crop vertically
8557(letterbox).<wbr/></p>
8558<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8559outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8560streams should match exactly.<wbr/> These additional crops must
8561be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8562<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8563times,<wbr/> no matter what the relative aspect ratios of the
8564crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8565corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8566larger than active pixel array.<wbr/> Width and height may be
8567rounded to nearest larger supportable width,<wbr/> especially
8568for raw output,<wbr/> where only a few fixed scales may be
8569possible.<wbr/> The width and height of the crop region cannot
8570be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8571android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8572activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8573respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8574 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8575 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8576
8577
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8578 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8579 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8580
8581
8582
8583 <!-- end of kind -->
8584 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8585 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8586
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8587 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8588 <tr>
8589 <th class="th_name">Property Name</th>
8590 <th class="th_type">Type</th>
8591 <th class="th_description">Description</th>
8592 <th class="th_units">Units</th>
8593 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8594 <th class="th_tags">Tags</th>
8595 </tr>
8596 </thead>
8597
8598 <tbody>
8599
8600
8601
8602
8603
8604
8605
8606
8607
8608
8609 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8610 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8611 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8612 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8613 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8614 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8615 <span class="entry_type_container">x</span>
8616
8617 <span class="entry_type_array">
8618 n
8619 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]8620 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8621 <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]8622
8623 <ul class="entry_type_enum">
8624 <li>
8625 <span class="entry_type_enum_name">RAW_SENSOR</span>
8626 <span class="entry_type_enum_value">0x20</span>
8627 </li>
8628 <li>
8629 <span class="entry_type_enum_name">YV12</span>
8630 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8631 <span class="entry_type_enum_notes">YCrCb 4:2:0 Planar</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8632 </li>
8633 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8634 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8635 <span class="entry_type_enum_value">0x11</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8636 <span class="entry_type_enum_notes">NV21</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8637 </li>
8638 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8639 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
8640 <span class="entry_type_enum_value">0x22</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8641 <span class="entry_type_enum_notes">Hal Implementation Defined</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8642 </li>
8643 <li>
8644 <span class="entry_type_enum_name">YCbCr_420_888</span>
8645 <span class="entry_type_enum_value">0x23</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8646 <span class="entry_type_enum_notes">Flexible YUV420 Format</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8647 </li>
8648 <li>
8649 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8650 <span class="entry_type_enum_value">0x21</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8651 <span class="entry_type_enum_notes">JPEG</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8652 </li>
8653 </ul>
8654
8655 </td> <!-- entry_type -->
8656
8657 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8658 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8659 </td>
8660
8661 <td class="entry_units">
8662 </td>
8663
8664 <td class="entry_range">
8665 </td>
8666
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8667 <td class="entry_tags">
8668 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8669 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8670 </ul>
8671 </td>
8672
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8673 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8674
8675
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8676 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8677 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8678
8679
8680 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8681 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8682 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8683 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8684 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8685 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8686 <span class="entry_type_container">x</span>
8687
8688 <span class="entry_type_array">
8689 n
8690 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8691 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8692
8693
8694 </td> <!-- entry_type -->
8695
8696 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8697 <p>The minimum frame duration that is supported
8698for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8699correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8700stream is active and captured in a burst,<wbr/> with all
8701processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8702 </td>
8703
8704 <td class="entry_units">
8705 </td>
8706
8707 <td class="entry_range">
8708 </td>
8709
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8710 <td class="entry_tags">
8711 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8712 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8713 </ul>
8714 </td>
8715
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8716 </tr>
8717 <tr class="entries_header">
8718 <th class="th_details" colspan="5">Details</th>
8719 </tr>
8720 <tr class="entry_cont">
8721 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8722 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8723frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8724durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8725 </td>
8726 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8727
8728
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8729 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8730 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8731
8732
8733 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8734 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8735 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8736 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8737 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8738 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8739 <span class="entry_type_container">x</span>
8740
8741 <span class="entry_type_array">
8742 n x 2
8743 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8744 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8745
8746
8747 </td> <!-- entry_type -->
8748
8749 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8750 <p>The resolutions available for output from
8751the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8752 </td>
8753
8754 <td class="entry_units">
8755 </td>
8756
8757 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8758 <p>Must include: - sensor maximum resolution Should
8759include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8760 </td>
8761
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8762 <td class="entry_tags">
8763 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8764 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8765 </ul>
8766 </td>
8767
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8768 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8769
8770
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8771 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8772 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8773
8774
8775 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8776 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8777 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8778 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8779 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8780 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8781
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8782 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8783
8784
8785 </td> <!-- entry_type -->
8786
8787 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8788 <p>The maximum ratio between active area width
8789and crop region width,<wbr/> or between active area height and
8790crop region height,<wbr/> if the crop region height is larger
8791than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8792 </td>
8793
8794 <td class="entry_units">
8795 </td>
8796
8797 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8798 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8799 </td>
8800
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8801 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8802 <ul class="entry_tags">
8803 <li><a href="#tag_BC">BC</a></li>
8804 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8805 </td>
8806
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8807 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8808
8809
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8810 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8811 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8812
8813
8814 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8815 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8816 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8817 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8818 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8819 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8820 <span class="entry_type_container">x</span>
8821
8822 <span class="entry_type_array">
8823 n
8824 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8825 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8826
8827
8828 </td> <!-- entry_type -->
8829
8830 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8831 <p>The minimum frame duration that is supported
8832for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8833correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8834stream is active,<wbr/> with all processing set to
8835FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8836 </td>
8837
8838 <td class="entry_units">
8839 </td>
8840
8841 <td class="entry_range">
8842 </td>
8843
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8844 <td class="entry_tags">
8845 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8846 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8847 </ul>
8848 </td>
8849
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8850 </tr>
8851 <tr class="entries_header">
8852 <th class="th_details" colspan="5">Details</th>
8853 </tr>
8854 <tr class="entry_cont">
8855 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8856 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8857frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8858durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8859 </td>
8860 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8861
8862
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8863 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8864 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8865
8866
8867 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8868 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8869 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8870 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8871 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8872 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8873 <span class="entry_type_container">x</span>
8874
8875 <span class="entry_type_array">
8876 n x 2
8877 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8878 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8879
8880
8881 </td> <!-- entry_type -->
8882
8883 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8884 <p>The resolutions available for use with
8885processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
8886platform opaque YUV/<wbr/>RGB streams to the GPU or video
8887encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8888 </td>
8889
8890 <td class="entry_units">
8891 </td>
8892
8893 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8894 <p>Must include: - sensor maximum resolution -
8895standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
8896resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8897 </td>
8898
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8899 <td class="entry_tags">
8900 <ul class="entry_tags">
8901 <li><a href="#tag_BC">BC</a></li>
8902 </ul>
8903 </td>
8904
8905 </tr>
8906 <tr class="entries_header">
8907 <th class="th_details" colspan="5">Details</th>
8908 </tr>
8909 <tr class="entry_cont">
8910 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8911 <p>The actual supported resolution list may be limited by
8912consumer end points for different use cases.<wbr/> For example,<wbr/> for
8913recording use case,<wbr/> the largest supported resolution may be
8914limited by max supported size from encoder,<wbr/> for preview use
8915case,<wbr/> the largest supported resolution may be limited by max
8916resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8917 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8918 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8919
8920
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8921 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8922 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8923
8924
8925 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8926 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8927 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8928 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8929 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8930 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8931 <span class="entry_type_container">x</span>
8932
8933 <span class="entry_type_array">
8934 n
8935 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8936 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8937
8938
8939 </td> <!-- entry_type -->
8940
8941 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8942 <p>The minimum frame duration that is supported
8943for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8944correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8945is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8946 </td>
8947
8948 <td class="entry_units">
8949 </td>
8950
8951 <td class="entry_range">
8952 </td>
8953
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8954 <td class="entry_tags">
8955 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8956 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8957 </ul>
8958 </td>
8959
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8960 </tr>
8961 <tr class="entries_header">
8962 <th class="th_details" colspan="5">Details</th>
8963 </tr>
8964 <tr class="entry_cont">
8965 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8966 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8967frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8968durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8969 </td>
8970 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8971
8972
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8973 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8974 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8975
8976
8977 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8978 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8979 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8980 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8981 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8982 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8983 <span class="entry_type_container">x</span>
8984
8985 <span class="entry_type_array">
8986 n x 2
8987 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8988 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8989
8990
8991 </td> <!-- entry_type -->
8992
8993 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8994 <p>The resolutions available for use with raw
8995sensor output streams,<wbr/> listed as width,<wbr/>
8996height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8997 </td>
8998
8999 <td class="entry_units">
9000 </td>
9001
9002 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9003 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9004 </td>
9005
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9006 <td class="entry_tags">
9007 </td>
9008
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9009 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9010
9011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9012 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9013 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9014
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9015
9016
9017 <!-- end of kind -->
9018 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9019 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9020
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9021 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9022 <tr>
9023 <th class="th_name">Property Name</th>
9024 <th class="th_type">Type</th>
9025 <th class="th_description">Description</th>
9026 <th class="th_units">Units</th>
9027 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9028 <th class="th_tags">Tags</th>
9029 </tr>
9030 </thead>
9031
9032 <tbody>
9033
9034
9035
9036
9037
9038
9039
9040
9041
9042
9043 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9044 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9045 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9046 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9047 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9048 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9049 <span class="entry_type_container">x</span>
9050
9051 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9052 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9053 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9054 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9055
9056
9057 </td> <!-- entry_type -->
9058
9059 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9060 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9061<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9062(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9063output.<wbr/> Each stream must use this rectangle to produce its
9064output,<wbr/> cropping to a smaller region if necessary to
9065maintain the stream's aspect ratio.<wbr/></p>
9066<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9067 </td>
9068
9069 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9070 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9071 in pixels; (0,<wbr/>0) is top-left corner of
9072 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9073 </td>
9074
9075 <td class="entry_range">
9076 </td>
9077
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9078 <td class="entry_tags">
9079 <ul class="entry_tags">
9080 <li><a href="#tag_BC">BC</a></li>
9081 </ul>
9082 </td>
9083
9084 </tr>
9085 <tr class="entries_header">
9086 <th class="th_details" colspan="5">Details</th>
9087 </tr>
9088 <tr class="entry_cont">
9089 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9090 <p>Any additional per-stream cropping must be done to
9091maximize the final pixel area of the stream.<wbr/></p>
9092<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9093ratio,<wbr/> then 4:3 streams should use the exact crop
9094region.<wbr/> 16:9 streams should further crop vertically
9095(letterbox).<wbr/></p>
9096<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9097outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9098streams should match exactly.<wbr/> These additional crops must
9099be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9100<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9101times,<wbr/> no matter what the relative aspect ratios of the
9102crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9103corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9104larger than active pixel array.<wbr/> Width and height may be
9105rounded to nearest larger supportable width,<wbr/> especially
9106for raw output,<wbr/> where only a few fixed scales may be
9107possible.<wbr/> The width and height of the crop region cannot
9108be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9109android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9110activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9111respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9112 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9113 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9114
9115
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9116 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9117 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9118
9119
9120
9121 <!-- end of kind -->
9122 </tbody>
9123
9124 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9125 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9126
9127
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9128 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9129
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9130 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9131 <tr>
9132 <th class="th_name">Property Name</th>
9133 <th class="th_type">Type</th>
9134 <th class="th_description">Description</th>
9135 <th class="th_units">Units</th>
9136 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9137 <th class="th_tags">Tags</th>
9138 </tr>
9139 </thead>
9140
9141 <tbody>
9142
9143
9144
9145
9146
9147
9148
9149
9150
9151
9152 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9153 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9154 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9155 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9156 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9157 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9158
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9159 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9160
9161
9162 </td> <!-- entry_type -->
9163
9164 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9165 <p>Duration each pixel is exposed to
9166light.<wbr/></p>
9167<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
9168duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9169 </td>
9170
9171 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9172 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9173 </td>
9174
9175 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9176 <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]9177 </td>
9178
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9179 <td class="entry_tags">
9180 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9181 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9182 </ul>
9183 </td>
9184
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9185 </tr>
9186 <tr class="entries_header">
9187 <th class="th_details" colspan="5">Details</th>
9188 </tr>
9189 <tr class="entry_cont">
9190 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9191 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9192 </td>
9193 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9194
9195
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9196 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9197 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9198
9199
9200 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9201 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9202 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9203 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9204 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9205 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9206
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9207 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9208
9209
9210 </td> <!-- entry_type -->
9211
9212 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9213 <p>Duration from start of frame exposure to
9214start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9215 </td>
9216
9217 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9218 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9219 </td>
9220
9221 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9222 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9223android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9224 </td>
9225
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9226 <td class="entry_tags">
9227 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9228 <li><a href="#tag_V1">V1</a></li>
9229 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9230 </ul>
9231 </td>
9232
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9233 </tr>
9234 <tr class="entries_header">
9235 <th class="th_details" colspan="5">Details</th>
9236 </tr>
9237 <tr class="entry_cont">
9238 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9239 <p>Exposure time has priority,<wbr/> so duration is set to
9240max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9241 </td>
9242 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9243
9244
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9245 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9246 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9247
9248
9249 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9250 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9251 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9252 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9253 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9254 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9255
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9256 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9257
9258
9259 </td> <!-- entry_type -->
9260
9261 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9262 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9263implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9264below 'maximum analog sensitivity'.<wbr/></p>
9265<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9266gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9267 </td>
9268
9269 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9270 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9271 </td>
9272
9273 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9274 <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]9275 </td>
9276
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9277 <td class="entry_tags">
9278 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9279 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9280 </ul>
9281 </td>
9282
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9283 </tr>
9284 <tr class="entries_header">
9285 <th class="th_details" colspan="5">Details</th>
9286 </tr>
9287 <tr class="entry_cont">
9288 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9289 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9290 </td>
9291 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9292
9293
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9294 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9295 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9296
9297
9298
9299 <!-- end of kind -->
9300 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9301 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9302
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9303 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9304 <tr>
9305 <th class="th_name">Property Name</th>
9306 <th class="th_type">Type</th>
9307 <th class="th_description">Description</th>
9308 <th class="th_units">Units</th>
9309 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9310 <th class="th_tags">Tags</th>
9311 </tr>
9312 </thead>
9313
9314 <tbody>
9315
9316
9317
9318
9319
9320
9321
9322
9323
9324
9325
9326
9327 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9328 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9329 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9330 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9331 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9332 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9333 <span class="entry_type_container">x</span>
9334
9335 <span class="entry_type_array">
9336 4
9337 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9338 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9339 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9340
9341
9342 </td> <!-- entry_type -->
9343
9344 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9345 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9346active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9347pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9348 </td>
9349
9350 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9351 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9352 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9353 </td>
9354
9355 <td class="entry_range">
9356 </td>
9357
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9358 <td class="entry_tags">
9359 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9360 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9361 </ul>
9362 </td>
9363
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9364 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9365
9366
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9367 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9368 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9369
9370
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9371 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9372 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9373 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9374 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9375 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9376 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9377 <span class="entry_type_container">x</span>
9378
9379 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9380 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9381 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9382 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9383 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9384
9385
9386 </td> <!-- entry_type -->
9387
9388 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9389 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9390 </td>
9391
9392 <td class="entry_units">
9393 </td>
9394
9395 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9396 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9397 </td>
9398
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9399 <td class="entry_tags">
9400 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9401 <li><a href="#tag_BC">BC</a></li>
9402 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9403 </ul>
9404 </td>
9405
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9406 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9407
9408
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9409 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9410 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9411
9412
9413 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9414 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9415 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9416 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9417 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9418 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9419
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9420 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9421
9422 <ul class="entry_type_enum">
9423 <li>
9424 <span class="entry_type_enum_name">RGGB</span>
9425 </li>
9426 <li>
9427 <span class="entry_type_enum_name">GRBG</span>
9428 </li>
9429 <li>
9430 <span class="entry_type_enum_name">GBRG</span>
9431 </li>
9432 <li>
9433 <span class="entry_type_enum_name">BGGR</span>
9434 </li>
9435 <li>
9436 <span class="entry_type_enum_name">RGB</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9437 <span class="entry_type_enum_notes">Sensor is not Bayer; output has 3 16-bit
9438 values for each pixel,<wbr/> instead of just 1 16-bit value
9439 per pixel.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9440 </li>
9441 </ul>
9442
9443 </td> <!-- entry_type -->
9444
9445 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9446 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9447represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9448the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9449 </td>
9450
9451 <td class="entry_units">
9452 </td>
9453
9454 <td class="entry_range">
9455 </td>
9456
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9457 <td class="entry_tags">
9458 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9459 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9460 </ul>
9461 </td>
9462
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9463 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9464
9465
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9466 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9467 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9468
9469
9470 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9471 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9472 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9473 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9474 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9475 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9476 <span class="entry_type_container">x</span>
9477
9478 <span class="entry_type_array">
9479 2
9480 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9481 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9482 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9483
9484
9485 </td> <!-- entry_type -->
9486
9487 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9488 <p>Range of valid exposure
9489times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9490 </td>
9491
9492 <td class="entry_units">
9493 </td>
9494
9495 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9496 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
9497sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9498 </td>
9499
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9500 <td class="entry_tags">
9501 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9502 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9503 </ul>
9504 </td>
9505
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9506 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9507
9508
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9509 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9510 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9511
9512
9513 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9514 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9515 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9516 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9517 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9518 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9519
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9520 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9521
9522
9523 </td> <!-- entry_type -->
9524
9525 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9526 <p>Maximum possible frame duration (minimum frame
9527rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9528 </td>
9529
9530 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9531 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9532 </td>
9533
9534 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9535 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9536 </td>
9537
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9538 <td class="entry_tags">
9539 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9540 <li><a href="#tag_BC">BC</a></li>
9541 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9542 </ul>
9543 </td>
9544
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9545 </tr>
9546 <tr class="entries_header">
9547 <th class="th_details" colspan="5">Details</th>
9548 </tr>
9549 <tr class="entry_cont">
9550 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9551 <p>Minimum duration is a function of resolution,<wbr/>
9552processing settings.<wbr/> See
9553android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
9554android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9555<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]9556 </td>
9557 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9558
9559
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9560 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9561 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9562
9563
9564 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9565 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9566 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9567 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9568 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9569 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9570 <span class="entry_type_container">x</span>
9571
9572 <span class="entry_type_array">
9573 2
9574 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]9575 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9576 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9577
9578
9579 </td> <!-- entry_type -->
9580
9581 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9582 <p>The physical dimensions of the full pixel
9583array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9584 </td>
9585
9586 <td class="entry_units">
9587 </td>
9588
9589 <td class="entry_range">
9590 </td>
9591
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9592 <td class="entry_tags">
9593 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9594 <li><a href="#tag_V1">V1</a></li>
9595 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9596 </ul>
9597 </td>
9598
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9599 </tr>
9600 <tr class="entries_header">
9601 <th class="th_details" colspan="5">Details</th>
9602 </tr>
9603 <tr class="entry_cont">
9604 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9605 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9606 </td>
9607 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9608
9609
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9610 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9611 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9612
9613
9614 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9615 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9616 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9617 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9618 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9619 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9620 <span class="entry_type_container">x</span>
9621
9622 <span class="entry_type_array">
9623 2
9624 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9625 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9626
9627
9628 </td> <!-- entry_type -->
9629
9630 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9631 <p>Dimensions of full pixel array,<wbr/> possibly
9632including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9633 </td>
9634
9635 <td class="entry_units">
9636 </td>
9637
9638 <td class="entry_range">
9639 </td>
9640
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9641 <td class="entry_tags">
9642 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9643 <li><a href="#tag_DNG">DNG</a></li>
9644 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9645 </ul>
9646 </td>
9647
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9648 </tr>
9649 <tr class="entries_header">
9650 <th class="th_details" colspan="5">Details</th>
9651 </tr>
9652 <tr class="entry_cont">
9653 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9654 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9655match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9656android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9657 </td>
9658 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9659
9660
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9661 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9662 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9663
9664
9665 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9666 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9667 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9668 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9669 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9670 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9671
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9672 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9673
9674
9675 </td> <!-- entry_type -->
9676
9677 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9678 <p>Maximum raw value output by
9679sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9680 </td>
9681
9682 <td class="entry_units">
9683 </td>
9684
9685 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9686 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9687 </td>
9688
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9689 <td class="entry_tags">
9690 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9691 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9692 </ul>
9693 </td>
9694
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9695 </tr>
9696 <tr class="entries_header">
9697 <th class="th_details" colspan="5">Details</th>
9698 </tr>
9699 <tr class="entry_cont">
9700 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9701 <p>Defines sensor bit depth (10-14 bits is
9702expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9703 </td>
9704 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9705
9706
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9707 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9708 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9709
9710
9711
9712
9713
9714 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9715 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9716 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9717 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9718 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9719 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9720
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9721 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9722
9723
9724 </td> <!-- entry_type -->
9725
9726 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9727 <p>Gain factor from electrons to raw units when
9728ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9729 </td>
9730
9731 <td class="entry_units">
9732 </td>
9733
9734 <td class="entry_range">
9735 </td>
9736
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9737 <td class="entry_tags">
9738 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9739 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9740 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9741 </ul>
9742 </td>
9743
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9744 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9745
9746
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9747 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9748 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9749
9750
9751 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9752 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9753 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9754 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9755 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9756 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9757 <span class="entry_type_container">x</span>
9758
9759 <span class="entry_type_array">
9760 4
9761 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9762 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9763 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9764
9765
9766 </td> <!-- entry_type -->
9767
9768 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9769 <p>A fixed black level offset for each of the
9770Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9771 </td>
9772
9773 <td class="entry_units">
9774 </td>
9775
9776 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9777 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9778 </td>
9779
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9780 <td class="entry_tags">
9781 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9782 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9783 </ul>
9784 </td>
9785
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9786 </tr>
9787 <tr class="entries_header">
9788 <th class="th_details" colspan="5">Details</th>
9789 </tr>
9790 <tr class="entry_cont">
9791 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9792 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
9793tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9794 </td>
9795 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9796
9797
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9798 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9799 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9800
9801
9802 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9803 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9804 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9805 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9806 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9807 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9808 <span class="entry_type_container">x</span>
9809
9810 <span class="entry_type_array">
9811 9
9812 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9813 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9814 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9815
9816
9817 </td> <!-- entry_type -->
9818
9819 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9820 <p>Per-device calibration on top of color space
9821transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9822 </td>
9823
9824 <td class="entry_units">
9825 </td>
9826
9827 <td class="entry_range">
9828 </td>
9829
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9830 <td class="entry_tags">
9831 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9832 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9833 </ul>
9834 </td>
9835
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9836 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9837
9838
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9839 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9840 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9841
9842
9843 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9844 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9845 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9846 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9847 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9848 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9849 <span class="entry_type_container">x</span>
9850
9851 <span class="entry_type_array">
9852 9
9853 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9854 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9855 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9856
9857
9858 </td> <!-- entry_type -->
9859
9860 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9861 <p>Per-device calibration on top of color space
9862transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9863 </td>
9864
9865 <td class="entry_units">
9866 </td>
9867
9868 <td class="entry_range">
9869 </td>
9870
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9871 <td class="entry_tags">
9872 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9873 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9874 </ul>
9875 </td>
9876
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9877 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9878
9879
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9880 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9881 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9882
9883
9884 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9885 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9886 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9887 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9888 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9889 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9890 <span class="entry_type_container">x</span>
9891
9892 <span class="entry_type_array">
9893 9
9894 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9895 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9896 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9897
9898
9899 </td> <!-- entry_type -->
9900
9901 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9902 <p>Linear mapping from XYZ (D50) color space to
9903reference linear sensor color,<wbr/> for first reference
9904illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9905 </td>
9906
9907 <td class="entry_units">
9908 </td>
9909
9910 <td class="entry_range">
9911 </td>
9912
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9913 <td class="entry_tags">
9914 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9915 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9916 </ul>
9917 </td>
9918
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9919 </tr>
9920 <tr class="entries_header">
9921 <th class="th_details" colspan="5">Details</th>
9922 </tr>
9923 <tr class="entry_cont">
9924 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9925 <p>Use as follows XYZ = inv(transform) * clip( (raw -
9926black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
9927At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9928 </td>
9929 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9930
9931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9932 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9933 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9934
9935
9936 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9937 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9938 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9939 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9940 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9941 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9942 <span class="entry_type_container">x</span>
9943
9944 <span class="entry_type_array">
9945 9
9946 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9947 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9948 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9949
9950
9951 </td> <!-- entry_type -->
9952
9953 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9954 <p>Linear mapping from XYZ (D50) color space to
9955reference linear sensor color,<wbr/> for second reference
9956illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9957 </td>
9958
9959 <td class="entry_units">
9960 </td>
9961
9962 <td class="entry_range">
9963 </td>
9964
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9965 <td class="entry_tags">
9966 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9967 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9968 </ul>
9969 </td>
9970
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9971 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9972
9973
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9974 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9975 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9976
9977
9978 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9979 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9980 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9981 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9982 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9983 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9984 <span class="entry_type_container">x</span>
9985
9986 <span class="entry_type_array">
9987 9
9988 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9989 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9990 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9991
9992
9993 </td> <!-- entry_type -->
9994
9995 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9996 <p>Used by DNG for better WB
9997adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9998 </td>
9999
10000 <td class="entry_units">
10001 </td>
10002
10003 <td class="entry_range">
10004 </td>
10005
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10006 <td class="entry_tags">
10007 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10008 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10009 </ul>
10010 </td>
10011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10012 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10013
10014
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10015 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10016 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10017
10018
10019 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10020 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10021 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10022 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10023 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10024 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10025 <span class="entry_type_container">x</span>
10026
10027 <span class="entry_type_array">
10028 9
10029 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10030 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10031 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10032
10033
10034 </td> <!-- entry_type -->
10035
10036 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10037 <p>Used by DNG for better WB
10038adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10039 </td>
10040
10041 <td class="entry_units">
10042 </td>
10043
10044 <td class="entry_range">
10045 </td>
10046
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10047 <td class="entry_tags">
10048 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10049 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10050 </ul>
10051 </td>
10052
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10053 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10054
10055
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10056 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10057 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10058
10059
10060 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10061 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10062 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10063 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10064 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10065 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10066
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10067 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10068
10069
10070 </td> <!-- entry_type -->
10071
10072 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10073 <p>Maximum sensitivity that is implemented
10074purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10075 </td>
10076
10077 <td class="entry_units">
10078 </td>
10079
10080 <td class="entry_range">
10081 </td>
10082
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10083 <td class="entry_tags">
10084 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10085 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10086 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10087 </ul>
10088 </td>
10089
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10090 </tr>
10091 <tr class="entries_header">
10092 <th class="th_details" colspan="5">Details</th>
10093 </tr>
10094 <tr class="entry_cont">
10095 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10096 <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]10097equal to this,<wbr/> all applied gain must be analog.<wbr/> For
10098values above this,<wbr/> it can be a mix of analog and
10099digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10100 </td>
10101 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10102
10103
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10104 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10105 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10106
10107
10108 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10109 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10110 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10111 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10112 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10113 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10114 <span class="entry_type_container">x</span>
10115
10116 <span class="entry_type_array">
10117 2
10118 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10119 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10120 <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]10121
10122
10123 </td> <!-- entry_type -->
10124
10125 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10126 <p>Estimation of sensor noise
10127characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10128 </td>
10129
10130 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10131 var(raw pixel value) = electrons * (baseGainFactor
10132 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
10133 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10134 </td>
10135
10136 <td class="entry_range">
10137 </td>
10138
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10139 <td class="entry_tags">
10140 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10141 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10142 </ul>
10143 </td>
10144
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10145 </tr>
10146 <tr class="entries_header">
10147 <th class="th_details" colspan="5">Details</th>
10148 </tr>
10149 <tr class="entry_cont">
10150 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10151 <p>A represents sensor read noise before analog
10152amplification; B represents noise from A/<wbr/>D conversion and
10153other circuits after amplification.<wbr/> Both noise sources
10154are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
10155across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10156 </td>
10157 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10158
10159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10160 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10161 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10162
10163
10164 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10165 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10166 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10167 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10168 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10169 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10170
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10171 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10172
10173
10174 </td> <!-- entry_type -->
10175
10176 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10177 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10178image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10179screen in its native orientation.<wbr/> Also defines the
10180direction of rolling shutter readout,<wbr/> which is from top
10181to bottom in the sensor's coordinate system</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 degrees clockwise rotation,<wbr/> only multiples of
10186 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10187 </td>
10188
10189 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10190 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10191 </td>
10192
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10193 <td class="entry_tags">
10194 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10195 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10196 </ul>
10197 </td>
10198
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10199 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10200
10201
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10202 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10203 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10204
10205
10206 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10207 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10208 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10209 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10210 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10211 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10212
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10213 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10214
10215 <ul class="entry_type_enum">
10216 <li>
10217 <span class="entry_type_enum_name">DAYLIGHT</span>
10218 <span class="entry_type_enum_value">1</span>
10219 </li>
10220 <li>
10221 <span class="entry_type_enum_name">FLUORESCENT</span>
10222 <span class="entry_type_enum_value">2</span>
10223 </li>
10224 <li>
10225 <span class="entry_type_enum_name">TUNGSTEN</span>
10226 <span class="entry_type_enum_value">3</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10227 <span class="entry_type_enum_notes">Incandescent light</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10228 </li>
10229 <li>
10230 <span class="entry_type_enum_name">FLASH</span>
10231 <span class="entry_type_enum_value">4</span>
10232 </li>
10233 <li>
10234 <span class="entry_type_enum_name">FINE_WEATHER</span>
10235 <span class="entry_type_enum_value">9</span>
10236 </li>
10237 <li>
10238 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10239 <span class="entry_type_enum_value">10</span>
10240 </li>
10241 <li>
10242 <span class="entry_type_enum_name">SHADE</span>
10243 <span class="entry_type_enum_value">11</span>
10244 </li>
10245 <li>
10246 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10247 <span class="entry_type_enum_value">12</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10248 <span class="entry_type_enum_notes">D 5700 - 7100K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10249 </li>
10250 <li>
10251 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10252 <span class="entry_type_enum_value">13</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10253 <span class="entry_type_enum_notes">N 4600 - 5400K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10254 </li>
10255 <li>
10256 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10257 <span class="entry_type_enum_value">14</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10258 <span class="entry_type_enum_notes">W 3900 - 4500K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10259 </li>
10260 <li>
10261 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10262 <span class="entry_type_enum_value">15</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10263 <span class="entry_type_enum_notes">WW 3200 - 3700K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10264 </li>
10265 <li>
10266 <span class="entry_type_enum_name">STANDARD_A</span>
10267 <span class="entry_type_enum_value">17</span>
10268 </li>
10269 <li>
10270 <span class="entry_type_enum_name">STANDARD_B</span>
10271 <span class="entry_type_enum_value">18</span>
10272 </li>
10273 <li>
10274 <span class="entry_type_enum_name">STANDARD_C</span>
10275 <span class="entry_type_enum_value">19</span>
10276 </li>
10277 <li>
10278 <span class="entry_type_enum_name">D55</span>
10279 <span class="entry_type_enum_value">20</span>
10280 </li>
10281 <li>
10282 <span class="entry_type_enum_name">D65</span>
10283 <span class="entry_type_enum_value">21</span>
10284 </li>
10285 <li>
10286 <span class="entry_type_enum_name">D75</span>
10287 <span class="entry_type_enum_value">22</span>
10288 </li>
10289 <li>
10290 <span class="entry_type_enum_name">D50</span>
10291 <span class="entry_type_enum_value">23</span>
10292 </li>
10293 <li>
10294 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10295 <span class="entry_type_enum_value">24</span>
10296 </li>
10297 </ul>
10298
10299 </td> <!-- entry_type -->
10300
10301 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10302 <p>Light source used to define transform
103031</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10304 </td>
10305
10306 <td class="entry_units">
10307 </td>
10308
10309 <td class="entry_range">
10310 </td>
10311
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10312 <td class="entry_tags">
10313 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10314 <li><a href="#tag_DNG">DNG</a></li>
10315 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10316 </ul>
10317 </td>
10318
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10319 </tr>
10320 <tr class="entries_header">
10321 <th class="th_details" colspan="5">Details</th>
10322 </tr>
10323 <tr class="entry_cont">
10324 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10325 <p>[EXIF LightSource tag] Must all these be
10326supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10327 </td>
10328 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10329
10330
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10331 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10332 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10333
10334
10335 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10336 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10337 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10338 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10339 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10340 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10341
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10342 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10343
10344
10345 </td> <!-- entry_type -->
10346
10347 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10348 <p>Light source used to define transform
103492</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10350 </td>
10351
10352 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10353 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10354 </td>
10355
10356 <td class="entry_range">
10357 </td>
10358
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10359 <td class="entry_tags">
10360 </td>
10361
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10362 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10363
10364
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10365 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10366 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10367
10368
10369
10370 <!-- end of kind -->
10371 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10372 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10373
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10374 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10375 <tr>
10376 <th class="th_name">Property Name</th>
10377 <th class="th_type">Type</th>
10378 <th class="th_description">Description</th>
10379 <th class="th_units">Units</th>
10380 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10381 <th class="th_tags">Tags</th>
10382 </tr>
10383 </thead>
10384
10385 <tbody>
10386
10387
10388
10389
10390
10391
10392
10393
10394
10395
10396 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10397 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10398 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10399 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10400 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10401 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10402
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10403 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10404
10405
10406 </td> <!-- entry_type -->
10407
10408 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10409 <p>Duration each pixel is exposed to
10410light.<wbr/></p>
10411<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
10412duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10413 </td>
10414
10415 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10416 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10417 </td>
10418
10419 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10420 <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]10421 </td>
10422
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10423 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10424 <ul class="entry_tags">
10425 <li><a href="#tag_V1">V1</a></li>
10426 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10427 </td>
10428
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10429 </tr>
10430 <tr class="entries_header">
10431 <th class="th_details" colspan="5">Details</th>
10432 </tr>
10433 <tr class="entry_cont">
10434 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10435 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10436 </td>
10437 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10438
10439
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10440 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10441 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10442
10443
10444 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10445 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10446 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10447 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10448 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10449 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10450
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10451 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10452
10453
10454 </td> <!-- entry_type -->
10455
10456 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10457 <p>Duration from start of frame exposure to
10458start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10459 </td>
10460
10461 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10462 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10463 </td>
10464
10465 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10466 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
10467android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10468 </td>
10469
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10470 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10471 <ul class="entry_tags">
10472 <li><a href="#tag_V1">V1</a></li>
10473 <li><a href="#tag_BC">BC</a></li>
10474 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10475 </td>
10476
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10477 </tr>
10478 <tr class="entries_header">
10479 <th class="th_details" colspan="5">Details</th>
10480 </tr>
10481 <tr class="entry_cont">
10482 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10483 <p>Exposure time has priority,<wbr/> so duration is set to
10484max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10485 </td>
10486 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10487
10488
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10489 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10490 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10491
10492
10493 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10494 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10495 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10496 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10497 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10498 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10499
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10500 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10501
10502
10503 </td> <!-- entry_type -->
10504
10505 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10506 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10507implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10508below 'maximum analog sensitivity'.<wbr/></p>
10509<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10510gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10511 </td>
10512
10513 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10514 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10515 </td>
10516
10517 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10518 <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]10519 </td>
10520
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10521 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10522 <ul class="entry_tags">
10523 <li><a href="#tag_V1">V1</a></li>
10524 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10525 </td>
10526
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10527 </tr>
10528 <tr class="entries_header">
10529 <th class="th_details" colspan="5">Details</th>
10530 </tr>
10531 <tr class="entry_cont">
10532 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10533 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10534 </td>
10535 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10536
10537
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10538 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10539 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10540
10541
10542 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10543 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10544 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10545 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10546 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10547 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10548
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10549 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10550
10551
10552 </td> <!-- entry_type -->
10553
10554 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10555 <p>Time at start of exposure of first
10556row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10557 </td>
10558
10559 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10560 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10561 </td>
10562
10563 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10564 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10565 </td>
10566
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10567 <td class="entry_tags">
10568 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10569 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10570 </ul>
10571 </td>
10572
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10573 </tr>
10574 <tr class="entries_header">
10575 <th class="th_details" colspan="5">Details</th>
10576 </tr>
10577 <tr class="entry_cont">
10578 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10579 <p>Monotonic,<wbr/> should be synced to other timestamps in
10580system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10581 </td>
10582 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10583
10584
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10585 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10586 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10587
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10588
10589 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10590 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10591 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10592 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10593 <td class="entry_type">
10594 <span class="entry_type_name">float</span>
10595
10596 <span class="entry_type_visibility"> [public]</span>
10597
10598
10599 </td> <!-- entry_type -->
10600
10601 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10602 <p>The temperature of the sensor,<wbr/> sampled at the time
10603exposure began for this frame.<wbr/></p>
10604<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
10605somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10606 </td>
10607
10608 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10609 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10610 </td>
10611
10612 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10613 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10614 </td>
10615
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10616 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10617 <ul class="entry_tags">
10618 <li><a href="#tag_FULL">FULL</a></li>
10619 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10620 </td>
10621
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10622 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10623
10624
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10625 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10626 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10627
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10628
10629
10630 <!-- end of kind -->
10631 </tbody>
10632
10633 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10634 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10635
10636
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10637 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10638
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10639 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10640 <tr>
10641 <th class="th_name">Property Name</th>
10642 <th class="th_type">Type</th>
10643 <th class="th_description">Description</th>
10644 <th class="th_units">Units</th>
10645 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10646 <th class="th_tags">Tags</th>
10647 </tr>
10648 </thead>
10649
10650 <tbody>
10651
10652
10653
10654
10655
10656
10657
10658
10659
10660
10661 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10662 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10663 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10664 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10665 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10666 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10667
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10668 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10669
10670 <ul class="entry_type_enum">
10671 <li>
10672 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10673 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10674 </li>
10675 <li>
10676 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10677 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10678 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10679 </li>
10680 <li>
10681 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10682 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10683 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10684 </li>
10685 </ul>
10686
10687 </td> <!-- entry_type -->
10688
10689 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10690 <p>Quality of lens shading correction applied
10691to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10692 </td>
10693
10694 <td class="entry_units">
10695 </td>
10696
10697 <td class="entry_range">
10698 </td>
10699
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10700 <td class="entry_tags">
10701 </td>
10702
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10703 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10704
10705
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10706 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10707 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10708
10709
10710 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10711 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10712 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10713 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10714 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10715 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10716
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10717 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10718
10719
10720 </td> <!-- entry_type -->
10721
10722 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10723 <p>Control the amount of shading correction
10724applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10725 </td>
10726
10727 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10728 unitless: 1-10; 10 is full shading
10729 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10730 </td>
10731
10732 <td class="entry_range">
10733 </td>
10734
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10735 <td class="entry_tags">
10736 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10737 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10738 </ul>
10739 </td>
10740
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10741 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10742
10743
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10744 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10745 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10746
10747
10748
10749 <!-- end of kind -->
10750 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10751 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10752
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10753 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10754 <tr>
10755 <th class="th_name">Property Name</th>
10756 <th class="th_type">Type</th>
10757 <th class="th_description">Description</th>
10758 <th class="th_units">Units</th>
10759 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10760 <th class="th_tags">Tags</th>
10761 </tr>
10762 </thead>
10763
10764 <tbody>
10765
10766
10767
10768
10769
10770
10771
10772
10773
10774
10775 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10776 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10777 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10778 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10779 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10780 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10781
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10782 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10783
10784 <ul class="entry_type_enum">
10785 <li>
10786 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10787 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10788 </li>
10789 <li>
10790 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10791 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10792 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10793 </li>
10794 <li>
10795 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10796 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10797 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10798 </li>
10799 </ul>
10800
10801 </td> <!-- entry_type -->
10802
10803 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10804 <p>Quality of lens shading correction applied
10805to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10806 </td>
10807
10808 <td class="entry_units">
10809 </td>
10810
10811 <td class="entry_range">
10812 </td>
10813
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10814 <td class="entry_tags">
10815 </td>
10816
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10817 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10818
10819
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10820 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10821 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10822
10823
10824
10825 <!-- end of kind -->
10826 </tbody>
10827
10828 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10829 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10830
10831
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10832 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10833
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10834 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10835 <tr>
10836 <th class="th_name">Property Name</th>
10837 <th class="th_type">Type</th>
10838 <th class="th_description">Description</th>
10839 <th class="th_units">Units</th>
10840 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10841 <th class="th_tags">Tags</th>
10842 </tr>
10843 </thead>
10844
10845 <tbody>
10846
10847
10848
10849
10850
10851
10852
10853
10854
10855
10856 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10857 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10858 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10859 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10860 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10861 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10862
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10863 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10864
10865 <ul class="entry_type_enum">
10866 <li>
10867 <span class="entry_type_enum_name">OFF</span>
10868 </li>
10869 <li>
10870 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10871 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
10872 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10873 </li>
10874 <li>
10875 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10876 <span class="entry_type_enum_notes">Optional Return all face
10877 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10878 </li>
10879 </ul>
10880
10881 </td> <!-- entry_type -->
10882
10883 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10884 <p>State of the face detector
10885unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10886 </td>
10887
10888 <td class="entry_units">
10889 </td>
10890
10891 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10892 <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]10893 </td>
10894
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10895 <td class="entry_tags">
10896 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10897 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10898 </ul>
10899 </td>
10900
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10901 </tr>
10902 <tr class="entries_header">
10903 <th class="th_details" colspan="5">Details</th>
10904 </tr>
10905 <tr class="entry_cont">
10906 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10907 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10908should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10909fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10910<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]10911 </td>
10912 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10913
10914
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10915 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10916 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10917
10918
10919 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10920 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10921 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10922 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10923 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10924 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10925
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10926 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10927
10928 <ul class="entry_type_enum">
10929 <li>
10930 <span class="entry_type_enum_name">OFF</span>
10931 </li>
10932 <li>
10933 <span class="entry_type_enum_name">ON</span>
10934 </li>
10935 </ul>
10936
10937 </td> <!-- entry_type -->
10938
10939 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10940 <p>Operating mode for histogram
10941generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10942 </td>
10943
10944 <td class="entry_units">
10945 </td>
10946
10947 <td class="entry_range">
10948 </td>
10949
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10950 <td class="entry_tags">
10951 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10952 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10953 </ul>
10954 </td>
10955
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10956 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10957
10958
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10959 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10960 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10961
10962
10963 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10964 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10965 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10966 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10967 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10968 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10969
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10970 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10971
10972 <ul class="entry_type_enum">
10973 <li>
10974 <span class="entry_type_enum_name">OFF</span>
10975 </li>
10976 <li>
10977 <span class="entry_type_enum_name">ON</span>
10978 </li>
10979 </ul>
10980
10981 </td> <!-- entry_type -->
10982
10983 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10984 <p>Operating mode for sharpness map
10985generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10986 </td>
10987
10988 <td class="entry_units">
10989 </td>
10990
10991 <td class="entry_range">
10992 </td>
10993
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10994 <td class="entry_tags">
10995 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10996 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10997 </ul>
10998 </td>
10999
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11000 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11001
11002
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11003 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11004 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11005
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11006
11007 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11008 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11009 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11010 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11011 <td class="entry_type">
11012 <span class="entry_type_name entry_type_name_enum">byte</span>
11013
11014 <span class="entry_type_visibility"> [public]</span>
11015
11016 <ul class="entry_type_enum">
11017 <li>
11018 <span class="entry_type_enum_name">OFF</span>
11019 </li>
11020 <li>
11021 <span class="entry_type_enum_name">ON</span>
11022 </li>
11023 </ul>
11024
11025 </td> <!-- entry_type -->
11026
11027 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11028 <p>Whether the HAL needs to output the lens
11029shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11030 </td>
11031
11032 <td class="entry_units">
11033 </td>
11034
11035 <td class="entry_range">
11036 </td>
11037
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11038 <td class="entry_tags">
11039 </td>
11040
11041 </tr>
11042 <tr class="entries_header">
11043 <th class="th_details" colspan="5">Details</th>
11044 </tr>
11045 <tr class="entry_cont">
11046 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11047 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11048<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]11049the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11050 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11051 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11052
11053
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11054 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11055 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11056
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11057
11058
11059 <!-- end of kind -->
11060 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11061 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11062
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11063 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11064 <tr>
11065 <th class="th_name">Property Name</th>
11066 <th class="th_type">Type</th>
11067 <th class="th_description">Description</th>
11068 <th class="th_units">Units</th>
11069 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11070 <th class="th_tags">Tags</th>
11071 </tr>
11072 </thead>
11073
11074 <tbody>
11075
11076
11077
11078
11079
11080
11081
11082
11083
11084
11085
11086
11087 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11088 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11089 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11090 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11091 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11092 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11093 <span class="entry_type_container">x</span>
11094
11095 <span class="entry_type_array">
11096 n
11097 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11098 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11099 <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]11100
11101
11102 </td> <!-- entry_type -->
11103
11104 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11105 <p>Which face detection modes are available,<wbr/>
11106if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11107 </td>
11108
11109 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11110 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11111 OFF
11112 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11113 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11114 </td>
11115
11116 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11117 </td>
11118
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11119 <td class="entry_tags">
11120 </td>
11121
11122 </tr>
11123 <tr class="entries_header">
11124 <th class="th_details" colspan="5">Details</th>
11125 </tr>
11126 <tr class="entry_cont">
11127 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11128 <p>OFF means face detection is disabled,<wbr/> it must
11129be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11130<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11131<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
11132<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]11133<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11134<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
11135<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]11136 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11137 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11138
11139
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11140 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11141 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11142
11143
11144 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11145 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11146 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11147 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11148 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11149 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11150
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11151 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11152
11153
11154 </td> <!-- entry_type -->
11155
11156 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11157 <p>Number of histogram buckets
11158supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11159 </td>
11160
11161 <td class="entry_units">
11162 </td>
11163
11164 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11165 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11166 </td>
11167
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11168 <td class="entry_tags">
11169 </td>
11170
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11171 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11172
11173
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11174 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11175 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11176
11177
11178 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11179 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11180 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11181 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11182 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11183 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11184
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11185 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11186
11187
11188 </td> <!-- entry_type -->
11189
11190 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11191 <p>Maximum number of simultaneously detectable
11192faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11193 </td>
11194
11195 <td class="entry_units">
11196 </td>
11197
11198 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11199 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11200modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11201 </td>
11202
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11203 <td class="entry_tags">
11204 </td>
11205
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11206 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11207
11208
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11209 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11210 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11211
11212
11213 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11214 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11215 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11216 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11217 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11218 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11219
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11220 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11221
11222
11223 </td> <!-- entry_type -->
11224
11225 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11226 <p>Maximum value possible for a histogram
11227bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11228 </td>
11229
11230 <td class="entry_units">
11231 </td>
11232
11233 <td class="entry_range">
11234 </td>
11235
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11236 <td class="entry_tags">
11237 </td>
11238
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11239 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11240
11241
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11242 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11243 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11244
11245
11246 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11247 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11248 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11249 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11250 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11251 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11252
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11253 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11254
11255
11256 </td> <!-- entry_type -->
11257
11258 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11259 <p>Maximum value possible for a sharpness map
11260region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11261 </td>
11262
11263 <td class="entry_units">
11264 </td>
11265
11266 <td class="entry_range">
11267 </td>
11268
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11269 <td class="entry_tags">
11270 </td>
11271
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11272 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11273
11274
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11275 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11276 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11277
11278
11279 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11280 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11281 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11282 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11283 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11284 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11285 <span class="entry_type_container">x</span>
11286
11287 <span class="entry_type_array">
11288 2
11289 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11290 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11291 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11292
11293
11294 </td> <!-- entry_type -->
11295
11296 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11297 <p>Dimensions of the sharpness
11298map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11299 </td>
11300
11301 <td class="entry_units">
11302 </td>
11303
11304 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11305 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11306 </td>
11307
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11308 <td class="entry_tags">
11309 </td>
11310
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11311 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11312
11313
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11314 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11315 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11316
11317
11318
11319
11320
11321
11322 <!-- end of kind -->
11323 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11324 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11325
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11326 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11327 <tr>
11328 <th class="th_name">Property Name</th>
11329 <th class="th_type">Type</th>
11330 <th class="th_description">Description</th>
11331 <th class="th_units">Units</th>
11332 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11333 <th class="th_tags">Tags</th>
11334 </tr>
11335 </thead>
11336
11337 <tbody>
11338
11339
11340
11341
11342
11343
11344
11345
11346
11347
11348 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11349 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11350 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11351 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11352 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11353 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11354
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11355 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11356
11357 <ul class="entry_type_enum">
11358 <li>
11359 <span class="entry_type_enum_name">OFF</span>
11360 </li>
11361 <li>
11362 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11363 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
11364 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11365 </li>
11366 <li>
11367 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11368 <span class="entry_type_enum_notes">Optional Return all face
11369 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11370 </li>
11371 </ul>
11372
11373 </td> <!-- entry_type -->
11374
11375 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11376 <p>State of the face detector
11377unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11378 </td>
11379
11380 <td class="entry_units">
11381 </td>
11382
11383 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11384 <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]11385 </td>
11386
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11387 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11388 <ul class="entry_tags">
11389 <li><a href="#tag_BC">BC</a></li>
11390 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11391 </td>
11392
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11393 </tr>
11394 <tr class="entries_header">
11395 <th class="th_details" colspan="5">Details</th>
11396 </tr>
11397 <tr class="entry_cont">
11398 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11399 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11400should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11401fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11402<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]11403 </td>
11404 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11405
11406
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11407 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11408 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11409
11410
11411 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11412 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11413 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11414 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11415 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11416 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11417 <span class="entry_type_container">x</span>
11418
11419 <span class="entry_type_array">
11420 n
11421 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11422 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11423
11424
11425 </td> <!-- entry_type -->
11426
11427 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11428 <p>List of unique IDs for detected
11429faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11430 </td>
11431
11432 <td class="entry_units">
11433 </td>
11434
11435 <td class="entry_range">
11436 </td>
11437
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11438 <td class="entry_tags">
11439 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11440 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11441 </ul>
11442 </td>
11443
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11444 </tr>
11445 <tr class="entries_header">
11446 <th class="th_details" colspan="5">Details</th>
11447 </tr>
11448 <tr class="entry_cont">
11449 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11450 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11451 </td>
11452 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11453
11454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11455 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11456 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11457
11458
11459 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11460 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11461 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11462 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11463 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11464 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11465 <span class="entry_type_container">x</span>
11466
11467 <span class="entry_type_array">
11468 n x 6
11469 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11470 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11471 <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]11472
11473
11474 </td> <!-- entry_type -->
11475
11476 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11477 <p>List of landmarks for detected
11478faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11479 </td>
11480
11481 <td class="entry_units">
11482 </td>
11483
11484 <td class="entry_range">
11485 </td>
11486
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11487 <td class="entry_tags">
11488 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11489 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11490 </ul>
11491 </td>
11492
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11493 </tr>
11494 <tr class="entries_header">
11495 <th class="th_details" colspan="5">Details</th>
11496 </tr>
11497 <tr class="entry_cont">
11498 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11499 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11500 </td>
11501 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11502
11503
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11504 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11505 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11506
11507
11508 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11509 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11510 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11511 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11512 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11513 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11514 <span class="entry_type_container">x</span>
11515
11516 <span class="entry_type_array">
11517 n x 4
11518 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11519 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11520 <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]11521
11522
11523 </td> <!-- entry_type -->
11524
11525 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11526 <p>List of the bounding rectangles for detected
11527faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11528 </td>
11529
11530 <td class="entry_units">
11531 </td>
11532
11533 <td class="entry_range">
11534 </td>
11535
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11536 <td class="entry_tags">
11537 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11538 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11539 </ul>
11540 </td>
11541
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11542 </tr>
11543 <tr class="entries_header">
11544 <th class="th_details" colspan="5">Details</th>
11545 </tr>
11546 <tr class="entry_cont">
11547 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11548 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11549 </td>
11550 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11551
11552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11553 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11554 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11555
11556
11557 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11558 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11559 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11560 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11561 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11562 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11563 <span class="entry_type_container">x</span>
11564
11565 <span class="entry_type_array">
11566 n
11567 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11568 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11569
11570
11571 </td> <!-- entry_type -->
11572
11573 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11574 <p>List of the face confidence scores for
11575detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11576 </td>
11577
11578 <td class="entry_units">
11579 </td>
11580
11581 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11582 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11583 </td>
11584
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11585 <td class="entry_tags">
11586 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11587 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11588 </ul>
11589 </td>
11590
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11591 </tr>
11592 <tr class="entries_header">
11593 <th class="th_details" colspan="5">Details</th>
11594 </tr>
11595 <tr class="entry_cont">
11596 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11597 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
11598meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11599 </td>
11600 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11601
11602
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11603 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11604 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11605
11606
11607 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11608 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11609 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11610 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11611 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11612 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11613 <span class="entry_type_container">x</span>
11614
11615 <span class="entry_type_array">
11616 n x 3
11617 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11618 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11619 <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]11620
11621
11622 </td> <!-- entry_type -->
11623
11624 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11625 <p>A 3-channel histogram based on the raw
11626sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11627 </td>
11628
11629 <td class="entry_units">
11630 </td>
11631
11632 <td class="entry_range">
11633 </td>
11634
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11635 <td class="entry_tags">
11636 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11637 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11638 </ul>
11639 </td>
11640
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11641 </tr>
11642 <tr class="entries_header">
11643 <th class="th_details" colspan="5">Details</th>
11644 </tr>
11645 <tr class="entry_cont">
11646 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11647 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11648(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]11649(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
11650supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11651 </td>
11652 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11653
11654
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11655 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11656 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11657
11658
11659 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11660 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11661 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11662 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11663 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11664 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11665
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11666 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11667
11668 <ul class="entry_type_enum">
11669 <li>
11670 <span class="entry_type_enum_name">OFF</span>
11671 </li>
11672 <li>
11673 <span class="entry_type_enum_name">ON</span>
11674 </li>
11675 </ul>
11676
11677 </td> <!-- entry_type -->
11678
11679 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11680 <p>Operating mode for histogram
11681generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11682 </td>
11683
11684 <td class="entry_units">
11685 </td>
11686
11687 <td class="entry_range">
11688 </td>
11689
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11690 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11691 <ul class="entry_tags">
11692 <li><a href="#tag_V1">V1</a></li>
11693 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11694 </td>
11695
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11696 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11697
11698
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11699 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11700 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11701
11702
11703 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11704 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11705 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11706 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11707 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11708 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11709 <span class="entry_type_container">x</span>
11710
11711 <span class="entry_type_array">
11712 n x m x 3
11713 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11714 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11715 <div class="entry_type_notes">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]11716
11717
11718 </td> <!-- entry_type -->
11719
11720 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11721 <p>A 3-channel sharpness map,<wbr/> based on the raw
11722sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11723 </td>
11724
11725 <td class="entry_units">
11726 </td>
11727
11728 <td class="entry_range">
11729 </td>
11730
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11731 <td class="entry_tags">
11732 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11733 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11734 </ul>
11735 </td>
11736
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11737 </tr>
11738 <tr class="entries_header">
11739 <th class="th_details" colspan="5">Details</th>
11740 </tr>
11741 <tr class="entry_cont">
11742 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11743 <p>If only a monochrome sharpness map is supported,<wbr/>
11744all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11745 </td>
11746 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11747
11748
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11749 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11750 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11751
11752
11753 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11754 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11755 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11756 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11757 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11758 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11759
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11760 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11761
11762 <ul class="entry_type_enum">
11763 <li>
11764 <span class="entry_type_enum_name">OFF</span>
11765 </li>
11766 <li>
11767 <span class="entry_type_enum_name">ON</span>
11768 </li>
11769 </ul>
11770
11771 </td> <!-- entry_type -->
11772
11773 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11774 <p>Operating mode for sharpness map
11775generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11776 </td>
11777
11778 <td class="entry_units">
11779 </td>
11780
11781 <td class="entry_range">
11782 </td>
11783
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11784 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11785 <ul class="entry_tags">
11786 <li><a href="#tag_V1">V1</a></li>
11787 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11788 </td>
11789
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11790 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11791
11792
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11793 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11794 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11795
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11796
11797 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11798 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11799 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11800 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11801 <td class="entry_type">
11802 <span class="entry_type_name">float</span>
11803 <span class="entry_type_container">x</span>
11804
11805 <span class="entry_type_array">
11806 4 x n x m
11807 </span>
11808 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11809 <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]11810
11811
11812 </td> <!-- entry_type -->
11813
11814 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11815 <p>The shading map is a low-resolution floating-point map
11816that lists the coefficients used to correct for vignetting,<wbr/> for each
11817Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11818 </td>
11819
11820 <td class="entry_units">
11821 </td>
11822
11823 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11824 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11825 </td>
11826
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11827 <td class="entry_tags">
11828 </td>
11829
11830 </tr>
11831 <tr class="entries_header">
11832 <th class="th_details" colspan="5">Details</th>
11833 </tr>
11834 <tr class="entry_cont">
11835 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11836 <p>The least shaded section of the image should have a gain factor
11837of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11838<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]11839must take into account the colorCorrection settings.<wbr/></p>
11840<p>The shading map is for the entire active pixel array,<wbr/> and is not
11841affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11842entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11843pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
11844map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
11845(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
11846pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
11847The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
11848<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
11849channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
11850The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11851is 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]11852<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
11853and must be smaller than 64x64.<wbr/></p>
11854<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11855<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
11856<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]11857[ 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/>
11858 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/>
11859 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/>
11860 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/>
11861 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/>
11862 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]11863</code></pre>
11864<p>The low-resolution scaling map images for each channel are
11865(displayed using nearest-neighbor interpolation):</p>
11866<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
11867<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
11868<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
11869<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]11870<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11871image 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]11872<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]11873 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11874 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11875
11876
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11877 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11878 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11879
11880
11881 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11882 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11883 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11884 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11885 <td class="entry_type">
11886 <span class="entry_type_name">float</span>
11887 <span class="entry_type_container">x</span>
11888
11889 <span class="entry_type_array">
11890 4
11891 </span>
11892 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11893 <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]11894
11895
11896 </td> <!-- entry_type -->
11897
11898 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11899 <p>The best-fit color channel gains calculated
11900by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11901 </td>
11902
11903 <td class="entry_units">
11904 </td>
11905
11906 <td class="entry_range">
11907 </td>
11908
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11909 <td class="entry_tags">
11910 </td>
11911
11912 </tr>
11913 <tr class="entries_header">
11914 <th class="th_details" colspan="5">Details</th>
11915 </tr>
11916 <tr class="entry_cont">
11917 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11918 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11919since statistics processing on data from a new frame
11920typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11921applied to that frame.<wbr/></p>
11922<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11923see <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]11924<p>This value should always be calculated by the AWB block,<wbr/>
11925regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11926 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11927 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11928
11929
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11930 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11931 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11932
11933
11934 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11935 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11936 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11937 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11938 <td class="entry_type">
11939 <span class="entry_type_name">rational</span>
11940 <span class="entry_type_container">x</span>
11941
11942 <span class="entry_type_array">
11943 3 x 3
11944 </span>
11945 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11946 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11947
11948
11949 </td> <!-- entry_type -->
11950
11951 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11952 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11953calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11954output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11955 </td>
11956
11957 <td class="entry_units">
11958 </td>
11959
11960 <td class="entry_range">
11961 </td>
11962
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11963 <td class="entry_tags">
11964 </td>
11965
11966 </tr>
11967 <tr class="entries_header">
11968 <th class="th_details" colspan="5">Details</th>
11969 </tr>
11970 <tr class="entry_cont">
11971 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11972 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11973statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11974for the next frame.<wbr/> These are the values the HAL believes
11975are the best fit for the current output frame.<wbr/> This may
11976be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11977statistics processing on data from a new frame typically
11978completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11979that frame.<wbr/></p>
11980<p>These estimates must be provided for all frames,<wbr/> even if
11981capture settings and color transforms are set by the application.<wbr/></p>
11982<p>This value should always be calculated by the AWB block,<wbr/>
11983regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11984 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11985 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11986
11987
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11988 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11989 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11990
11991
11992 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11993 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11994 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11995 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11996 <td class="entry_type">
11997 <span class="entry_type_name entry_type_name_enum">byte</span>
11998
11999 <span class="entry_type_visibility"> [public]</span>
12000
12001 <ul class="entry_type_enum">
12002 <li>
12003 <span class="entry_type_enum_name">NONE</span>
12004 </li>
12005 <li>
12006 <span class="entry_type_enum_name">50HZ</span>
12007 </li>
12008 <li>
12009 <span class="entry_type_enum_name">60HZ</span>
12010 </li>
12011 </ul>
12012
12013 </td> <!-- entry_type -->
12014
12015 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12016 <p>The HAL estimated scene illumination lighting
12017frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12018 </td>
12019
12020 <td class="entry_units">
12021 </td>
12022
12023 <td class="entry_range">
12024 </td>
12025
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12026 <td class="entry_tags">
12027 </td>
12028
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12029 </tr>
12030 <tr class="entries_header">
12031 <th class="th_details" colspan="5">Details</th>
12032 </tr>
12033 <tr class="entry_cont">
12034 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12035 <p>Report NONE if there doesn't appear to be flickering
12036illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12037 </td>
12038 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12039
12040
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12041 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12042 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12043
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12044
12045
12046 <!-- end of kind -->
12047 </tbody>
12048
12049 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12050 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12051
12052
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12053 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12054
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12055 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12056 <tr>
12057 <th class="th_name">Property Name</th>
12058 <th class="th_type">Type</th>
12059 <th class="th_description">Description</th>
12060 <th class="th_units">Units</th>
12061 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12062 <th class="th_tags">Tags</th>
12063 </tr>
12064 </thead>
12065
12066 <tbody>
12067
12068
12069
12070
12071
12072
12073
12074
12075
12076
12077 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12078 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12079 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12080 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12081 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12082 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12083 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12084
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12085 <span class="entry_type_array">
12086 n x 2
12087 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12088 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12089 <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]12090
12091
12092 </td> <!-- entry_type -->
12093
12094 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12095 <p>Table mapping blue input values to output
12096values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12097 </td>
12098
12099 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12100 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12101 </td>
12102
12103 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12104 <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]12105 </td>
12106
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12107 <td class="entry_tags">
12108 </td>
12109
12110 </tr>
12111 <tr class="entries_header">
12112 <th class="th_details" colspan="5">Details</th>
12113 </tr>
12114 <tr class="entry_cont">
12115 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12116 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12117channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12118<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]12119 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12120 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12121
12122
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12123 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12124 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12125
12126
12127 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12128 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12129 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12130 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12131 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12132 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12133 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12134
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12135 <span class="entry_type_array">
12136 n x 2
12137 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12138 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12139 <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]12140
12141
12142 </td> <!-- entry_type -->
12143
12144 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12145 <p>Table mapping green input values to output
12146values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12147 </td>
12148
12149 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12150 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12151 </td>
12152
12153 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12154 <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]12155 </td>
12156
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12157 <td class="entry_tags">
12158 </td>
12159
12160 </tr>
12161 <tr class="entries_header">
12162 <th class="th_details" colspan="5">Details</th>
12163 </tr>
12164 <tr class="entry_cont">
12165 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12166 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12167channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12168<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]12169 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12170 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12171
12172
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12173 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12174 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12175
12176
12177 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12178 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12179 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12180 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12181 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12182 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12183 <span class="entry_type_container">x</span>
12184
12185 <span class="entry_type_array">
12186 n x 2
12187 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12188 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12189 <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]12190
12191
12192 </td> <!-- entry_type -->
12193
12194 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12195 <p>Table mapping red input values to output
12196values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12197 </td>
12198
12199 <td class="entry_units">
12200 </td>
12201
12202 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12203 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12204 </td>
12205
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12206 <td class="entry_tags">
12207 <ul class="entry_tags">
12208 <li><a href="#tag_DNG">DNG</a></li>
12209 </ul>
12210 </td>
12211
12212 </tr>
12213 <tr class="entries_header">
12214 <th class="th_details" colspan="5">Details</th>
12215 </tr>
12216 <tr class="entry_cont">
12217 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12218 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12219channel,<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]12220<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12221the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12222are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12223between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12224<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12225defined points.<wbr/> The points will be listed in increasing
12226order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
122270.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12228for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
122290.<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]12230 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12231 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12232
12233
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12234 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12235 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12236
12237
12238 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12239 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12240 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12241 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12242 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12243 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12244
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12245 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12246
12247 <ul class="entry_type_enum">
12248 <li>
12249 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12250 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12251 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12252 </li>
12253 <li>
12254 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12255 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12256 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12257 </li>
12258 <li>
12259 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12260 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12261 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12262 </li>
12263 </ul>
12264
12265 </td> <!-- entry_type -->
12266
12267 <td class="entry_description">
12268 </td>
12269
12270 <td class="entry_units">
12271 </td>
12272
12273 <td class="entry_range">
12274 </td>
12275
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12276 <td class="entry_tags">
12277 </td>
12278
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12279 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12280
12281
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12282 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12283 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12284
12285
12286
12287 <!-- end of kind -->
12288 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12289 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12290
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12291 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12292 <tr>
12293 <th class="th_name">Property Name</th>
12294 <th class="th_type">Type</th>
12295 <th class="th_description">Description</th>
12296 <th class="th_units">Units</th>
12297 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12298 <th class="th_tags">Tags</th>
12299 </tr>
12300 </thead>
12301
12302 <tbody>
12303
12304
12305
12306
12307
12308
12309
12310
12311
12312
12313 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12314 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12315 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12316 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12317 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12318 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12319
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12320 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12321
12322
12323 </td> <!-- entry_type -->
12324
12325 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12326 <p>Maximum number of supported points in the
12327tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12328 </td>
12329
12330 <td class="entry_units">
12331 </td>
12332
12333 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]12334 <p>&gt;= 128</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12335 </td>
12336
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12337 <td class="entry_tags">
12338 </td>
12339
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12340 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12341
12342
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12343 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12344 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12345
12346
12347
12348 <!-- end of kind -->
12349 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12350 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12351
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12352 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12353 <tr>
12354 <th class="th_name">Property Name</th>
12355 <th class="th_type">Type</th>
12356 <th class="th_description">Description</th>
12357 <th class="th_units">Units</th>
12358 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12359 <th class="th_tags">Tags</th>
12360 </tr>
12361 </thead>
12362
12363 <tbody>
12364
12365
12366
12367
12368
12369
12370
12371
12372
12373
12374 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12375 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12376 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12377 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12378 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12379 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12380 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12381
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12382 <span class="entry_type_array">
12383 n x 2
12384 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12385 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12386 <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]12387
12388
12389 </td> <!-- entry_type -->
12390
12391 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12392 <p>Table mapping blue input values to output
12393values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12394 </td>
12395
12396 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12397 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12398 </td>
12399
12400 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12401 <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]12402 </td>
12403
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12404 <td class="entry_tags">
12405 </td>
12406
12407 </tr>
12408 <tr class="entries_header">
12409 <th class="th_details" colspan="5">Details</th>
12410 </tr>
12411 <tr class="entry_cont">
12412 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12413 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12414channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12415<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]12416 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12417 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12418
12419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12420 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12421 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12422
12423
12424 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12425 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12426 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12427 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12428 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12429 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12430 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12431
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12432 <span class="entry_type_array">
12433 n x 2
12434 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12435 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12436 <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]12437
12438
12439 </td> <!-- entry_type -->
12440
12441 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12442 <p>Table mapping green input values to output
12443values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12444 </td>
12445
12446 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12447 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12448 </td>
12449
12450 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12451 <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]12452 </td>
12453
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12454 <td class="entry_tags">
12455 </td>
12456
12457 </tr>
12458 <tr class="entries_header">
12459 <th class="th_details" colspan="5">Details</th>
12460 </tr>
12461 <tr class="entry_cont">
12462 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12463 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12464channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12465<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]12466 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12467 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12468
12469
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12470 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12471 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12472
12473
12474 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12475 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12476 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12477 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12478 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12479 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12480 <span class="entry_type_container">x</span>
12481
12482 <span class="entry_type_array">
12483 n x 2
12484 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12485 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12486 <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]12487
12488
12489 </td> <!-- entry_type -->
12490
12491 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12492 <p>Table mapping red input values to output
12493values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12494 </td>
12495
12496 <td class="entry_units">
12497 </td>
12498
12499 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12500 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12501 </td>
12502
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12503 <td class="entry_tags">
12504 <ul class="entry_tags">
12505 <li><a href="#tag_DNG">DNG</a></li>
12506 </ul>
12507 </td>
12508
12509 </tr>
12510 <tr class="entries_header">
12511 <th class="th_details" colspan="5">Details</th>
12512 </tr>
12513 <tr class="entry_cont">
12514 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12515 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12516channel,<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]12517<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12518the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12519are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12520between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12521<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12522defined points.<wbr/> The points will be listed in increasing
12523order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
125240.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12525for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
125260.<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]12527 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12528 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12529
12530
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12531 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12532 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12533
12534
12535 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12536 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12537 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12538 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12539 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12540 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12541
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12542 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12543
12544 <ul class="entry_type_enum">
12545 <li>
12546 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12547 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12548 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12549 </li>
12550 <li>
12551 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12552 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12553 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12554 </li>
12555 <li>
12556 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12557 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12558 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12559 </li>
12560 </ul>
12561
12562 </td> <!-- entry_type -->
12563
12564 <td class="entry_description">
12565 </td>
12566
12567 <td class="entry_units">
12568 </td>
12569
12570 <td class="entry_range">
12571 </td>
12572
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12573 <td class="entry_tags">
12574 </td>
12575
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12576 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12577
12578
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12579 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12580 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12581
12582
12583
12584 <!-- end of kind -->
12585 </tbody>
12586
12587 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12588 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12589
12590
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12591 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12592
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12593 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12594 <tr>
12595 <th class="th_name">Property Name</th>
12596 <th class="th_type">Type</th>
12597 <th class="th_description">Description</th>
12598 <th class="th_units">Units</th>
12599 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12600 <th class="th_tags">Tags</th>
12601 </tr>
12602 </thead>
12603
12604 <tbody>
12605
12606
12607
12608
12609
12610
12611
12612
12613
12614
12615 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12616 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12617 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12618 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12619 <td class="entry_type">
12620 <span class="entry_type_name entry_type_name_enum">byte</span>
12621
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12622 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12623
12624 <ul class="entry_type_enum">
12625 <li>
12626 <span class="entry_type_enum_name">OFF</span>
12627 </li>
12628 <li>
12629 <span class="entry_type_enum_name">ON</span>
12630 </li>
12631 </ul>
12632
12633 </td> <!-- entry_type -->
12634
12635 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12636 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12637that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12638Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12639disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12640any untrusted applications.<wbr/></p>
12641<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12642transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12643data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12644<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]12645doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12646 </td>
12647
12648 <td class="entry_units">
12649 </td>
12650
12651 <td class="entry_range">
12652 </td>
12653
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12654 <td class="entry_tags">
12655 </td>
12656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12657 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12658
12659
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12660 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12661 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12662
12663
12664
12665 <!-- end of kind -->
12666 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12667 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12668
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12669 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12670 <tr>
12671 <th class="th_name">Property Name</th>
12672 <th class="th_type">Type</th>
12673 <th class="th_description">Description</th>
12674 <th class="th_units">Units</th>
12675 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12676 <th class="th_tags">Tags</th>
12677 </tr>
12678 </thead>
12679
12680 <tbody>
12681
12682
12683
12684
12685
12686
12687
12688
12689
12690
12691 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12692 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12693 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12694 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12695 <td class="entry_type">
12696 <span class="entry_type_name entry_type_name_enum">byte</span>
12697
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12698 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12699
12700 <ul class="entry_type_enum">
12701 <li>
12702 <span class="entry_type_enum_name">OFF</span>
12703 </li>
12704 <li>
12705 <span class="entry_type_enum_name">ON</span>
12706 </li>
12707 </ul>
12708
12709 </td> <!-- entry_type -->
12710
12711 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12712 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12713that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12714Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12715disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12716any untrusted applications.<wbr/></p>
12717<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12718transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12719data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12720<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]12721doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12722 </td>
12723
12724 <td class="entry_units">
12725 </td>
12726
12727 <td class="entry_range">
12728 </td>
12729
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12730 <td class="entry_tags">
12731 </td>
12732
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12733 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12734
12735
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12736 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12737 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12738
12739
12740
12741 <!-- end of kind -->
12742 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12743 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12744
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12745 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12746 <tr>
12747 <th class="th_name">Property Name</th>
12748 <th class="th_type">Type</th>
12749 <th class="th_description">Description</th>
12750 <th class="th_units">Units</th>
12751 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12752 <th class="th_tags">Tags</th>
12753 </tr>
12754 </thead>
12755
12756 <tbody>
12757
12758
12759
12760
12761
12762
12763
12764
12765
12766
12767 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12768 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12769 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12770 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12771 <td class="entry_type">
12772 <span class="entry_type_name entry_type_name_enum">byte</span>
12773 <span class="entry_type_container">x</span>
12774
12775 <span class="entry_type_array">
12776 n
12777 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12778 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12779
12780 <ul class="entry_type_enum">
12781 <li>
12782 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12783 <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]12784 </li>
12785 </ul>
12786
12787 </td> <!-- entry_type -->
12788
12789 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12790 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12791 </td>
12792
12793 <td class="entry_units">
12794 </td>
12795
12796 <td class="entry_range">
12797 </td>
12798
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12799 <td class="entry_tags">
12800 </td>
12801
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12802 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12803
12804
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12805 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12806 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12807
12808
12809
12810 <!-- end of kind -->
12811 </tbody>
12812
12813 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12814 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12815
12816
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12817 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12818
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12819 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12820 <tr>
12821 <th class="th_name">Property Name</th>
12822 <th class="th_type">Type</th>
12823 <th class="th_description">Description</th>
12824 <th class="th_units">Units</th>
12825 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12826 <th class="th_tags">Tags</th>
12827 </tr>
12828 </thead>
12829
12830 <tbody>
12831
12832
12833
12834
12835
12836
12837
12838
12839
12840
12841 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12842 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12843 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12844 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12845 <td class="entry_type">
12846 <span class="entry_type_name entry_type_name_enum">byte</span>
12847
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12848 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12849
12850 <ul class="entry_type_enum">
12851 <li>
12852 <span class="entry_type_enum_name">LIMITED</span>
12853 </li>
12854 <li>
12855 <span class="entry_type_enum_name">FULL</span>
12856 </li>
12857 </ul>
12858
12859 </td> <!-- entry_type -->
12860
12861 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12862 <p>The camera 3 HAL device can implement one of two possible
12863operational modes; limited and full.<wbr/> Full support is
12864expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12865hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12866camera HAL device v1 implementation,<wbr/> and is expected from
12867older or inexpensive devices.<wbr/> Full is a strict superset of
12868limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
12869<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]12870 </td>
12871
12872 <td class="entry_units">
12873 </td>
12874
12875 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12876 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12877 </td>
12878
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12879 <td class="entry_tags">
12880 </td>
12881
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12882 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12883
12884
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12885 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12886 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12887
12888
12889
12890 <!-- end of kind -->
12891 </tbody>
12892
12893 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12894 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12895
12896
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12897 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12898
12899 <thead class="entries_header">
12900 <tr>
12901 <th class="th_name">Property Name</th>
12902 <th class="th_type">Type</th>
12903 <th class="th_description">Description</th>
12904 <th class="th_units">Units</th>
12905 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12906 <th class="th_tags">Tags</th>
12907 </tr>
12908 </thead>
12909
12910 <tbody>
12911
12912
12913
12914
12915
12916
12917
12918
12919
12920
12921 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12922 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12923 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12924 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12925 <td class="entry_type">
12926 <span class="entry_type_name entry_type_name_enum">byte</span>
12927
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12928 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12929
12930 <ul class="entry_type_enum">
12931 <li>
12932 <span class="entry_type_enum_name">OFF</span>
12933 </li>
12934 <li>
12935 <span class="entry_type_enum_name">ON</span>
12936 </li>
12937 </ul>
12938
12939 </td> <!-- entry_type -->
12940
12941 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12942 <p>Whether black-level compensation is locked
12943to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12944 </td>
12945
12946 <td class="entry_units">
12947 </td>
12948
12949 <td class="entry_range">
12950 </td>
12951
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12952 <td class="entry_tags">
12953 <ul class="entry_tags">
12954 <li><a href="#tag_HAL2">HAL2</a></li>
12955 </ul>
12956 </td>
12957
12958 </tr>
12959 <tr class="entries_header">
12960 <th class="th_details" colspan="5">Details</th>
12961 </tr>
12962 <tr class="entry_cont">
12963 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12964 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12965compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12966OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12967<p>Since changes to certain capture parameters (such as
12968exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12969compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12970the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12971metadata.<wbr/></p>
12972<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12973<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12974<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12975<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12976<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12977<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12978<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12979<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12980</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12981<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12982device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12983result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12984<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12985<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12986<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12987<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12988<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
12989<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12990<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12991</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12992<p>This indicates to the application that on frame 4,<wbr/> black
12993levels were reset due to exposure value changes,<wbr/> and pixel
12994values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12995<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12996possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12997other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12998or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12999 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13000 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13001
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13002 <tr class="entries_header">
13003 <th class="th_details" colspan="5">HAL Implementation Details</th>
13004 </tr>
13005 <tr class="entry_cont">
13006 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13007 <p>If for some reason black level locking is no longer possible
13008(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13009black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13010override this request (and it must report 'OFF' when this
13011does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13012possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13013 </td>
13014 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13015
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13016 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13017 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13018
13019
13020
13021 <!-- end of kind -->
13022 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13023 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13024
13025 <thead class="entries_header">
13026 <tr>
13027 <th class="th_name">Property Name</th>
13028 <th class="th_type">Type</th>
13029 <th class="th_description">Description</th>
13030 <th class="th_units">Units</th>
13031 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13032 <th class="th_tags">Tags</th>
13033 </tr>
13034 </thead>
13035
13036 <tbody>
13037
13038
13039
13040
13041
13042
13043
13044
13045
13046
13047 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13048 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13049 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13050 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13051 <td class="entry_type">
13052 <span class="entry_type_name entry_type_name_enum">byte</span>
13053
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13054 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13055
13056 <ul class="entry_type_enum">
13057 <li>
13058 <span class="entry_type_enum_name">OFF</span>
13059 </li>
13060 <li>
13061 <span class="entry_type_enum_name">ON</span>
13062 </li>
13063 </ul>
13064
13065 </td> <!-- entry_type -->
13066
13067 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13068 <p>Whether black-level compensation is locked
13069to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13070 </td>
13071
13072 <td class="entry_units">
13073 </td>
13074
13075 <td class="entry_range">
13076 </td>
13077
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13078 <td class="entry_tags">
13079 <ul class="entry_tags">
13080 <li><a href="#tag_HAL2">HAL2</a></li>
13081 </ul>
13082 </td>
13083
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13084 </tr>
13085 <tr class="entries_header">
13086 <th class="th_details" colspan="5">Details</th>
13087 </tr>
13088 <tr class="entry_cont">
13089 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13090 <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]13091ON 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]13092a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13093perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13094 </td>
13095 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13096
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13097 <tr class="entries_header">
13098 <th class="th_details" colspan="5">HAL Implementation Details</th>
13099 </tr>
13100 <tr class="entry_cont">
13101 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13102 <p>If for some reason black level locking is no longer possible
13103(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13104black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13105override this request (and it must report 'OFF' when this
13106does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13107possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13108 </td>
13109 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13110
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13111 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13112 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13113
13114
13115
13116 <!-- end of kind -->
13117 </tbody>
13118
13119 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13120<!-- </namespace> -->
13121 </table>
13122
13123 <div class="tags" id="tag_index">
13124 <h2>Tags</h2>
13125 <ul>
13126 <li id="tag_AWB">AWB -
13127 Needed for auto white balance
13128
13129 <ul class="tags_entries">
13130 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13131 </ul>
13132 </li> <!-- tag_AWB -->
13133 <li id="tag_BC">BC -
13134 Needed for backwards compatibility with old Java API
13135
13136 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]13137 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13138 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
13139 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
13140 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
13141 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
13142 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13143 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13144 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
13145 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13146 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13147 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
13148 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13149 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
13150 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
13151 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
13152 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
13153 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
13154 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]13155 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13156 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
13157 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
13158 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
13159 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
13160 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
13161 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
13162 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
13163 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
13164 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
13165 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
13166 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
13167 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
13168 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
13169 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
13170 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
13171 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
13172 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
13173 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
13174 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
13175 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13176 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13177 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
13178 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
13179 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
13180 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
13181 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
13182 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
13183 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]13184 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13185 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
13186 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
13187 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13188 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13189 <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]13190 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13191 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13192 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13193 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
13194 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
13195 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
13196 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
13197 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
13198 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
13199 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
13200 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
13201 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
13202 </ul>
13203 </li> <!-- tag_BC -->
13204 <li id="tag_V1">V1 -
13205 New features for first camera 2 release (API1)
13206
13207 <ul class="tags_entries">
13208 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13209 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13210 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13211 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13212 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13213 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13214 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13215 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13216 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13217 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13218 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13219 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13220 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13221 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13222 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13223 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13224 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13225 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13226 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13227 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13228 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13229 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13230 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13231 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13232 <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]13233 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13234 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13235 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13236 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13237 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13238 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13239 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13240 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13241 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13242 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13243 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13244 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13245 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13246 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13247 </ul>
13248 </li> <!-- tag_V1 -->
13249 <li id="tag_ADV">ADV - None
13250 <ul class="tags_entries">
13251 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13252 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13253 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13254 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13255 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13256 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13257 </ul>
13258 </li> <!-- tag_ADV -->
13259 <li id="tag_DNG">DNG -
13260 Needed for DNG file support
13261
13262 <ul class="tags_entries">
13263 <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]13264 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13265 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13266 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13267 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13268 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13269 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13270 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13271 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13272 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13273 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13274 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13275 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13276 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13277 </ul>
13278 </li> <!-- tag_DNG -->
13279 <li id="tag_EXIF">EXIF - None
13280 <ul class="tags_entries">
13281 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13282 </ul>
13283 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13284 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13285 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13286
13287 <ul class="tags_entries">
13288 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13289 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13290 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13291 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13292 </ul>
13293 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13294 <li id="tag_FULL">FULL -
13295 Entry is required for full hardware level devices, and optional for other hardware levels
13296
13297 <ul class="tags_entries">
13298 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13299 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13300 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13301 </ul>
13302 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13303 </ul>
13304 </div>
13305
13306 [ <a href="#">top</a> ]
13307
13308</body>
13309</html>