Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / 92e698de8118f5315f10d1282e8798fb1203c936 / . / camera / docs / docs.html
blob: c93c748e09ab1fd009a445f353cc1bd9ad6e8382 [file] [log] [blame]
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1<!DOCTYPE html>
2<html>
3<!-- Copyright (C) 2012 The Android Open Source Project
4
5 Licensed under the Apache License, Version 2.0 (the "License");
6 you may not use this file except in compliance with the License.
7 You may obtain a copy of the License at
8
9 http://www.apache.org/licenses/LICENSE-2.0
10
11 Unless required by applicable law or agreed to in writing, software
12 distributed under the License is distributed on an "AS IS" BASIS,
13 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 See the License for the specific language governing permissions and
15 limitations under the License.
16-->
17<head>
18 <!-- automatically generated from html.mako. do NOT edit directly -->
19 <meta charset="utf-8" />
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]20 <title>Android Camera HAL3.0 Properties</title>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]21 <style type="text/css">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]22 body { background-color: #f7f7f7; font-family: Roboto, sans-serif;}
23 h1 { color: #333333; }
24 h2 { color: #333333; }
25 a:link { color: #258aaf; text-decoration: none}
26 a:hover { color: #459aaf; text-decoration: underline }
27 a:visited { color: #154a5f; text-decoration: none}
28 .section { color: #eeeeee; font-size: 1.5em; font-weight: bold; background-color: #888888; padding: 0.5em 0em 0.5em 0.5em; border-width: thick thin thin thin; border-color: #111111 #777777 #777777 #777777}
29 .kind { color: #eeeeee; font-size: 1.2em; font-weight: bold; padding-left: 1.5em; background-color: #aaaaaa }
30 .entry { background-color: #f0f0f0 }
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]31 .entry_cont { background-color: #f0f0f0 }
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]32 .entries_header { background-color: #dddddd; text-align: center}
33
34 /* toc style */
35 .toc_section_header { font-size:1.3em; }
36 .toc_kind_header { font-size:1.2em; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]37
38 /* table column sizes */
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]39 table { border-collapse:collapse; table-layout: fixed; width: 100%; word-wrap: break-word }
40 td,th { border: 1px solid; border-color: #aaaaaa; padding-left: 0.5em; padding-right: 0.5em }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]41 .th_name { width: 20% }
42 .th_units { width: 10% }
43 .th_tags { width: 5% }
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]44 .th_details { width: 25% }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]45 .th_type { width: 20% }
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]46 .th_description { width: 20% }
47 .th_range { width: 10% }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]48 td { font-size: 0.9em; }
49
50 /* hide the first thead, we need it there only to enforce column sizes */
51 .thead_dummy { visibility: hidden; }
52
53 /* Entry flair */
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]54 .entry_name { color: #333333; padding-left:1.0em; font-size:1.1em; font-family: monospace; vertical-align:top; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]55
56 /* Entry type flair */
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]57 .entry_type_name { font-size:1.1em; color: #669900; font-weight: bold;}
58 .entry_type_name_enum:after { color: #669900; font-weight: bold; content:" (enum)" }
59 .entry_type_visibility { font-weight: bolder; padding-left:1em}
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]60 .entry_type_enum_name { font-family: monospace; font-weight: bolder; }
61 .entry_type_enum_notes:before { content:" - " }
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]62 .entry_type_enum_notes>p:first-child { display:inline; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]63 .entry_type_enum_value:before { content:" = " }
64 .entry_type_enum_value { font-family: monospace; }
65 .entry ul { margin: 0 0 0 0; list-style-position: inside; padding-left: 0.5em; }
66 .entry ul li { padding: 0 0 0 0; margin: 0 0 0 0;}
67
68 /* Entry tags flair */
69 .entry_tags ul { list-style-type: none; }
70
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]71 /* Entry details (full docs) flair */
72 .entry_details_header { font-weight: bold; background-color: #dddddd;
73 text-align: center; font-size: 1.1em; margin-left: 0em; margin-right: 0em; }
74
75 /* Entry spacer flair */
76 .entry_spacer { background-color: transparent; border-style: none; height: 0.5em; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]77
78 /* TODO: generate abbr element for each tag link? */
79 /* TODO for each x.y.z try to link it to the entry */
80
81 </style>
82
83 <style>
84
85 {
86 /* broken...
87 supposedly there is a bug in chrome that it lays out tables before
88 it knows its being printed, so the page-break-* styles are ignored
89 */
90 tr { page-break-after: always; page-break-inside: avoid; }
91 }
92
93 </style>
94</head>
95
96
97
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]98<body>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]99 <h1>Android Camera HAL3.0 Properties</h1>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]100
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]101
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]102 <h2>Table of Contents</h2>
103 <ul class="toc">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]104 <li><a href="#tag_index" class="toc_section_header">Tags</a></li>
105 <li>
106 <span class="toc_section_header"><a href="#section_colorCorrection">colorCorrection</a></span>
107 <ul class="toc_section">
108 <li>
109 <span class="toc_kind_header">controls</span>
110 <ul class="toc_section">
111 <li><a href="#controls_android.colorCorrection.mode">android.colorCorrection.mode</a></li>
112 <li><a href="#controls_android.colorCorrection.transform">android.colorCorrection.transform</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]113 <li><a href="#controls_android.colorCorrection.gains">android.colorCorrection.gains</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]114 </ul>
115 </li>
116 <li>
117 <span class="toc_kind_header">dynamic</span>
118 <ul class="toc_section">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]119 <li><a href="#dynamic_android.colorCorrection.transform">android.colorCorrection.transform</a></li>
120 <li><a href="#dynamic_android.colorCorrection.gains">android.colorCorrection.gains</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]121 </ul>
122 </li>
123 </ul> <!-- toc_section -->
124 </li>
125 <li>
126 <span class="toc_section_header"><a href="#section_control">control</a></span>
127 <ul class="toc_section">
128 <li>
129 <span class="toc_kind_header">controls</span>
130 <ul class="toc_section">
131 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a></li>
132 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a></li>
133 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a></li>
134 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a></li>
135 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a></li>
136 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a></li>
137 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a></li>
138 <li><a href="#controls_android.control.afMode">android.control.afMode</a></li>
139 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a></li>
140 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a></li>
141 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a></li>
142 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a></li>
143 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a></li>
144 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a></li>
145 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a></li>
146 <li><a href="#controls_android.control.mode">android.control.mode</a></li>
147 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a></li>
148 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a></li>
149 </ul>
150 </li>
151 <li>
152 <span class="toc_kind_header">static</span>
153 <ul class="toc_section">
154 <li><a href="#static_android.control.aeAvailableAntibandingModes">android.control.aeAvailableAntibandingModes</a></li>
155 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a></li>
156 <li><a href="#static_android.control.aeAvailableTargetFpsRanges">android.control.aeAvailableTargetFpsRanges</a></li>
157 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a></li>
158 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a></li>
159 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a></li>
160 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a></li>
161 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a></li>
162 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a></li>
163 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a></li>
164 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a></li>
165 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a></li>
166 </ul>
167 </li>
168 <li>
169 <span class="toc_kind_header">dynamic</span>
170 <ul class="toc_section">
171 <li><a href="#dynamic_android.control.aePrecaptureId">android.control.aePrecaptureId</a></li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]172 <li><a href="#dynamic_android.control.aeMode">android.control.aeMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]173 <li><a href="#dynamic_android.control.aeRegions">android.control.aeRegions</a></li>
174 <li><a href="#dynamic_android.control.aeState">android.control.aeState</a></li>
175 <li><a href="#dynamic_android.control.afMode">android.control.afMode</a></li>
176 <li><a href="#dynamic_android.control.afRegions">android.control.afRegions</a></li>
177 <li><a href="#dynamic_android.control.afState">android.control.afState</a></li>
178 <li><a href="#dynamic_android.control.afTriggerId">android.control.afTriggerId</a></li>
179 <li><a href="#dynamic_android.control.awbMode">android.control.awbMode</a></li>
180 <li><a href="#dynamic_android.control.awbRegions">android.control.awbRegions</a></li>
181 <li><a href="#dynamic_android.control.awbState">android.control.awbState</a></li>
182 <li><a href="#dynamic_android.control.mode">android.control.mode</a></li>
183 </ul>
184 </li>
185 </ul> <!-- toc_section -->
186 </li>
187 <li>
188 <span class="toc_section_header"><a href="#section_demosaic">demosaic</a></span>
189 <ul class="toc_section">
190 <li>
191 <span class="toc_kind_header">controls</span>
192 <ul class="toc_section">
193 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a></li>
194 </ul>
195 </li>
196 </ul> <!-- toc_section -->
197 </li>
198 <li>
199 <span class="toc_section_header"><a href="#section_edge">edge</a></span>
200 <ul class="toc_section">
201 <li>
202 <span class="toc_kind_header">controls</span>
203 <ul class="toc_section">
204 <li><a href="#controls_android.edge.mode">android.edge.mode</a></li>
205 <li><a href="#controls_android.edge.strength">android.edge.strength</a></li>
206 </ul>
207 </li>
208 <li>
209 <span class="toc_kind_header">dynamic</span>
210 <ul class="toc_section">
211 <li><a href="#dynamic_android.edge.mode">android.edge.mode</a></li>
212 </ul>
213 </li>
214 </ul> <!-- toc_section -->
215 </li>
216 <li>
217 <span class="toc_section_header"><a href="#section_flash">flash</a></span>
218 <ul class="toc_section">
219 <li>
220 <span class="toc_kind_header">controls</span>
221 <ul class="toc_section">
222 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a></li>
223 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a></li>
224 <li><a href="#controls_android.flash.mode">android.flash.mode</a></li>
225 </ul>
226 </li>
227 <li>
228 <span class="toc_kind_header">static</span>
229 <ul class="toc_section">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]230
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]231 <li><a href="#static_android.flash.info.available">android.flash.info.available</a></li>
232 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]233
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]234 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a></li>
235 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a></li>
236 </ul>
237 </li>
238 <li>
239 <span class="toc_kind_header">dynamic</span>
240 <ul class="toc_section">
241 <li><a href="#dynamic_android.flash.firingPower">android.flash.firingPower</a></li>
242 <li><a href="#dynamic_android.flash.firingTime">android.flash.firingTime</a></li>
243 <li><a href="#dynamic_android.flash.mode">android.flash.mode</a></li>
244 <li><a href="#dynamic_android.flash.state">android.flash.state</a></li>
245 </ul>
246 </li>
247 </ul> <!-- toc_section -->
248 </li>
249 <li>
250 <span class="toc_section_header"><a href="#section_geometric">geometric</a></span>
251 <ul class="toc_section">
252 <li>
253 <span class="toc_kind_header">controls</span>
254 <ul class="toc_section">
255 <li><a href="#controls_android.geometric.mode">android.geometric.mode</a></li>
256 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a></li>
257 </ul>
258 </li>
259 </ul> <!-- toc_section -->
260 </li>
261 <li>
262 <span class="toc_section_header"><a href="#section_hotPixel">hotPixel</a></span>
263 <ul class="toc_section">
264 <li>
265 <span class="toc_kind_header">controls</span>
266 <ul class="toc_section">
267 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a></li>
268 </ul>
269 </li>
270 <li>
271 <span class="toc_kind_header">static</span>
272 <ul class="toc_section">
273
274 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a></li>
275
276 </ul>
277 </li>
278 <li>
279 <span class="toc_kind_header">dynamic</span>
280 <ul class="toc_section">
281 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a></li>
282 </ul>
283 </li>
284 </ul> <!-- toc_section -->
285 </li>
286 <li>
287 <span class="toc_section_header"><a href="#section_jpeg">jpeg</a></span>
288 <ul class="toc_section">
289 <li>
290 <span class="toc_kind_header">controls</span>
291 <ul class="toc_section">
292 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
293 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
294 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
295 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a></li>
296 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a></li>
297 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
298 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
299 </ul>
300 </li>
301 <li>
302 <span class="toc_kind_header">static</span>
303 <ul class="toc_section">
304 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a></li>
305 <li><a href="#static_android.jpeg.maxSize">android.jpeg.maxSize</a></li>
306 </ul>
307 </li>
308 <li>
309 <span class="toc_kind_header">dynamic</span>
310 <ul class="toc_section">
311 <li><a href="#dynamic_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
312 <li><a href="#dynamic_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
313 <li><a href="#dynamic_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
314 <li><a href="#dynamic_android.jpeg.orientation">android.jpeg.orientation</a></li>
315 <li><a href="#dynamic_android.jpeg.quality">android.jpeg.quality</a></li>
316 <li><a href="#dynamic_android.jpeg.size">android.jpeg.size</a></li>
317 <li><a href="#dynamic_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
318 <li><a href="#dynamic_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
319 </ul>
320 </li>
321 </ul> <!-- toc_section -->
322 </li>
323 <li>
324 <span class="toc_section_header"><a href="#section_lens">lens</a></span>
325 <ul class="toc_section">
326 <li>
327 <span class="toc_kind_header">controls</span>
328 <ul class="toc_section">
329 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a></li>
330 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a></li>
331 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a></li>
332 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a></li>
333 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
334 </ul>
335 </li>
336 <li>
337 <span class="toc_kind_header">static</span>
338 <ul class="toc_section">
339
340 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a></li>
341 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a></li>
342 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a></li>
343 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a></li>
344 <li><a href="#static_android.lens.info.geometricCorrectionMap">android.lens.info.geometricCorrectionMap</a></li>
345 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a></li>
346 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a></li>
347 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]348 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a></li>
349
350 <li><a href="#static_android.lens.facing">android.lens.facing</a></li>
351 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a></li>
352 <li><a href="#static_android.lens.position">android.lens.position</a></li>
353 </ul>
354 </li>
355 <li>
356 <span class="toc_kind_header">dynamic</span>
357 <ul class="toc_section">
358 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a></li>
359 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a></li>
360 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a></li>
361 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a></li>
362 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a></li>
363 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
364 <li><a href="#dynamic_android.lens.state">android.lens.state</a></li>
365 </ul>
366 </li>
367 </ul> <!-- toc_section -->
368 </li>
369 <li>
370 <span class="toc_section_header"><a href="#section_noiseReduction">noiseReduction</a></span>
371 <ul class="toc_section">
372 <li>
373 <span class="toc_kind_header">controls</span>
374 <ul class="toc_section">
375 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
376 <li><a href="#controls_android.noiseReduction.strength">android.noiseReduction.strength</a></li>
377 </ul>
378 </li>
379 <li>
380 <span class="toc_kind_header">dynamic</span>
381 <ul class="toc_section">
382 <li><a href="#dynamic_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
383 </ul>
384 </li>
385 </ul> <!-- toc_section -->
386 </li>
387 <li>
388 <span class="toc_section_header"><a href="#section_quirks">quirks</a></span>
389 <ul class="toc_section">
390 <li>
391 <span class="toc_kind_header">static</span>
392 <ul class="toc_section">
393 <li><a href="#static_android.quirks.meteringCropRegion">android.quirks.meteringCropRegion</a></li>
394 <li><a href="#static_android.quirks.triggerAfWithAuto">android.quirks.triggerAfWithAuto</a></li>
395 <li><a href="#static_android.quirks.useZslFormat">android.quirks.useZslFormat</a></li>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]396 <li><a href="#static_android.quirks.usePartialResult">android.quirks.usePartialResult</a></li>
397 </ul>
398 </li>
399 <li>
400 <span class="toc_kind_header">dynamic</span>
401 <ul class="toc_section">
402 <li><a href="#dynamic_android.quirks.partialResult">android.quirks.partialResult</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]403 </ul>
404 </li>
405 </ul> <!-- toc_section -->
406 </li>
407 <li>
408 <span class="toc_section_header"><a href="#section_request">request</a></span>
409 <ul class="toc_section">
410 <li>
411 <span class="toc_kind_header">controls</span>
412 <ul class="toc_section">
413 <li><a href="#controls_android.request.frameCount">android.request.frameCount</a></li>
414 <li><a href="#controls_android.request.id">android.request.id</a></li>
415 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a></li>
416 <li><a href="#controls_android.request.metadataMode">android.request.metadataMode</a></li>
417 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a></li>
418 <li><a href="#controls_android.request.type">android.request.type</a></li>
419 </ul>
420 </li>
421 <li>
422 <span class="toc_kind_header">static</span>
423 <ul class="toc_section">
424 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a></li>
425 <li><a href="#static_android.request.maxNumReprocessStreams">android.request.maxNumReprocessStreams</a></li>
426 </ul>
427 </li>
428 <li>
429 <span class="toc_kind_header">dynamic</span>
430 <ul class="toc_section">
431 <li><a href="#dynamic_android.request.frameCount">android.request.frameCount</a></li>
432 <li><a href="#dynamic_android.request.id">android.request.id</a></li>
433 <li><a href="#dynamic_android.request.metadataMode">android.request.metadataMode</a></li>
434 <li><a href="#dynamic_android.request.outputStreams">android.request.outputStreams</a></li>
435 </ul>
436 </li>
437 </ul> <!-- toc_section -->
438 </li>
439 <li>
440 <span class="toc_section_header"><a href="#section_scaler">scaler</a></span>
441 <ul class="toc_section">
442 <li>
443 <span class="toc_kind_header">controls</span>
444 <ul class="toc_section">
445 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
446 </ul>
447 </li>
448 <li>
449 <span class="toc_kind_header">static</span>
450 <ul class="toc_section">
451 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a></li>
452 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a></li>
453 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a></li>
454 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a></li>
455 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a></li>
456 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a></li>
457 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a></li>
458 <li><a href="#static_android.scaler.availableRawSizes">android.scaler.availableRawSizes</a></li>
459 </ul>
460 </li>
461 <li>
462 <span class="toc_kind_header">dynamic</span>
463 <ul class="toc_section">
464 <li><a href="#dynamic_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
465 </ul>
466 </li>
467 </ul> <!-- toc_section -->
468 </li>
469 <li>
470 <span class="toc_section_header"><a href="#section_sensor">sensor</a></span>
471 <ul class="toc_section">
472 <li>
473 <span class="toc_kind_header">controls</span>
474 <ul class="toc_section">
475 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
476 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
477 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
478 </ul>
479 </li>
480 <li>
481 <span class="toc_kind_header">static</span>
482 <ul class="toc_section">
483
484 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]485 <li><a href="#static_android.sensor.info.sensitivityRange">android.sensor.info.sensitivityRange</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]486 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a></li>
487 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a></li>
488 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a></li>
489 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a></li>
490 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a></li>
491 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a></li>
492
493 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a></li>
494 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a></li>
495 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a></li>
496 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a></li>
497 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a></li>
498 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a></li>
499 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a></li>
500 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a></li>
501 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a></li>
502 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a></li>
503 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a></li>
504 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a></li>
505 <li><a href="#static_android.sensor.referenceIlluminant2">android.sensor.referenceIlluminant2</a></li>
506 </ul>
507 </li>
508 <li>
509 <span class="toc_kind_header">dynamic</span>
510 <ul class="toc_section">
511 <li><a href="#dynamic_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
512 <li><a href="#dynamic_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
513 <li><a href="#dynamic_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
514 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a></li>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]515 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]516 </ul>
517 </li>
518 </ul> <!-- toc_section -->
519 </li>
520 <li>
521 <span class="toc_section_header"><a href="#section_shading">shading</a></span>
522 <ul class="toc_section">
523 <li>
524 <span class="toc_kind_header">controls</span>
525 <ul class="toc_section">
526 <li><a href="#controls_android.shading.mode">android.shading.mode</a></li>
527 <li><a href="#controls_android.shading.strength">android.shading.strength</a></li>
528 </ul>
529 </li>
530 <li>
531 <span class="toc_kind_header">dynamic</span>
532 <ul class="toc_section">
533 <li><a href="#dynamic_android.shading.mode">android.shading.mode</a></li>
534 </ul>
535 </li>
536 </ul> <!-- toc_section -->
537 </li>
538 <li>
539 <span class="toc_section_header"><a href="#section_statistics">statistics</a></span>
540 <ul class="toc_section">
541 <li>
542 <span class="toc_kind_header">controls</span>
543 <ul class="toc_section">
544 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
545 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
546 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]547 <li><a href="#controls_android.statistics.lensShadingMapMode">android.statistics.lensShadingMapMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]548 </ul>
549 </li>
550 <li>
551 <span class="toc_kind_header">static</span>
552 <ul class="toc_section">
553
554 <li><a href="#static_android.statistics.info.availableFaceDetectModes">android.statistics.info.availableFaceDetectModes</a></li>
555 <li><a href="#static_android.statistics.info.histogramBucketCount">android.statistics.info.histogramBucketCount</a></li>
556 <li><a href="#static_android.statistics.info.maxFaceCount">android.statistics.info.maxFaceCount</a></li>
557 <li><a href="#static_android.statistics.info.maxHistogramCount">android.statistics.info.maxHistogramCount</a></li>
558 <li><a href="#static_android.statistics.info.maxSharpnessMapValue">android.statistics.info.maxSharpnessMapValue</a></li>
559 <li><a href="#static_android.statistics.info.sharpnessMapSize">android.statistics.info.sharpnessMapSize</a></li>
560
561 </ul>
562 </li>
563 <li>
564 <span class="toc_kind_header">dynamic</span>
565 <ul class="toc_section">
566 <li><a href="#dynamic_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
567 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a></li>
568 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a></li>
569 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a></li>
570 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a></li>
571 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a></li>
572 <li><a href="#dynamic_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
573 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a></li>
574 <li><a href="#dynamic_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]575 <li><a href="#dynamic_android.statistics.lensShadingMap">android.statistics.lensShadingMap</a></li>
576 <li><a href="#dynamic_android.statistics.predictedColorGains">android.statistics.predictedColorGains</a></li>
577 <li><a href="#dynamic_android.statistics.predictedColorTransform">android.statistics.predictedColorTransform</a></li>
578 <li><a href="#dynamic_android.statistics.sceneFlicker">android.statistics.sceneFlicker</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]579 </ul>
580 </li>
581 </ul> <!-- toc_section -->
582 </li>
583 <li>
584 <span class="toc_section_header"><a href="#section_tonemap">tonemap</a></span>
585 <ul class="toc_section">
586 <li>
587 <span class="toc_kind_header">controls</span>
588 <ul class="toc_section">
589 <li><a href="#controls_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
590 <li><a href="#controls_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
591 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
592 <li><a href="#controls_android.tonemap.mode">android.tonemap.mode</a></li>
593 </ul>
594 </li>
595 <li>
596 <span class="toc_kind_header">static</span>
597 <ul class="toc_section">
598 <li><a href="#static_android.tonemap.maxCurvePoints">android.tonemap.maxCurvePoints</a></li>
599 </ul>
600 </li>
601 <li>
602 <span class="toc_kind_header">dynamic</span>
603 <ul class="toc_section">
604 <li><a href="#dynamic_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
605 <li><a href="#dynamic_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
606 <li><a href="#dynamic_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
607 <li><a href="#dynamic_android.tonemap.mode">android.tonemap.mode</a></li>
608 </ul>
609 </li>
610 </ul> <!-- toc_section -->
611 </li>
612 <li>
613 <span class="toc_section_header"><a href="#section_led">led</a></span>
614 <ul class="toc_section">
615 <li>
616 <span class="toc_kind_header">controls</span>
617 <ul class="toc_section">
618 <li><a href="#controls_android.led.transmit">android.led.transmit</a></li>
619 </ul>
620 </li>
621 <li>
622 <span class="toc_kind_header">dynamic</span>
623 <ul class="toc_section">
624 <li><a href="#dynamic_android.led.transmit">android.led.transmit</a></li>
625 </ul>
626 </li>
627 <li>
628 <span class="toc_kind_header">static</span>
629 <ul class="toc_section">
630 <li><a href="#static_android.led.availableLeds">android.led.availableLeds</a></li>
631 </ul>
632 </li>
633 </ul> <!-- toc_section -->
634 </li>
635 <li>
636 <span class="toc_section_header"><a href="#section_info">info</a></span>
637 <ul class="toc_section">
638 <li>
639 <span class="toc_kind_header">static</span>
640 <ul class="toc_section">
641 <li><a href="#static_android.info.supportedHardwareLevel">android.info.supportedHardwareLevel</a></li>
642 </ul>
643 </li>
644 </ul> <!-- toc_section -->
645 </li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]646 <li>
647 <span class="toc_section_header"><a href="#section_blackLevel">blackLevel</a></span>
648 <ul class="toc_section">
649 <li>
650 <span class="toc_kind_header">controls</span>
651 <ul class="toc_section">
652 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a></li>
653 </ul>
654 </li>
655 <li>
656 <span class="toc_kind_header">dynamic</span>
657 <ul class="toc_section">
658 <li><a href="#dynamic_android.blackLevel.lock">android.blackLevel.lock</a></li>
659 </ul>
660 </li>
661 </ul> <!-- toc_section -->
662 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]663 </ul>
664
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]665
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]666 <h1>Properties</h1>
667 <table class="properties">
668
669 <thead class="thead_dummy">
670 <tr>
671 <th class="th_name">Property Name</th>
672 <th class="th_type">Type</th>
673 <th class="th_description">Description</th>
674 <th class="th_units">Units</th>
675 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]676 <th class="th_tags">Tags</th>
677 </tr>
678 </thead> <!-- so that the first occurrence of thead is not
679 above the first occurrence of tr -->
680<!-- <namespace name="android"> -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]681 <tr><td colspan="6" id="section_colorCorrection" class="section">colorCorrection</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]682
683
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]684 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]685
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]686 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]687 <tr>
688 <th class="th_name">Property Name</th>
689 <th class="th_type">Type</th>
690 <th class="th_description">Description</th>
691 <th class="th_units">Units</th>
692 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]693 <th class="th_tags">Tags</th>
694 </tr>
695 </thead>
696
697 <tbody>
698
699
700
701
702
703
704
705
706
707
708 <tr class="entry" id="controls_android.colorCorrection.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]709 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]710 android.<wbr/>color<wbr/>Correction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]711 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]712 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]713 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]714
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]715 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]716
717 <ul class="entry_type_enum">
718 <li>
719 <span class="entry_type_enum_name">TRANSFORM_MATRIX</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]720 <span class="entry_type_enum_notes"><p>Use the <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a> matrix
721and <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> to do color conversion</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]722 </li>
723 <li>
724 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]725 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
726bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]727 </li>
728 <li>
729 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]730 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
731quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]732 </li>
733 </ul>
734
735 </td> <!-- entry_type -->
736
737 <td class="entry_description">
738 </td>
739
740 <td class="entry_units">
741 </td>
742
743 <td class="entry_range">
744 </td>
745
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]746 <td class="entry_tags">
747 </td>
748
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]749 </tr>
750 <tr class="entries_header">
751 <th class="th_details" colspan="5">Details</th>
752 </tr>
753 <tr class="entry_cont">
754 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]755 <p>When <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> is not OFF,<wbr/> TRANSFORM_<wbr/>MATRIX
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]756should be ignored.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]757 </td>
758 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]759
760
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]761 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
762 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]763
764
765 <tr class="entry" id="controls_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]766 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]767 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]768 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]769 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]770 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]771 <span class="entry_type_container">x</span>
772
773 <span class="entry_type_array">
774 3 x 3
775 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]776 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]777 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]778
779
780 </td> <!-- entry_type -->
781
782 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]783 <p>A color transform matrix to use to transform
784from sensor RGB color space to output linear sRGB color space</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]785 </td>
786
787 <td class="entry_units">
788 </td>
789
790 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]791 <p>Output values are expected to be in the range
792(0,<wbr/>1)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]793 </td>
794
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]795 <td class="entry_tags">
796 </td>
797
798 </tr>
799 <tr class="entries_header">
800 <th class="th_details" colspan="5">Details</th>
801 </tr>
802 <tr class="entry_cont">
803 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]804 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]805<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]806directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]807<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]808<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]809for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]810reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]811 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]812 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]813
814
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]815 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
816 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]817
818
819 <tr class="entry" id="controls_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]820 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]821 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]822 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]823 <td class="entry_type">
824 <span class="entry_type_name">float</span>
825 <span class="entry_type_container">x</span>
826
827 <span class="entry_type_array">
828 4
829 </span>
830 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]831 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]832
833
834 </td> <!-- entry_type -->
835
836 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]837 <p>Gains applying to Bayer color channels for
838white-balance</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]839 </td>
840
841 <td class="entry_units">
842 </td>
843
844 <td class="entry_range">
845 </td>
846
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]847 <td class="entry_tags">
848 </td>
849
850 </tr>
851 <tr class="entries_header">
852 <th class="th_details" colspan="5">Details</th>
853 </tr>
854 <tr class="entry_cont">
855 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]856 <p>The 4-channel white-balance gains are defined in
857the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
858for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
859is the gain for greenpixels on the odd rows.<wbr/> if a HAL
860does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
861it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
862G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]863<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]864<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]865directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]866<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]867<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]868the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]869 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]870 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]871
872
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]873 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
874 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]875
876
877
878 <!-- end of kind -->
879 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]880 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]881
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]882 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]883 <tr>
884 <th class="th_name">Property Name</th>
885 <th class="th_type">Type</th>
886 <th class="th_description">Description</th>
887 <th class="th_units">Units</th>
888 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]889 <th class="th_tags">Tags</th>
890 </tr>
891 </thead>
892
893 <tbody>
894
895
896
897
898
899
900
901
902
903
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]904 <tr class="entry" id="dynamic_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]905 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]906 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]907 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]908 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]909 <span class="entry_type_name">rational</span>
910 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]911
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]912 <span class="entry_type_array">
913 3 x 3
914 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]915 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]916 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]917
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]918
919 </td> <!-- entry_type -->
920
921 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]922 <p>A color transform matrix to use to transform
923from sensor RGB color space to output linear sRGB color space</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]924 </td>
925
926 <td class="entry_units">
927 </td>
928
929 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]930 <p>Output values are expected to be in the range
931(0,<wbr/>1)</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]932 </td>
933
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]934 <td class="entry_tags">
935 </td>
936
937 </tr>
938 <tr class="entries_header">
939 <th class="th_details" colspan="5">Details</th>
940 </tr>
941 <tr class="entry_cont">
942 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]943 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]944<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]945directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]946<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]947<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]948for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]949reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]950 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]951 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]952
953
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]954 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
955 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]956
957
958 <tr class="entry" id="dynamic_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]959 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]960 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]961 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]962 <td class="entry_type">
963 <span class="entry_type_name">float</span>
964 <span class="entry_type_container">x</span>
965
966 <span class="entry_type_array">
967 4
968 </span>
969 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]970 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]971
972
973 </td> <!-- entry_type -->
974
975 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]976 <p>Gains applying to Bayer color channels for
977white-balance</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]978 </td>
979
980 <td class="entry_units">
981 </td>
982
983 <td class="entry_range">
984 </td>
985
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]986 <td class="entry_tags">
987 </td>
988
989 </tr>
990 <tr class="entries_header">
991 <th class="th_details" colspan="5">Details</th>
992 </tr>
993 <tr class="entry_cont">
994 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]995 <p>The 4-channel white-balance gains are defined in
996the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
997for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
998is the gain for greenpixels on the odd rows.<wbr/> if a HAL
999does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
1000it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
1001G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1002<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1003<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1004directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1005<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1006<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1007the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1008 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1009 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1010
1011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1012 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1013 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1014
1015
1016
1017 <!-- end of kind -->
1018 </tbody>
1019
1020 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1021 <tr><td colspan="6" id="section_control" class="section">control</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1022
1023
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1024 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1025
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1026 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1027 <tr>
1028 <th class="th_name">Property Name</th>
1029 <th class="th_type">Type</th>
1030 <th class="th_description">Description</th>
1031 <th class="th_units">Units</th>
1032 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1033 <th class="th_tags">Tags</th>
1034 </tr>
1035 </thead>
1036
1037 <tbody>
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048 <tr class="entry" id="controls_android.control.aeAntibandingMode">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1049 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1050 android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1051 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1052 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1053 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1054
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1055 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1056
1057 <ul class="entry_type_enum">
1058 <li>
1059 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1060 <span class="entry_type_enum_notes"><p>The camera device will not adjust exposure duration to
1061avoid banding problems.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1062 </li>
1063 <li>
1064 <span class="entry_type_enum_name">50HZ</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1065 <span class="entry_type_enum_notes"><p>The camera device will adjust exposure duration to
1066avoid banding problems with 50Hz illumination sources.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1067 </li>
1068 <li>
1069 <span class="entry_type_enum_name">60HZ</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1070 <span class="entry_type_enum_notes"><p>The camera device will adjust exposure duration to
1071avoid banding problems with 60Hz illumination
1072sources.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1073 </li>
1074 <li>
1075 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1076 <span class="entry_type_enum_notes"><p>The camera device will automatically adapt its
1077antibanding routine to the current illumination
1078conditions.<wbr/> This is the default.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1079 </li>
1080 </ul>
1081
1082 </td> <!-- entry_type -->
1083
1084 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1085 <p>The desired setting for the camera device's auto-exposure
1086algorithm's antibanding compensation.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1087 </td>
1088
1089 <td class="entry_units">
1090 </td>
1091
1092 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1093 <p><a href="#static_android.control.aeAvailableAntibandingModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1094 </td>
1095
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1096 <td class="entry_tags">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1097 <ul class="entry_tags">
1098 <li><a href="#tag_BC">BC</a></li>
1099 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1100 </td>
1101
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1102 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1103 <tr class="entries_header">
1104 <th class="th_details" colspan="5">Details</th>
1105 </tr>
1106 <tr class="entry_cont">
1107 <td class="entry_details" colspan="5">
1108 <p>Some kinds of lighting fixtures,<wbr/> such as some fluorescent
1109lights,<wbr/> flicker at the rate of the power supply frequency
1110(60Hz or 50Hz,<wbr/> depending on country).<wbr/> While this is
1111typically not noticeable to a person,<wbr/> it can be visible to
1112a camera device.<wbr/> If a camera sets its exposure time to the
1113wrong value,<wbr/> the flicker may become visible in the
1114viewfinder as flicker or in a final captured image,<wbr/> as a
1115set of variable-brightness bands across the image.<wbr/></p>
1116<p>Therefore,<wbr/> the auto-exposure routines of camera devices
1117include antibanding routines that ensure that the chosen
1118exposure value will not cause such banding.<wbr/> The choice of
1119exposure time depends on the rate of flicker,<wbr/> which the
1120camera device can detect automatically,<wbr/> or the expected
1121rate can be selected by the application using this
1122control.<wbr/></p>
1123<p>A given camera device may not support all of the possible
1124options for the antibanding mode.<wbr/> The
1125<a href="#static_android.control.aeAvailableAntibandingModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes</a> key contains
1126the available modes for a given camera device.<wbr/></p>
1127<p>The default mode is AUTO,<wbr/> which must be supported by all
1128camera devices.<wbr/></p>
1129<p>If manual exposure control is enabled (by setting
1130<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> or <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> to OFF),<wbr/>
1131then this setting has no effect,<wbr/> and the application must
1132ensure it selects exposure times that do not cause banding
1133issues.<wbr/> The <a href="#dynamic_android.statistics.sceneFlicker">android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker</a> key can assist
1134the application in this.<wbr/></p>
1135 </td>
1136 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1137
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1138 <tr class="entries_header">
1139 <th class="th_details" colspan="5">HAL Implementation Details</th>
1140 </tr>
1141 <tr class="entry_cont">
1142 <td class="entry_details" colspan="5">
1143 <p>For all capture request templates,<wbr/> this field must be set
1144to AUTO.<wbr/> AUTO is the only mode that must supported;
1145OFF,<wbr/> 50HZ,<wbr/> 60HZ are all optional.<wbr/></p>
1146<p>If manual exposure control is enabled (by setting
1147<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> or <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> to OFF),<wbr/>
1148then the exposure values provided by the application must not be
1149adjusted for antibanding.<wbr/></p>
1150 </td>
1151 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1152
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1153 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1154 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1155
1156
1157 <tr class="entry" id="controls_android.control.aeExposureCompensation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1158 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1159 android.<wbr/>control.<wbr/>ae<wbr/>Exposure<wbr/>Compensation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1160 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1161 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1162 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1163
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1164 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1165
1166
1167 </td> <!-- entry_type -->
1168
1169 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1170 <p>Adjustment to AE target image
1171brightness</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1172 </td>
1173
1174 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1175 count of positive/<wbr/>negative EV steps
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1176 </td>
1177
1178 <td class="entry_range">
1179 </td>
1180
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1181 <td class="entry_tags">
1182 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1183 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1184 </ul>
1185 </td>
1186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1187 </tr>
1188 <tr class="entries_header">
1189 <th class="th_details" colspan="5">Details</th>
1190 </tr>
1191 <tr class="entry_cont">
1192 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1193 <p>For example,<wbr/> if EV step is 0.<wbr/>333,<wbr/> '6' will mean an
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1194exposure compensation of +2 EV; -3 will mean an exposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1195compensation of -1</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1196 </td>
1197 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1198
1199
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1200 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1201 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1202
1203
1204 <tr class="entry" id="controls_android.control.aeLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1205 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1206 android.<wbr/>control.<wbr/>ae<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1207 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1208 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1209 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1210
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1211 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1212
1213 <ul class="entry_type_enum">
1214 <li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1215 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1216 <span class="entry_type_enum_notes"><p>Autoexposure lock is disabled; the AE algorithm
1217is free to update its parameters.<wbr/></p></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1218 </li>
1219 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1220 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1221 <span class="entry_type_enum_notes"><p>Autoexposure lock is enabled; the AE algorithm
1222must not update the exposure and sensitivity parameters
1223while the lock is active</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1224 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1225 </ul>
1226
1227 </td> <!-- entry_type -->
1228
1229 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1230 <p>Whether AE is currently locked to its latest
1231calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1232 </td>
1233
1234 <td class="entry_units">
1235 </td>
1236
1237 <td class="entry_range">
1238 </td>
1239
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1240 <td class="entry_tags">
1241 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1242 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1243 </ul>
1244 </td>
1245
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1246 </tr>
1247 <tr class="entries_header">
1248 <th class="th_details" colspan="5">Details</th>
1249 </tr>
1250 <tr class="entry_cont">
1251 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1252 <p>Note that even when AE is locked,<wbr/> the flash may be
1253fired if the AE mode is ON_<wbr/>AUTO_<wbr/>FLASH /<wbr/> ON_<wbr/>ALWAYS_<wbr/>FLASH /<wbr/>
1254ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1255 </td>
1256 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1257
1258
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1259 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1260 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1261
1262
1263 <tr class="entry" id="controls_android.control.aeMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1264 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1265 android.<wbr/>control.<wbr/>ae<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1266 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1267 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1268 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1269
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1270 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1271
1272 <ul class="entry_type_enum">
1273 <li>
1274 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1275 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is disabled;
1276the application-selected <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1277<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> and
1278<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are used by the camera
1279device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
1280a flash unit for this camera device.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1281 </li>
1282 <li>
1283 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1284 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is active,<wbr/>
1285with no flash control.<wbr/> The application's values for
1286<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1287<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
1288<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are ignored.<wbr/> The
1289application has control over the various
1290android.<wbr/>flash.<wbr/>* fields.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1291 </li>
1292 <li>
1293 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1294 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
1295the camera's flash unit,<wbr/> firing it in low-light
1296conditions.<wbr/> The flash may be fired during a
1297precapture sequence (triggered by
1298<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and may be fired
1299for captures for which the
1300<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
1301STILL_<wbr/>CAPTURE</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1302 </li>
1303 <li>
1304 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1305 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
1306the camera's flash unit,<wbr/> always firing it for still
1307captures.<wbr/> The flash may be fired during a precapture
1308sequence (triggered by
1309<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and will always
1310be fired for captures for which the
1311<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
1312STILL_<wbr/>CAPTURE</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1313 </li>
1314 <li>
1315 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1316 <span class="entry_type_enum_notes"><p>Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
1317reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
1318a red eye reduction flash will fire during the
1319precapture sequence.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1320 </li>
1321 </ul>
1322
1323 </td> <!-- entry_type -->
1324
1325 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1326 <p>The desired mode for the camera device's
1327auto-exposure routine.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1328 </td>
1329
1330 <td class="entry_units">
1331 </td>
1332
1333 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1334 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1335 </td>
1336
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1337 <td class="entry_tags">
1338 <ul class="entry_tags">
1339 <li><a href="#tag_BC">BC</a></li>
1340 </ul>
1341 </td>
1342
1343 </tr>
1344 <tr class="entries_header">
1345 <th class="th_details" colspan="5">Details</th>
1346 </tr>
1347 <tr class="entry_cont">
1348 <td class="entry_details" colspan="5">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1349 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
1350AUTO.<wbr/></p>
1351<p>When set to any of the ON modes,<wbr/> the camera device's
1352auto-exposure routine is enabled,<wbr/> overriding the
1353application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
1354and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1355<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
1356<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
1357is selected,<wbr/> the camera device's flash unit controls are
1358also overridden.<wbr/></p>
1359<p>The FLASH modes are only available if the camera device
1360has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
1361<p>If flash TORCH mode is desired,<wbr/> this field must be set to
1362ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
1363<p>When set to any of the ON modes,<wbr/> the values chosen by the
1364camera device auto-exposure routine for the overridden
1365fields for a given capture will be available in its
1366CaptureResult.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1367 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1368 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1369
1370
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1371 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1372 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1373
1374
1375 <tr class="entry" id="controls_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1376 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1377 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1378 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1379 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1380 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1381 <span class="entry_type_container">x</span>
1382
1383 <span class="entry_type_array">
1384 5 x area_count
1385 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1386 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1387
1388
1389 </td> <!-- entry_type -->
1390
1391 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1392 <p>List of areas to use for
1393metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1394 </td>
1395
1396 <td class="entry_units">
1397 </td>
1398
1399 <td class="entry_range">
1400 </td>
1401
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1402 <td class="entry_tags">
1403 <ul class="entry_tags">
1404 <li><a href="#tag_BC">BC</a></li>
1405 </ul>
1406 </td>
1407
1408 </tr>
1409 <tr class="entries_header">
1410 <th class="th_details" colspan="5">Details</th>
1411 </tr>
1412 <tr class="entry_cont">
1413 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1414 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1415xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1416specified coordinates.<wbr/></p>
1417<p>The coordinate system is based on the active pixel array,<wbr/>
1418with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1419(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1420<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1421bottom-right pixel in the active pixel array.<wbr/> The weight
1422should be nonnegative.<wbr/></p>
1423<p>If all regions have 0 weight,<wbr/> then no specific metering area
1424needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1425outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1426should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1427used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1428 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1429 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1430
1431
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1432 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1433 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1434
1435
1436 <tr class="entry" id="controls_android.control.aeTargetFpsRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1437 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1438 android.<wbr/>control.<wbr/>ae<wbr/>Target<wbr/>Fps<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1439 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1440 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1441 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1442 <span class="entry_type_container">x</span>
1443
1444 <span class="entry_type_array">
1445 2
1446 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1447 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1448
1449
1450 </td> <!-- entry_type -->
1451
1452 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1453 <p>Range over which fps can be adjusted to
1454maintain exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1455 </td>
1456
1457 <td class="entry_units">
1458 </td>
1459
1460 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1461 <p><a href="#static_android.control.aeAvailableTargetFpsRanges">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1462 </td>
1463
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1464 <td class="entry_tags">
1465 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1466 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1467 </ul>
1468 </td>
1469
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1470 </tr>
1471 <tr class="entries_header">
1472 <th class="th_details" colspan="5">Details</th>
1473 </tr>
1474 <tr class="entry_cont">
1475 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1476 <p>Only constrains AE algorithm,<wbr/> not manual control
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1477of <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1478 </td>
1479 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1480
1481
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1482 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1483 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1484
1485
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1486 <tr class="entry" id="controls_android.control.aePrecaptureTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1487 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1488 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1489 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1490 <td class="entry_type">
1491 <span class="entry_type_name entry_type_name_enum">byte</span>
1492
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1493 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1494
1495 <ul class="entry_type_enum">
1496 <li>
1497 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1498 <span class="entry_type_enum_notes"><p>The trigger is idle.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1499 </li>
1500 <li>
1501 <span class="entry_type_enum_name">START</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]1502 <span class="entry_type_enum_notes"><p>The precapture metering sequence will be started
1503by the camera device.<wbr/> The exact effect of the precapture
1504trigger depends on the current AE mode and state.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1505 </li>
1506 </ul>
1507
1508 </td> <!-- entry_type -->
1509
1510 <td class="entry_description">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]1511 <p>Whether the camera device will trigger a precapture
1512metering sequence when it processes this request.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1513 </td>
1514
1515 <td class="entry_units">
1516 </td>
1517
1518 <td class="entry_range">
1519 </td>
1520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1521 <td class="entry_tags">
1522 <ul class="entry_tags">
1523 <li><a href="#tag_BC">BC</a></li>
1524 </ul>
1525 </td>
1526
1527 </tr>
1528 <tr class="entries_header">
1529 <th class="th_details" colspan="5">Details</th>
1530 </tr>
1531 <tr class="entry_cont">
1532 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1533 <p>This entry is normally set to IDLE,<wbr/> or is not
1534included at all in the request settings.<wbr/> When included and
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]1535set to START,<wbr/> the camera device will trigger the autoexposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1536precapture metering sequence.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1537<p>The effect of AE precapture trigger depends on the current
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]1538AE mode and state; see <a href="#dynamic_android.control.aeState">android.<wbr/>control.<wbr/>ae<wbr/>State</a> for AE precapture
1539state transition details.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1540 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1541 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1542
1543
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1544 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1545 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1546
1547
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1548 <tr class="entry" id="controls_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1549 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1550 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1551 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1552 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1553 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1554
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1555 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1556
1557 <ul class="entry_type_enum">
1558 <li>
1559 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1560 <span class="entry_type_enum_notes"><p>The auto-focus routine does not control the lens;
1561<a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> is controlled by the
1562application</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1563 </li>
1564 <li>
1565 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1566 <span class="entry_type_enum_notes"><p>If lens is not fixed focus.<wbr/></p>
1567<p>Use <a href="#static_android.lens.info.minimumFocusDistance">android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance</a> to determine if lens
1568is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
1569the autofocus trigger action is called.<wbr/> When that trigger
1570is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
1571the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/></p>
1572<p>Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
1573and sets the AF state to INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1574 </li>
1575 <li>
1576 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1577 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the lens does not move unless the
1578autofocus trigger action is called.<wbr/></p>
1579<p>When that trigger is activated,<wbr/> AF must transition to
1580ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
1581NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
1582position to default,<wbr/> and sets the AF state to
1583INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1584 </li>
1585 <li>
1586 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1587 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
1588position continually to attempt to provide a
1589constantly-in-focus image stream.<wbr/></p>
1590<p>The focusing behavior should be suitable for good quality
1591video recording; typically this means slower focus
1592movement and no overshoots.<wbr/> When the AF trigger is not
1593involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
1594and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
1595states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
1596the algorithm should immediately transition into
1597AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1598lens position until a cancel AF trigger is received.<wbr/></p>
1599<p>Once cancel is received,<wbr/> the algorithm should transition
1600back to INACTIVE and resume passive scan.<wbr/> Note that this
1601behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
1602ongoing PASSIVE_<wbr/>SCAN must immediately be
1603canceled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1604 </li>
1605 <li>
1606 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1607 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
1608position continually to attempt to provide a
1609constantly-in-focus image stream.<wbr/></p>
1610<p>The focusing behavior should be suitable for still image
1611capture; typically this means focusing as fast as
1612possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
1613algorithm should start in INACTIVE state,<wbr/> and then
1614transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
1615appropriate as it attempts to maintain focus.<wbr/> When the AF
1616trigger is activated,<wbr/> the algorithm should finish its
1617PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
1618AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1619lens position until a cancel AF trigger is received.<wbr/></p>
1620<p>When the AF cancel trigger is activated,<wbr/> the algorithm
1621should transition back to INACTIVE and then act as if it
1622has just been started.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1623 </li>
1624 <li>
1625 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1626 <span class="entry_type_enum_notes"><p>Extended depth of field (digital focus).<wbr/> AF
1627trigger is ignored,<wbr/> AF state should always be
1628INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1629 </li>
1630 </ul>
1631
1632 </td> <!-- entry_type -->
1633
1634 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1635 <p>Whether AF is currently enabled,<wbr/> and what
1636mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1637 </td>
1638
1639 <td class="entry_units">
1640 </td>
1641
1642 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]1643 <p><a href="#static_android.control.afAvailableModes">android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1644 </td>
1645
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1646 <td class="entry_tags">
1647 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1648 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1649 </ul>
1650 </td>
1651
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1652 </tr>
1653 <tr class="entries_header">
1654 <th class="th_details" colspan="5">Details</th>
1655 </tr>
1656 <tr class="entry_cont">
1657 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1658 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]1659<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
1660the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
1661in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1662 </td>
1663 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1664
1665
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1666 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1667 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1668
1669
1670 <tr class="entry" id="controls_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1671 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1672 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1673 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1674 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1675 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1676 <span class="entry_type_container">x</span>
1677
1678 <span class="entry_type_array">
1679 5 x area_count
1680 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1681 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1682
1683
1684 </td> <!-- entry_type -->
1685
1686 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1687 <p>List of areas to use for focus
1688estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1689 </td>
1690
1691 <td class="entry_units">
1692 </td>
1693
1694 <td class="entry_range">
1695 </td>
1696
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1697 <td class="entry_tags">
1698 <ul class="entry_tags">
1699 <li><a href="#tag_BC">BC</a></li>
1700 </ul>
1701 </td>
1702
1703 </tr>
1704 <tr class="entries_header">
1705 <th class="th_details" colspan="5">Details</th>
1706 </tr>
1707 <tr class="entry_cont">
1708 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1709 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1710xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1711specified coordinates.<wbr/></p>
1712<p>The coordinate system is based on the active pixel array,<wbr/>
1713with (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]1714(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1715<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]1716bottom-right pixel in the active pixel array.<wbr/> The weight
1717should be nonnegative.<wbr/></p>
1718<p>If all regions have 0 weight,<wbr/> then no specific focus area
1719needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1720outside 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]1721should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1722used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1723 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1724 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1725
1726
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1727 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1728 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1729
1730
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1731 <tr class="entry" id="controls_android.control.afTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1732 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1733 android.<wbr/>control.<wbr/>af<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1734 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1735 <td class="entry_type">
1736 <span class="entry_type_name entry_type_name_enum">byte</span>
1737
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1738 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1739
1740 <ul class="entry_type_enum">
1741 <li>
1742 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1743 <span class="entry_type_enum_notes"><p>The trigger is idle.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1744 </li>
1745 <li>
1746 <span class="entry_type_enum_name">START</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]1747 <span class="entry_type_enum_notes"><p>Autofocus will trigger now.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1748 </li>
1749 <li>
1750 <span class="entry_type_enum_name">CANCEL</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]1751 <span class="entry_type_enum_notes"><p>Autofocus will return to its initial
1752state,<wbr/> and cancel any currently active trigger.<wbr/></p></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1753 </li>
1754 </ul>
1755
1756 </td> <!-- entry_type -->
1757
1758 <td class="entry_description">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]1759 <p>Whether the camera device will trigger autofocus for this request.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1760 </td>
1761
1762 <td class="entry_units">
1763 </td>
1764
1765 <td class="entry_range">
1766 </td>
1767
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1768 <td class="entry_tags">
1769 <ul class="entry_tags">
1770 <li><a href="#tag_BC">BC</a></li>
1771 </ul>
1772 </td>
1773
1774 </tr>
1775 <tr class="entries_header">
1776 <th class="th_details" colspan="5">Details</th>
1777 </tr>
1778 <tr class="entry_cont">
1779 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1780 <p>This entry is normally set to IDLE,<wbr/> or is not
1781included at all in the request settings.<wbr/></p>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]1782<p>When included and set to START,<wbr/> the camera device will trigger the
1783autofocus algorithm.<wbr/> If autofocus is disabled,<wbr/> this trigger has no effect.<wbr/></p>
1784<p>When set to CANCEL,<wbr/> the camera device will cancel any active trigger,<wbr/>
1785and return to its initial AF state.<wbr/></p>
1786<p>See <a href="#dynamic_android.control.afState">android.<wbr/>control.<wbr/>af<wbr/>State</a> for what that means for each AF mode.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1787 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1788 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1789
1790
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1791 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1792 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1793
1794
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1795 <tr class="entry" id="controls_android.control.awbLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1796 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1797 android.<wbr/>control.<wbr/>awb<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1798 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1799 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1800 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1801
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1802 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1803
1804 <ul class="entry_type_enum">
1805 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1806 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1807 <span class="entry_type_enum_notes"><p>Auto-whitebalance lock is disabled; the AWB
1808algorithm is free to update its parameters if in AUTO
1809mode.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1810 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1811 <li>
1812 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1813 <span class="entry_type_enum_notes"><p>Auto-whitebalance lock is enabled; the AWB
1814algorithm must not update the exposure and sensitivity
1815parameters while the lock is active</p></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1816 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1817 </ul>
1818
1819 </td> <!-- entry_type -->
1820
1821 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1822 <p>Whether AWB is currently locked to its
1823latest calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1824 </td>
1825
1826 <td class="entry_units">
1827 </td>
1828
1829 <td class="entry_range">
1830 </td>
1831
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1832 <td class="entry_tags">
1833 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1834 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1835 </ul>
1836 </td>
1837
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1838 </tr>
1839 <tr class="entries_header">
1840 <th class="th_details" colspan="5">Details</th>
1841 </tr>
1842 <tr class="entry_cont">
1843 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1844 <p>Note that AWB lock is only meaningful for AUTO
1845mode; in other modes,<wbr/> AWB is already fixed to a specific
1846setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1847 </td>
1848 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1849
1850
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1851 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1852 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1853
1854
1855 <tr class="entry" id="controls_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1856 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1857 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1858 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1859 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1860 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1861
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1862 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1863
1864 <ul class="entry_type_enum">
1865 <li>
1866 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1867 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1868the application-selected color transform matrix
1869(<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>) and gains
1870(<a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>) are used by the camera
1871device for manual white balance control.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1872 </li>
1873 <li>
1874 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1875 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is active;
1876the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
1877and <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> are ignored.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1878 </li>
1879 <li>
1880 <span class="entry_type_enum_name">INCANDESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1881 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1882the camera device uses incandescent light as the assumed scene
1883illumination for white balance.<wbr/> While the exact white balance
1884transforms are up to the camera device,<wbr/> they will approximately
1885match the CIE standard illuminant A.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1886 </li>
1887 <li>
1888 <span class="entry_type_enum_name">FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1889 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1890the camera device uses fluorescent light as the assumed scene
1891illumination for white balance.<wbr/> While the exact white balance
1892transforms are up to the camera device,<wbr/> they will approximately
1893match the CIE standard illuminant F2.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1894 </li>
1895 <li>
1896 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1897 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1898the camera device uses warm fluorescent light as the assumed scene
1899illumination for white balance.<wbr/> While the exact white balance
1900transforms are up to the camera device,<wbr/> they will approximately
1901match the CIE standard illuminant F4.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1902 </li>
1903 <li>
1904 <span class="entry_type_enum_name">DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1905 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1906the camera device uses daylight light as the assumed scene
1907illumination for white balance.<wbr/> While the exact white balance
1908transforms are up to the camera device,<wbr/> they will approximately
1909match the CIE standard illuminant D65.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1910 </li>
1911 <li>
1912 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1913 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1914the camera device uses cloudy daylight light as the assumed scene
1915illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1916 </li>
1917 <li>
1918 <span class="entry_type_enum_name">TWILIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1919 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1920the camera device uses twilight light as the assumed scene
1921illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1922 </li>
1923 <li>
1924 <span class="entry_type_enum_name">SHADE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]1925 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
1926the camera device uses shade light as the assumed scene
1927illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1928 </li>
1929 </ul>
1930
1931 </td> <!-- entry_type -->
1932
1933 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1934 <p>Whether AWB is currently setting the color
1935transform fields,<wbr/> and what its illumination target
1936is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1937 </td>
1938
1939 <td class="entry_units">
1940 </td>
1941
1942 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]1943 <p><a href="#static_android.control.awbAvailableModes">android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1944 </td>
1945
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1946 <td class="entry_tags">
1947 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1948 <li><a href="#tag_BC">BC</a></li>
1949 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1950 </ul>
1951 </td>
1952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1953 </tr>
1954 <tr class="entries_header">
1955 <th class="th_details" colspan="5">Details</th>
1956 </tr>
1957 <tr class="entry_cont">
1958 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]1959 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
1960<p>When set to the ON mode,<wbr/> the camera device's auto white balance
1961routine is enabled,<wbr/> overriding the application's selected
1962<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> and
1963<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
1964<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
1965routine is disabled.<wbr/> The applicantion manually controls the white
1966balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
1967and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
1968<p>When set to any other modes,<wbr/> the camera device's auto white balance
1969routine is disabled.<wbr/> The camera device uses each particular illumination
1970target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1971 </td>
1972 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1973
1974
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1975 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1976 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1977
1978
1979 <tr class="entry" id="controls_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1980 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1981 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1982 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1983 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1984 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1985 <span class="entry_type_container">x</span>
1986
1987 <span class="entry_type_array">
1988 5 x area_count
1989 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1990 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1991
1992
1993 </td> <!-- entry_type -->
1994
1995 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1996 <p>List of areas to use for illuminant
1997estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1998 </td>
1999
2000 <td class="entry_units">
2001 </td>
2002
2003 <td class="entry_range">
2004 </td>
2005
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2006 <td class="entry_tags">
2007 <ul class="entry_tags">
2008 <li><a href="#tag_BC">BC</a></li>
2009 </ul>
2010 </td>
2011
2012 </tr>
2013 <tr class="entries_header">
2014 <th class="th_details" colspan="5">Details</th>
2015 </tr>
2016 <tr class="entry_cont">
2017 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2018 <p>Only used in AUTO mode.<wbr/></p>
2019<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
2020xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
2021specified coordinates.<wbr/></p>
2022<p>The coordinate system is based on the active pixel array,<wbr/>
2023with (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]2024(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
2025<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]2026bottom-right pixel in the active pixel array.<wbr/> The weight
2027should be nonnegative.<wbr/></p>
2028<p>If all regions have 0 weight,<wbr/> then no specific metering area
2029needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2030outside 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]2031should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2032used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2033 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2034 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2035
2036
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2037 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2038 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2039
2040
2041 <tr class="entry" id="controls_android.control.captureIntent">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2042 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2043 android.<wbr/>control.<wbr/>capture<wbr/>Intent
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2044 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2045 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2046 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2047
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2048 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2049
2050 <ul class="entry_type_enum">
2051 <li>
2052 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2053 <span class="entry_type_enum_notes"><p>This request doesn't fall into the other
2054categories.<wbr/> Default to preview-like
2055behavior.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2056 </li>
2057 <li>
2058 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2059 <span class="entry_type_enum_notes"><p>This request is for a preview-like usecase.<wbr/> The
2060precapture trigger may be used to start off a metering
2061w/<wbr/>flash sequence</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2062 </li>
2063 <li>
2064 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2065 <span class="entry_type_enum_notes"><p>This request is for a still capture-type
2066usecase.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2067 </li>
2068 <li>
2069 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2070 <span class="entry_type_enum_notes"><p>This request is for a video recording
2071usecase.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2072 </li>
2073 <li>
2074 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2075 <span class="entry_type_enum_notes"><p>This request is for a video snapshot (still
2076image while recording video) usecase</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2077 </li>
2078 <li>
2079 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2080 <span class="entry_type_enum_notes"><p>This request is for a ZSL usecase; the
2081application will stream full-resolution images and
2082reprocess one or several later for a final
2083capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2084 </li>
2085 </ul>
2086
2087 </td> <!-- entry_type -->
2088
2089 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2090 <p>Information to 3A routines about the purpose
2091of this capture,<wbr/> to help decide optimal 3A
2092strategy</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2093 </td>
2094
2095 <td class="entry_units">
2096 </td>
2097
2098 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2099 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2100 </td>
2101
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2102 <td class="entry_tags">
2103 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2104 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2105 </ul>
2106 </td>
2107
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2108 </tr>
2109 <tr class="entries_header">
2110 <th class="th_details" colspan="5">Details</th>
2111 </tr>
2112 <tr class="entry_cont">
2113 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2114 <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]2115 </td>
2116 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2117
2118
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2119 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2120 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2121
2122
2123 <tr class="entry" id="controls_android.control.effectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2124 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2125 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2126 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2127 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2128 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2129
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2130 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2131
2132 <ul class="entry_type_enum">
2133 <li>
2134 <span class="entry_type_enum_name">OFF</span>
2135 </li>
2136 <li>
2137 <span class="entry_type_enum_name">MONO</span>
2138 <span class="entry_type_enum_optional">optional</span>
2139 </li>
2140 <li>
2141 <span class="entry_type_enum_name">NEGATIVE</span>
2142 <span class="entry_type_enum_optional">optional</span>
2143 </li>
2144 <li>
2145 <span class="entry_type_enum_name">SOLARIZE</span>
2146 <span class="entry_type_enum_optional">optional</span>
2147 </li>
2148 <li>
2149 <span class="entry_type_enum_name">SEPIA</span>
2150 <span class="entry_type_enum_optional">optional</span>
2151 </li>
2152 <li>
2153 <span class="entry_type_enum_name">POSTERIZE</span>
2154 <span class="entry_type_enum_optional">optional</span>
2155 </li>
2156 <li>
2157 <span class="entry_type_enum_name">WHITEBOARD</span>
2158 <span class="entry_type_enum_optional">optional</span>
2159 </li>
2160 <li>
2161 <span class="entry_type_enum_name">BLACKBOARD</span>
2162 <span class="entry_type_enum_optional">optional</span>
2163 </li>
2164 <li>
2165 <span class="entry_type_enum_name">AQUA</span>
2166 <span class="entry_type_enum_optional">optional</span>
2167 </li>
2168 </ul>
2169
2170 </td> <!-- entry_type -->
2171
2172 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2173 <p>Whether any special color effect is in use.<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2174Only 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]2175 </td>
2176
2177 <td class="entry_units">
2178 </td>
2179
2180 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2181 <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]2182 </td>
2183
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2184 <td class="entry_tags">
2185 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2186 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2187 </ul>
2188 </td>
2189
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2190 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2191
2192
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2193 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2194 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2195
2196
2197 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2198 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2199 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2200 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2201 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2202 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2203
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2204 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2205
2206 <ul class="entry_type_enum">
2207 <li>
2208 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2209 <span class="entry_type_enum_notes"><p>Full application control of pipeline.<wbr/> All 3A
2210routines are disabled,<wbr/> no other settings in
2211android.<wbr/>control.<wbr/>* have any effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2212 </li>
2213 <li>
2214 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2215 <span class="entry_type_enum_notes"><p>Use settings for each individual 3A routine.<wbr/>
2216Manual control of capture parameters is disabled.<wbr/> All
2217controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2218effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2219 </li>
2220 <li>
2221 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2222 <span class="entry_type_enum_notes"><p>Use specific scene mode.<wbr/> Enabling this disables
2223control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
2224controls; the HAL must ignore those settings while
2225USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2226scene mode).<wbr/> Other control entries are still active.<wbr/>
2227This setting can only be used if availableSceneModes !=
2228UNSUPPORTED</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2229 </li>
2230 </ul>
2231
2232 </td> <!-- entry_type -->
2233
2234 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2235 <p>Overall mode of 3A control
2236routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2237 </td>
2238
2239 <td class="entry_units">
2240 </td>
2241
2242 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2243 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2244 </td>
2245
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2246 <td class="entry_tags">
2247 <ul class="entry_tags">
2248 <li><a href="#tag_BC">BC</a></li>
2249 </ul>
2250 </td>
2251
2252 </tr>
2253 <tr class="entries_header">
2254 <th class="th_details" colspan="5">Details</th>
2255 </tr>
2256 <tr class="entry_cont">
2257 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2258 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2259by the camera device is disabled.<wbr/> The application must set the fields for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2260capture parameters itself.<wbr/></p>
2261<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2262android.<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]2263<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2264android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the camera device implements
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2265one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2266as it wishes.<wbr/> The camera device scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2267<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]2268 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2269 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2270
2271
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2272 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2273 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2274
2275
2276 <tr class="entry" id="controls_android.control.sceneMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2277 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2278 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2279 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2280 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2281 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2282
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2283 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2284
2285 <ul class="entry_type_enum">
2286 <li>
2287 <span class="entry_type_enum_name">UNSUPPORTED</span>
2288 <span class="entry_type_enum_value">0</span>
2289 </li>
2290 <li>
2291 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2292 <span class="entry_type_enum_notes"><p>if face detection support exists Use face
2293detection data to drive 3A routines.<wbr/> If face detection
2294statistics are disabled,<wbr/> should still operate correctly
2295(but not return face detection statistics to the
2296framework).<wbr/></p>
2297<p>Unlike the other scene modes,<wbr/> aeMode,<wbr/> awbMode,<wbr/> and afMode
2298remain active when FACE_<wbr/>PRIORITY is set.<wbr/> This is due to
2299compatibility concerns with the old camera
2300API</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2301 </li>
2302 <li>
2303 <span class="entry_type_enum_name">ACTION</span>
2304 <span class="entry_type_enum_optional">optional</span>
2305 </li>
2306 <li>
2307 <span class="entry_type_enum_name">PORTRAIT</span>
2308 <span class="entry_type_enum_optional">optional</span>
2309 </li>
2310 <li>
2311 <span class="entry_type_enum_name">LANDSCAPE</span>
2312 <span class="entry_type_enum_optional">optional</span>
2313 </li>
2314 <li>
2315 <span class="entry_type_enum_name">NIGHT</span>
2316 <span class="entry_type_enum_optional">optional</span>
2317 </li>
2318 <li>
2319 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2320 <span class="entry_type_enum_optional">optional</span>
2321 </li>
2322 <li>
2323 <span class="entry_type_enum_name">THEATRE</span>
2324 <span class="entry_type_enum_optional">optional</span>
2325 </li>
2326 <li>
2327 <span class="entry_type_enum_name">BEACH</span>
2328 <span class="entry_type_enum_optional">optional</span>
2329 </li>
2330 <li>
2331 <span class="entry_type_enum_name">SNOW</span>
2332 <span class="entry_type_enum_optional">optional</span>
2333 </li>
2334 <li>
2335 <span class="entry_type_enum_name">SUNSET</span>
2336 <span class="entry_type_enum_optional">optional</span>
2337 </li>
2338 <li>
2339 <span class="entry_type_enum_name">STEADYPHOTO</span>
2340 <span class="entry_type_enum_optional">optional</span>
2341 </li>
2342 <li>
2343 <span class="entry_type_enum_name">FIREWORKS</span>
2344 <span class="entry_type_enum_optional">optional</span>
2345 </li>
2346 <li>
2347 <span class="entry_type_enum_name">SPORTS</span>
2348 <span class="entry_type_enum_optional">optional</span>
2349 </li>
2350 <li>
2351 <span class="entry_type_enum_name">PARTY</span>
2352 <span class="entry_type_enum_optional">optional</span>
2353 </li>
2354 <li>
2355 <span class="entry_type_enum_name">CANDLELIGHT</span>
2356 <span class="entry_type_enum_optional">optional</span>
2357 </li>
2358 <li>
2359 <span class="entry_type_enum_name">BARCODE</span>
2360 <span class="entry_type_enum_optional">optional</span>
2361 </li>
2362 </ul>
2363
2364 </td> <!-- entry_type -->
2365
2366 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2367 <p>Which scene mode is active when
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2368<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]2369 </td>
2370
2371 <td class="entry_units">
2372 </td>
2373
2374 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2375 <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]2376 </td>
2377
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2378 <td class="entry_tags">
2379 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2380 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2381 </ul>
2382 </td>
2383
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2384 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2385
2386
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2387 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2388 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2389
2390
2391 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2392 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2393 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2394 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2395 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2396 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2397
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2398 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2399
2400 <ul class="entry_type_enum">
2401 <li>
2402 <span class="entry_type_enum_name">OFF</span>
2403 </li>
2404 <li>
2405 <span class="entry_type_enum_name">ON</span>
2406 </li>
2407 </ul>
2408
2409 </td> <!-- entry_type -->
2410
2411 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2412 <p>Whether video stabilization is
2413active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2414 </td>
2415
2416 <td class="entry_units">
2417 </td>
2418
2419 <td class="entry_range">
2420 </td>
2421
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2422 <td class="entry_tags">
2423 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2424 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2425 </ul>
2426 </td>
2427
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2428 </tr>
2429 <tr class="entries_header">
2430 <th class="th_details" colspan="5">Details</th>
2431 </tr>
2432 <tr class="entry_cont">
2433 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2434 <p>If enabled,<wbr/> video stabilization can modify the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2435<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]2436stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2437 </td>
2438 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2439
2440
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2441 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2442 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2443
2444
2445
2446 <!-- end of kind -->
2447 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2448 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2449
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2450 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2451 <tr>
2452 <th class="th_name">Property Name</th>
2453 <th class="th_type">Type</th>
2454 <th class="th_description">Description</th>
2455 <th class="th_units">Units</th>
2456 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2457 <th class="th_tags">Tags</th>
2458 </tr>
2459 </thead>
2460
2461 <tbody>
2462
2463
2464
2465
2466
2467
2468
2469
2470
2471
2472 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2473 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2474 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2475 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2476 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2477 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2478 <span class="entry_type_container">x</span>
2479
2480 <span class="entry_type_array">
2481 n
2482 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2483 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2484 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2485
2486
2487 </td> <!-- entry_type -->
2488
2489 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2490 <p>The set of auto-exposure antibanding modes that are
2491supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2492 </td>
2493
2494 <td class="entry_units">
2495 </td>
2496
2497 <td class="entry_range">
2498 </td>
2499
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2500 <td class="entry_tags">
2501 </td>
2502
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2503 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2504 <tr class="entries_header">
2505 <th class="th_details" colspan="5">Details</th>
2506 </tr>
2507 <tr class="entry_cont">
2508 <td class="entry_details" colspan="5">
2509 <p>Not all of the auto-exposure anti-banding modes may be
2510supported by a given camera device.<wbr/> This field lists the
2511valid anti-banding modes that the application may request
2512for this camera device; they must include AUTO.<wbr/></p>
2513 </td>
2514 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2515
2516
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2517 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2518 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2519
2520
2521 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2522 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2523 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2524 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2525 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2526 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2527 <span class="entry_type_container">x</span>
2528
2529 <span class="entry_type_array">
2530 n
2531 </span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2532 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2533 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2534
2535
2536 </td> <!-- entry_type -->
2537
2538 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2539 <p>The set of auto-exposure modes that are supported by this
2540camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2541 </td>
2542
2543 <td class="entry_units">
2544 </td>
2545
2546 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2547 </td>
2548
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2549 <td class="entry_tags">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2550 <ul class="entry_tags">
2551 <li><a href="#tag_BC">BC</a></li>
2552 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2553 </td>
2554
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2555 </tr>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2556 <tr class="entries_header">
2557 <th class="th_details" colspan="5">Details</th>
2558 </tr>
2559 <tr class="entry_cont">
2560 <td class="entry_details" colspan="5">
2561 <p>Not all the auto-exposure modes may be supported by a
2562given camera device,<wbr/> especially if no flash unit is
2563available.<wbr/> This entry lists the valid modes for
2564<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> for this camera device.<wbr/></p>
2565<p>All camera devices support ON,<wbr/> and all camera devices with
2566flash units support ON_<wbr/>AUTO_<wbr/>FLASH and
2567ON_<wbr/>ALWAYS_<wbr/>FLASH.<wbr/></p>
2568<p>Full-capability camera devices always support OFF mode,<wbr/>
2569which enables application control of camera exposure time,<wbr/>
2570sensitivity,<wbr/> and frame duration.<wbr/></p>
2571 </td>
2572 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2573
2574
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2575 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2576 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2577
2578
2579 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2580 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2581 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2582 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2583 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2584 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2585 <span class="entry_type_container">x</span>
2586
2587 <span class="entry_type_array">
2588 2 x n
2589 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2590 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2591 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2592
2593
2594 </td> <!-- entry_type -->
2595
2596 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2597 <p>List of frame rate ranges supported by the
2598AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2599 </td>
2600
2601 <td class="entry_units">
2602 </td>
2603
2604 <td class="entry_range">
2605 </td>
2606
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2607 <td class="entry_tags">
2608 </td>
2609
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2610 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2611
2612
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2613 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2614 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2615
2616
2617 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2618 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2619 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2620 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2621 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2622 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2623 <span class="entry_type_container">x</span>
2624
2625 <span class="entry_type_array">
2626 2
2627 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2628 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2629
2630
2631 </td> <!-- entry_type -->
2632
2633 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2634 <p>Maximum and minimum exposure compensation
2635setting,<wbr/> in counts of
2636android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2637 </td>
2638
2639 <td class="entry_units">
2640 </td>
2641
2642 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2643 <p>At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2644size)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2645 </td>
2646
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2647 <td class="entry_tags">
2648 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2649 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2650 </ul>
2651 </td>
2652
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2653 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2654
2655
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2656 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2657 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2658
2659
2660 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2661 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2662 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2663 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2664 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2665 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2666
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2667 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2668
2669
2670 </td> <!-- entry_type -->
2671
2672 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2673 <p>Smallest step by which exposure compensation
2674can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2675 </td>
2676
2677 <td class="entry_units">
2678 </td>
2679
2680 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2681 <p>&lt;= 1/<wbr/>2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2682 </td>
2683
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2684 <td class="entry_tags">
2685 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2686 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2687 </ul>
2688 </td>
2689
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2690 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2691
2692
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2693 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2694 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2695
2696
2697 <tr class="entry" id="static_android.control.afAvailableModes">
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2698 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2699 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2700 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2701 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2702 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2703 <span class="entry_type_container">x</span>
2704
2705 <span class="entry_type_array">
2706 n
2707 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2708 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2709 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2710
2711
2712 </td> <!-- entry_type -->
2713
2714 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2715 <p>List of AF modes that can be
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2716selected with <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2717 </td>
2718
2719 <td class="entry_units">
2720 </td>
2721
2722 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2723 </td>
2724
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2725 <td class="entry_tags">
2726 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2727 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2728 </ul>
2729 </td>
2730
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2731 </tr>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2732 <tr class="entries_header">
2733 <th class="th_details" colspan="5">Details</th>
2734 </tr>
2735 <tr class="entry_cont">
2736 <td class="entry_details" colspan="5">
2737 <p>Not all the auto-focus modes may be supported by a
2738given camera device.<wbr/> This entry lists the valid modes for
2739<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> for this camera device.<wbr/></p>
2740<p>All camera devices will support OFF mode,<wbr/> and all camera devices with
2741adjustable focuser units (<code><a href="#static_android.lens.info.minimumFocusDistance">android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance</a> &gt; 0</code>)
2742will support AUTO mode.<wbr/></p>
2743 </td>
2744 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2745
2746
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2747 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2748 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2749
2750
2751 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2752 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2753 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2754 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2755 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2756 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2757 <span class="entry_type_container">x</span>
2758
2759 <span class="entry_type_array">
2760 n
2761 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2762 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2763 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2764
2765
2766 </td> <!-- entry_type -->
2767
2768 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2769 <p>what subset of the full color effect enum
2770list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2771 </td>
2772
2773 <td class="entry_units">
2774 </td>
2775
2776 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2777 <p>OFF must be listed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2778 </td>
2779
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2780 <td class="entry_tags">
2781 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2782 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2783 </ul>
2784 </td>
2785
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2786 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2787
2788
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2789 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2790 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2791
2792
2793 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2794 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2795 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2796 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2797 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2798 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2799 <span class="entry_type_container">x</span>
2800
2801 <span class="entry_type_array">
2802 n
2803 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2804 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2805 <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]2806
2807
2808 </td> <!-- entry_type -->
2809
2810 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2811 <p>what subset of the scene mode enum list is
2812supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2813 </td>
2814
2815 <td class="entry_units">
2816 </td>
2817
2818 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2819 <p>SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2820detection is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2821 </td>
2822
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2823 <td class="entry_tags">
2824 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2825 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2826 </ul>
2827 </td>
2828
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2829 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2830
2831
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2832 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2833 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2834
2835
2836 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2837 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2838 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2839 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2840 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2841 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2842 <span class="entry_type_container">x</span>
2843
2844 <span class="entry_type_array">
2845 n
2846 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2847 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2848 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2849
2850
2851 </td> <!-- entry_type -->
2852
2853 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2854 <p>List of video stabilization modes that can
2855be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2856 </td>
2857
2858 <td class="entry_units">
2859 </td>
2860
2861 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2862 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2863 </td>
2864
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2865 <td class="entry_tags">
2866 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2867 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2868 </ul>
2869 </td>
2870
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2871 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2872
2873
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2874 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2875 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2876
2877
2878 <tr class="entry" id="static_android.control.awbAvailableModes">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2879 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2880 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2881 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2882 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2883 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2884 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2885
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2886 <span class="entry_type_array">
2887 n
2888 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2889 <span class="entry_type_visibility"> [public]</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2890 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2891
2892
2893 </td> <!-- entry_type -->
2894
2895 <td class="entry_description">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2896 <p>The set of auto-white-balance modes (<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>)
2897that are supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2898 </td>
2899
2900 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2901 </td>
2902
2903 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2904 </td>
2905
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2906 <td class="entry_tags">
2907 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2908 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2909 </ul>
2910 </td>
2911
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2912 </tr>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2913 <tr class="entries_header">
2914 <th class="th_details" colspan="5">Details</th>
2915 </tr>
2916 <tr class="entry_cont">
2917 <td class="entry_details" colspan="5">
2918 <p>Not all the auto-white-balance modes may be supported by a
2919given camera device.<wbr/> This entry lists the valid modes for
2920<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> for this camera device.<wbr/></p>
2921<p>All camera devices will support ON mode.<wbr/></p>
2922<p>Full-capability camera devices will always support OFF mode,<wbr/>
2923which enables application control of white balance,<wbr/> by using
2924<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a> and <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>(<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> must be set to TRANSFORM_<wbr/>MATRIX).<wbr/></p>
2925 </td>
2926 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2927
2928
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2929 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2930 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2931
2932
2933 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2934 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2935 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2936 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2937 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2938 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2939
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2940 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2941
2942
2943 </td> <!-- entry_type -->
2944
2945 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2946 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
2947regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2948 </td>
2949
2950 <td class="entry_units">
2951 </td>
2952
2953 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]2954 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2955 </td>
2956
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2957 <td class="entry_tags">
2958 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2959 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2960 </ul>
2961 </td>
2962
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2963 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2964
2965
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2966 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2967 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2968
2969
2970 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2971 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2972 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2973 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2974 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2975 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2976 <span class="entry_type_container">x</span>
2977
2978 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2979 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2980 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2981 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2982
2983
2984 </td> <!-- entry_type -->
2985
2986 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2987 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
2988each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2989 </td>
2990
2991 <td class="entry_units">
2992 </td>
2993
2994 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2995 <p>For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
2996awbMode,<wbr/> and afMode that the HAL wants to use for that
2997scene mode.<wbr/></p>
2998<p>For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
2999order of increasing index</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3000 </td>
3001
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3002 <td class="entry_tags">
3003 <ul class="entry_tags">
3004 <li><a href="#tag_BC">BC</a></li>
3005 </ul>
3006 </td>
3007
3008 </tr>
3009 <tr class="entries_header">
3010 <th class="th_details" colspan="5">Details</th>
3011 </tr>
3012 <tr class="entry_cont">
3013 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3014 <p>When a scene mode is enabled,<wbr/> the HAL is expected
3015to override aeMode,<wbr/> awbMode,<wbr/> and afMode with its
3016preferred settings for that scene mode.<wbr/></p>
3017<p>To simplify communication with old camera API applications,<wbr/>
3018the service wants this override list in the static metadata.<wbr/>
3019The order of this list matches that of availableSceneModes,<wbr/>
3020with 3 entires for each scene mode.<wbr/> The overrides listed
3021for SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
3022mode,<wbr/> the application-set aeMode,<wbr/> awbMode,<wbr/> and afMode are
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3023used 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]3024AUTO.<wbr/></p>
3025<p>It is recommended that for FACE_<wbr/>PRIORITY,<wbr/> the overrides
3026should be set to 0.<wbr/> As an example,<wbr/> if availableSceneModes is
3027{ FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT },<wbr/> then the service expects
3028this field to have 9 entries; for example { 0 ,<wbr/> 0,<wbr/> 0,<wbr/>
3029ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
3030INCANDESCENT,<wbr/> AUTO }</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3031 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3032 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3033
3034
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3035 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3036 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3037
3038
3039
3040 <!-- end of kind -->
3041 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3042 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3043
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3044 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3045 <tr>
3046 <th class="th_name">Property Name</th>
3047 <th class="th_type">Type</th>
3048 <th class="th_description">Description</th>
3049 <th class="th_units">Units</th>
3050 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3051 <th class="th_tags">Tags</th>
3052 </tr>
3053 </thead>
3054
3055 <tbody>
3056
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3067 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3068 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3069 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3070 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3071 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3072
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3073 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3074
3075
3076 </td> <!-- entry_type -->
3077
3078 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3079 <p>The ID sent with the latest
3080CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3081 </td>
3082
3083 <td class="entry_units">
3084 </td>
3085
3086 <td class="entry_range">
3087 </td>
3088
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3089 <td class="entry_tags">
3090 </td>
3091
3092 </tr>
3093 <tr class="entries_header">
3094 <th class="th_details" colspan="5">Details</th>
3095 </tr>
3096 <tr class="entry_cont">
3097 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3098 <p>Must be 0 if no
3099CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
3100by HAL.<wbr/> Always updated even if AE algorithm ignores the
3101trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3102 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3103 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3104
3105
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3106 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3107 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3108
3109
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3110 <tr class="entry" id="dynamic_android.control.aeMode">
3111 <td class="entry_name" rowspan="3">
3112 android.<wbr/>control.<wbr/>ae<wbr/>Mode
3113 </td>
3114 <td class="entry_type">
3115 <span class="entry_type_name entry_type_name_enum">byte</span>
3116
3117 <span class="entry_type_visibility"> [public]</span>
3118
3119 <ul class="entry_type_enum">
3120 <li>
3121 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3122 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is disabled;
3123the application-selected <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3124<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> and
3125<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are used by the camera
3126device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
3127a flash unit for this camera device.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3128 </li>
3129 <li>
3130 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3131 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is active,<wbr/>
3132with no flash control.<wbr/> The application's values for
3133<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3134<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3135<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are ignored.<wbr/> The
3136application has control over the various
3137android.<wbr/>flash.<wbr/>* fields.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3138 </li>
3139 <li>
3140 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3141 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
3142the camera's flash unit,<wbr/> firing it in low-light
3143conditions.<wbr/> The flash may be fired during a
3144precapture sequence (triggered by
3145<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and may be fired
3146for captures for which the
3147<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
3148STILL_<wbr/>CAPTURE</p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3149 </li>
3150 <li>
3151 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3152 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
3153the camera's flash unit,<wbr/> always firing it for still
3154captures.<wbr/> The flash may be fired during a precapture
3155sequence (triggered by
3156<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and will always
3157be fired for captures for which the
3158<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
3159STILL_<wbr/>CAPTURE</p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3160 </li>
3161 <li>
3162 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3163 <span class="entry_type_enum_notes"><p>Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
3164reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
3165a red eye reduction flash will fire during the
3166precapture sequence.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3167 </li>
3168 </ul>
3169
3170 </td> <!-- entry_type -->
3171
3172 <td class="entry_description">
3173 <p>The desired mode for the camera device's
3174auto-exposure routine.<wbr/></p>
3175 </td>
3176
3177 <td class="entry_units">
3178 </td>
3179
3180 <td class="entry_range">
3181 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
3182 </td>
3183
3184 <td class="entry_tags">
3185 <ul class="entry_tags">
3186 <li><a href="#tag_BC">BC</a></li>
3187 </ul>
3188 </td>
3189
3190 </tr>
3191 <tr class="entries_header">
3192 <th class="th_details" colspan="5">Details</th>
3193 </tr>
3194 <tr class="entry_cont">
3195 <td class="entry_details" colspan="5">
3196 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
3197AUTO.<wbr/></p>
3198<p>When set to any of the ON modes,<wbr/> the camera device's
3199auto-exposure routine is enabled,<wbr/> overriding the
3200application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
3201and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3202<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3203<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
3204is selected,<wbr/> the camera device's flash unit controls are
3205also overridden.<wbr/></p>
3206<p>The FLASH modes are only available if the camera device
3207has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
3208<p>If flash TORCH mode is desired,<wbr/> this field must be set to
3209ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
3210<p>When set to any of the ON modes,<wbr/> the values chosen by the
3211camera device auto-exposure routine for the overridden
3212fields for a given capture will be available in its
3213CaptureResult.<wbr/></p>
3214 </td>
3215 </tr>
3216
3217
3218 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3219 <!-- end of entry -->
3220
3221
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3222 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3223 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3224 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3225 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3226 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3227 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3228 <span class="entry_type_container">x</span>
3229
3230 <span class="entry_type_array">
3231 5 x area_count
3232 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3233 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3234
3235
3236 </td> <!-- entry_type -->
3237
3238 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3239 <p>List of areas to use for
3240metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3241 </td>
3242
3243 <td class="entry_units">
3244 </td>
3245
3246 <td class="entry_range">
3247 </td>
3248
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3249 <td class="entry_tags">
3250 <ul class="entry_tags">
3251 <li><a href="#tag_BC">BC</a></li>
3252 </ul>
3253 </td>
3254
3255 </tr>
3256 <tr class="entries_header">
3257 <th class="th_details" colspan="5">Details</th>
3258 </tr>
3259 <tr class="entry_cont">
3260 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3261 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3262xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3263specified coordinates.<wbr/></p>
3264<p>The coordinate system is based on the active pixel array,<wbr/>
3265with (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]3266(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3267<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]3268bottom-right pixel in the active pixel array.<wbr/> The weight
3269should be nonnegative.<wbr/></p>
3270<p>If all regions have 0 weight,<wbr/> then no specific metering area
3271needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3272outside 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]3273should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3274used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3275 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3276 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3277
3278
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3279 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3280 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3281
3282
3283 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3284 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3285 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3286 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3287 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3288 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3289
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3290 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3291
3292 <ul class="entry_type_enum">
3293 <li>
3294 <span class="entry_type_enum_name">INACTIVE</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]3295 <span class="entry_type_enum_notes"><p>AE is off or recently reset.<wbr/> When a camera device is opened,<wbr/> it starts in
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3296this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3297 </li>
3298 <li>
3299 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3300 <span class="entry_type_enum_notes"><p>AE doesn't yet have a good set of control values
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]3301for the current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3302 </li>
3303 <li>
3304 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3305 <span class="entry_type_enum_notes"><p>AE has a good set of control values for the
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]3306current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3307 </li>
3308 <li>
3309 <span class="entry_type_enum_name">LOCKED</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]3310 <span class="entry_type_enum_notes"><p>AE has been locked.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3311 </li>
3312 <li>
3313 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3314 <span class="entry_type_enum_notes"><p>AE has a good set of control values,<wbr/> but flash
3315needs to be fired for good quality still
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]3316capture.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3317 </li>
3318 <li>
3319 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3320 <span class="entry_type_enum_notes"><p>AE has been asked to do a precapture sequence
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]3321(through the <a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a> START),<wbr/>
3322and is currently executing it.<wbr/> Once PRECAPTURE
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3323completes,<wbr/> AE will transition to CONVERGED or
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]3324FLASH_<wbr/>REQUIRED as appropriate.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3325 </li>
3326 </ul>
3327
3328 </td> <!-- entry_type -->
3329
3330 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3331 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3332 </td>
3333
3334 <td class="entry_units">
3335 </td>
3336
3337 <td class="entry_range">
3338 </td>
3339
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3340 <td class="entry_tags">
3341 </td>
3342
3343 </tr>
3344 <tr class="entries_header">
3345 <th class="th_details" colspan="5">Details</th>
3346 </tr>
3347 <tr class="entry_cont">
3348 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]3349 <p>Switching between or enabling AE modes (<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>) always
3350resets the AE state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
3351or <a href="#controls_android.control.sceneMode">android.<wbr/>control.<wbr/>scene<wbr/>Mode</a> if <code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> == USE_<wbr/>SCENE_<wbr/>MODE</code> resets all
3352the algorithm states to INACTIVE.<wbr/></p>
3353<p>The camera device can do several state transitions between two results,<wbr/> if it is
3354allowed by the state transition table.<wbr/> For example: INACTIVE may never actually be
3355seen in a result.<wbr/></p>
3356<p>The state in the result is the state for this image (in sync with this image): if
3357AE state becomes CONVERGED,<wbr/> then the image data associated with this result should
3358be good to use.<wbr/></p>
3359<p>Below are state transition tables for different AE modes.<wbr/></p>
3360<table>
3361<thead>
3362<tr>
3363<th align="center">State</th>
3364<th align="center">Transition Cause</th>
3365<th align="center">New State</th>
3366<th align="center">Notes</th>
3367</tr>
3368</thead>
3369<tbody>
3370<tr>
3371<td align="center">INACTIVE</td>
3372<td align="center"></td>
3373<td align="center">INACTIVE</td>
3374<td align="center">Camera device auto exposure algorithm is disabled</td>
3375</tr>
3376</tbody>
3377</table>
3378<p>When <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is AE_<wbr/>MODE_<wbr/>ON_<wbr/>*:</p>
3379<table>
3380<thead>
3381<tr>
3382<th align="center">State</th>
3383<th align="center">Transition Cause</th>
3384<th align="center">New State</th>
3385<th align="center">Notes</th>
3386</tr>
3387</thead>
3388<tbody>
3389<tr>
3390<td align="center">INACTIVE</td>
3391<td align="center">Camera device initiates AE scan</td>
3392<td align="center">SEARCHING</td>
3393<td align="center">Values changing</td>
3394</tr>
3395<tr>
3396<td align="center">INACTIVE</td>
3397<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3398<td align="center">LOCKED</td>
3399<td align="center">Values locked</td>
3400</tr>
3401<tr>
3402<td align="center">SEARCHING</td>
3403<td align="center">Camera device finishes AE scan</td>
3404<td align="center">CONVERGED</td>
3405<td align="center">Good values,<wbr/> not changing</td>
3406</tr>
3407<tr>
3408<td align="center">SEARCHING</td>
3409<td align="center">Camera device finishes AE scan</td>
3410<td align="center">FLASH_<wbr/>REQUIRED</td>
3411<td align="center">Converged but too dark w/<wbr/>o flash</td>
3412</tr>
3413<tr>
3414<td align="center">SEARCHING</td>
3415<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3416<td align="center">LOCKED</td>
3417<td align="center">Values locked</td>
3418</tr>
3419<tr>
3420<td align="center">CONVERGED</td>
3421<td align="center">Camera device initiates AE scan</td>
3422<td align="center">SEARCHING</td>
3423<td align="center">Values changing</td>
3424</tr>
3425<tr>
3426<td align="center">CONVERGED</td>
3427<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3428<td align="center">LOCKED</td>
3429<td align="center">Values locked</td>
3430</tr>
3431<tr>
3432<td align="center">FLASH_<wbr/>REQUIRED</td>
3433<td align="center">Camera device initiates AE scan</td>
3434<td align="center">SEARCHING</td>
3435<td align="center">Values changing</td>
3436</tr>
3437<tr>
3438<td align="center">FLASH_<wbr/>REQUIRED</td>
3439<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3440<td align="center">LOCKED</td>
3441<td align="center">Values locked</td>
3442</tr>
3443<tr>
3444<td align="center">LOCKED</td>
3445<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3446<td align="center">SEARCHING</td>
3447<td align="center">Values not good after unlock</td>
3448</tr>
3449<tr>
3450<td align="center">LOCKED</td>
3451<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3452<td align="center">CONVERGED</td>
3453<td align="center">Values good after unlock</td>
3454</tr>
3455<tr>
3456<td align="center">LOCKED</td>
3457<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3458<td align="center">FLASH_<wbr/>REQUIRED</td>
3459<td align="center">Exposure good,<wbr/> but too dark</td>
3460</tr>
3461<tr>
3462<td align="center">PRECAPTURE</td>
3463<td align="center">Sequence done.<wbr/> <a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3464<td align="center">CONVERGED</td>
3465<td align="center">Ready for high-quality capture</td>
3466</tr>
3467<tr>
3468<td align="center">PRECAPTURE</td>
3469<td align="center">Sequence done.<wbr/> <a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3470<td align="center">LOCKED</td>
3471<td align="center">Ready for high-quality capture</td>
3472</tr>
3473<tr>
3474<td align="center">Any state</td>
3475<td align="center"><a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a> is START</td>
3476<td align="center">PRECAPTURE</td>
3477<td align="center">Start AE precapture metering sequence</td>
3478</tr>
3479</tbody>
3480</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3481 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3482 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3483
3484
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3485 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3486 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3487
3488
3489 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3490 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3491 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3492 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3493 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3494 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3495
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3496 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3497
3498 <ul class="entry_type_enum">
3499 <li>
3500 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3501 <span class="entry_type_enum_notes"><p>The auto-focus routine does not control the lens;
3502<a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> is controlled by the
3503application</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3504 </li>
3505 <li>
3506 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3507 <span class="entry_type_enum_notes"><p>If lens is not fixed focus.<wbr/></p>
3508<p>Use <a href="#static_android.lens.info.minimumFocusDistance">android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance</a> to determine if lens
3509is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3510the autofocus trigger action is called.<wbr/> When that trigger
3511is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3512the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/></p>
3513<p>Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3514and sets the AF state to INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3515 </li>
3516 <li>
3517 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3518 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the lens does not move unless the
3519autofocus trigger action is called.<wbr/></p>
3520<p>When that trigger is activated,<wbr/> AF must transition to
3521ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3522NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3523position to default,<wbr/> and sets the AF state to
3524INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3525 </li>
3526 <li>
3527 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3528 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
3529position continually to attempt to provide a
3530constantly-in-focus image stream.<wbr/></p>
3531<p>The focusing behavior should be suitable for good quality
3532video recording; typically this means slower focus
3533movement and no overshoots.<wbr/> When the AF trigger is not
3534involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3535and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3536states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
3537the algorithm should immediately transition into
3538AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3539lens position until a cancel AF trigger is received.<wbr/></p>
3540<p>Once cancel is received,<wbr/> the algorithm should transition
3541back to INACTIVE and resume passive scan.<wbr/> Note that this
3542behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3543ongoing PASSIVE_<wbr/>SCAN must immediately be
3544canceled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3545 </li>
3546 <li>
3547 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3548 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
3549position continually to attempt to provide a
3550constantly-in-focus image stream.<wbr/></p>
3551<p>The focusing behavior should be suitable for still image
3552capture; typically this means focusing as fast as
3553possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3554algorithm should start in INACTIVE state,<wbr/> and then
3555transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3556appropriate as it attempts to maintain focus.<wbr/> When the AF
3557trigger is activated,<wbr/> the algorithm should finish its
3558PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3559AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3560lens position until a cancel AF trigger is received.<wbr/></p>
3561<p>When the AF cancel trigger is activated,<wbr/> the algorithm
3562should transition back to INACTIVE and then act as if it
3563has just been started.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3564 </li>
3565 <li>
3566 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3567 <span class="entry_type_enum_notes"><p>Extended depth of field (digital focus).<wbr/> AF
3568trigger is ignored,<wbr/> AF state should always be
3569INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3570 </li>
3571 </ul>
3572
3573 </td> <!-- entry_type -->
3574
3575 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3576 <p>Whether AF is currently enabled,<wbr/> and what
3577mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3578 </td>
3579
3580 <td class="entry_units">
3581 </td>
3582
3583 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]3584 <p><a href="#static_android.control.afAvailableModes">android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3585 </td>
3586
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3587 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3588 <ul class="entry_tags">
3589 <li><a href="#tag_BC">BC</a></li>
3590 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3591 </td>
3592
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3593 </tr>
3594 <tr class="entries_header">
3595 <th class="th_details" colspan="5">Details</th>
3596 </tr>
3597 <tr class="entry_cont">
3598 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3599 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]3600<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
3601the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
3602in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3603 </td>
3604 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3605
3606
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3607 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3608 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3609
3610
3611 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3612 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3613 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3614 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3615 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3616 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3617 <span class="entry_type_container">x</span>
3618
3619 <span class="entry_type_array">
3620 5 x area_count
3621 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3622 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3623
3624
3625 </td> <!-- entry_type -->
3626
3627 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3628 <p>List of areas to use for focus
3629estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3630 </td>
3631
3632 <td class="entry_units">
3633 </td>
3634
3635 <td class="entry_range">
3636 </td>
3637
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3638 <td class="entry_tags">
3639 <ul class="entry_tags">
3640 <li><a href="#tag_BC">BC</a></li>
3641 </ul>
3642 </td>
3643
3644 </tr>
3645 <tr class="entries_header">
3646 <th class="th_details" colspan="5">Details</th>
3647 </tr>
3648 <tr class="entry_cont">
3649 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3650 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3651xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3652specified coordinates.<wbr/></p>
3653<p>The coordinate system is based on the active pixel array,<wbr/>
3654with (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]3655(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3656<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]3657bottom-right pixel in the active pixel array.<wbr/> The weight
3658should be nonnegative.<wbr/></p>
3659<p>If all regions have 0 weight,<wbr/> then no specific focus area
3660needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3661outside 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]3662should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3663used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3664 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3665 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3666
3667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3668 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3669 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3670
3671
3672 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3673 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3674 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3675 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3676 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3677 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3678
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3679 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3680
3681 <ul class="entry_type_enum">
3682 <li>
3683 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3684 <span class="entry_type_enum_notes"><p>AF off or has not yet tried to scan/<wbr/>been asked
3685to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3686this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3687 </li>
3688 <li>
3689 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3690 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF is
3691currently doing an AF scan initiated by a continuous
3692autofocus mode</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3693 </li>
3694 <li>
3695 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3696 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3697believes it is in focus,<wbr/> but may restart scanning at
3698any time.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3699 </li>
3700 <li>
3701 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3702 <span class="entry_type_enum_notes"><p>if AUTO or MACRO modes are supported.<wbr/> AF is doing
3703an AF scan because it was triggered by AF
3704trigger</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3705 </li>
3706 <li>
3707 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3708 <span class="entry_type_enum_notes"><p>if any AF mode besides OFF is supported.<wbr/> AF
3709believes it is focused correctly and is
3710locked</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3711 </li>
3712 <li>
3713 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3714 <span class="entry_type_enum_notes"><p>if any AF mode besides OFF is supported.<wbr/> AF has
3715failed to focus successfully and is
3716locked</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3717 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3718 <li>
3719 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3720 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3721passive scan without finding focus,<wbr/> and may restart
3722scanning at any time.<wbr/></p></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3723 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3724 </ul>
3725
3726 </td> <!-- entry_type -->
3727
3728 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3729 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3730 </td>
3731
3732 <td class="entry_units">
3733 </td>
3734
3735 <td class="entry_range">
3736 </td>
3737
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3738 <td class="entry_tags">
3739 </td>
3740
3741 </tr>
3742 <tr class="entries_header">
3743 <th class="th_details" colspan="5">Details</th>
3744 </tr>
3745 <tr class="entry_cont">
3746 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]3747 <p>Switching between or enabling AF modes (<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>) always
3748resets the AF state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
3749or <a href="#controls_android.control.sceneMode">android.<wbr/>control.<wbr/>scene<wbr/>Mode</a> if <code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> == USE_<wbr/>SCENE_<wbr/>MODE</code> resets all
3750the algorithm states to INACTIVE.<wbr/></p>
3751<p>The camera device can do several state transitions between two results,<wbr/> if it is
3752allowed by the state transition table.<wbr/> For example: INACTIVE may never actually be
3753seen in a result.<wbr/></p>
3754<p>The state in the result is the state for this image (in sync with this image): if
3755AF state becomes FOCUSED,<wbr/> then the image data associated with this result should
3756be sharp.<wbr/></p>
3757<p>Below are state transition tables for different AF modes.<wbr/></p>
3758<p>When <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> is AF_<wbr/>MODE_<wbr/>OFF or AF_<wbr/>MODE_<wbr/>EDOF:</p>
3759<table>
3760<thead>
3761<tr>
3762<th align="center">State</th>
3763<th align="center">Transition Cause</th>
3764<th align="center">New State</th>
3765<th align="center">Notes</th>
3766</tr>
3767</thead>
3768<tbody>
3769<tr>
3770<td align="center">INACTIVE</td>
3771<td align="center"></td>
3772<td align="center">INACTIVE</td>
3773<td align="center">Never changes</td>
3774</tr>
3775</tbody>
3776</table>
3777<p>When <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> is AF_<wbr/>MODE_<wbr/>AUTO or AF_<wbr/>MODE_<wbr/>MACRO:</p>
3778<table>
3779<thead>
3780<tr>
3781<th align="center">State</th>
3782<th align="center">Transition Cause</th>
3783<th align="center">New State</th>
3784<th align="center">Notes</th>
3785</tr>
3786</thead>
3787<tbody>
3788<tr>
3789<td align="center">INACTIVE</td>
3790<td align="center">AF_<wbr/>TRIGGER</td>
3791<td align="center">ACTIVE_<wbr/>SCAN</td>
3792<td align="center">Start AF sweep,<wbr/> Lens now moving</td>
3793</tr>
3794<tr>
3795<td align="center">ACTIVE_<wbr/>SCAN</td>
3796<td align="center">AF sweep done</td>
3797<td align="center">FOCUSED_<wbr/>LOCKED</td>
3798<td align="center">Focused,<wbr/> Lens now locked</td>
3799</tr>
3800<tr>
3801<td align="center">ACTIVE_<wbr/>SCAN</td>
3802<td align="center">AF sweep done</td>
3803<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3804<td align="center">Not focused,<wbr/> Lens now locked</td>
3805</tr>
3806<tr>
3807<td align="center">ACTIVE_<wbr/>SCAN</td>
3808<td align="center">AF_<wbr/>CANCEL</td>
3809<td align="center">INACTIVE</td>
3810<td align="center">Cancel/<wbr/>reset AF,<wbr/> Lens now locked</td>
3811</tr>
3812<tr>
3813<td align="center">FOCUSED_<wbr/>LOCKED</td>
3814<td align="center">AF_<wbr/>CANCEL</td>
3815<td align="center">INACTIVE</td>
3816<td align="center">Cancel/<wbr/>reset AF</td>
3817</tr>
3818<tr>
3819<td align="center">FOCUSED_<wbr/>LOCKED</td>
3820<td align="center">AF_<wbr/>TRIGGER</td>
3821<td align="center">ACTIVE_<wbr/>SCAN</td>
3822<td align="center">Start new sweep,<wbr/> Lens now moving</td>
3823</tr>
3824<tr>
3825<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3826<td align="center">AF_<wbr/>CANCEL</td>
3827<td align="center">INACTIVE</td>
3828<td align="center">Cancel/<wbr/>reset AF</td>
3829</tr>
3830<tr>
3831<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3832<td align="center">AF_<wbr/>TRIGGER</td>
3833<td align="center">ACTIVE_<wbr/>SCAN</td>
3834<td align="center">Start new sweep,<wbr/> Lens now moving</td>
3835</tr>
3836<tr>
3837<td align="center">Any state</td>
3838<td align="center">Mode change</td>
3839<td align="center">INACTIVE</td>
3840<td align="center"></td>
3841</tr>
3842</tbody>
3843</table>
3844<p>When <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> is AF_<wbr/>MODE_<wbr/>CONTINUOUS_<wbr/>VIDEO:</p>
3845<table>
3846<thead>
3847<tr>
3848<th align="center">State</th>
3849<th align="center">Transition Cause</th>
3850<th align="center">New State</th>
3851<th align="center">Notes</th>
3852</tr>
3853</thead>
3854<tbody>
3855<tr>
3856<td align="center">INACTIVE</td>
3857<td align="center">Camera device initiates new scan</td>
3858<td align="center">PASSIVE_<wbr/>SCAN</td>
3859<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3860</tr>
3861<tr>
3862<td align="center">INACTIVE</td>
3863<td align="center">AF_<wbr/>TRIGGER</td>
3864<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3865<td align="center">AF state query,<wbr/> Lens now locked</td>
3866</tr>
3867<tr>
3868<td align="center">PASSIVE_<wbr/>SCAN</td>
3869<td align="center">Camera device completes current scan</td>
3870<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3871<td align="center">End AF scan,<wbr/> Lens now locked</td>
3872</tr>
3873<tr>
3874<td align="center">PASSIVE_<wbr/>SCAN</td>
3875<td align="center">Camera device fails current scan</td>
3876<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3877<td align="center">End AF scan,<wbr/> Lens now locked</td>
3878</tr>
3879<tr>
3880<td align="center">PASSIVE_<wbr/>SCAN</td>
3881<td align="center">AF_<wbr/>TRIGGER</td>
3882<td align="center">FOCUSED_<wbr/>LOCKED</td>
3883<td align="center">Immediate trans.<wbr/> If focus is good,<wbr/> Lens now locked</td>
3884</tr>
3885<tr>
3886<td align="center">PASSIVE_<wbr/>SCAN</td>
3887<td align="center">AF_<wbr/>TRIGGER</td>
3888<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3889<td align="center">Immediate trans.<wbr/> if focus is bad,<wbr/> Lens now locked</td>
3890</tr>
3891<tr>
3892<td align="center">PASSIVE_<wbr/>SCAN</td>
3893<td align="center">AF_<wbr/>CANCEL</td>
3894<td align="center">INACTIVE</td>
3895<td align="center">Reset lens position,<wbr/> Lens now locked</td>
3896</tr>
3897<tr>
3898<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3899<td align="center">Camera device initiates new scan</td>
3900<td align="center">PASSIVE_<wbr/>SCAN</td>
3901<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3902</tr>
3903<tr>
3904<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3905<td align="center">Camera device initiates new scan</td>
3906<td align="center">PASSIVE_<wbr/>SCAN</td>
3907<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3908</tr>
3909<tr>
3910<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3911<td align="center">AF_<wbr/>TRIGGER</td>
3912<td align="center">FOCUSED_<wbr/>LOCKED</td>
3913<td align="center">Immediate trans.<wbr/> Lens now locked</td>
3914</tr>
3915<tr>
3916<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3917<td align="center">AF_<wbr/>TRIGGER</td>
3918<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3919<td align="center">Immediate trans.<wbr/> Lens now locked</td>
3920</tr>
3921<tr>
3922<td align="center">FOCUSED_<wbr/>LOCKED</td>
3923<td align="center">AF_<wbr/>TRIGGER</td>
3924<td align="center">FOCUSED_<wbr/>LOCKED</td>
3925<td align="center">No effect</td>
3926</tr>
3927<tr>
3928<td align="center">FOCUSED_<wbr/>LOCKED</td>
3929<td align="center">AF_<wbr/>CANCEL</td>
3930<td align="center">INACTIVE</td>
3931<td align="center">Restart AF scan</td>
3932</tr>
3933<tr>
3934<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3935<td align="center">AF_<wbr/>TRIGGER</td>
3936<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3937<td align="center">No effect</td>
3938</tr>
3939<tr>
3940<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3941<td align="center">AF_<wbr/>CANCEL</td>
3942<td align="center">INACTIVE</td>
3943<td align="center">Restart AF scan</td>
3944</tr>
3945</tbody>
3946</table>
3947<p>When <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> is AF_<wbr/>MODE_<wbr/>CONTINUOUS_<wbr/>PICTURE:</p>
3948<table>
3949<thead>
3950<tr>
3951<th align="center">State</th>
3952<th align="center">Transition Cause</th>
3953<th align="center">New State</th>
3954<th align="center">Notes</th>
3955</tr>
3956</thead>
3957<tbody>
3958<tr>
3959<td align="center">INACTIVE</td>
3960<td align="center">Camera device initiates new scan</td>
3961<td align="center">PASSIVE_<wbr/>SCAN</td>
3962<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3963</tr>
3964<tr>
3965<td align="center">INACTIVE</td>
3966<td align="center">AF_<wbr/>TRIGGER</td>
3967<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3968<td align="center">AF state query,<wbr/> Lens now locked</td>
3969</tr>
3970<tr>
3971<td align="center">PASSIVE_<wbr/>SCAN</td>
3972<td align="center">Camera device completes current scan</td>
3973<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3974<td align="center">End AF scan,<wbr/> Lens now locked</td>
3975</tr>
3976<tr>
3977<td align="center">PASSIVE_<wbr/>SCAN</td>
3978<td align="center">Camera device fails current scan</td>
3979<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3980<td align="center">End AF scan,<wbr/> Lens now locked</td>
3981</tr>
3982<tr>
3983<td align="center">PASSIVE_<wbr/>SCAN</td>
3984<td align="center">AF_<wbr/>TRIGGER</td>
3985<td align="center">FOCUSED_<wbr/>LOCKED</td>
3986<td align="center">Eventual trans.<wbr/> once focus good,<wbr/> Lens now locked</td>
3987</tr>
3988<tr>
3989<td align="center">PASSIVE_<wbr/>SCAN</td>
3990<td align="center">AF_<wbr/>TRIGGER</td>
3991<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3992<td align="center">Eventual trans.<wbr/> if cannot focus,<wbr/> Lens now locked</td>
3993</tr>
3994<tr>
3995<td align="center">PASSIVE_<wbr/>SCAN</td>
3996<td align="center">AF_<wbr/>CANCEL</td>
3997<td align="center">INACTIVE</td>
3998<td align="center">Reset lens position,<wbr/> Lens now locked</td>
3999</tr>
4000<tr>
4001<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4002<td align="center">Camera device initiates new scan</td>
4003<td align="center">PASSIVE_<wbr/>SCAN</td>
4004<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4005</tr>
4006<tr>
4007<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4008<td align="center">Camera device initiates new scan</td>
4009<td align="center">PASSIVE_<wbr/>SCAN</td>
4010<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4011</tr>
4012<tr>
4013<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4014<td align="center">AF_<wbr/>TRIGGER</td>
4015<td align="center">FOCUSED_<wbr/>LOCKED</td>
4016<td align="center">Immediate trans.<wbr/> Lens now locked</td>
4017</tr>
4018<tr>
4019<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4020<td align="center">AF_<wbr/>TRIGGER</td>
4021<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4022<td align="center">Immediate trans.<wbr/> Lens now locked</td>
4023</tr>
4024<tr>
4025<td align="center">FOCUSED_<wbr/>LOCKED</td>
4026<td align="center">AF_<wbr/>TRIGGER</td>
4027<td align="center">FOCUSED_<wbr/>LOCKED</td>
4028<td align="center">No effect</td>
4029</tr>
4030<tr>
4031<td align="center">FOCUSED_<wbr/>LOCKED</td>
4032<td align="center">AF_<wbr/>CANCEL</td>
4033<td align="center">INACTIVE</td>
4034<td align="center">Restart AF scan</td>
4035</tr>
4036<tr>
4037<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4038<td align="center">AF_<wbr/>TRIGGER</td>
4039<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4040<td align="center">No effect</td>
4041</tr>
4042<tr>
4043<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4044<td align="center">AF_<wbr/>CANCEL</td>
4045<td align="center">INACTIVE</td>
4046<td align="center">Restart AF scan</td>
4047</tr>
4048</tbody>
4049</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4050 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4051 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4052
4053
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4054 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4055 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4056
4057
4058 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4059 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4060 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4061 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4062 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4063 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4064
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4065 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4066
4067
4068 </td> <!-- entry_type -->
4069
4070 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4071 <p>The ID sent with the latest
4072CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4073 </td>
4074
4075 <td class="entry_units">
4076 </td>
4077
4078 <td class="entry_range">
4079 </td>
4080
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4081 <td class="entry_tags">
4082 </td>
4083
4084 </tr>
4085 <tr class="entries_header">
4086 <th class="th_details" colspan="5">Details</th>
4087 </tr>
4088 <tr class="entry_cont">
4089 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4090 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
4091received yet by HAL.<wbr/> Always updated even if AF algorithm
4092ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4093 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4094 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4095
4096
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4097 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4098 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4099
4100
4101 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4102 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4103 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4104 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4105 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4106 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4107
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4108 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4109
4110 <ul class="entry_type_enum">
4111 <li>
4112 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4113 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4114the application-selected color transform matrix
4115(<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>) and gains
4116(<a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>) are used by the camera
4117device for manual white balance control.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4118 </li>
4119 <li>
4120 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4121 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is active;
4122the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
4123and <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> are ignored.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4124 </li>
4125 <li>
4126 <span class="entry_type_enum_name">INCANDESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4127 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4128the camera device uses incandescent light as the assumed scene
4129illumination for white balance.<wbr/> While the exact white balance
4130transforms are up to the camera device,<wbr/> they will approximately
4131match the CIE standard illuminant A.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4132 </li>
4133 <li>
4134 <span class="entry_type_enum_name">FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4135 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4136the camera device uses fluorescent light as the assumed scene
4137illumination for white balance.<wbr/> While the exact white balance
4138transforms are up to the camera device,<wbr/> they will approximately
4139match the CIE standard illuminant F2.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4140 </li>
4141 <li>
4142 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4143 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4144the camera device uses warm fluorescent light as the assumed scene
4145illumination for white balance.<wbr/> While the exact white balance
4146transforms are up to the camera device,<wbr/> they will approximately
4147match the CIE standard illuminant F4.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4148 </li>
4149 <li>
4150 <span class="entry_type_enum_name">DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4151 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4152the camera device uses daylight light as the assumed scene
4153illumination for white balance.<wbr/> While the exact white balance
4154transforms are up to the camera device,<wbr/> they will approximately
4155match the CIE standard illuminant D65.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4156 </li>
4157 <li>
4158 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4159 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4160the camera device uses cloudy daylight light as the assumed scene
4161illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4162 </li>
4163 <li>
4164 <span class="entry_type_enum_name">TWILIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4165 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4166the camera device uses twilight light as the assumed scene
4167illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4168 </li>
4169 <li>
4170 <span class="entry_type_enum_name">SHADE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4171 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4172the camera device uses shade light as the assumed scene
4173illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4174 </li>
4175 </ul>
4176
4177 </td> <!-- entry_type -->
4178
4179 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4180 <p>Whether AWB is currently setting the color
4181transform fields,<wbr/> and what its illumination target
4182is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4183 </td>
4184
4185 <td class="entry_units">
4186 </td>
4187
4188 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]4189 <p><a href="#static_android.control.awbAvailableModes">android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4190 </td>
4191
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4192 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4193 <ul class="entry_tags">
4194 <li><a href="#tag_BC">BC</a></li>
4195 <li><a href="#tag_AWB">AWB</a></li>
4196 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4197 </td>
4198
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4199 </tr>
4200 <tr class="entries_header">
4201 <th class="th_details" colspan="5">Details</th>
4202 </tr>
4203 <tr class="entry_cont">
4204 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]4205 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
4206<p>When set to the ON mode,<wbr/> the camera device's auto white balance
4207routine is enabled,<wbr/> overriding the application's selected
4208<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> and
4209<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
4210<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
4211routine is disabled.<wbr/> The applicantion manually controls the white
4212balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
4213and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
4214<p>When set to any other modes,<wbr/> the camera device's auto white balance
4215routine is disabled.<wbr/> The camera device uses each particular illumination
4216target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4217 </td>
4218 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4219
4220
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4221 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4222 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4223
4224
4225 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4226 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4227 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4228 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4229 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4230 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4231 <span class="entry_type_container">x</span>
4232
4233 <span class="entry_type_array">
4234 5 x area_count
4235 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4236 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4237
4238
4239 </td> <!-- entry_type -->
4240
4241 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4242 <p>List of areas to use for illuminant
4243estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4244 </td>
4245
4246 <td class="entry_units">
4247 </td>
4248
4249 <td class="entry_range">
4250 </td>
4251
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4252 <td class="entry_tags">
4253 <ul class="entry_tags">
4254 <li><a href="#tag_BC">BC</a></li>
4255 </ul>
4256 </td>
4257
4258 </tr>
4259 <tr class="entries_header">
4260 <th class="th_details" colspan="5">Details</th>
4261 </tr>
4262 <tr class="entry_cont">
4263 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4264 <p>Only used in AUTO mode.<wbr/></p>
4265<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
4266xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
4267specified coordinates.<wbr/></p>
4268<p>The coordinate system is based on the active pixel array,<wbr/>
4269with (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]4270(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
4271<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]4272bottom-right pixel in the active pixel array.<wbr/> The weight
4273should be nonnegative.<wbr/></p>
4274<p>If all regions have 0 weight,<wbr/> then no specific metering area
4275needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4276outside 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]4277should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4278used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4279 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4280 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4281
4282
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4283 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4284 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4285
4286
4287 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4288 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4289 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4290 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4291 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4292 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4293
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4294 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4295
4296 <ul class="entry_type_enum">
4297 <li>
4298 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4299 <span class="entry_type_enum_notes"><p>AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
4300starts in this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4301 </li>
4302 <li>
4303 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4304 <span class="entry_type_enum_notes"><p>AWB doesn't yet have a good set of control
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]4305values for the current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4306 </li>
4307 <li>
4308 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4309 <span class="entry_type_enum_notes"><p>AWB has a good set of control values for the
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]4310current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4311 </li>
4312 <li>
4313 <span class="entry_type_enum_name">LOCKED</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]4314 <span class="entry_type_enum_notes"><p>AWB has been locked.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4315 </li>
4316 </ul>
4317
4318 </td> <!-- entry_type -->
4319
4320 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4321 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4322 </td>
4323
4324 <td class="entry_units">
4325 </td>
4326
4327 <td class="entry_range">
4328 </td>
4329
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4330 <td class="entry_tags">
4331 </td>
4332
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">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame^]4339 <p>Switching between or enabling AWB modes (<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>) always
4340resets the AWB state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
4341or <a href="#controls_android.control.sceneMode">android.<wbr/>control.<wbr/>scene<wbr/>Mode</a> if <code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> == USE_<wbr/>SCENE_<wbr/>MODE</code> resets all
4342the algorithm states to INACTIVE.<wbr/></p>
4343<p>The camera device can do several state transitions between two results,<wbr/> if it is
4344allowed by the state transition table.<wbr/> So INACTIVE may never actually be seen in
4345a result.<wbr/></p>
4346<p>The state in the result is the state for this image (in sync with this image): if
4347AWB state becomes CONVERGED,<wbr/> then the image data associated with this result should
4348be good to use.<wbr/></p>
4349<p>Below are state transition tables for different AWB modes.<wbr/></p>
4350<p>When <code><a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> != AWB_<wbr/>MODE_<wbr/>AUTO</code>:</p>
4351<table>
4352<thead>
4353<tr>
4354<th align="center">State</th>
4355<th align="center">Transition Cause</th>
4356<th align="center">New State</th>
4357<th align="center">Notes</th>
4358</tr>
4359</thead>
4360<tbody>
4361<tr>
4362<td align="center">INACTIVE</td>
4363<td align="center"></td>
4364<td align="center">INACTIVE</td>
4365<td align="center">Camera device auto white balance algorithm is disabled</td>
4366</tr>
4367</tbody>
4368</table>
4369<p>When <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> is AWB_<wbr/>MODE_<wbr/>AUTO:</p>
4370<table>
4371<thead>
4372<tr>
4373<th align="center">State</th>
4374<th align="center">Transition Cause</th>
4375<th align="center">New State</th>
4376<th align="center">Notes</th>
4377</tr>
4378</thead>
4379<tbody>
4380<tr>
4381<td align="center">INACTIVE</td>
4382<td align="center">Camera device initiates AWB scan</td>
4383<td align="center">SEARCHING</td>
4384<td align="center">Values changing</td>
4385</tr>
4386<tr>
4387<td align="center">INACTIVE</td>
4388<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4389<td align="center">LOCKED</td>
4390<td align="center">Values locked</td>
4391</tr>
4392<tr>
4393<td align="center">SEARCHING</td>
4394<td align="center">Camera device finishes AWB scan</td>
4395<td align="center">CONVERGED</td>
4396<td align="center">Good values,<wbr/> not changing</td>
4397</tr>
4398<tr>
4399<td align="center">SEARCHING</td>
4400<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4401<td align="center">LOCKED</td>
4402<td align="center">Values locked</td>
4403</tr>
4404<tr>
4405<td align="center">CONVERGED</td>
4406<td align="center">Camera device initiates AWB scan</td>
4407<td align="center">SEARCHING</td>
4408<td align="center">Values changing</td>
4409</tr>
4410<tr>
4411<td align="center">CONVERGED</td>
4412<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4413<td align="center">LOCKED</td>
4414<td align="center">Values locked</td>
4415</tr>
4416<tr>
4417<td align="center">LOCKED</td>
4418<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is OFF</td>
4419<td align="center">SEARCHING</td>
4420<td align="center">Values not good after unlock</td>
4421</tr>
4422<tr>
4423<td align="center">LOCKED</td>
4424<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is OFF</td>
4425<td align="center">CONVERGED</td>
4426<td align="center">Values good after unlock</td>
4427</tr>
4428</tbody>
4429</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4430 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4431 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4432
4433
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4434 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4435 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4436
4437
4438 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4439 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4440 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4441 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4442 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4443 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4444
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4445 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4446
4447 <ul class="entry_type_enum">
4448 <li>
4449 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4450 <span class="entry_type_enum_notes"><p>Full application control of pipeline.<wbr/> All 3A
4451routines are disabled,<wbr/> no other settings in
4452android.<wbr/>control.<wbr/>* have any effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4453 </li>
4454 <li>
4455 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4456 <span class="entry_type_enum_notes"><p>Use settings for each individual 3A routine.<wbr/>
4457Manual control of capture parameters is disabled.<wbr/> All
4458controls in android.<wbr/>control.<wbr/>* besides sceneMode take
4459effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4460 </li>
4461 <li>
4462 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4463 <span class="entry_type_enum_notes"><p>Use specific scene mode.<wbr/> Enabling this disables
4464control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
4465controls; the HAL must ignore those settings while
4466USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
4467scene mode).<wbr/> Other control entries are still active.<wbr/>
4468This setting can only be used if availableSceneModes !=
4469UNSUPPORTED</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4470 </li>
4471 </ul>
4472
4473 </td> <!-- entry_type -->
4474
4475 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4476 <p>Overall mode of 3A control
4477routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4478 </td>
4479
4480 <td class="entry_units">
4481 </td>
4482
4483 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4484 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4485 </td>
4486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4487 <td class="entry_tags">
4488 <ul class="entry_tags">
4489 <li><a href="#tag_BC">BC</a></li>
4490 </ul>
4491 </td>
4492
4493 </tr>
4494 <tr class="entries_header">
4495 <th class="th_details" colspan="5">Details</th>
4496 </tr>
4497 <tr class="entry_cont">
4498 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4499 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4500by the camera device is disabled.<wbr/> The application must set the fields for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4501capture parameters itself.<wbr/></p>
4502<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4503android.<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]4504<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4505android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the camera device implements
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4506one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4507as it wishes.<wbr/> The camera device scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4508<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]4509 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4510 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4511
4512
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4513 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4514 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4515
4516
4517
4518 <!-- end of kind -->
4519 </tbody>
4520
4521 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4522 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4523
4524
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4525 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4526
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4527 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4528 <tr>
4529 <th class="th_name">Property Name</th>
4530 <th class="th_type">Type</th>
4531 <th class="th_description">Description</th>
4532 <th class="th_units">Units</th>
4533 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4534 <th class="th_tags">Tags</th>
4535 </tr>
4536 </thead>
4537
4538 <tbody>
4539
4540
4541
4542
4543
4544
4545
4546
4547
4548
4549 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4550 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4551 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4552 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4553 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4554 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4555
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4556 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4557
4558 <ul class="entry_type_enum">
4559 <li>
4560 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4561 <span class="entry_type_enum_notes"><p>Minimal or no slowdown of frame rate compared to
4562Bayer RAW output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4563 </li>
4564 <li>
4565 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4566 <span class="entry_type_enum_notes"><p>High-quality may reduce output frame
4567rate</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4568 </li>
4569 </ul>
4570
4571 </td> <!-- entry_type -->
4572
4573 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4574 <p>Controls the quality of the demosaicing
4575processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4576 </td>
4577
4578 <td class="entry_units">
4579 </td>
4580
4581 <td class="entry_range">
4582 </td>
4583
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4584 <td class="entry_tags">
4585 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4586 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4587 </ul>
4588 </td>
4589
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4590 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4591
4592
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4593 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4594 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4595
4596
4597
4598 <!-- end of kind -->
4599 </tbody>
4600
4601 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4602 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4603
4604
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4605 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4606
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4607 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4608 <tr>
4609 <th class="th_name">Property Name</th>
4610 <th class="th_type">Type</th>
4611 <th class="th_description">Description</th>
4612 <th class="th_units">Units</th>
4613 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4614 <th class="th_tags">Tags</th>
4615 </tr>
4616 </thead>
4617
4618 <tbody>
4619
4620
4621
4622
4623
4624
4625
4626
4627
4628
4629 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4630 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4631 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4632 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4633 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4634 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4635
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4636 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4637
4638 <ul class="entry_type_enum">
4639 <li>
4640 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4641 <span class="entry_type_enum_notes"><p>No edge enhancement is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4642 </li>
4643 <li>
4644 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4645 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
4646output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4647 </li>
4648 <li>
4649 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4650 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4651quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4652 </li>
4653 </ul>
4654
4655 </td> <!-- entry_type -->
4656
4657 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4658 <p>Operation mode for edge
4659enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4660 </td>
4661
4662 <td class="entry_units">
4663 </td>
4664
4665 <td class="entry_range">
4666 </td>
4667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4668 <td class="entry_tags">
4669 </td>
4670
4671 </tr>
4672 <tr class="entries_header">
4673 <th class="th_details" colspan="5">Details</th>
4674 </tr>
4675 <tr class="entry_cont">
4676 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4677 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4678enhancement will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4679<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined enhancement
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4680will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4681camera device will use the highest-quality enhancement algorithms,<wbr/>
4682even if it slows down capture rate.<wbr/> FAST means the camera device will
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4683not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4684 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4685 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4686
4687
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4688 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4689 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4690
4691
4692 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4693 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4694 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4695 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4696 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4697 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4698
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4699 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4700
4701
4702 </td> <!-- entry_type -->
4703
4704 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4705 <p>Control the amount of edge enhancement
4706applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4707 </td>
4708
4709 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4710 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4711 </td>
4712
4713 <td class="entry_range">
4714 </td>
4715
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4716 <td class="entry_tags">
4717 </td>
4718
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4719 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4720
4721
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4722 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4723 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4724
4725
4726
4727 <!-- end of kind -->
4728 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4729 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4730
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4731 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4732 <tr>
4733 <th class="th_name">Property Name</th>
4734 <th class="th_type">Type</th>
4735 <th class="th_description">Description</th>
4736 <th class="th_units">Units</th>
4737 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4738 <th class="th_tags">Tags</th>
4739 </tr>
4740 </thead>
4741
4742 <tbody>
4743
4744
4745
4746
4747
4748
4749
4750
4751
4752
4753 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4754 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4755 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4756 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4757 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4758 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4759
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4760 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4761
4762 <ul class="entry_type_enum">
4763 <li>
4764 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4765 <span class="entry_type_enum_notes"><p>No edge enhancement is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4766 </li>
4767 <li>
4768 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4769 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
4770output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4771 </li>
4772 <li>
4773 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4774 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4775quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4776 </li>
4777 </ul>
4778
4779 </td> <!-- entry_type -->
4780
4781 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4782 <p>Operation mode for edge
4783enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4784 </td>
4785
4786 <td class="entry_units">
4787 </td>
4788
4789 <td class="entry_range">
4790 </td>
4791
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4792 <td class="entry_tags">
4793 </td>
4794
4795 </tr>
4796 <tr class="entries_header">
4797 <th class="th_details" colspan="5">Details</th>
4798 </tr>
4799 <tr class="entry_cont">
4800 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4801 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4802enhancement will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4803<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined enhancement
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4804will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4805camera device will use the highest-quality enhancement algorithms,<wbr/>
4806even if it slows down capture rate.<wbr/> FAST means the camera device will
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4807not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4808 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4809 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4810
4811
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4812 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4813 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4814
4815
4816
4817 <!-- end of kind -->
4818 </tbody>
4819
4820 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4821 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4822
4823
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4824 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4825
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4826 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4827 <tr>
4828 <th class="th_name">Property Name</th>
4829 <th class="th_type">Type</th>
4830 <th class="th_description">Description</th>
4831 <th class="th_units">Units</th>
4832 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4833 <th class="th_tags">Tags</th>
4834 </tr>
4835 </thead>
4836
4837 <tbody>
4838
4839
4840
4841
4842
4843
4844
4845
4846
4847
4848 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4849 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4850 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4851 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4852 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4853 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4854
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4855 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4856
4857
4858 </td> <!-- entry_type -->
4859
4860 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4861 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4862 </td>
4863
4864 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4865 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4866 </td>
4867
4868 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4869 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4870 </td>
4871
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4872 <td class="entry_tags">
4873 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4874 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4875 </ul>
4876 </td>
4877
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4878 </tr>
4879 <tr class="entries_header">
4880 <th class="th_details" colspan="5">Details</th>
4881 </tr>
4882 <tr class="entry_cont">
4883 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4884 <p>Power for snapshot may use a different scale than
4885for torch mode.<wbr/> Only one entry for torch mode will be
4886used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4887 </td>
4888 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4889
4890
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4891 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4892 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4893
4894
4895 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4896 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4897 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4898 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4899 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4900 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4901
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4902 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4903
4904
4905 </td> <!-- entry_type -->
4906
4907 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4908 <p>Firing time of flash relative to start of
4909exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4910 </td>
4911
4912 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4913 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4914 </td>
4915
4916 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4917 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4918 </td>
4919
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4920 <td class="entry_tags">
4921 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4922 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4923 </ul>
4924 </td>
4925
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4926 </tr>
4927 <tr class="entries_header">
4928 <th class="th_details" colspan="5">Details</th>
4929 </tr>
4930 <tr class="entry_cont">
4931 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4932 <p>Clamped to (0,<wbr/> exposure time - flash
4933duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4934 </td>
4935 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4936
4937
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4938 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4939 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4940
4941
4942 <tr class="entry" id="controls_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4943 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4944 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4945 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4946 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4947 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4948
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4949 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4950
4951 <ul class="entry_type_enum">
4952 <li>
4953 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4954 <span class="entry_type_enum_notes"><p>Do not fire the flash for this
4955capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4956 </li>
4957 <li>
4958 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4959 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Fire flash
4960for this capture based on firingPower,<wbr/>
4961firingTime.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4962 </li>
4963 <li>
4964 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4965 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash
4966continuously on,<wbr/> power set by
4967firingPower</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4968 </li>
4969 </ul>
4970
4971 </td> <!-- entry_type -->
4972
4973 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4974 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4975 </td>
4976
4977 <td class="entry_units">
4978 </td>
4979
4980 <td class="entry_range">
4981 </td>
4982
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4983 <td class="entry_tags">
4984 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4985 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4986 </ul>
4987 </td>
4988
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4989 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4990
4991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4992 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4993 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4994
4995
4996
4997 <!-- end of kind -->
4998 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4999 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5000
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5001 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5002 <tr>
5003 <th class="th_name">Property Name</th>
5004 <th class="th_type">Type</th>
5005 <th class="th_description">Description</th>
5006 <th class="th_units">Units</th>
5007 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5008 <th class="th_tags">Tags</th>
5009 </tr>
5010 </thead>
5011
5012 <tbody>
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5026 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5027 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5028 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5029 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5030 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5031
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5032 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5033
5034
5035 </td> <!-- entry_type -->
5036
5037 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5038 <p>Whether this camera has a
5039flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5040 </td>
5041
5042 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5043 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5044 </td>
5045
5046 <td class="entry_range">
5047 </td>
5048
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5049 <td class="entry_tags">
5050 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5051 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5052 </ul>
5053 </td>
5054
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5055 </tr>
5056 <tr class="entries_header">
5057 <th class="th_details" colspan="5">Details</th>
5058 </tr>
5059 <tr class="entry_cont">
5060 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5061 <p>If no flash,<wbr/> none of the flash controls do
5062anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5063 </td>
5064 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5065
5066
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5067 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5068 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5069
5070
5071 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5072 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5073 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5074 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5075 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5076 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5077
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5078 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5079
5080
5081 </td> <!-- entry_type -->
5082
5083 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5084 <p>Time taken before flash can fire
5085again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5086 </td>
5087
5088 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5089 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5090 </td>
5091
5092 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5093 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5094 </td>
5095
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5096 <td class="entry_tags">
5097 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5098 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5099 </ul>
5100 </td>
5101
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5102 </tr>
5103 <tr class="entries_header">
5104 <th class="th_details" colspan="5">Details</th>
5105 </tr>
5106 <tr class="entry_cont">
5107 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5108 <p>1 second too long/<wbr/>too short for recharge? Should
5109this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5110 </td>
5111 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5112
5113
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5114 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5115 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5116
5117
5118
5119
5120
5121 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5122 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5123 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5124 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5125 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5126 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5127
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5128 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5129
5130
5131 </td> <!-- entry_type -->
5132
5133 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5134 <p>The x,<wbr/>y whitepoint of the
5135flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5136 </td>
5137
5138 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5139 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5140 </td>
5141
5142 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5143 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5144 </td>
5145
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5146 <td class="entry_tags">
5147 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5148 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5149 </ul>
5150 </td>
5151
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5152 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5153
5154
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5155 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5156 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5157
5158
5159 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5160 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5161 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5162 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5163 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5164 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5165
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5166 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5167
5168
5169 </td> <!-- entry_type -->
5170
5171 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5172 <p>Max energy output of the flash for a full
5173power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5174 </td>
5175
5176 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5177 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5178 </td>
5179
5180 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]5181 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5182 </td>
5183
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5184 <td class="entry_tags">
5185 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5186 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5187 </ul>
5188 </td>
5189
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5190 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5191
5192
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5193 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5194 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5195
5196
5197
5198 <!-- end of kind -->
5199 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5200 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5201
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5202 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5203 <tr>
5204 <th class="th_name">Property Name</th>
5205 <th class="th_type">Type</th>
5206 <th class="th_description">Description</th>
5207 <th class="th_units">Units</th>
5208 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5209 <th class="th_tags">Tags</th>
5210 </tr>
5211 </thead>
5212
5213 <tbody>
5214
5215
5216
5217
5218
5219
5220
5221
5222
5223
5224 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5225 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5226 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5227 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5228 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5229 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5230
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5231 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5232
5233
5234 </td> <!-- entry_type -->
5235
5236 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5237 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5238 </td>
5239
5240 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5241 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5242 </td>
5243
5244 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5245 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5246 </td>
5247
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5248 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5249 <ul class="entry_tags">
5250 <li><a href="#tag_V1">V1</a></li>
5251 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5252 </td>
5253
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5254 </tr>
5255 <tr class="entries_header">
5256 <th class="th_details" colspan="5">Details</th>
5257 </tr>
5258 <tr class="entry_cont">
5259 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5260 <p>Power for snapshot may use a different scale than
5261for torch mode.<wbr/> Only one entry for torch mode will be
5262used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5263 </td>
5264 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5265
5266
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5267 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5268 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5269
5270
5271 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5272 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5273 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5274 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5275 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5276 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5277
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5278 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5279
5280
5281 </td> <!-- entry_type -->
5282
5283 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5284 <p>Firing time of flash relative to start of
5285exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5286 </td>
5287
5288 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5289 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5290 </td>
5291
5292 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5293 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5294 </td>
5295
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5296 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5297 <ul class="entry_tags">
5298 <li><a href="#tag_V1">V1</a></li>
5299 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5300 </td>
5301
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5302 </tr>
5303 <tr class="entries_header">
5304 <th class="th_details" colspan="5">Details</th>
5305 </tr>
5306 <tr class="entry_cont">
5307 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5308 <p>Clamped to (0,<wbr/> exposure time - flash
5309duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5310 </td>
5311 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5312
5313
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5314 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5315 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5316
5317
5318 <tr class="entry" id="dynamic_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5319 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5320 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5321 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5322 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5323 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5324
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5325 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5326
5327 <ul class="entry_type_enum">
5328 <li>
5329 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5330 <span class="entry_type_enum_notes"><p>Do not fire the flash for this
5331capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5332 </li>
5333 <li>
5334 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5335 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Fire flash
5336for this capture based on firingPower,<wbr/>
5337firingTime.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5338 </li>
5339 <li>
5340 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5341 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash
5342continuously on,<wbr/> power set by
5343firingPower</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5344 </li>
5345 </ul>
5346
5347 </td> <!-- entry_type -->
5348
5349 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5350 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5351 </td>
5352
5353 <td class="entry_units">
5354 </td>
5355
5356 <td class="entry_range">
5357 </td>
5358
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5359 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5360 <ul class="entry_tags">
5361 <li><a href="#tag_BC">BC</a></li>
5362 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5363 </td>
5364
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5365 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5366
5367
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5368 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5369 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5370
5371
5372 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5373 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5374 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5375 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5376 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5377 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5378
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5379 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5380
5381 <ul class="entry_type_enum">
5382 <li>
5383 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5384 <span class="entry_type_enum_notes"><p>No flash on camera</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5385 </li>
5386 <li>
5387 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5388 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash is
5389charging and cannot be fired</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5390 </li>
5391 <li>
5392 <span class="entry_type_enum_name">READY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5393 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash is
5394ready to fire</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5395 </li>
5396 <li>
5397 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5398 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash fired
5399for this capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5400 </li>
5401 </ul>
5402
5403 </td> <!-- entry_type -->
5404
5405 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5406 <p>Current state of the flash
5407unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5408 </td>
5409
5410 <td class="entry_units">
5411 </td>
5412
5413 <td class="entry_range">
5414 </td>
5415
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5416 <td class="entry_tags">
5417 </td>
5418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5419 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5420
5421
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5422 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5423 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5424
5425
5426
5427 <!-- end of kind -->
5428 </tbody>
5429
5430 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5431 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5432
5433
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5434 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5435
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5436 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5437 <tr>
5438 <th class="th_name">Property Name</th>
5439 <th class="th_type">Type</th>
5440 <th class="th_description">Description</th>
5441 <th class="th_units">Units</th>
5442 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5443 <th class="th_tags">Tags</th>
5444 </tr>
5445 </thead>
5446
5447 <tbody>
5448
5449
5450
5451
5452
5453
5454
5455
5456
5457
5458 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5459 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5460 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5461 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5462 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5463 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5464
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5465 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5466
5467 <ul class="entry_type_enum">
5468 <li>
5469 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5470 <span class="entry_type_enum_notes"><p>No geometric correction is
5471applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5472 </li>
5473 <li>
5474 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5475 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
5476bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5477 </li>
5478 <li>
5479 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5480 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5481quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5482 </li>
5483 </ul>
5484
5485 </td> <!-- entry_type -->
5486
5487 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5488 <p>Operating mode of geometric
5489correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5490 </td>
5491
5492 <td class="entry_units">
5493 </td>
5494
5495 <td class="entry_range">
5496 </td>
5497
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5498 <td class="entry_tags">
5499 </td>
5500
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5501 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5502
5503
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5504 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5505 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5506
5507
5508 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5509 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5510 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5511 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5512 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5513 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5514
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5515 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5516
5517
5518 </td> <!-- entry_type -->
5519
5520 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5521 <p>Control the amount of shading correction
5522applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5523 </td>
5524
5525 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5526 unitless: 1-10; 10 is full shading
5527 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5528 </td>
5529
5530 <td class="entry_range">
5531 </td>
5532
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5533 <td class="entry_tags">
5534 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5535 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5536 </ul>
5537 </td>
5538
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5539 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5540
5541
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5542 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5543 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5544
5545
5546
5547 <!-- end of kind -->
5548 </tbody>
5549
5550 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5551 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5552
5553
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5554 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5555
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5556 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5557 <tr>
5558 <th class="th_name">Property Name</th>
5559 <th class="th_type">Type</th>
5560 <th class="th_description">Description</th>
5561 <th class="th_units">Units</th>
5562 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5563 <th class="th_tags">Tags</th>
5564 </tr>
5565 </thead>
5566
5567 <tbody>
5568
5569
5570
5571
5572
5573
5574
5575
5576
5577
5578 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5579 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5580 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5581 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5582 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5583 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5584
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5585 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5586
5587 <ul class="entry_type_enum">
5588 <li>
5589 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5590 <span class="entry_type_enum_notes"><p>No hot pixel correction can be
5591applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5592 </li>
5593 <li>
5594 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5595 <span class="entry_type_enum_notes"><p>Frame rate must not be reduced compared to raw
5596Bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5597 </li>
5598 <li>
5599 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5600 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5601quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5602 </li>
5603 </ul>
5604
5605 </td> <!-- entry_type -->
5606
5607 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5608 <p>Set operational mode for hot pixel
5609correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5610 </td>
5611
5612 <td class="entry_units">
5613 </td>
5614
5615 <td class="entry_range">
5616 </td>
5617
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5618 <td class="entry_tags">
5619 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5620 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5621 </ul>
5622 </td>
5623
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5624 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5625
5626
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5627 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5628 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5629
5630
5631
5632 <!-- end of kind -->
5633 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5634 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5635
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5636 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5637 <tr>
5638 <th class="th_name">Property Name</th>
5639 <th class="th_type">Type</th>
5640 <th class="th_description">Description</th>
5641 <th class="th_units">Units</th>
5642 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5643 <th class="th_tags">Tags</th>
5644 </tr>
5645 </thead>
5646
5647 <tbody>
5648
5649
5650
5651
5652
5653
5654
5655
5656
5657
5658
5659
5660 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5661 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5662 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5663 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5664 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5665 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5666 <span class="entry_type_container">x</span>
5667
5668 <span class="entry_type_array">
5669 2 x n
5670 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5671 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5672 <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]5673
5674
5675 </td> <!-- entry_type -->
5676
5677 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5678 <p>Location of hot/<wbr/>defective pixels on
5679sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5680 </td>
5681
5682 <td class="entry_units">
5683 </td>
5684
5685 <td class="entry_range">
5686 </td>
5687
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5688 <td class="entry_tags">
5689 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5690 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5691 </ul>
5692 </td>
5693
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5694 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5695
5696
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5697 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5698 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5699
5700
5701
5702
5703
5704
5705 <!-- end of kind -->
5706 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5707 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5708
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5709 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5710 <tr>
5711 <th class="th_name">Property Name</th>
5712 <th class="th_type">Type</th>
5713 <th class="th_description">Description</th>
5714 <th class="th_units">Units</th>
5715 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5716 <th class="th_tags">Tags</th>
5717 </tr>
5718 </thead>
5719
5720 <tbody>
5721
5722
5723
5724
5725
5726
5727
5728
5729
5730
5731 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5732 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5733 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5734 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5735 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5736 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5737
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5738 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5739
5740 <ul class="entry_type_enum">
5741 <li>
5742 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5743 <span class="entry_type_enum_notes"><p>No hot pixel correction can be
5744applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5745 </li>
5746 <li>
5747 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5748 <span class="entry_type_enum_notes"><p>Frame rate must not be reduced compared to raw
5749Bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5750 </li>
5751 <li>
5752 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5753 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5754quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5755 </li>
5756 </ul>
5757
5758 </td> <!-- entry_type -->
5759
5760 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5761 <p>Set operational mode for hot pixel
5762correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5763 </td>
5764
5765 <td class="entry_units">
5766 </td>
5767
5768 <td class="entry_range">
5769 </td>
5770
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5771 <td class="entry_tags">
5772 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5773 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5774 </ul>
5775 </td>
5776
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5777 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5778
5779
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5780 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5781 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5782
5783
5784
5785 <!-- end of kind -->
5786 </tbody>
5787
5788 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5789 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5790
5791
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5792 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5793
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5794 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5795 <tr>
5796 <th class="th_name">Property Name</th>
5797 <th class="th_type">Type</th>
5798 <th class="th_description">Description</th>
5799 <th class="th_units">Units</th>
5800 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5801 <th class="th_tags">Tags</th>
5802 </tr>
5803 </thead>
5804
5805 <tbody>
5806
5807
5808
5809
5810
5811
5812
5813
5814
5815
5816 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5817 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5818 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5819 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5820 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5821 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5822 <span class="entry_type_container">x</span>
5823
5824 <span class="entry_type_array">
5825 3
5826 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5827 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5828 <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]5829
5830
5831 </td> <!-- entry_type -->
5832
5833 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5834 <p>GPS coordinates to include in output JPEG
5835EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5836 </td>
5837
5838 <td class="entry_units">
5839 </td>
5840
5841 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5842 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5843 </td>
5844
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5845 <td class="entry_tags">
5846 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5847 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5848 </ul>
5849 </td>
5850
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5851 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5852
5853
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5854 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5855 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5856
5857
5858 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5859 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5860 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5861 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5862 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5863 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5864
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5865 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5866
5867
5868 </td> <!-- entry_type -->
5869
5870 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5871 <p>32 characters describing GPS algorithm to
5872include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5873 </td>
5874
5875 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5876 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5877 </td>
5878
5879 <td class="entry_range">
5880 </td>
5881
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5882 <td class="entry_tags">
5883 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5884 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5885 </ul>
5886 </td>
5887
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5888 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5889
5890
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5891 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5892 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5893
5894
5895 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5896 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5897 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5898 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5899 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5900 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5901
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5902 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5903
5904
5905 </td> <!-- entry_type -->
5906
5907 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5908 <p>Time GPS fix was made to include in
5909EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5910 </td>
5911
5912 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5913 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5914 </td>
5915
5916 <td class="entry_range">
5917 </td>
5918
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5919 <td class="entry_tags">
5920 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5921 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5922 </ul>
5923 </td>
5924
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5925 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5926
5927
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5928 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5929 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5930
5931
5932 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5933 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5934 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5935 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5936 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5937 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5938
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5939 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5940
5941
5942 </td> <!-- entry_type -->
5943
5944 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5945 <p>Orientation of JPEG image to
5946write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5947 </td>
5948
5949 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5950 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5951 </td>
5952
5953 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5954 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5955 </td>
5956
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5957 <td class="entry_tags">
5958 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5959 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5960 </ul>
5961 </td>
5962
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5963 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5964
5965
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5966 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5967 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5968
5969
5970 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5971 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5972 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5973 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5974 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5975 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5976
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5977 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5978
5979
5980 </td> <!-- entry_type -->
5981
5982 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5983 <p>Compression quality of the final JPEG
5984image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5985 </td>
5986
5987 <td class="entry_units">
5988 </td>
5989
5990 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5991 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5992 </td>
5993
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5994 <td class="entry_tags">
5995 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5996 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5997 </ul>
5998 </td>
5999
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6000 </tr>
6001 <tr class="entries_header">
6002 <th class="th_details" colspan="5">Details</th>
6003 </tr>
6004 <tr class="entry_cont">
6005 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6006 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6007 </td>
6008 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6009
6010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6011 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6012 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6013
6014
6015 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6016 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6017 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6018 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6019 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6020 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6021
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6022 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6023
6024
6025 </td> <!-- entry_type -->
6026
6027 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6028 <p>Compression quality of JPEG
6029thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6030 </td>
6031
6032 <td class="entry_units">
6033 </td>
6034
6035 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6036 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6037 </td>
6038
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6039 <td class="entry_tags">
6040 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6041 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6042 </ul>
6043 </td>
6044
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6045 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6046
6047
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6048 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6049 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6050
6051
6052 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6053 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6054 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6055 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6056 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6057 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6058 <span class="entry_type_container">x</span>
6059
6060 <span class="entry_type_array">
6061 2
6062 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6063 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6064
6065
6066 </td> <!-- entry_type -->
6067
6068 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6069 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6070 </td>
6071
6072 <td class="entry_units">
6073 </td>
6074
6075 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6076 <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]6077 </td>
6078
6079 <td class="entry_tags">
6080 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6081 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6082 </ul>
6083 </td>
6084
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6085 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6086 <tr class="entries_header">
6087 <th class="th_details" colspan="5">Details</th>
6088 </tr>
6089 <tr class="entry_cont">
6090 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6091 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF will not contain thumbnail,<wbr/>
6092but the captured JPEG will still be a valid image.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6093<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6094the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6095 </td>
6096 </tr>
6097
6098
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6099 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6100 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6101
6102
6103
6104 <!-- end of kind -->
6105 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6106 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6107
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6108 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6109 <tr>
6110 <th class="th_name">Property Name</th>
6111 <th class="th_type">Type</th>
6112 <th class="th_description">Description</th>
6113 <th class="th_units">Units</th>
6114 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6115 <th class="th_tags">Tags</th>
6116 </tr>
6117 </thead>
6118
6119 <tbody>
6120
6121
6122
6123
6124
6125
6126
6127
6128
6129
6130 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6131 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6132 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6133 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6134 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6135 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6136 <span class="entry_type_container">x</span>
6137
6138 <span class="entry_type_array">
6139 2 x n
6140 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6141 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6142
6143
6144 </td> <!-- entry_type -->
6145
6146 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6147 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6148 </td>
6149
6150 <td class="entry_units">
6151 </td>
6152
6153 <td class="entry_range">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6154 <p>Will include at least one valid resolution,<wbr/> plus
6155(0,<wbr/>0) for no thumbnail generation,<wbr/> and each size will be distinct.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6156 </td>
6157
6158 <td class="entry_tags">
6159 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6160 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6161 </ul>
6162 </td>
6163
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6164 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6165 <tr class="entries_header">
6166 <th class="th_details" colspan="5">Details</th>
6167 </tr>
6168 <tr class="entry_cont">
6169 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6170 <p>Below condiditions will be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6171<ul>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6172<li>The sizes will be sorted by increasing pixel area (width x height).<wbr/>
6173If several resolutions have the same area,<wbr/> they will be sorted by increasing width.<wbr/></li>
6174<li>The aspect ratio of the largest thumbnail size will be same as the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6175aspect 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]6176The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6177in a given size list.<wbr/></li>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6178<li>Each size in <a href="#static_android.scaler.availableJpegSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes</a> will have at least
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6179one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
6180and vice versa.<wbr/></li>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6181<li>All non (0,<wbr/> 0) sizes will have non-zero widths and heights.<wbr/></li>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6182</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6183 </td>
6184 </tr>
6185
6186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6187 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6188 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6189
6190
6191 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6192 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6193 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6194 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6195 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6196 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6197
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6198 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6199
6200
6201 </td> <!-- entry_type -->
6202
6203 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6204 <p>Maximum size in bytes for the compressed
6205JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6206 </td>
6207
6208 <td class="entry_units">
6209 </td>
6210
6211 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6212 <p>Must be large enough to fit any JPEG produced by
6213the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6214 </td>
6215
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6216 <td class="entry_tags">
6217 </td>
6218
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6219 </tr>
6220 <tr class="entries_header">
6221 <th class="th_details" colspan="5">Details</th>
6222 </tr>
6223 <tr class="entry_cont">
6224 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6225 <p>This is used for sizing the gralloc buffers for
6226JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6227 </td>
6228 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6229
6230
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6231 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6232 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6233
6234
6235
6236 <!-- end of kind -->
6237 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6238 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6239
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6240 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6241 <tr>
6242 <th class="th_name">Property Name</th>
6243 <th class="th_type">Type</th>
6244 <th class="th_description">Description</th>
6245 <th class="th_units">Units</th>
6246 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6247 <th class="th_tags">Tags</th>
6248 </tr>
6249 </thead>
6250
6251 <tbody>
6252
6253
6254
6255
6256
6257
6258
6259
6260
6261
6262 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6263 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6264 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6265 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6266 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6267 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6268 <span class="entry_type_container">x</span>
6269
6270 <span class="entry_type_array">
6271 3
6272 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6273 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6274 <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]6275
6276
6277 </td> <!-- entry_type -->
6278
6279 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6280 <p>GPS coordinates to include in output JPEG
6281EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6282 </td>
6283
6284 <td class="entry_units">
6285 </td>
6286
6287 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6288 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6289 </td>
6290
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6291 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6292 <ul class="entry_tags">
6293 <li><a href="#tag_BC">BC</a></li>
6294 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6295 </td>
6296
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6297 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6298
6299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6300 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6301 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6302
6303
6304 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6305 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6306 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6307 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6308 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6309 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6310
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6311 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6312
6313
6314 </td> <!-- entry_type -->
6315
6316 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6317 <p>32 characters describing GPS algorithm to
6318include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6319 </td>
6320
6321 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6322 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6323 </td>
6324
6325 <td class="entry_range">
6326 </td>
6327
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6328 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6329 <ul class="entry_tags">
6330 <li><a href="#tag_BC">BC</a></li>
6331 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6332 </td>
6333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6334 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6335
6336
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6337 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6338 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6339
6340
6341 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6342 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6343 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6344 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6345 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6346 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6347
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6348 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6349
6350
6351 </td> <!-- entry_type -->
6352
6353 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6354 <p>Time GPS fix was made to include in
6355EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6356 </td>
6357
6358 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6359 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6360 </td>
6361
6362 <td class="entry_range">
6363 </td>
6364
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6365 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6366 <ul class="entry_tags">
6367 <li><a href="#tag_BC">BC</a></li>
6368 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6369 </td>
6370
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6371 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6372
6373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6374 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6375 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6376
6377
6378 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6379 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6380 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6381 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6382 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6383 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6384
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6385 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6386
6387
6388 </td> <!-- entry_type -->
6389
6390 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6391 <p>Orientation of JPEG image to
6392write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6393 </td>
6394
6395 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6396 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6397 </td>
6398
6399 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6400 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6401 </td>
6402
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6403 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6404 <ul class="entry_tags">
6405 <li><a href="#tag_BC">BC</a></li>
6406 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6407 </td>
6408
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6409 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6410
6411
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6412 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6413 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6414
6415
6416 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6417 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6418 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6419 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6420 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6421 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6422
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6423 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6424
6425
6426 </td> <!-- entry_type -->
6427
6428 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6429 <p>Compression quality of the final JPEG
6430image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6431 </td>
6432
6433 <td class="entry_units">
6434 </td>
6435
6436 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6437 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6438 </td>
6439
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6440 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6441 <ul class="entry_tags">
6442 <li><a href="#tag_BC">BC</a></li>
6443 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6444 </td>
6445
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6446 </tr>
6447 <tr class="entries_header">
6448 <th class="th_details" colspan="5">Details</th>
6449 </tr>
6450 <tr class="entry_cont">
6451 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6452 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6453 </td>
6454 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6455
6456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6457 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6458 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6459
6460
6461 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6462 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6463 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6464 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6465 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6466 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6467
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6468 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6469
6470
6471 </td> <!-- entry_type -->
6472
6473 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6474 <p>The size of the compressed JPEG image,<wbr/> in
6475bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6476 </td>
6477
6478 <td class="entry_units">
6479 </td>
6480
6481 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6482 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6483 </td>
6484
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6485 <td class="entry_tags">
6486 </td>
6487
6488 </tr>
6489 <tr class="entries_header">
6490 <th class="th_details" colspan="5">Details</th>
6491 </tr>
6492 <tr class="entry_cont">
6493 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6494 <p>If no JPEG output is produced for the request,<wbr/>
6495this must be 0.<wbr/></p>
6496<p>Otherwise,<wbr/> this describes the real size of the compressed
6497JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6498if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
6499has <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]6500the JPEG stream will be 1000000 bytes,<wbr/> of which the first
6501500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6502 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6503 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6504
6505
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6506 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6507 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6508
6509
6510 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6511 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6512 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6513 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6514 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6515 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6516
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6517 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6518
6519
6520 </td> <!-- entry_type -->
6521
6522 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6523 <p>Compression quality of JPEG
6524thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6525 </td>
6526
6527 <td class="entry_units">
6528 </td>
6529
6530 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6531 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6532 </td>
6533
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6534 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6535 <ul class="entry_tags">
6536 <li><a href="#tag_BC">BC</a></li>
6537 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6538 </td>
6539
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6540 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6541
6542
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6543 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6544 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6545
6546
6547 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6548 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6549 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6550 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6551 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6552 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6553 <span class="entry_type_container">x</span>
6554
6555 <span class="entry_type_array">
6556 2
6557 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6558 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6559
6560
6561 </td> <!-- entry_type -->
6562
6563 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6564 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6565 </td>
6566
6567 <td class="entry_units">
6568 </td>
6569
6570 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6571 <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]6572 </td>
6573
6574 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6575 <ul class="entry_tags">
6576 <li><a href="#tag_BC">BC</a></li>
6577 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6578 </td>
6579
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6580 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6581 <tr class="entries_header">
6582 <th class="th_details" colspan="5">Details</th>
6583 </tr>
6584 <tr class="entry_cont">
6585 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6586 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF will not contain thumbnail,<wbr/>
6587but the captured JPEG will still be a valid image.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6588<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6589the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6590 </td>
6591 </tr>
6592
6593
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6594 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6595 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6596
6597
6598
6599 <!-- end of kind -->
6600 </tbody>
6601
6602 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6603 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6604
6605
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6606 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6607
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6608 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6609 <tr>
6610 <th class="th_name">Property Name</th>
6611 <th class="th_type">Type</th>
6612 <th class="th_description">Description</th>
6613 <th class="th_units">Units</th>
6614 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6615 <th class="th_tags">Tags</th>
6616 </tr>
6617 </thead>
6618
6619 <tbody>
6620
6621
6622
6623
6624
6625
6626
6627
6628
6629
6630 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6631 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6632 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6633 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6634 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6635 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6636
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6637 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6638
6639
6640 </td> <!-- entry_type -->
6641
6642 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6643 <p>The ratio of lens focal length to the effective
6644aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6645 </td>
6646
6647 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6648 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6649 </td>
6650
6651 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6652 <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]6653 </td>
6654
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6655 <td class="entry_tags">
6656 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6657 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6658 </ul>
6659 </td>
6660
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6661 </tr>
6662 <tr class="entries_header">
6663 <th class="th_details" colspan="5">Details</th>
6664 </tr>
6665 <tr class="entry_cont">
6666 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6667 <p>This will only be supported on the camera devices that
6668have variable aperture lens.<wbr/> The aperture value can only be
6669one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
6670<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
6671this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
6672<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
6673to achieve manual exposure control.<wbr/></p>
6674<p>The requested aperture value may take several frames to reach the
6675requested value; the camera device will report the current (intermediate)
6676aperture size in capture result metadata while the aperture is changing.<wbr/></p>
6677<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
6678the ON modes,<wbr/> this will be overridden by the camera device
6679auto-exposure algorithm,<wbr/> the overridden values are then provided
6680back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6681 </td>
6682 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6683
6684
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6685 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6686 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6687
6688
6689 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6690 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6691 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6692 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6693 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6694 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6695
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6696 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6697
6698
6699 </td> <!-- entry_type -->
6700
6701 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6702 <p>State of lens neutral density
6703filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6704 </td>
6705
6706 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6707 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6708 </td>
6709
6710 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6711 <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]6712 </td>
6713
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6714 <td class="entry_tags">
6715 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6716 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6717 </ul>
6718 </td>
6719
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6720 </tr>
6721 <tr class="entries_header">
6722 <th class="th_details" colspan="5">Details</th>
6723 </tr>
6724 <tr class="entry_cont">
6725 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6726 <p>Will not be supported on most devices.<wbr/> Can only
6727pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6728 </td>
6729 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6730
6731
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6732 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6733 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6734
6735
6736 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6737 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6738 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6739 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6740 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6741 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6742
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6743 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6744
6745
6746 </td> <!-- entry_type -->
6747
6748 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6749 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6750 </td>
6751
6752 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6753 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6754 </td>
6755
6756 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6757 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6758 </td>
6759
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6760 <td class="entry_tags">
6761 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6762 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6763 </ul>
6764 </td>
6765
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6766 </tr>
6767 <tr class="entries_header">
6768 <th class="th_details" colspan="5">Details</th>
6769 </tr>
6770 <tr class="entry_cont">
6771 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6772 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6773 </td>
6774 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6775
6776
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6777 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6778 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6779
6780
6781 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6782 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6783 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6784 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6785 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6786 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6787
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6788 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6789
6790
6791 </td> <!-- entry_type -->
6792
6793 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6794 <p>Distance to plane of sharpest focus,<wbr/>
6795measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6796 </td>
6797
6798 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6799 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6800 </td>
6801
6802 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6803 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6804 </td>
6805
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6806 <td class="entry_tags">
6807 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6808 <li><a href="#tag_BC">BC</a></li>
6809 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6810 </ul>
6811 </td>
6812
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6813 </tr>
6814 <tr class="entries_header">
6815 <th class="th_details" colspan="5">Details</th>
6816 </tr>
6817 <tr class="entry_cont">
6818 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6819 <p>0 = infinity focus.<wbr/> Used value should be clamped
6820to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6821 </td>
6822 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6823
6824
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6825 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6826 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6827
6828
6829 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6830 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6831 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6832 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6833 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6834 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6835
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6836 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6837
6838 <ul class="entry_type_enum">
6839 <li>
6840 <span class="entry_type_enum_name">OFF</span>
6841 </li>
6842 <li>
6843 <span class="entry_type_enum_name">ON</span>
6844 <span class="entry_type_enum_optional">optional</span>
6845 </li>
6846 </ul>
6847
6848 </td> <!-- entry_type -->
6849
6850 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6851 <p>Whether optical image stabilization is
6852enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6853 </td>
6854
6855 <td class="entry_units">
6856 </td>
6857
6858 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6859 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6860 </td>
6861
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6862 <td class="entry_tags">
6863 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6864 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6865 </ul>
6866 </td>
6867
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6868 </tr>
6869 <tr class="entries_header">
6870 <th class="th_details" colspan="5">Details</th>
6871 </tr>
6872 <tr class="entry_cont">
6873 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6874 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6875 </td>
6876 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6877
6878
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6879 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6880 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6881
6882
6883
6884 <!-- end of kind -->
6885 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6886 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6887
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6888 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6889 <tr>
6890 <th class="th_name">Property Name</th>
6891 <th class="th_type">Type</th>
6892 <th class="th_description">Description</th>
6893 <th class="th_units">Units</th>
6894 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6895 <th class="th_tags">Tags</th>
6896 </tr>
6897 </thead>
6898
6899 <tbody>
6900
6901
6902
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6913 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6914 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6915 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6916 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6917 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6918 <span class="entry_type_container">x</span>
6919
6920 <span class="entry_type_array">
6921 n
6922 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6923 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6924
6925
6926 </td> <!-- entry_type -->
6927
6928 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6929 <p>List of supported aperture
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6930values.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6931 </td>
6932
6933 <td class="entry_units">
6934 </td>
6935
6936 <td class="entry_range">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6937 <p>one entry required,<wbr/> &amp;&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6938 </td>
6939
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6940 <td class="entry_tags">
6941 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6942 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6943 </ul>
6944 </td>
6945
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6946 </tr>
6947 <tr class="entries_header">
6948 <th class="th_details" colspan="5">Details</th>
6949 </tr>
6950 <tr class="entry_cont">
6951 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6952 <p>If the camera device doesn't support variable apertures,<wbr/>
6953listed value will be the fixed aperture.<wbr/></p>
6954<p>If the camera device supports variable apertures,<wbr/> the aperture value
6955in this list will be sorted in ascending order.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6956 </td>
6957 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6958
6959
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6960 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6961 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6962
6963
6964 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6965 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6966 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6967 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6968 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6969 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6970 <span class="entry_type_container">x</span>
6971
6972 <span class="entry_type_array">
6973 n
6974 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6975 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6976
6977
6978 </td> <!-- entry_type -->
6979
6980 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6981 <p>List of supported ND filter
6982values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6983 </td>
6984
6985 <td class="entry_units">
6986 </td>
6987
6988 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6989 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6990 </td>
6991
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6992 <td class="entry_tags">
6993 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6994 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6995 </ul>
6996 </td>
6997
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6998 </tr>
6999 <tr class="entries_header">
7000 <th class="th_details" colspan="5">Details</th>
7001 </tr>
7002 <tr class="entry_cont">
7003 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7004 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7005lists the available exposure index values for dimming
7006(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7007light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7008 </td>
7009 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7010
7011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7012 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7013 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7014
7015
7016 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7017 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7018 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7019 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7020 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7021 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7022 <span class="entry_type_container">x</span>
7023
7024 <span class="entry_type_array">
7025 n
7026 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7027 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7028 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7029
7030
7031 </td> <!-- entry_type -->
7032
7033 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7034 <p>If fitted with optical zoom,<wbr/> what focal
7035lengths are available.<wbr/> If not,<wbr/> the static focal
7036length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7037 </td>
7038
7039 <td class="entry_units">
7040 </td>
7041
7042 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7043 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7044 </td>
7045
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7046 <td class="entry_tags">
7047 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7048 <li><a href="#tag_BC">BC</a></li>
7049 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7050 </ul>
7051 </td>
7052
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7053 </tr>
7054 <tr class="entries_header">
7055 <th class="th_details" colspan="5">Details</th>
7056 </tr>
7057 <tr class="entry_cont">
7058 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7059 <p>If optical zoom not supported,<wbr/> only one value
7060should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7061 </td>
7062 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7063
7064
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7065 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7066 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7067
7068
7069 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7070 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7071 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7072 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7073 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7074 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7075 <span class="entry_type_container">x</span>
7076
7077 <span class="entry_type_array">
7078 n
7079 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7080 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7081 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7082
7083
7084 </td> <!-- entry_type -->
7085
7086 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7087 <p>List of supported optical image
7088stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7089 </td>
7090
7091 <td class="entry_units">
7092 </td>
7093
7094 <td class="entry_range">
7095 </td>
7096
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7097 <td class="entry_tags">
7098 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7099 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7100 </ul>
7101 </td>
7102
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7103 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7104
7105
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7106 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7107 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7108
7109
7110 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7111 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7112 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7113 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7114 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7115 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7116 <span class="entry_type_container">x</span>
7117
7118 <span class="entry_type_array">
7119 2 x 3 x n x m
7120 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7121 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7122 <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]7123
7124
7125 </td> <!-- entry_type -->
7126
7127 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7128 <p>A low-resolution map for correction of
7129geometric distortions and chromatic aberrations,<wbr/> per
7130color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7131 </td>
7132
7133 <td class="entry_units">
7134 </td>
7135
7136 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7137 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7138 </td>
7139
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7140 <td class="entry_tags">
7141 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7142 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7143 </ul>
7144 </td>
7145
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7146 </tr>
7147 <tr class="entries_header">
7148 <th class="th_details" colspan="5">Details</th>
7149 </tr>
7150 <tr class="entry_cont">
7151 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7152 <p>[DNG wants a function instead].<wbr/> What's easiest
7153for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
7154j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
7155j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
7156entry 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]7157 </td>
7158 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7159
7160
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7161 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7162 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7163
7164
7165 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7166 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7167 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7168 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7169 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7170 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7171 <span class="entry_type_container">x</span>
7172
7173 <span class="entry_type_array">
7174 2
7175 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7176 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7177 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7178
7179
7180 </td> <!-- entry_type -->
7181
7182 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7183 <p>Dimensions of geometric correction
7184map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7185 </td>
7186
7187 <td class="entry_units">
7188 </td>
7189
7190 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7191 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7192 </td>
7193
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7194 <td class="entry_tags">
7195 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7196 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7197 </ul>
7198 </td>
7199
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7200 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7201
7202
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7203 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7204 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7205
7206
7207 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7208 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7209 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7210 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7211 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7212 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7213
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7214 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7215
7216
7217 </td> <!-- entry_type -->
7218
7219 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7220 <p>Hyperfocal distance for this lens; set to
72210 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7222 </td>
7223
7224 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7225 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7226 </td>
7227
7228 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7229 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7230 </td>
7231
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7232 <td class="entry_tags">
7233 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7234 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7235 </ul>
7236 </td>
7237
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7238 </tr>
7239 <tr class="entries_header">
7240 <th class="th_details" colspan="5">Details</th>
7241 </tr>
7242 <tr class="entry_cont">
7243 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7244 <p>The hyperfocal distance is used for the old
7245API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7246 </td>
7247 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7248
7249
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7250 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7251 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7252
7253
7254 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7255 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7256 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7257 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7258 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7259 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7260
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7261 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7262
7263
7264 </td> <!-- entry_type -->
7265
7266 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7267 <p>Shortest distance from frontmost surface
7268of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7269 </td>
7270
7271 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7272 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7273 </td>
7274
7275 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7276 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7277 </td>
7278
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7279 <td class="entry_tags">
7280 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7281 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7282 </ul>
7283 </td>
7284
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7285 </tr>
7286 <tr class="entries_header">
7287 <th class="th_details" colspan="5">Details</th>
7288 </tr>
7289 <tr class="entry_cont">
7290 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7291 <p>If the lens is fixed-focus,<wbr/> this should be
72920</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7293 </td>
7294 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7295
7296
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7297 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7298 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7299
7300
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7301 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7302 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7303 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7304 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7305 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7306 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7307 <span class="entry_type_container">x</span>
7308
7309 <span class="entry_type_array">
7310 2
7311 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7312 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7313 <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]7314
7315
7316 </td> <!-- entry_type -->
7317
7318 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7319 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7320 </td>
7321
7322 <td class="entry_units">
7323 </td>
7324
7325 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7326 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7327 </td>
7328
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7329 <td class="entry_tags">
7330 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7331 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7332 </ul>
7333 </td>
7334
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7335 </tr>
7336 <tr class="entries_header">
7337 <th class="th_details" colspan="5">Details</th>
7338 </tr>
7339 <tr class="entry_cont">
7340 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7341 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
7342must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7343 </td>
7344 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7345
7346
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7347 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7348 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7349
7350
7351
7352
7353
7354 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7355 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7356 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7357 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7358 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7359 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7360
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7361 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7362
7363 <ul class="entry_type_enum">
7364 <li>
7365 <span class="entry_type_enum_name">FRONT</span>
7366 </li>
7367 <li>
7368 <span class="entry_type_enum_name">BACK</span>
7369 </li>
7370 </ul>
7371
7372 </td> <!-- entry_type -->
7373
7374 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7375 <p>Direction the camera faces relative to
7376device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7377 </td>
7378
7379 <td class="entry_units">
7380 </td>
7381
7382 <td class="entry_range">
7383 </td>
7384
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7385 <td class="entry_tags">
7386 </td>
7387
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7388 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7389
7390
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7391 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7392 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7393
7394
7395 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7396 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7397 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7398 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7399 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7400 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7401 <span class="entry_type_container">x</span>
7402
7403 <span class="entry_type_array">
7404 2
7405 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7406 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7407 <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]7408
7409
7410 </td> <!-- entry_type -->
7411
7412 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7413 <p>Relative angle of camera optical axis to the
7414perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7415 </td>
7416
7417 <td class="entry_units">
7418 </td>
7419
7420 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7421 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7422 </td>
7423
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7424 <td class="entry_tags">
7425 <ul class="entry_tags">
7426 <li><a href="#tag_ADV">ADV</a></li>
7427 </ul>
7428 </td>
7429
7430 </tr>
7431 <tr class="entries_header">
7432 <th class="th_details" colspan="5">Details</th>
7433 </tr>
7434 <tr class="entry_cont">
7435 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7436 <p>Examples:</p>
7437<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7438is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7439<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7440device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7441<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
7442the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7443<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7444direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7445 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7446 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7447
7448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7449 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7450 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7451
7452
7453 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7454 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7455 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7456 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7457 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7458 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7459 <span class="entry_type_container">x</span>
7460
7461 <span class="entry_type_array">
7462 3, location in mm, in the sensor coordinate
7463 system
7464 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7465 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7466
7467
7468 </td> <!-- entry_type -->
7469
7470 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7471 <p>Coordinates of camera optical axis on
7472device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7473 </td>
7474
7475 <td class="entry_units">
7476 </td>
7477
7478 <td class="entry_range">
7479 </td>
7480
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7481 <td class="entry_tags">
7482 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7483 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7484 </ul>
7485 </td>
7486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7487 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7488
7489
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7490 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7491 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7492
7493
7494
7495 <!-- end of kind -->
7496 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7497 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7498
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7499 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7500 <tr>
7501 <th class="th_name">Property Name</th>
7502 <th class="th_type">Type</th>
7503 <th class="th_description">Description</th>
7504 <th class="th_units">Units</th>
7505 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7506 <th class="th_tags">Tags</th>
7507 </tr>
7508 </thead>
7509
7510 <tbody>
7511
7512
7513
7514
7515
7516
7517
7518
7519
7520
7521 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7522 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7523 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7524 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7525 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7526 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7527
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7528 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7529
7530
7531 </td> <!-- entry_type -->
7532
7533 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7534 <p>The ratio of lens focal length to the effective
7535aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7536 </td>
7537
7538 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7539 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7540 </td>
7541
7542 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7543 <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]7544 </td>
7545
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7546 <td class="entry_tags">
7547 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7548 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7549 </ul>
7550 </td>
7551
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7552 </tr>
7553 <tr class="entries_header">
7554 <th class="th_details" colspan="5">Details</th>
7555 </tr>
7556 <tr class="entry_cont">
7557 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7558 <p>This will only be supported on the camera devices that
7559have variable aperture lens.<wbr/> The aperture value can only be
7560one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
7561<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
7562this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
7563<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
7564to achieve manual exposure control.<wbr/></p>
7565<p>The requested aperture value may take several frames to reach the
7566requested value; the camera device will report the current (intermediate)
7567aperture size in capture result metadata while the aperture is changing.<wbr/></p>
7568<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
7569the ON modes,<wbr/> this will be overridden by the camera device
7570auto-exposure algorithm,<wbr/> the overridden values are then provided
7571back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7572 </td>
7573 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7574
7575
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7576 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7577 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7578
7579
7580 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7581 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7582 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7583 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7584 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7585 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7586
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7587 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7588
7589
7590 </td> <!-- entry_type -->
7591
7592 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7593 <p>State of lens neutral density
7594filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7595 </td>
7596
7597 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7598 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7599 </td>
7600
7601 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7602 <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]7603 </td>
7604
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7605 <td class="entry_tags">
7606 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7607 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7608 </ul>
7609 </td>
7610
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]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>Will not be supported on most devices.<wbr/> Can only
7618pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7619 </td>
7620 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7621
7622
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7623 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7624 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7625
7626
7627 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7628 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7629 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7630 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7631 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7632 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7633
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7634 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7635
7636
7637 </td> <!-- entry_type -->
7638
7639 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7640 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7641 </td>
7642
7643 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7644 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7645 </td>
7646
7647 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7648 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7649 </td>
7650
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7651 <td class="entry_tags">
7652 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7653 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7654 </ul>
7655 </td>
7656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7657 </tr>
7658 <tr class="entries_header">
7659 <th class="th_details" colspan="5">Details</th>
7660 </tr>
7661 <tr class="entry_cont">
7662 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7663 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7664 </td>
7665 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7666
7667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7668 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7669 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7670
7671
7672 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7673 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7674 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7675 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7676 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7677 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7678
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7679 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7680
7681
7682 </td> <!-- entry_type -->
7683
7684 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7685 <p>Distance to plane of sharpest focus,<wbr/>
7686measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7687 </td>
7688
7689 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7690 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7691 </td>
7692
7693 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7694 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7695 </td>
7696
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7697 <td class="entry_tags">
7698 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7699 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7700 </ul>
7701 </td>
7702
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7703 </tr>
7704 <tr class="entries_header">
7705 <th class="th_details" colspan="5">Details</th>
7706 </tr>
7707 <tr class="entry_cont">
7708 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7709 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7710 </td>
7711 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7712
7713
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7714 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7715 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7716
7717
7718 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7719 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7720 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7721 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7722 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7723 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7724 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7725
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7726 <span class="entry_type_array">
7727 2
7728 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7729 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7730 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7731
7732
7733 </td> <!-- entry_type -->
7734
7735 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7736 <p>The range of scene distances that are in
7737sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7738 </td>
7739
7740 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7741 pair of focus distances in diopters: (near,<wbr/>
7742 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7743 </td>
7744
7745 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7746 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7747 </td>
7748
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7749 <td class="entry_tags">
7750 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7751 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7752 </ul>
7753 </td>
7754
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7755 </tr>
7756 <tr class="entries_header">
7757 <th class="th_details" colspan="5">Details</th>
7758 </tr>
7759 <tr class="entry_cont">
7760 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7761 <p>If variable focus not supported,<wbr/> can still report
7762fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7763 </td>
7764 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7765
7766
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7767 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7768 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7769
7770
7771 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7772 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7773 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7774 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7775 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7776 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7777
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7778 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7779
7780 <ul class="entry_type_enum">
7781 <li>
7782 <span class="entry_type_enum_name">OFF</span>
7783 </li>
7784 <li>
7785 <span class="entry_type_enum_name">ON</span>
7786 <span class="entry_type_enum_optional">optional</span>
7787 </li>
7788 </ul>
7789
7790 </td> <!-- entry_type -->
7791
7792 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7793 <p>Whether optical image stabilization is
7794enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7795 </td>
7796
7797 <td class="entry_units">
7798 </td>
7799
7800 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7801 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7802 </td>
7803
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7804 <td class="entry_tags">
7805 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7806 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7807 </ul>
7808 </td>
7809
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7810 </tr>
7811 <tr class="entries_header">
7812 <th class="th_details" colspan="5">Details</th>
7813 </tr>
7814 <tr class="entry_cont">
7815 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7816 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7817 </td>
7818 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7819
7820
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7821 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7822 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7823
7824
7825 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7826 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7827 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7828 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7829 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7830 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7831
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7832 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7833
7834 <ul class="entry_type_enum">
7835 <li>
7836 <span class="entry_type_enum_name">STATIONARY</span>
7837 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7838 <li>
7839 <span class="entry_type_enum_name">MOVING</span>
7840 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7841 </ul>
7842
7843 </td> <!-- entry_type -->
7844
7845 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7846 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7847 </td>
7848
7849 <td class="entry_units">
7850 </td>
7851
7852 <td class="entry_range">
7853 </td>
7854
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7855 <td class="entry_tags">
7856 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7857 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7858 </ul>
7859 </td>
7860
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7861 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7862
7863
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7864 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7865 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7866
7867
7868
7869 <!-- end of kind -->
7870 </tbody>
7871
7872 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7873 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7874
7875
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7876 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7877
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7878 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7879 <tr>
7880 <th class="th_name">Property Name</th>
7881 <th class="th_type">Type</th>
7882 <th class="th_description">Description</th>
7883 <th class="th_units">Units</th>
7884 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7885 <th class="th_tags">Tags</th>
7886 </tr>
7887 </thead>
7888
7889 <tbody>
7890
7891
7892
7893
7894
7895
7896
7897
7898
7899
7900 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7901 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7902 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7903 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7904 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7905 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7906
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7907 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7908
7909 <ul class="entry_type_enum">
7910 <li>
7911 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7912 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7913 </li>
7914 <li>
7915 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7916 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
7917output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7918 </li>
7919 <li>
7920 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7921 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
7922quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7923 </li>
7924 </ul>
7925
7926 </td> <!-- entry_type -->
7927
7928 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7929 <p>Mode of operation for the noise reduction
7930algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7931 </td>
7932
7933 <td class="entry_units">
7934 </td>
7935
7936 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7937 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7938 </td>
7939
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7940 <td class="entry_tags">
7941 <ul class="entry_tags">
7942 <li><a href="#tag_V1">V1</a></li>
7943 </ul>
7944 </td>
7945
7946 </tr>
7947 <tr class="entries_header">
7948 <th class="th_details" colspan="5">Details</th>
7949 </tr>
7950 <tr class="entry_cont">
7951 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7952 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7953will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]7954<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
7955will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
7956will use the highest-quality noise filtering algorithms,<wbr/>
7957even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7958slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7959 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7960 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7961
7962
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7963 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7964 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7965
7966
7967 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7968 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7969 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7970 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7971 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7972 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7973
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7974 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7975
7976
7977 </td> <!-- entry_type -->
7978
7979 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7980 <p>Control the amount of noise reduction
7981applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7982 </td>
7983
7984 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7985 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7986 </td>
7987
7988 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7989 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7990 </td>
7991
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7992 <td class="entry_tags">
7993 </td>
7994
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7995 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7996
7997
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7998 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7999 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8000
8001
8002
8003 <!-- end of kind -->
8004 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8005 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8006
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8007 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8008 <tr>
8009 <th class="th_name">Property Name</th>
8010 <th class="th_type">Type</th>
8011 <th class="th_description">Description</th>
8012 <th class="th_units">Units</th>
8013 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8014 <th class="th_tags">Tags</th>
8015 </tr>
8016 </thead>
8017
8018 <tbody>
8019
8020
8021
8022
8023
8024
8025
8026
8027
8028
8029 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8030 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8031 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8032 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8033 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8034 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8035
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8036 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8037
8038 <ul class="entry_type_enum">
8039 <li>
8040 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8041 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8042 </li>
8043 <li>
8044 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8045 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
8046output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8047 </li>
8048 <li>
8049 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8050 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
8051quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8052 </li>
8053 </ul>
8054
8055 </td> <!-- entry_type -->
8056
8057 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8058 <p>Mode of operation for the noise reduction
8059algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8060 </td>
8061
8062 <td class="entry_units">
8063 </td>
8064
8065 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8066 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8067 </td>
8068
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8069 <td class="entry_tags">
8070 <ul class="entry_tags">
8071 <li><a href="#tag_V1">V1</a></li>
8072 </ul>
8073 </td>
8074
8075 </tr>
8076 <tr class="entries_header">
8077 <th class="th_details" colspan="5">Details</th>
8078 </tr>
8079 <tr class="entry_cont">
8080 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8081 <p>Noise filtering control.<wbr/> OFF means no noise reduction
8082will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]8083<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
8084will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
8085will use the highest-quality noise filtering algorithms,<wbr/>
8086even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8087slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8088 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8089 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8090
8091
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8092 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8093 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8094
8095
8096
8097 <!-- end of kind -->
8098 </tbody>
8099
8100 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8101 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8102
8103
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8104 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8105
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8106 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8107 <tr>
8108 <th class="th_name">Property Name</th>
8109 <th class="th_type">Type</th>
8110 <th class="th_description">Description</th>
8111 <th class="th_units">Units</th>
8112 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8113 <th class="th_tags">Tags</th>
8114 </tr>
8115 </thead>
8116
8117 <tbody>
8118
8119
8120
8121
8122
8123
8124
8125
8126
8127
8128 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8129 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8130 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8131 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8132 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8133 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8134
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8135 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8136
8137
8138 </td> <!-- entry_type -->
8139
8140 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8141 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8142scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8143region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
8144and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8145 </td>
8146
8147 <td class="entry_units">
8148 </td>
8149
8150 <td class="entry_range">
8151 </td>
8152
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8153 <td class="entry_tags">
8154 </td>
8155
8156 </tr>
8157 <tr class="entries_header">
8158 <th class="th_details" colspan="5">Details</th>
8159 </tr>
8160 <tr class="entry_cont">
8161 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8162 <p>Normalized coordinates refer to those in the
8163(-1000,<wbr/>1000) range mentioned in the
8164android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8165<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8166sensor array-relative coordinates for all region data.<wbr/> Does
8167not need to be listed in static metadata.<wbr/> Support will be
8168removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8169 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8170 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8171
8172
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8173 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8174 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8175
8176
8177 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8178 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8179 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8180 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8181 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8182 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8183
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8184 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8185
8186
8187 </td> <!-- entry_type -->
8188
8189 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8190 <p>If set to 1,<wbr/> then the camera service always
8191switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
8192trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8193 </td>
8194
8195 <td class="entry_units">
8196 </td>
8197
8198 <td class="entry_range">
8199 </td>
8200
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8201 <td class="entry_tags">
8202 </td>
8203
8204 </tr>
8205 <tr class="entries_header">
8206 <th class="th_details" colspan="5">Details</th>
8207 </tr>
8208 <tr class="entry_cont">
8209 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8210 <p>HAL implementations should implement AF trigger
8211modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
8212CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
8213not need to be listed in static metadata.<wbr/> Support will be
8214removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8215 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8216 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8217
8218
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8219 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8220 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8221
8222
8223 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8224 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8225 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8226 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8227 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8228 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8229
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>If set to 1,<wbr/> the camera service uses
8237CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
8238HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
8239shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8240 </td>
8241
8242 <td class="entry_units">
8243 </td>
8244
8245 <td class="entry_range">
8246 </td>
8247
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8248 <td class="entry_tags">
8249 </td>
8250
8251 </tr>
8252 <tr class="entries_header">
8253 <th class="th_details" colspan="5">Details</th>
8254 </tr>
8255 <tr class="entry_cont">
8256 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8257 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8258to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8259zero-shutter-lag,<wbr/> instead of relying on an explicit
8260format setting.<wbr/> Does not need to be listed in static
8261metadata.<wbr/> Support will be removed in future versions of
8262camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8263 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8264 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8265
8266
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8267 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8268 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8269
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8270
8271 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8272 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8273 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8274 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8275 <td class="entry_type">
8276 <span class="entry_type_name">byte</span>
8277
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]8278 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8279
8280
8281 </td> <!-- entry_type -->
8282
8283 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8284 <p>If set to 1,<wbr/> the HAL will always split result
8285metadata for a single capture into multiple buffers,<wbr/>
8286returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8287 </td>
8288
8289 <td class="entry_units">
8290 </td>
8291
8292 <td class="entry_range">
8293 </td>
8294
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8295 <td class="entry_tags">
8296 </td>
8297
8298 </tr>
8299 <tr class="entries_header">
8300 <th class="th_details" colspan="5">Details</th>
8301 </tr>
8302 <tr class="entry_cont">
8303 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8304 <p>Does not need to be listed in static
8305metadata.<wbr/> Support for partial results will be reworked in
8306future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8307working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8308consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8309 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8310 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8311
8312
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8313 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8314 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8315
8316
8317
8318 <!-- end of kind -->
8319 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8320 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8321
8322 <thead class="entries_header">
8323 <tr>
8324 <th class="th_name">Property Name</th>
8325 <th class="th_type">Type</th>
8326 <th class="th_description">Description</th>
8327 <th class="th_units">Units</th>
8328 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8329 <th class="th_tags">Tags</th>
8330 </tr>
8331 </thead>
8332
8333 <tbody>
8334
8335
8336
8337
8338
8339
8340
8341
8342
8343
8344 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8345 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8346 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8347 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8348 <td class="entry_type">
8349 <span class="entry_type_name entry_type_name_enum">byte</span>
8350
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]8351 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8352
8353 <ul class="entry_type_enum">
8354 <li>
8355 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8356 <span class="entry_type_enum_notes"><p>The last or only metadata result buffer
8357for this capture.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8358 </li>
8359 <li>
8360 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8361 <span class="entry_type_enum_notes"><p>A partial buffer of result metadata for this
8362capture.<wbr/> More result buffers for this capture will be sent
8363by the HAL,<wbr/> the last of which will be marked
8364FINAL.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8365 </li>
8366 </ul>
8367
8368 </td> <!-- entry_type -->
8369
8370 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8371 <p>Whether a result given to the framework is the
8372final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8373subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8374values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8375 </td>
8376
8377 <td class="entry_units">
8378 </td>
8379
8380 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8381 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8382 </td>
8383
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8384 <td class="entry_tags">
8385 </td>
8386
8387 </tr>
8388 <tr class="entries_header">
8389 <th class="th_details" colspan="5">Details</th>
8390 </tr>
8391 <tr class="entry_cont">
8392 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8393 <p>The entries in the result metadata buffers for a
8394single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8395FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8396requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
8397always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
8398before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
8399in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
8400capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
8401only 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]8402 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8403 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8404
8405
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8406 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8407 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8408
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8409
8410
8411 <!-- end of kind -->
8412 </tbody>
8413
8414 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8415 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8416
8417
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8418 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8419
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8420 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8421 <tr>
8422 <th class="th_name">Property Name</th>
8423 <th class="th_type">Type</th>
8424 <th class="th_description">Description</th>
8425 <th class="th_units">Units</th>
8426 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8427 <th class="th_tags">Tags</th>
8428 </tr>
8429 </thead>
8430
8431 <tbody>
8432
8433
8434
8435
8436
8437
8438
8439
8440
8441
8442 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8443 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8444 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8445 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8446 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8447 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8448
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8449 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8450
8451
8452 </td> <!-- entry_type -->
8453
8454 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8455 <p>A frame counter set by the framework.<wbr/> Must
8456be maintained unchanged in output frame.<wbr/> This value monotonically
8457increases with every new result (that is,<wbr/> each new result has a unique
8458frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8459 </td>
8460
8461 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8462 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8463 </td>
8464
8465 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8466 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8467 </td>
8468
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8469 <td class="entry_tags">
8470 </td>
8471
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8472 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8473
8474
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8475 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8476 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8477
8478
8479 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8480 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8481 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8482 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8483 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8484 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8485
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8486 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8487
8488
8489 </td> <!-- entry_type -->
8490
8491 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8492 <p>An application-specified ID for the current
8493request.<wbr/> Must be maintained unchanged in output
8494frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8495 </td>
8496
8497 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8498 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8499 </td>
8500
8501 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8502 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8503 </td>
8504
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8505 <td class="entry_tags">
8506 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8507 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8508 </ul>
8509 </td>
8510
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8511 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8512
8513
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8514 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8515 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8516
8517
8518 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8519 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8520 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8521 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8522 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8523 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8524 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8525
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8526 <span class="entry_type_array">
8527 n
8528 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8529 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8530
8531
8532 </td> <!-- entry_type -->
8533
8534 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8535 <p>List which camera reprocess stream is used
8536for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8537 </td>
8538
8539 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8540 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8541 </td>
8542
8543 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8544 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
8545reprocess stream ID.<wbr/></p>
8546<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
8547reprocess streams may be included in a single request; they
8548must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8549 </td>
8550
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8551 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8552 <ul class="entry_tags">
8553 <li><a href="#tag_HAL2">HAL2</a></li>
8554 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8555 </td>
8556
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8557 </tr>
8558 <tr class="entries_header">
8559 <th class="th_details" colspan="5">Details</th>
8560 </tr>
8561 <tr class="entry_cont">
8562 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8563 <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]8564REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8565 </td>
8566 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8567
8568
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8569 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8570 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8571
8572
8573 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8574 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8575 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8576 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8577 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8578 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8579
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8580 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8581
8582 <ul class="entry_type_enum">
8583 <li>
8584 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8585 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
8586for application-bound buffer data.<wbr/> If no
8587application-bound streams exist,<wbr/> no frame should be
8588placed in the output frame queue.<wbr/> If such streams
8589exist,<wbr/> a frame should be placed on the output queue
8590with null metadata but with the necessary output buffer
8591information.<wbr/> Timestamp information should still be
8592included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8593 </li>
8594 <li>
8595 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8596 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
8597only be produced if they are separately
8598enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8599 </li>
8600 </ul>
8601
8602 </td> <!-- entry_type -->
8603
8604 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8605 <p>How much metadata to produce on
8606output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8607 </td>
8608
8609 <td class="entry_units">
8610 </td>
8611
8612 <td class="entry_range">
8613 </td>
8614
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8615 <td class="entry_tags">
8616 </td>
8617
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8618 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8619
8620
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8621 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8622 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8623
8624
8625 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8626 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8627 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8628 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8629 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8630 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8631 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8632
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8633 <span class="entry_type_array">
8634 n
8635 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8636 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8637
8638
8639 </td> <!-- entry_type -->
8640
8641 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8642 <p>Lists which camera output streams image data
8643from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8644 </td>
8645
8646 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8647 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8648 </td>
8649
8650 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8651 <p>List must only include streams that have been
8652created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8653 </td>
8654
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8655 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8656 <ul class="entry_tags">
8657 <li><a href="#tag_HAL2">HAL2</a></li>
8658 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8659 </td>
8660
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8661 </tr>
8662 <tr class="entries_header">
8663 <th class="th_details" colspan="5">Details</th>
8664 </tr>
8665 <tr class="entry_cont">
8666 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8667 <p>If no output streams are listed,<wbr/> then the image
8668data should simply be discarded.<wbr/> The image data must
8669still be captured for metadata and statistics production,<wbr/>
8670and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8671 </td>
8672 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8673
8674
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8675 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8676 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8677
8678
8679 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8680 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8681 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8682 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8683 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8684 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8685
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8686 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8687
8688 <ul class="entry_type_enum">
8689 <li>
8690 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8691 <span class="entry_type_enum_notes"><p>Capture a new image from the imaging hardware,<wbr/>
8692and process it according to the
8693settings</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8694 </li>
8695 <li>
8696 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8697 <span class="entry_type_enum_notes"><p>Process previously captured data; the
8698android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
8699source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
8700needed for reprocessing with [RP]</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8701 </li>
8702 </ul>
8703
8704 </td> <!-- entry_type -->
8705
8706 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8707 <p>The type of the request; either CAPTURE or
8708REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8709 </td>
8710
8711 <td class="entry_units">
8712 </td>
8713
8714 <td class="entry_range">
8715 </td>
8716
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8717 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8718 <ul class="entry_tags">
8719 <li><a href="#tag_HAL2">HAL2</a></li>
8720 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8721 </td>
8722
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8723 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8724
8725
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8726 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8727 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8728
8729
8730
8731 <!-- end of kind -->
8732 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8733 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8734
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8735 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8736 <tr>
8737 <th class="th_name">Property Name</th>
8738 <th class="th_type">Type</th>
8739 <th class="th_description">Description</th>
8740 <th class="th_units">Units</th>
8741 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8742 <th class="th_tags">Tags</th>
8743 </tr>
8744 </thead>
8745
8746 <tbody>
8747
8748
8749
8750
8751
8752
8753
8754
8755
8756
8757 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8758 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8759 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8760 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8761 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8762 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8763 <span class="entry_type_container">x</span>
8764
8765 <span class="entry_type_array">
8766 3
8767 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8768 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8769
8770
8771 </td> <!-- entry_type -->
8772
8773 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8774 <p>How many output streams can be allocated at
8775the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8776 </td>
8777
8778 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8779 The number of raw sensor streams; the number of
8780 processed,<wbr/> uncompressed streams; and the number of
8781 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8782 </td>
8783
8784 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8785 <p>&gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8786for processed,<wbr/> uncompressed streams</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8787 </td>
8788
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8789 <td class="entry_tags">
8790 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8791 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8792 </ul>
8793 </td>
8794
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8795 </tr>
8796 <tr class="entries_header">
8797 <th class="th_details" colspan="5">Details</th>
8798 </tr>
8799 <tr class="entry_cont">
8800 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8801 <p>Video snapshot with preview callbacks requires 3
8802processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8803one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8804 </td>
8805 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8806
8807
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8808 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8809 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8810
8811
8812 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8813 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8814 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8815 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8816 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8817 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8818 <span class="entry_type_container">x</span>
8819
8820 <span class="entry_type_array">
8821 1
8822 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8823 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8824
8825
8826 </td> <!-- entry_type -->
8827
8828 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8829 <p>How many reprocessing streams of any type
8830can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8831 </td>
8832
8833 <td class="entry_units">
8834 </td>
8835
8836 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8837 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8838 </td>
8839
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8840 <td class="entry_tags">
8841 </td>
8842
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8843 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8844
8845
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8846 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8847 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8848
8849
8850
8851 <!-- end of kind -->
8852 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8853 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8854
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8855 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8856 <tr>
8857 <th class="th_name">Property Name</th>
8858 <th class="th_type">Type</th>
8859 <th class="th_description">Description</th>
8860 <th class="th_units">Units</th>
8861 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8862 <th class="th_tags">Tags</th>
8863 </tr>
8864 </thead>
8865
8866 <tbody>
8867
8868
8869
8870
8871
8872
8873
8874
8875
8876
8877 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8878 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8879 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8880 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8881 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8882 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8883
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8884 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8885
8886
8887 </td> <!-- entry_type -->
8888
8889 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8890 <p>A frame counter set by the framework.<wbr/> This value monotonically
8891increases with every new result (that is,<wbr/> each new result has a unique
8892frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8893 </td>
8894
8895 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8896 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8897 </td>
8898
8899 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8900 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8901 </td>
8902
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8903 <td class="entry_tags">
8904 </td>
8905
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8906 </tr>
8907 <tr class="entries_header">
8908 <th class="th_details" colspan="5">Details</th>
8909 </tr>
8910 <tr class="entry_cont">
8911 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8912 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8913 </td>
8914 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8915
8916
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8917 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8918 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8919
8920
8921 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8922 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8923 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8924 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8925 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8926 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8927
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8928 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8929
8930
8931 </td> <!-- entry_type -->
8932
8933 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8934 <p>An application-specified ID for the current
8935request.<wbr/> Must be maintained unchanged in output
8936frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8937 </td>
8938
8939 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8940 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8941 </td>
8942
8943 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8944 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8945 </td>
8946
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8947 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8948 <ul class="entry_tags">
8949 <li><a href="#tag_V1">V1</a></li>
8950 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8951 </td>
8952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8953 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8954
8955
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8956 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8957 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8958
8959
8960 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8961 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8962 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8963 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8964 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8965 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8966
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8967 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8968
8969 <ul class="entry_type_enum">
8970 <li>
8971 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8972 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
8973for application-bound buffer data.<wbr/> If no
8974application-bound streams exist,<wbr/> no frame should be
8975placed in the output frame queue.<wbr/> If such streams
8976exist,<wbr/> a frame should be placed on the output queue
8977with null metadata but with the necessary output buffer
8978information.<wbr/> Timestamp information should still be
8979included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8980 </li>
8981 <li>
8982 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8983 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
8984only be produced if they are separately
8985enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8986 </li>
8987 </ul>
8988
8989 </td> <!-- entry_type -->
8990
8991 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8992 <p>How much metadata to produce on
8993output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8994 </td>
8995
8996 <td class="entry_units">
8997 </td>
8998
8999 <td class="entry_range">
9000 </td>
9001
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9002 <td class="entry_tags">
9003 </td>
9004
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9005 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9006
9007
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9008 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9009 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9010
9011
9012 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9013 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9014 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9015 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9016 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]9017 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9018 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9019
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9020 <span class="entry_type_array">
9021 n
9022 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9023 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9024
9025
9026 </td> <!-- entry_type -->
9027
9028 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9029 <p>Lists which camera output streams image data
9030from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9031 </td>
9032
9033 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9034 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9035 </td>
9036
9037 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9038 <p>List must only include streams that have been
9039created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9040 </td>
9041
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9042 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9043 <ul class="entry_tags">
9044 <li><a href="#tag_HAL2">HAL2</a></li>
9045 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9046 </td>
9047
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9048 </tr>
9049 <tr class="entries_header">
9050 <th class="th_details" colspan="5">Details</th>
9051 </tr>
9052 <tr class="entry_cont">
9053 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9054 <p>If no output streams are listed,<wbr/> then the image
9055data should simply be discarded.<wbr/> The image data must
9056still be captured for metadata and statistics production,<wbr/>
9057and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9058 </td>
9059 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9060
9061
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9062 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9063 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9064
9065
9066
9067 <!-- end of kind -->
9068 </tbody>
9069
9070 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9071 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9072
9073
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9074 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9075
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9076 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9077 <tr>
9078 <th class="th_name">Property Name</th>
9079 <th class="th_type">Type</th>
9080 <th class="th_description">Description</th>
9081 <th class="th_units">Units</th>
9082 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9083 <th class="th_tags">Tags</th>
9084 </tr>
9085 </thead>
9086
9087 <tbody>
9088
9089
9090
9091
9092
9093
9094
9095
9096
9097
9098 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9099 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9100 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9101 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9102 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9103 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9104 <span class="entry_type_container">x</span>
9105
9106 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9107 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9108 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9109 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9110
9111
9112 </td> <!-- entry_type -->
9113
9114 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9115 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9116<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9117(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9118output.<wbr/> Each stream must use this rectangle to produce its
9119output,<wbr/> cropping to a smaller region if necessary to
9120maintain the stream's aspect ratio.<wbr/></p>
9121<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9122 </td>
9123
9124 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9125 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9126 in pixels; (0,<wbr/>0) is top-left corner of
9127 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9128 </td>
9129
9130 <td class="entry_range">
9131 </td>
9132
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9133 <td class="entry_tags">
9134 <ul class="entry_tags">
9135 <li><a href="#tag_BC">BC</a></li>
9136 </ul>
9137 </td>
9138
9139 </tr>
9140 <tr class="entries_header">
9141 <th class="th_details" colspan="5">Details</th>
9142 </tr>
9143 <tr class="entry_cont">
9144 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9145 <p>Any additional per-stream cropping must be done to
9146maximize the final pixel area of the stream.<wbr/></p>
9147<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9148ratio,<wbr/> then 4:3 streams should use the exact crop
9149region.<wbr/> 16:9 streams should further crop vertically
9150(letterbox).<wbr/></p>
9151<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9152outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9153streams should match exactly.<wbr/> These additional crops must
9154be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9155<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9156times,<wbr/> no matter what the relative aspect ratios of the
9157crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9158corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9159larger than active pixel array.<wbr/> Width and height may be
9160rounded to nearest larger supportable width,<wbr/> especially
9161for raw output,<wbr/> where only a few fixed scales may be
9162possible.<wbr/> The width and height of the crop region cannot
9163be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9164android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9165activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9166respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9167 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9168 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9169
9170
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9171 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9172 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9173
9174
9175
9176 <!-- end of kind -->
9177 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9178 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9179
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9180 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9181 <tr>
9182 <th class="th_name">Property Name</th>
9183 <th class="th_type">Type</th>
9184 <th class="th_description">Description</th>
9185 <th class="th_units">Units</th>
9186 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9187 <th class="th_tags">Tags</th>
9188 </tr>
9189 </thead>
9190
9191 <tbody>
9192
9193
9194
9195
9196
9197
9198
9199
9200
9201
9202 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9203 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9204 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9205 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9206 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9207 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9208 <span class="entry_type_container">x</span>
9209
9210 <span class="entry_type_array">
9211 n
9212 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]9213 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9214 <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]9215
9216 <ul class="entry_type_enum">
9217 <li>
9218 <span class="entry_type_enum_name">RAW_SENSOR</span>
9219 <span class="entry_type_enum_value">0x20</span>
9220 </li>
9221 <li>
9222 <span class="entry_type_enum_name">YV12</span>
9223 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9224 <span class="entry_type_enum_notes"><p>YCrCb 4:2:0 Planar</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9225 </li>
9226 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9227 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9228 <span class="entry_type_enum_value">0x11</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9229 <span class="entry_type_enum_notes"><p>NV21</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9230 </li>
9231 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9232 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
9233 <span class="entry_type_enum_value">0x22</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9234 <span class="entry_type_enum_notes"><p>Hal Implementation Defined</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9235 </li>
9236 <li>
9237 <span class="entry_type_enum_name">YCbCr_420_888</span>
9238 <span class="entry_type_enum_value">0x23</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9239 <span class="entry_type_enum_notes"><p>Flexible YUV420 Format</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9240 </li>
9241 <li>
9242 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9243 <span class="entry_type_enum_value">0x21</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9244 <span class="entry_type_enum_notes"><p>JPEG</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9245 </li>
9246 </ul>
9247
9248 </td> <!-- entry_type -->
9249
9250 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9251 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9252 </td>
9253
9254 <td class="entry_units">
9255 </td>
9256
9257 <td class="entry_range">
9258 </td>
9259
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9260 <td class="entry_tags">
9261 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9262 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9263 </ul>
9264 </td>
9265
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9266 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9267
9268
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9269 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9270 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9271
9272
9273 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9274 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9275 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9276 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9277 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9278 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9279 <span class="entry_type_container">x</span>
9280
9281 <span class="entry_type_array">
9282 n
9283 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9284 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9285
9286
9287 </td> <!-- entry_type -->
9288
9289 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9290 <p>The minimum frame duration that is supported
9291for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9292correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9293stream is active and captured in a burst,<wbr/> with all
9294processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9295 </td>
9296
9297 <td class="entry_units">
9298 </td>
9299
9300 <td class="entry_range">
9301 </td>
9302
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9303 <td class="entry_tags">
9304 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9305 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9306 </ul>
9307 </td>
9308
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9309 </tr>
9310 <tr class="entries_header">
9311 <th class="th_details" colspan="5">Details</th>
9312 </tr>
9313 <tr class="entry_cont">
9314 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9315 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9316frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9317durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9318 </td>
9319 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9320
9321
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9322 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9323 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9324
9325
9326 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9327 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9328 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9329 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9330 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9331 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9332 <span class="entry_type_container">x</span>
9333
9334 <span class="entry_type_array">
9335 n x 2
9336 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9337 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9338
9339
9340 </td> <!-- entry_type -->
9341
9342 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9343 <p>The resolutions available for output from
9344the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9345 </td>
9346
9347 <td class="entry_units">
9348 </td>
9349
9350 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9351 <p>Must include: - sensor maximum resolution Should
9352include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9353 </td>
9354
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9355 <td class="entry_tags">
9356 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9357 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9358 </ul>
9359 </td>
9360
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9361 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9362
9363
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9364 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9365 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9366
9367
9368 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9369 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9370 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9371 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9372 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]9373 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9374
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9375 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9376
9377
9378 </td> <!-- entry_type -->
9379
9380 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9381 <p>The maximum ratio between active area width
9382and crop region width,<wbr/> or between active area height and
9383crop region height,<wbr/> if the crop region height is larger
9384than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9385 </td>
9386
9387 <td class="entry_units">
9388 </td>
9389
9390 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9391 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9392 </td>
9393
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9394 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]9395 <ul class="entry_tags">
9396 <li><a href="#tag_BC">BC</a></li>
9397 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9398 </td>
9399
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9400 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9401
9402
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9403 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9404 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9405
9406
9407 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9408 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9409 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9410 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9411 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9412 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9413 <span class="entry_type_container">x</span>
9414
9415 <span class="entry_type_array">
9416 n
9417 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9418 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9419
9420
9421 </td> <!-- entry_type -->
9422
9423 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9424 <p>The minimum frame duration that is supported
9425for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9426correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9427stream is active,<wbr/> with all processing set to
9428FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9429 </td>
9430
9431 <td class="entry_units">
9432 </td>
9433
9434 <td class="entry_range">
9435 </td>
9436
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9437 <td class="entry_tags">
9438 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9439 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9440 </ul>
9441 </td>
9442
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9443 </tr>
9444 <tr class="entries_header">
9445 <th class="th_details" colspan="5">Details</th>
9446 </tr>
9447 <tr class="entry_cont">
9448 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9449 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9450frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9451durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9452 </td>
9453 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9454
9455
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9456 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9457 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9458
9459
9460 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9461 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9462 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9463 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9464 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9465 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9466 <span class="entry_type_container">x</span>
9467
9468 <span class="entry_type_array">
9469 n x 2
9470 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9471 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9472
9473
9474 </td> <!-- entry_type -->
9475
9476 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9477 <p>The resolutions available for use with
9478processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
9479platform opaque YUV/<wbr/>RGB streams to the GPU or video
9480encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9481 </td>
9482
9483 <td class="entry_units">
9484 </td>
9485
9486 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9487 <p>Must include: - sensor maximum resolution -
9488standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
9489resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9490 </td>
9491
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9492 <td class="entry_tags">
9493 <ul class="entry_tags">
9494 <li><a href="#tag_BC">BC</a></li>
9495 </ul>
9496 </td>
9497
9498 </tr>
9499 <tr class="entries_header">
9500 <th class="th_details" colspan="5">Details</th>
9501 </tr>
9502 <tr class="entry_cont">
9503 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9504 <p>The actual supported resolution list may be limited by
9505consumer end points for different use cases.<wbr/> For example,<wbr/> for
9506recording use case,<wbr/> the largest supported resolution may be
9507limited by max supported size from encoder,<wbr/> for preview use
9508case,<wbr/> the largest supported resolution may be limited by max
9509resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9510 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9511 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9512
9513
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9514 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9515 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9516
9517
9518 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9519 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9520 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9521 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9522 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9523 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9524 <span class="entry_type_container">x</span>
9525
9526 <span class="entry_type_array">
9527 n
9528 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9529 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9530
9531
9532 </td> <!-- entry_type -->
9533
9534 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9535 <p>The minimum frame duration that is supported
9536for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9537correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9538is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9539 </td>
9540
9541 <td class="entry_units">
9542 </td>
9543
9544 <td class="entry_range">
9545 </td>
9546
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9547 <td class="entry_tags">
9548 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9549 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9550 </ul>
9551 </td>
9552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9553 </tr>
9554 <tr class="entries_header">
9555 <th class="th_details" colspan="5">Details</th>
9556 </tr>
9557 <tr class="entry_cont">
9558 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9559 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9560frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9561durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9562 </td>
9563 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9564
9565
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9566 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9567 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9568
9569
9570 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9571 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9572 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9573 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9574 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9575 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9576 <span class="entry_type_container">x</span>
9577
9578 <span class="entry_type_array">
9579 n x 2
9580 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9581 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9582
9583
9584 </td> <!-- entry_type -->
9585
9586 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9587 <p>The resolutions available for use with raw
9588sensor output streams,<wbr/> listed as width,<wbr/>
9589height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9590 </td>
9591
9592 <td class="entry_units">
9593 </td>
9594
9595 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9596 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9597 </td>
9598
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9599 <td class="entry_tags">
9600 </td>
9601
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9602 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9603
9604
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9605 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9606 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9607
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9608
9609
9610 <!-- end of kind -->
9611 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9612 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9613
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9614 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9615 <tr>
9616 <th class="th_name">Property Name</th>
9617 <th class="th_type">Type</th>
9618 <th class="th_description">Description</th>
9619 <th class="th_units">Units</th>
9620 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9621 <th class="th_tags">Tags</th>
9622 </tr>
9623 </thead>
9624
9625 <tbody>
9626
9627
9628
9629
9630
9631
9632
9633
9634
9635
9636 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9637 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9638 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9639 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9640 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9641 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9642 <span class="entry_type_container">x</span>
9643
9644 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9645 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9646 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9647 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9648
9649
9650 </td> <!-- entry_type -->
9651
9652 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9653 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9654<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9655(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9656output.<wbr/> Each stream must use this rectangle to produce its
9657output,<wbr/> cropping to a smaller region if necessary to
9658maintain the stream's aspect ratio.<wbr/></p>
9659<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9660 </td>
9661
9662 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9663 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9664 in pixels; (0,<wbr/>0) is top-left corner of
9665 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9666 </td>
9667
9668 <td class="entry_range">
9669 </td>
9670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9671 <td class="entry_tags">
9672 <ul class="entry_tags">
9673 <li><a href="#tag_BC">BC</a></li>
9674 </ul>
9675 </td>
9676
9677 </tr>
9678 <tr class="entries_header">
9679 <th class="th_details" colspan="5">Details</th>
9680 </tr>
9681 <tr class="entry_cont">
9682 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9683 <p>Any additional per-stream cropping must be done to
9684maximize the final pixel area of the stream.<wbr/></p>
9685<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9686ratio,<wbr/> then 4:3 streams should use the exact crop
9687region.<wbr/> 16:9 streams should further crop vertically
9688(letterbox).<wbr/></p>
9689<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9690outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9691streams should match exactly.<wbr/> These additional crops must
9692be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9693<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9694times,<wbr/> no matter what the relative aspect ratios of the
9695crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9696corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9697larger than active pixel array.<wbr/> Width and height may be
9698rounded to nearest larger supportable width,<wbr/> especially
9699for raw output,<wbr/> where only a few fixed scales may be
9700possible.<wbr/> The width and height of the crop region cannot
9701be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9702android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9703activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9704respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9705 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9706 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9707
9708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9709 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9710 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9711
9712
9713
9714 <!-- end of kind -->
9715 </tbody>
9716
9717 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9718 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9719
9720
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9721 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9722
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9723 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9724 <tr>
9725 <th class="th_name">Property Name</th>
9726 <th class="th_type">Type</th>
9727 <th class="th_description">Description</th>
9728 <th class="th_units">Units</th>
9729 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9730 <th class="th_tags">Tags</th>
9731 </tr>
9732 </thead>
9733
9734 <tbody>
9735
9736
9737
9738
9739
9740
9741
9742
9743
9744
9745 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9746 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9747 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9748 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9749 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9750 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9751
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9752 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9753
9754
9755 </td> <!-- entry_type -->
9756
9757 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9758 <p>Duration each pixel is exposed to
9759light.<wbr/></p>
9760<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
9761duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9762 </td>
9763
9764 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9765 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9766 </td>
9767
9768 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9769 <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]9770 </td>
9771
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9772 <td class="entry_tags">
9773 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9774 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9775 </ul>
9776 </td>
9777
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9778 </tr>
9779 <tr class="entries_header">
9780 <th class="th_details" colspan="5">Details</th>
9781 </tr>
9782 <tr class="entry_cont">
9783 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9784 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9785 </td>
9786 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9787
9788
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9789 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9790 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9791
9792
9793 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9794 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9795 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9796 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9797 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9798 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9799
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9800 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9801
9802
9803 </td> <!-- entry_type -->
9804
9805 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9806 <p>Duration from start of frame exposure to
9807start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9808 </td>
9809
9810 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9811 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9812 </td>
9813
9814 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9815 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9816android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9817 </td>
9818
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9819 <td class="entry_tags">
9820 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9821 <li><a href="#tag_V1">V1</a></li>
9822 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9823 </ul>
9824 </td>
9825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9826 </tr>
9827 <tr class="entries_header">
9828 <th class="th_details" colspan="5">Details</th>
9829 </tr>
9830 <tr class="entry_cont">
9831 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9832 <p>Exposure time has priority,<wbr/> so duration is set to
9833max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9834 </td>
9835 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9836
9837
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9838 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9839 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9840
9841
9842 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9843 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9844 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9845 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9846 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9847 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9848
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9849 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9850
9851
9852 </td> <!-- entry_type -->
9853
9854 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9855 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9856implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9857below 'maximum analog sensitivity'.<wbr/></p>
9858<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9859gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9860 </td>
9861
9862 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9863 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9864 </td>
9865
9866 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9867 <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]9868 </td>
9869
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9870 <td class="entry_tags">
9871 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9872 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9873 </ul>
9874 </td>
9875
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9876 </tr>
9877 <tr class="entries_header">
9878 <th class="th_details" colspan="5">Details</th>
9879 </tr>
9880 <tr class="entry_cont">
9881 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9882 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9883 </td>
9884 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9885
9886
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9887 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9888 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9889
9890
9891
9892 <!-- end of kind -->
9893 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9894 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9895
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9896 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9897 <tr>
9898 <th class="th_name">Property Name</th>
9899 <th class="th_type">Type</th>
9900 <th class="th_description">Description</th>
9901 <th class="th_units">Units</th>
9902 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9903 <th class="th_tags">Tags</th>
9904 </tr>
9905 </thead>
9906
9907 <tbody>
9908
9909
9910
9911
9912
9913
9914
9915
9916
9917
9918
9919
9920 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9921 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9922 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9923 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9924 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9925 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9926 <span class="entry_type_container">x</span>
9927
9928 <span class="entry_type_array">
9929 4
9930 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9931 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9932 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9933
9934
9935 </td> <!-- entry_type -->
9936
9937 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9938 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9939active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9940pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9941 </td>
9942
9943 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9944 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9945 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9946 </td>
9947
9948 <td class="entry_range">
9949 </td>
9950
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9951 <td class="entry_tags">
9952 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9953 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9954 </ul>
9955 </td>
9956
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9957 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9958
9959
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9960 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9961 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9962
9963
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9964 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9965 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9966 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9967 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9968 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9969 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9970 <span class="entry_type_container">x</span>
9971
9972 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9973 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9974 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9975 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9976 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9977
9978
9979 </td> <!-- entry_type -->
9980
9981 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9982 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9983 </td>
9984
9985 <td class="entry_units">
9986 </td>
9987
9988 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9989 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9990 </td>
9991
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9992 <td class="entry_tags">
9993 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9994 <li><a href="#tag_BC">BC</a></li>
9995 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9996 </ul>
9997 </td>
9998
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9999 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10000
10001
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10002 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10003 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10004
10005
10006 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10007 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10008 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10009 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10010 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10011 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10012
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10013 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10014
10015 <ul class="entry_type_enum">
10016 <li>
10017 <span class="entry_type_enum_name">RGGB</span>
10018 </li>
10019 <li>
10020 <span class="entry_type_enum_name">GRBG</span>
10021 </li>
10022 <li>
10023 <span class="entry_type_enum_name">GBRG</span>
10024 </li>
10025 <li>
10026 <span class="entry_type_enum_name">BGGR</span>
10027 </li>
10028 <li>
10029 <span class="entry_type_enum_name">RGB</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10030 <span class="entry_type_enum_notes"><p>Sensor is not Bayer; output has 3 16-bit
10031values for each pixel,<wbr/> instead of just 1 16-bit value
10032per pixel.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10033 </li>
10034 </ul>
10035
10036 </td> <!-- entry_type -->
10037
10038 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10039 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10040represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10041the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10042 </td>
10043
10044 <td class="entry_units">
10045 </td>
10046
10047 <td class="entry_range">
10048 </td>
10049
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10050 <td class="entry_tags">
10051 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10052 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10053 </ul>
10054 </td>
10055
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10056 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10057
10058
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10059 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10060 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10061
10062
10063 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10064 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10065 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10066 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10067 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10068 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10069 <span class="entry_type_container">x</span>
10070
10071 <span class="entry_type_array">
10072 2
10073 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10074 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10075 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10076
10077
10078 </td> <!-- entry_type -->
10079
10080 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10081 <p>Range of valid exposure
10082times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10083 </td>
10084
10085 <td class="entry_units">
10086 </td>
10087
10088 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10089 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
10090sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10091 </td>
10092
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10093 <td class="entry_tags">
10094 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10095 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10096 </ul>
10097 </td>
10098
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10099 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10100
10101
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10102 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10103 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10104
10105
10106 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10107 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10108 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10109 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10110 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10111 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10112
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10113 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10114
10115
10116 </td> <!-- entry_type -->
10117
10118 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10119 <p>Maximum possible frame duration (minimum frame
10120rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10121 </td>
10122
10123 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10124 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10125 </td>
10126
10127 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10128 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10129 </td>
10130
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10131 <td class="entry_tags">
10132 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10133 <li><a href="#tag_BC">BC</a></li>
10134 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10135 </ul>
10136 </td>
10137
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10138 </tr>
10139 <tr class="entries_header">
10140 <th class="th_details" colspan="5">Details</th>
10141 </tr>
10142 <tr class="entry_cont">
10143 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10144 <p>Minimum duration is a function of resolution,<wbr/>
10145processing settings.<wbr/> See
10146android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
10147android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10148<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]10149 </td>
10150 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10151
10152
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10153 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10154 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10155
10156
10157 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10158 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10159 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10160 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10161 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10162 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10163 <span class="entry_type_container">x</span>
10164
10165 <span class="entry_type_array">
10166 2
10167 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]10168 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10169 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10170
10171
10172 </td> <!-- entry_type -->
10173
10174 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10175 <p>The physical dimensions of the full pixel
10176array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10177 </td>
10178
10179 <td class="entry_units">
10180 </td>
10181
10182 <td class="entry_range">
10183 </td>
10184
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10185 <td class="entry_tags">
10186 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10187 <li><a href="#tag_V1">V1</a></li>
10188 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10189 </ul>
10190 </td>
10191
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10192 </tr>
10193 <tr class="entries_header">
10194 <th class="th_details" colspan="5">Details</th>
10195 </tr>
10196 <tr class="entry_cont">
10197 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10198 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10199 </td>
10200 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10201
10202
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10203 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10204 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10205
10206
10207 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10208 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10209 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10210 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10211 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10212 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10213 <span class="entry_type_container">x</span>
10214
10215 <span class="entry_type_array">
10216 2
10217 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10218 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10219
10220
10221 </td> <!-- entry_type -->
10222
10223 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10224 <p>Dimensions of full pixel array,<wbr/> possibly
10225including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10226 </td>
10227
10228 <td class="entry_units">
10229 </td>
10230
10231 <td class="entry_range">
10232 </td>
10233
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10234 <td class="entry_tags">
10235 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10236 <li><a href="#tag_DNG">DNG</a></li>
10237 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10238 </ul>
10239 </td>
10240
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10241 </tr>
10242 <tr class="entries_header">
10243 <th class="th_details" colspan="5">Details</th>
10244 </tr>
10245 <tr class="entry_cont">
10246 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10247 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10248match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10249android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10250 </td>
10251 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10252
10253
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10254 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10255 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10256
10257
10258 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10259 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10260 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10261 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10262 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10263 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10264
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10265 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10266
10267
10268 </td> <!-- entry_type -->
10269
10270 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10271 <p>Maximum raw value output by
10272sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10273 </td>
10274
10275 <td class="entry_units">
10276 </td>
10277
10278 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10279 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10280 </td>
10281
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10282 <td class="entry_tags">
10283 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10284 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10285 </ul>
10286 </td>
10287
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10288 </tr>
10289 <tr class="entries_header">
10290 <th class="th_details" colspan="5">Details</th>
10291 </tr>
10292 <tr class="entry_cont">
10293 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10294 <p>Defines sensor bit depth (10-14 bits is
10295expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10296 </td>
10297 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10298
10299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10300 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10301 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10302
10303
10304
10305
10306
10307 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10308 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10309 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10310 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10311 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10312 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10313
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10314 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10315
10316
10317 </td> <!-- entry_type -->
10318
10319 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10320 <p>Gain factor from electrons to raw units when
10321ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10322 </td>
10323
10324 <td class="entry_units">
10325 </td>
10326
10327 <td class="entry_range">
10328 </td>
10329
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10330 <td class="entry_tags">
10331 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10332 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10333 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10334 </ul>
10335 </td>
10336
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10337 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10338
10339
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10340 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10341 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10342
10343
10344 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10345 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10346 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10347 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10348 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10349 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10350 <span class="entry_type_container">x</span>
10351
10352 <span class="entry_type_array">
10353 4
10354 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10355 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10356 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10357
10358
10359 </td> <!-- entry_type -->
10360
10361 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10362 <p>A fixed black level offset for each of the
10363Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10364 </td>
10365
10366 <td class="entry_units">
10367 </td>
10368
10369 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10370 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10371 </td>
10372
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10373 <td class="entry_tags">
10374 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10375 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10376 </ul>
10377 </td>
10378
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10379 </tr>
10380 <tr class="entries_header">
10381 <th class="th_details" colspan="5">Details</th>
10382 </tr>
10383 <tr class="entry_cont">
10384 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10385 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
10386tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10387 </td>
10388 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10389
10390
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10391 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10392 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10393
10394
10395 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10396 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10397 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10398 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10399 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10400 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10401 <span class="entry_type_container">x</span>
10402
10403 <span class="entry_type_array">
10404 9
10405 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10406 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10407 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10408
10409
10410 </td> <!-- entry_type -->
10411
10412 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10413 <p>Per-device calibration on top of color space
10414transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10415 </td>
10416
10417 <td class="entry_units">
10418 </td>
10419
10420 <td class="entry_range">
10421 </td>
10422
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10423 <td class="entry_tags">
10424 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10425 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10426 </ul>
10427 </td>
10428
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10429 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10430
10431
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10432 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10433 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10434
10435
10436 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10437 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10438 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10439 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10440 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10441 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10442 <span class="entry_type_container">x</span>
10443
10444 <span class="entry_type_array">
10445 9
10446 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10447 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10448 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10449
10450
10451 </td> <!-- entry_type -->
10452
10453 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10454 <p>Per-device calibration on top of color space
10455transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10456 </td>
10457
10458 <td class="entry_units">
10459 </td>
10460
10461 <td class="entry_range">
10462 </td>
10463
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10464 <td class="entry_tags">
10465 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10466 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10467 </ul>
10468 </td>
10469
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10470 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10471
10472
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10473 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10474 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10475
10476
10477 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10478 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10479 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10480 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10481 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10482 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10483 <span class="entry_type_container">x</span>
10484
10485 <span class="entry_type_array">
10486 9
10487 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10488 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10489 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10490
10491
10492 </td> <!-- entry_type -->
10493
10494 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10495 <p>Linear mapping from XYZ (D50) color space to
10496reference linear sensor color,<wbr/> for first reference
10497illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10498 </td>
10499
10500 <td class="entry_units">
10501 </td>
10502
10503 <td class="entry_range">
10504 </td>
10505
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10506 <td class="entry_tags">
10507 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10508 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10509 </ul>
10510 </td>
10511
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10512 </tr>
10513 <tr class="entries_header">
10514 <th class="th_details" colspan="5">Details</th>
10515 </tr>
10516 <tr class="entry_cont">
10517 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10518 <p>Use as follows XYZ = inv(transform) * clip( (raw -
10519black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
10520At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10521 </td>
10522 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10523
10524
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10525 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10526 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10527
10528
10529 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10530 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10531 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10532 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10533 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10534 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10535 <span class="entry_type_container">x</span>
10536
10537 <span class="entry_type_array">
10538 9
10539 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10540 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10541 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10542
10543
10544 </td> <!-- entry_type -->
10545
10546 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10547 <p>Linear mapping from XYZ (D50) color space to
10548reference linear sensor color,<wbr/> for second reference
10549illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10550 </td>
10551
10552 <td class="entry_units">
10553 </td>
10554
10555 <td class="entry_range">
10556 </td>
10557
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10558 <td class="entry_tags">
10559 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10560 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10561 </ul>
10562 </td>
10563
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10564 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10565
10566
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10567 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10568 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10569
10570
10571 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10572 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10573 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10574 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10575 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10576 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10577 <span class="entry_type_container">x</span>
10578
10579 <span class="entry_type_array">
10580 9
10581 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10582 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10583 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10584
10585
10586 </td> <!-- entry_type -->
10587
10588 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10589 <p>Used by DNG for better WB
10590adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10591 </td>
10592
10593 <td class="entry_units">
10594 </td>
10595
10596 <td class="entry_range">
10597 </td>
10598
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10599 <td class="entry_tags">
10600 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10601 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10602 </ul>
10603 </td>
10604
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10605 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10606
10607
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10608 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10609 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10610
10611
10612 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10613 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10614 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10615 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10616 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10617 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10618 <span class="entry_type_container">x</span>
10619
10620 <span class="entry_type_array">
10621 9
10622 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10623 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10624 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10625
10626
10627 </td> <!-- entry_type -->
10628
10629 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10630 <p>Used by DNG for better WB
10631adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10632 </td>
10633
10634 <td class="entry_units">
10635 </td>
10636
10637 <td class="entry_range">
10638 </td>
10639
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10640 <td class="entry_tags">
10641 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10642 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10643 </ul>
10644 </td>
10645
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10646 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10647
10648
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10649 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10650 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10651
10652
10653 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10654 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10655 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10656 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10657 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10658 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10659
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10660 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10661
10662
10663 </td> <!-- entry_type -->
10664
10665 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10666 <p>Maximum sensitivity that is implemented
10667purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10668 </td>
10669
10670 <td class="entry_units">
10671 </td>
10672
10673 <td class="entry_range">
10674 </td>
10675
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10676 <td class="entry_tags">
10677 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10678 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10679 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10680 </ul>
10681 </td>
10682
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10683 </tr>
10684 <tr class="entries_header">
10685 <th class="th_details" colspan="5">Details</th>
10686 </tr>
10687 <tr class="entry_cont">
10688 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10689 <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]10690equal to this,<wbr/> all applied gain must be analog.<wbr/> For
10691values above this,<wbr/> it can be a mix of analog and
10692digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10693 </td>
10694 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10695
10696
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10697 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10698 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10699
10700
10701 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10702 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10703 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10704 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10705 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10706 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10707 <span class="entry_type_container">x</span>
10708
10709 <span class="entry_type_array">
10710 2
10711 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10712 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10713 <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]10714
10715
10716 </td> <!-- entry_type -->
10717
10718 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10719 <p>Estimation of sensor noise
10720characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10721 </td>
10722
10723 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10724 var(raw pixel value) = electrons * (baseGainFactor
10725 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
10726 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10727 </td>
10728
10729 <td class="entry_range">
10730 </td>
10731
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10732 <td class="entry_tags">
10733 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10734 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10735 </ul>
10736 </td>
10737
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10738 </tr>
10739 <tr class="entries_header">
10740 <th class="th_details" colspan="5">Details</th>
10741 </tr>
10742 <tr class="entry_cont">
10743 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10744 <p>A represents sensor read noise before analog
10745amplification; B represents noise from A/<wbr/>D conversion and
10746other circuits after amplification.<wbr/> Both noise sources
10747are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
10748across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10749 </td>
10750 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10751
10752
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10753 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10754 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10755
10756
10757 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10758 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10759 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10760 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10761 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10762 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10763
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10764 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10765
10766
10767 </td> <!-- entry_type -->
10768
10769 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10770 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10771image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10772screen in its native orientation.<wbr/> Also defines the
10773direction of rolling shutter readout,<wbr/> which is from top
10774to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10775 </td>
10776
10777 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10778 degrees clockwise rotation,<wbr/> only multiples of
10779 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10780 </td>
10781
10782 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10783 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10784 </td>
10785
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10786 <td class="entry_tags">
10787 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10788 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10789 </ul>
10790 </td>
10791
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10792 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10793
10794
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10795 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10796 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10797
10798
10799 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10800 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10801 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10802 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10803 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10804 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10805
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10806 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10807
10808 <ul class="entry_type_enum">
10809 <li>
10810 <span class="entry_type_enum_name">DAYLIGHT</span>
10811 <span class="entry_type_enum_value">1</span>
10812 </li>
10813 <li>
10814 <span class="entry_type_enum_name">FLUORESCENT</span>
10815 <span class="entry_type_enum_value">2</span>
10816 </li>
10817 <li>
10818 <span class="entry_type_enum_name">TUNGSTEN</span>
10819 <span class="entry_type_enum_value">3</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10820 <span class="entry_type_enum_notes"><p>Incandescent light</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10821 </li>
10822 <li>
10823 <span class="entry_type_enum_name">FLASH</span>
10824 <span class="entry_type_enum_value">4</span>
10825 </li>
10826 <li>
10827 <span class="entry_type_enum_name">FINE_WEATHER</span>
10828 <span class="entry_type_enum_value">9</span>
10829 </li>
10830 <li>
10831 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10832 <span class="entry_type_enum_value">10</span>
10833 </li>
10834 <li>
10835 <span class="entry_type_enum_name">SHADE</span>
10836 <span class="entry_type_enum_value">11</span>
10837 </li>
10838 <li>
10839 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10840 <span class="entry_type_enum_value">12</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10841 <span class="entry_type_enum_notes"><p>D 5700 - 7100K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10842 </li>
10843 <li>
10844 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10845 <span class="entry_type_enum_value">13</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10846 <span class="entry_type_enum_notes"><p>N 4600 - 5400K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10847 </li>
10848 <li>
10849 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10850 <span class="entry_type_enum_value">14</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10851 <span class="entry_type_enum_notes"><p>W 3900 - 4500K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10852 </li>
10853 <li>
10854 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10855 <span class="entry_type_enum_value">15</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10856 <span class="entry_type_enum_notes"><p>WW 3200 - 3700K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10857 </li>
10858 <li>
10859 <span class="entry_type_enum_name">STANDARD_A</span>
10860 <span class="entry_type_enum_value">17</span>
10861 </li>
10862 <li>
10863 <span class="entry_type_enum_name">STANDARD_B</span>
10864 <span class="entry_type_enum_value">18</span>
10865 </li>
10866 <li>
10867 <span class="entry_type_enum_name">STANDARD_C</span>
10868 <span class="entry_type_enum_value">19</span>
10869 </li>
10870 <li>
10871 <span class="entry_type_enum_name">D55</span>
10872 <span class="entry_type_enum_value">20</span>
10873 </li>
10874 <li>
10875 <span class="entry_type_enum_name">D65</span>
10876 <span class="entry_type_enum_value">21</span>
10877 </li>
10878 <li>
10879 <span class="entry_type_enum_name">D75</span>
10880 <span class="entry_type_enum_value">22</span>
10881 </li>
10882 <li>
10883 <span class="entry_type_enum_name">D50</span>
10884 <span class="entry_type_enum_value">23</span>
10885 </li>
10886 <li>
10887 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10888 <span class="entry_type_enum_value">24</span>
10889 </li>
10890 </ul>
10891
10892 </td> <!-- entry_type -->
10893
10894 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10895 <p>Light source used to define transform
108961</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10897 </td>
10898
10899 <td class="entry_units">
10900 </td>
10901
10902 <td class="entry_range">
10903 </td>
10904
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10905 <td class="entry_tags">
10906 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10907 <li><a href="#tag_DNG">DNG</a></li>
10908 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10909 </ul>
10910 </td>
10911
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10912 </tr>
10913 <tr class="entries_header">
10914 <th class="th_details" colspan="5">Details</th>
10915 </tr>
10916 <tr class="entry_cont">
10917 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10918 <p>[EXIF LightSource tag] Must all these be
10919supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10920 </td>
10921 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10922
10923
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10924 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10925 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10926
10927
10928 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10929 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10930 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10931 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10932 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10933 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10934
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10935 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10936
10937
10938 </td> <!-- entry_type -->
10939
10940 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10941 <p>Light source used to define transform
109422</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10943 </td>
10944
10945 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10946 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10947 </td>
10948
10949 <td class="entry_range">
10950 </td>
10951
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10952 <td class="entry_tags">
10953 </td>
10954
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10955 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10956
10957
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10958 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10959 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10960
10961
10962
10963 <!-- end of kind -->
10964 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10965 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10966
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10967 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10968 <tr>
10969 <th class="th_name">Property Name</th>
10970 <th class="th_type">Type</th>
10971 <th class="th_description">Description</th>
10972 <th class="th_units">Units</th>
10973 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10974 <th class="th_tags">Tags</th>
10975 </tr>
10976 </thead>
10977
10978 <tbody>
10979
10980
10981
10982
10983
10984
10985
10986
10987
10988
10989 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10990 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10991 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10992 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10993 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10994 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10995
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10996 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10997
10998
10999 </td> <!-- entry_type -->
11000
11001 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11002 <p>Duration each pixel is exposed to
11003light.<wbr/></p>
11004<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
11005duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11006 </td>
11007
11008 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11009 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11010 </td>
11011
11012 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11013 <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]11014 </td>
11015
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11016 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11017 <ul class="entry_tags">
11018 <li><a href="#tag_V1">V1</a></li>
11019 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11020 </td>
11021
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11022 </tr>
11023 <tr class="entries_header">
11024 <th class="th_details" colspan="5">Details</th>
11025 </tr>
11026 <tr class="entry_cont">
11027 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11028 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11029 </td>
11030 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11031
11032
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11033 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11034 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11035
11036
11037 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11038 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11039 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11040 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11041 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11042 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11043
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11044 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11045
11046
11047 </td> <!-- entry_type -->
11048
11049 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11050 <p>Duration from start of frame exposure to
11051start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11052 </td>
11053
11054 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11055 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11056 </td>
11057
11058 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11059 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
11060android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11061 </td>
11062
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11063 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11064 <ul class="entry_tags">
11065 <li><a href="#tag_V1">V1</a></li>
11066 <li><a href="#tag_BC">BC</a></li>
11067 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11068 </td>
11069
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11070 </tr>
11071 <tr class="entries_header">
11072 <th class="th_details" colspan="5">Details</th>
11073 </tr>
11074 <tr class="entry_cont">
11075 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11076 <p>Exposure time has priority,<wbr/> so duration is set to
11077max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11078 </td>
11079 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11080
11081
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11082 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11083 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11084
11085
11086 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11087 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11088 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11089 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11090 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11091 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11092
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11093 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11094
11095
11096 </td> <!-- entry_type -->
11097
11098 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11099 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11100implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11101below 'maximum analog sensitivity'.<wbr/></p>
11102<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
11103gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11104 </td>
11105
11106 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11107 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11108 </td>
11109
11110 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11111 <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]11112 </td>
11113
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11114 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11115 <ul class="entry_tags">
11116 <li><a href="#tag_V1">V1</a></li>
11117 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11118 </td>
11119
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11120 </tr>
11121 <tr class="entries_header">
11122 <th class="th_details" colspan="5">Details</th>
11123 </tr>
11124 <tr class="entry_cont">
11125 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11126 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11127 </td>
11128 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11129
11130
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11131 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11132 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11133
11134
11135 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11136 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11137 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11138 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11139 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11140 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11141
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11142 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11143
11144
11145 </td> <!-- entry_type -->
11146
11147 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11148 <p>Time at start of exposure of first
11149row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11150 </td>
11151
11152 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11153 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11154 </td>
11155
11156 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11157 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11158 </td>
11159
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11160 <td class="entry_tags">
11161 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11162 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11163 </ul>
11164 </td>
11165
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11166 </tr>
11167 <tr class="entries_header">
11168 <th class="th_details" colspan="5">Details</th>
11169 </tr>
11170 <tr class="entry_cont">
11171 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11172 <p>Monotonic,<wbr/> should be synced to other timestamps in
11173system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11174 </td>
11175 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11176
11177
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11178 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11179 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11180
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11181
11182 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11183 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11184 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11185 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11186 <td class="entry_type">
11187 <span class="entry_type_name">float</span>
11188
11189 <span class="entry_type_visibility"> [public]</span>
11190
11191
11192 </td> <!-- entry_type -->
11193
11194 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11195 <p>The temperature of the sensor,<wbr/> sampled at the time
11196exposure began for this frame.<wbr/></p>
11197<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
11198somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11199 </td>
11200
11201 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11202 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11203 </td>
11204
11205 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11206 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11207 </td>
11208
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11209 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]11210 <ul class="entry_tags">
11211 <li><a href="#tag_FULL">FULL</a></li>
11212 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11213 </td>
11214
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11215 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11216
11217
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11218 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11219 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11220
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11221
11222
11223 <!-- end of kind -->
11224 </tbody>
11225
11226 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11227 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11228
11229
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11230 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11231
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11232 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11233 <tr>
11234 <th class="th_name">Property Name</th>
11235 <th class="th_type">Type</th>
11236 <th class="th_description">Description</th>
11237 <th class="th_units">Units</th>
11238 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11239 <th class="th_tags">Tags</th>
11240 </tr>
11241 </thead>
11242
11243 <tbody>
11244
11245
11246
11247
11248
11249
11250
11251
11252
11253
11254 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11255 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11256 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11257 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11258 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11259 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11260
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11261 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11262
11263 <ul class="entry_type_enum">
11264 <li>
11265 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11266 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11267 </li>
11268 <li>
11269 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11270 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
11271bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11272 </li>
11273 <li>
11274 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11275 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
11276quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11277 </li>
11278 </ul>
11279
11280 </td> <!-- entry_type -->
11281
11282 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11283 <p>Quality of lens shading correction applied
11284to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11285 </td>
11286
11287 <td class="entry_units">
11288 </td>
11289
11290 <td class="entry_range">
11291 </td>
11292
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11293 <td class="entry_tags">
11294 </td>
11295
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11296 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11297
11298
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11299 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11300 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11301
11302
11303 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11304 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11305 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11306 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11307 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11308 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11309
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11310 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11311
11312
11313 </td> <!-- entry_type -->
11314
11315 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11316 <p>Control the amount of shading correction
11317applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11318 </td>
11319
11320 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11321 unitless: 1-10; 10 is full shading
11322 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11323 </td>
11324
11325 <td class="entry_range">
11326 </td>
11327
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11328 <td class="entry_tags">
11329 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11330 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11331 </ul>
11332 </td>
11333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11334 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11335
11336
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11337 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11338 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11339
11340
11341
11342 <!-- end of kind -->
11343 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11344 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11345
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11346 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11347 <tr>
11348 <th class="th_name">Property Name</th>
11349 <th class="th_type">Type</th>
11350 <th class="th_description">Description</th>
11351 <th class="th_units">Units</th>
11352 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11353 <th class="th_tags">Tags</th>
11354 </tr>
11355 </thead>
11356
11357 <tbody>
11358
11359
11360
11361
11362
11363
11364
11365
11366
11367
11368 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11369 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11370 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11371 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11372 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11373 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11374
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11375 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11376
11377 <ul class="entry_type_enum">
11378 <li>
11379 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11380 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11381 </li>
11382 <li>
11383 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11384 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
11385bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11386 </li>
11387 <li>
11388 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11389 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
11390quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11391 </li>
11392 </ul>
11393
11394 </td> <!-- entry_type -->
11395
11396 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11397 <p>Quality of lens shading correction applied
11398to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11399 </td>
11400
11401 <td class="entry_units">
11402 </td>
11403
11404 <td class="entry_range">
11405 </td>
11406
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11407 <td class="entry_tags">
11408 </td>
11409
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11410 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11411
11412
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11413 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11414 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11415
11416
11417
11418 <!-- end of kind -->
11419 </tbody>
11420
11421 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11422 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11423
11424
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11425 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11426
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11427 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11428 <tr>
11429 <th class="th_name">Property Name</th>
11430 <th class="th_type">Type</th>
11431 <th class="th_description">Description</th>
11432 <th class="th_units">Units</th>
11433 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11434 <th class="th_tags">Tags</th>
11435 </tr>
11436 </thead>
11437
11438 <tbody>
11439
11440
11441
11442
11443
11444
11445
11446
11447
11448
11449 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11450 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11451 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11452 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11453 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11454 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11455
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11456 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11457
11458 <ul class="entry_type_enum">
11459 <li>
11460 <span class="entry_type_enum_name">OFF</span>
11461 </li>
11462 <li>
11463 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11464 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
11465only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11466 </li>
11467 <li>
11468 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11469 <span class="entry_type_enum_notes"><p>Optional Return all face
11470metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11471 </li>
11472 </ul>
11473
11474 </td> <!-- entry_type -->
11475
11476 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11477 <p>State of the face detector
11478unit</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">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11485 <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]11486 </td>
11487
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11488 <td class="entry_tags">
11489 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11490 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11491 </ul>
11492 </td>
11493
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11494 </tr>
11495 <tr class="entries_header">
11496 <th class="th_details" colspan="5">Details</th>
11497 </tr>
11498 <tr class="entry_cont">
11499 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11500 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11501should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11502fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11503<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]11504 </td>
11505 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11506
11507
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11508 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11509 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11510
11511
11512 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11513 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11514 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11515 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11516 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11517 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11518
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11519 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11520
11521 <ul class="entry_type_enum">
11522 <li>
11523 <span class="entry_type_enum_name">OFF</span>
11524 </li>
11525 <li>
11526 <span class="entry_type_enum_name">ON</span>
11527 </li>
11528 </ul>
11529
11530 </td> <!-- entry_type -->
11531
11532 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11533 <p>Operating mode for histogram
11534generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11535 </td>
11536
11537 <td class="entry_units">
11538 </td>
11539
11540 <td class="entry_range">
11541 </td>
11542
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11543 <td class="entry_tags">
11544 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11545 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11546 </ul>
11547 </td>
11548
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11549 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11550
11551
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11552 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11553 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11554
11555
11556 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11557 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11558 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11559 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11560 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11561 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11562
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11563 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11564
11565 <ul class="entry_type_enum">
11566 <li>
11567 <span class="entry_type_enum_name">OFF</span>
11568 </li>
11569 <li>
11570 <span class="entry_type_enum_name">ON</span>
11571 </li>
11572 </ul>
11573
11574 </td> <!-- entry_type -->
11575
11576 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11577 <p>Operating mode for sharpness map
11578generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11579 </td>
11580
11581 <td class="entry_units">
11582 </td>
11583
11584 <td class="entry_range">
11585 </td>
11586
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11587 <td class="entry_tags">
11588 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11589 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11590 </ul>
11591 </td>
11592
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11593 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11594
11595
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11596 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11597 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11598
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11599
11600 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11601 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11602 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11603 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11604 <td class="entry_type">
11605 <span class="entry_type_name entry_type_name_enum">byte</span>
11606
11607 <span class="entry_type_visibility"> [public]</span>
11608
11609 <ul class="entry_type_enum">
11610 <li>
11611 <span class="entry_type_enum_name">OFF</span>
11612 </li>
11613 <li>
11614 <span class="entry_type_enum_name">ON</span>
11615 </li>
11616 </ul>
11617
11618 </td> <!-- entry_type -->
11619
11620 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11621 <p>Whether the HAL needs to output the lens
11622shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11623 </td>
11624
11625 <td class="entry_units">
11626 </td>
11627
11628 <td class="entry_range">
11629 </td>
11630
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11631 <td class="entry_tags">
11632 </td>
11633
11634 </tr>
11635 <tr class="entries_header">
11636 <th class="th_details" colspan="5">Details</th>
11637 </tr>
11638 <tr class="entry_cont">
11639 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11640 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11641<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]11642the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11643 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11644 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11645
11646
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11647 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11648 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11649
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11650
11651
11652 <!-- end of kind -->
11653 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11654 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11655
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11656 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11657 <tr>
11658 <th class="th_name">Property Name</th>
11659 <th class="th_type">Type</th>
11660 <th class="th_description">Description</th>
11661 <th class="th_units">Units</th>
11662 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11663 <th class="th_tags">Tags</th>
11664 </tr>
11665 </thead>
11666
11667 <tbody>
11668
11669
11670
11671
11672
11673
11674
11675
11676
11677
11678
11679
11680 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11681 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11682 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11683 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11684 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11685 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11686 <span class="entry_type_container">x</span>
11687
11688 <span class="entry_type_array">
11689 n
11690 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11691 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11692 <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]11693
11694
11695 </td> <!-- entry_type -->
11696
11697 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11698 <p>Which face detection modes are available,<wbr/>
11699if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11700 </td>
11701
11702 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11703 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11704 OFF
11705 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11706 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11707 </td>
11708
11709 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11710 </td>
11711
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11712 <td class="entry_tags">
11713 </td>
11714
11715 </tr>
11716 <tr class="entries_header">
11717 <th class="th_details" colspan="5">Details</th>
11718 </tr>
11719 <tr class="entry_cont">
11720 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11721 <p>OFF means face detection is disabled,<wbr/> it must
11722be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11723<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11724<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
11725<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]11726<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11727<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
11728<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]11729 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11730 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11731
11732
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11733 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11734 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11735
11736
11737 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11738 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11739 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11740 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11741 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11742 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11743
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11744 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11745
11746
11747 </td> <!-- entry_type -->
11748
11749 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11750 <p>Number of histogram buckets
11751supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11752 </td>
11753
11754 <td class="entry_units">
11755 </td>
11756
11757 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11758 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11759 </td>
11760
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11761 <td class="entry_tags">
11762 </td>
11763
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11764 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11765
11766
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11767 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11768 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11769
11770
11771 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11772 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11773 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11774 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11775 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11776 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11777
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11778 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11779
11780
11781 </td> <!-- entry_type -->
11782
11783 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11784 <p>Maximum number of simultaneously detectable
11785faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11786 </td>
11787
11788 <td class="entry_units">
11789 </td>
11790
11791 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11792 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11793modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11794 </td>
11795
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11796 <td class="entry_tags">
11797 </td>
11798
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11799 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11800
11801
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11802 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11803 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11804
11805
11806 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11807 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11808 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11809 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11810 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11811 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11812
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11813 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11814
11815
11816 </td> <!-- entry_type -->
11817
11818 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11819 <p>Maximum value possible for a histogram
11820bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11821 </td>
11822
11823 <td class="entry_units">
11824 </td>
11825
11826 <td class="entry_range">
11827 </td>
11828
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11829 <td class="entry_tags">
11830 </td>
11831
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11832 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11833
11834
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11835 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11836 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11837
11838
11839 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11840 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11841 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11842 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11843 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11844 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11845
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11846 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11847
11848
11849 </td> <!-- entry_type -->
11850
11851 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11852 <p>Maximum value possible for a sharpness map
11853region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11854 </td>
11855
11856 <td class="entry_units">
11857 </td>
11858
11859 <td class="entry_range">
11860 </td>
11861
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11862 <td class="entry_tags">
11863 </td>
11864
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11865 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11866
11867
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11868 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11869 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11870
11871
11872 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11873 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11874 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11875 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11876 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11877 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11878 <span class="entry_type_container">x</span>
11879
11880 <span class="entry_type_array">
11881 2
11882 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11883 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11884 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11885
11886
11887 </td> <!-- entry_type -->
11888
11889 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11890 <p>Dimensions of the sharpness
11891map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11892 </td>
11893
11894 <td class="entry_units">
11895 </td>
11896
11897 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11898 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11899 </td>
11900
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11901 <td class="entry_tags">
11902 </td>
11903
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11904 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11905
11906
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11907 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11908 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11909
11910
11911
11912
11913
11914
11915 <!-- end of kind -->
11916 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11917 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11918
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11919 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11920 <tr>
11921 <th class="th_name">Property Name</th>
11922 <th class="th_type">Type</th>
11923 <th class="th_description">Description</th>
11924 <th class="th_units">Units</th>
11925 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11926 <th class="th_tags">Tags</th>
11927 </tr>
11928 </thead>
11929
11930 <tbody>
11931
11932
11933
11934
11935
11936
11937
11938
11939
11940
11941 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11942 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11943 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11944 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11945 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11946 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11947
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11948 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11949
11950 <ul class="entry_type_enum">
11951 <li>
11952 <span class="entry_type_enum_name">OFF</span>
11953 </li>
11954 <li>
11955 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11956 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
11957only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11958 </li>
11959 <li>
11960 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11961 <span class="entry_type_enum_notes"><p>Optional Return all face
11962metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11963 </li>
11964 </ul>
11965
11966 </td> <!-- entry_type -->
11967
11968 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11969 <p>State of the face detector
11970unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11971 </td>
11972
11973 <td class="entry_units">
11974 </td>
11975
11976 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11977 <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]11978 </td>
11979
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11980 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11981 <ul class="entry_tags">
11982 <li><a href="#tag_BC">BC</a></li>
11983 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11984 </td>
11985
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11986 </tr>
11987 <tr class="entries_header">
11988 <th class="th_details" colspan="5">Details</th>
11989 </tr>
11990 <tr class="entry_cont">
11991 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11992 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11993should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11994fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11995<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]11996 </td>
11997 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11998
11999
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12000 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12001 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12002
12003
12004 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12005 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12006 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12007 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12008 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12009 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12010 <span class="entry_type_container">x</span>
12011
12012 <span class="entry_type_array">
12013 n
12014 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12015 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12016
12017
12018 </td> <!-- entry_type -->
12019
12020 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12021 <p>List of unique IDs for detected
12022faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12023 </td>
12024
12025 <td class="entry_units">
12026 </td>
12027
12028 <td class="entry_range">
12029 </td>
12030
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12031 <td class="entry_tags">
12032 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12033 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12034 </ul>
12035 </td>
12036
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12037 </tr>
12038 <tr class="entries_header">
12039 <th class="th_details" colspan="5">Details</th>
12040 </tr>
12041 <tr class="entry_cont">
12042 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12043 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12044 </td>
12045 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12046
12047
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12048 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12049 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12050
12051
12052 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12053 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12054 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12055 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12056 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12057 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12058 <span class="entry_type_container">x</span>
12059
12060 <span class="entry_type_array">
12061 n x 6
12062 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12063 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12064 <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]12065
12066
12067 </td> <!-- entry_type -->
12068
12069 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12070 <p>List of landmarks for detected
12071faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12072 </td>
12073
12074 <td class="entry_units">
12075 </td>
12076
12077 <td class="entry_range">
12078 </td>
12079
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12080 <td class="entry_tags">
12081 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12082 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12083 </ul>
12084 </td>
12085
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12086 </tr>
12087 <tr class="entries_header">
12088 <th class="th_details" colspan="5">Details</th>
12089 </tr>
12090 <tr class="entry_cont">
12091 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12092 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12093 </td>
12094 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12095
12096
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12097 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12098 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12099
12100
12101 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12102 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12103 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12104 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12105 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12106 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12107 <span class="entry_type_container">x</span>
12108
12109 <span class="entry_type_array">
12110 n x 4
12111 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12112 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12113 <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]12114
12115
12116 </td> <!-- entry_type -->
12117
12118 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12119 <p>List of the bounding rectangles for detected
12120faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12121 </td>
12122
12123 <td class="entry_units">
12124 </td>
12125
12126 <td class="entry_range">
12127 </td>
12128
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12129 <td class="entry_tags">
12130 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12131 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12132 </ul>
12133 </td>
12134
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12135 </tr>
12136 <tr class="entries_header">
12137 <th class="th_details" colspan="5">Details</th>
12138 </tr>
12139 <tr class="entry_cont">
12140 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12141 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12142 </td>
12143 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12144
12145
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12146 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12147 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12148
12149
12150 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12151 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12152 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12153 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12154 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12155 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12156 <span class="entry_type_container">x</span>
12157
12158 <span class="entry_type_array">
12159 n
12160 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12161 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12162
12163
12164 </td> <!-- entry_type -->
12165
12166 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12167 <p>List of the face confidence scores for
12168detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12169 </td>
12170
12171 <td class="entry_units">
12172 </td>
12173
12174 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12175 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12176 </td>
12177
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12178 <td class="entry_tags">
12179 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12180 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12181 </ul>
12182 </td>
12183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12184 </tr>
12185 <tr class="entries_header">
12186 <th class="th_details" colspan="5">Details</th>
12187 </tr>
12188 <tr class="entry_cont">
12189 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12190 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
12191meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12192 </td>
12193 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12194
12195
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12196 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12197 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12198
12199
12200 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12201 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12202 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12203 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12204 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12205 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12206 <span class="entry_type_container">x</span>
12207
12208 <span class="entry_type_array">
12209 n x 3
12210 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12211 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12212 <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]12213
12214
12215 </td> <!-- entry_type -->
12216
12217 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12218 <p>A 3-channel histogram based on the raw
12219sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12220 </td>
12221
12222 <td class="entry_units">
12223 </td>
12224
12225 <td class="entry_range">
12226 </td>
12227
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12228 <td class="entry_tags">
12229 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12230 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12231 </ul>
12232 </td>
12233
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12234 </tr>
12235 <tr class="entries_header">
12236 <th class="th_details" colspan="5">Details</th>
12237 </tr>
12238 <tr class="entry_cont">
12239 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12240 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12241(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]12242(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
12243supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12244 </td>
12245 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12246
12247
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12248 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12249 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12250
12251
12252 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12253 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12254 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12255 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12256 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12257 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12258
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12259 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12260
12261 <ul class="entry_type_enum">
12262 <li>
12263 <span class="entry_type_enum_name">OFF</span>
12264 </li>
12265 <li>
12266 <span class="entry_type_enum_name">ON</span>
12267 </li>
12268 </ul>
12269
12270 </td> <!-- entry_type -->
12271
12272 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12273 <p>Operating mode for histogram
12274generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12275 </td>
12276
12277 <td class="entry_units">
12278 </td>
12279
12280 <td class="entry_range">
12281 </td>
12282
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12283 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12284 <ul class="entry_tags">
12285 <li><a href="#tag_V1">V1</a></li>
12286 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12287 </td>
12288
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12289 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12290
12291
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12292 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12293 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12294
12295
12296 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12297 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12298 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12299 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12300 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12301 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12302 <span class="entry_type_container">x</span>
12303
12304 <span class="entry_type_array">
12305 n x m x 3
12306 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12307 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12308 <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]12309
12310
12311 </td> <!-- entry_type -->
12312
12313 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12314 <p>A 3-channel sharpness map,<wbr/> based on the raw
12315sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12316 </td>
12317
12318 <td class="entry_units">
12319 </td>
12320
12321 <td class="entry_range">
12322 </td>
12323
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12324 <td class="entry_tags">
12325 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12326 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12327 </ul>
12328 </td>
12329
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12330 </tr>
12331 <tr class="entries_header">
12332 <th class="th_details" colspan="5">Details</th>
12333 </tr>
12334 <tr class="entry_cont">
12335 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12336 <p>If only a monochrome sharpness map is supported,<wbr/>
12337all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12338 </td>
12339 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12340
12341
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12342 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12343 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12344
12345
12346 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12347 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12348 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12349 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12350 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12351 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12352
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12353 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12354
12355 <ul class="entry_type_enum">
12356 <li>
12357 <span class="entry_type_enum_name">OFF</span>
12358 </li>
12359 <li>
12360 <span class="entry_type_enum_name">ON</span>
12361 </li>
12362 </ul>
12363
12364 </td> <!-- entry_type -->
12365
12366 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12367 <p>Operating mode for sharpness map
12368generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12369 </td>
12370
12371 <td class="entry_units">
12372 </td>
12373
12374 <td class="entry_range">
12375 </td>
12376
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12377 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12378 <ul class="entry_tags">
12379 <li><a href="#tag_V1">V1</a></li>
12380 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12381 </td>
12382
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12383 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12384
12385
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12386 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12387 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12388
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12389
12390 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12391 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12392 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12393 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12394 <td class="entry_type">
12395 <span class="entry_type_name">float</span>
12396 <span class="entry_type_container">x</span>
12397
12398 <span class="entry_type_array">
12399 4 x n x m
12400 </span>
12401 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12402 <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]12403
12404
12405 </td> <!-- entry_type -->
12406
12407 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12408 <p>The shading map is a low-resolution floating-point map
12409that lists the coefficients used to correct for vignetting,<wbr/> for each
12410Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12411 </td>
12412
12413 <td class="entry_units">
12414 </td>
12415
12416 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12417 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12418 </td>
12419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12420 <td class="entry_tags">
12421 </td>
12422
12423 </tr>
12424 <tr class="entries_header">
12425 <th class="th_details" colspan="5">Details</th>
12426 </tr>
12427 <tr class="entry_cont">
12428 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12429 <p>The least shaded section of the image should have a gain factor
12430of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12431<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]12432must take into account the colorCorrection settings.<wbr/></p>
12433<p>The shading map is for the entire active pixel array,<wbr/> and is not
12434affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]12435entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12436pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
12437map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
12438(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
12439pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
12440The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
12441<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
12442channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
12443The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12444is 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]12445<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
12446and must be smaller than 64x64.<wbr/></p>
12447<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12448<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
12449<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]12450[ 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/>
12451 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/>
12452 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/>
12453 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/>
12454 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/>
12455 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]12456</code></pre>
12457<p>The low-resolution scaling map images for each channel are
12458(displayed using nearest-neighbor interpolation):</p>
12459<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
12460<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
12461<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
12462<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]12463<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]12464image 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]12465<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]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 -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12472
12473
12474 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
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/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12477 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12478 <td class="entry_type">
12479 <span class="entry_type_name">float</span>
12480 <span class="entry_type_container">x</span>
12481
12482 <span class="entry_type_array">
12483 4
12484 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12485 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12486 <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]12487
12488
12489 </td> <!-- entry_type -->
12490
12491 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12492 <p>The best-fit color channel gains calculated
12493by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12494 </td>
12495
12496 <td class="entry_units">
12497 </td>
12498
12499 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12500 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12501 </td>
12502
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12503 <td class="entry_tags">
12504 </td>
12505
12506 </tr>
12507 <tr class="entries_header">
12508 <th class="th_details" colspan="5">Details</th>
12509 </tr>
12510 <tr class="entry_cont">
12511 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12512 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12513since statistics processing on data from a new frame
12514typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12515applied to that frame.<wbr/></p>
12516<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12517see <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]12518<p>This value should always be calculated by the AWB block,<wbr/>
12519regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12520 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12521 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12522
12523
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12524 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12525 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12526
12527
12528 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12529 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12530 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12531 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12532 <td class="entry_type">
12533 <span class="entry_type_name">rational</span>
12534 <span class="entry_type_container">x</span>
12535
12536 <span class="entry_type_array">
12537 3 x 3
12538 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12539 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12540 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12541
12542
12543 </td> <!-- entry_type -->
12544
12545 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12546 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12547calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12548output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12549 </td>
12550
12551 <td class="entry_units">
12552 </td>
12553
12554 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12555 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12556 </td>
12557
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12558 <td class="entry_tags">
12559 </td>
12560
12561 </tr>
12562 <tr class="entries_header">
12563 <th class="th_details" colspan="5">Details</th>
12564 </tr>
12565 <tr class="entry_cont">
12566 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12567 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12568statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12569for the next frame.<wbr/> These are the values the HAL believes
12570are the best fit for the current output frame.<wbr/> This may
12571be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12572statistics processing on data from a new frame typically
12573completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12574that frame.<wbr/></p>
12575<p>These estimates must be provided for all frames,<wbr/> even if
12576capture settings and color transforms are set by the application.<wbr/></p>
12577<p>This value should always be calculated by the AWB block,<wbr/>
12578regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12579 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12580 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12581
12582
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12583 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12584 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12585
12586
12587 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12588 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12589 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12590 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12591 <td class="entry_type">
12592 <span class="entry_type_name entry_type_name_enum">byte</span>
12593
12594 <span class="entry_type_visibility"> [public]</span>
12595
12596 <ul class="entry_type_enum">
12597 <li>
12598 <span class="entry_type_enum_name">NONE</span>
12599 </li>
12600 <li>
12601 <span class="entry_type_enum_name">50HZ</span>
12602 </li>
12603 <li>
12604 <span class="entry_type_enum_name">60HZ</span>
12605 </li>
12606 </ul>
12607
12608 </td> <!-- entry_type -->
12609
12610 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12611 <p>The HAL estimated scene illumination lighting
12612frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12613 </td>
12614
12615 <td class="entry_units">
12616 </td>
12617
12618 <td class="entry_range">
12619 </td>
12620
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12621 <td class="entry_tags">
12622 </td>
12623
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12624 </tr>
12625 <tr class="entries_header">
12626 <th class="th_details" colspan="5">Details</th>
12627 </tr>
12628 <tr class="entry_cont">
12629 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12630 <p>Report NONE if there doesn't appear to be flickering
12631illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12632 </td>
12633 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12634
12635
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12636 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12637 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12638
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12639
12640
12641 <!-- end of kind -->
12642 </tbody>
12643
12644 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12645 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12646
12647
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12648 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12649
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12650 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12651 <tr>
12652 <th class="th_name">Property Name</th>
12653 <th class="th_type">Type</th>
12654 <th class="th_description">Description</th>
12655 <th class="th_units">Units</th>
12656 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12657 <th class="th_tags">Tags</th>
12658 </tr>
12659 </thead>
12660
12661 <tbody>
12662
12663
12664
12665
12666
12667
12668
12669
12670
12671
12672 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12673 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12674 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12675 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12676 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12677 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12678 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12679
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12680 <span class="entry_type_array">
12681 n x 2
12682 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12683 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12684 <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]12685
12686
12687 </td> <!-- entry_type -->
12688
12689 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12690 <p>Table mapping blue input values to output
12691values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12692 </td>
12693
12694 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12695 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12696 </td>
12697
12698 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12699 <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]12700 </td>
12701
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12702 <td class="entry_tags">
12703 </td>
12704
12705 </tr>
12706 <tr class="entries_header">
12707 <th class="th_details" colspan="5">Details</th>
12708 </tr>
12709 <tr class="entry_cont">
12710 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12711 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12712channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12713<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]12714 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12715 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12716
12717
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12718 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12719 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12720
12721
12722 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12723 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12724 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12725 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12726 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12727 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12728 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12729
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12730 <span class="entry_type_array">
12731 n x 2
12732 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12733 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12734 <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]12735
12736
12737 </td> <!-- entry_type -->
12738
12739 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12740 <p>Table mapping green input values to output
12741values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12742 </td>
12743
12744 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12745 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12746 </td>
12747
12748 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12749 <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]12750 </td>
12751
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12752 <td class="entry_tags">
12753 </td>
12754
12755 </tr>
12756 <tr class="entries_header">
12757 <th class="th_details" colspan="5">Details</th>
12758 </tr>
12759 <tr class="entry_cont">
12760 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12761 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12762channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12763<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]12764 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12765 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12766
12767
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12768 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12769 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12770
12771
12772 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12773 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12774 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12775 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12776 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12777 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12778 <span class="entry_type_container">x</span>
12779
12780 <span class="entry_type_array">
12781 n x 2
12782 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12783 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12784 <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]12785
12786
12787 </td> <!-- entry_type -->
12788
12789 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12790 <p>Table mapping red input values to output
12791values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12792 </td>
12793
12794 <td class="entry_units">
12795 </td>
12796
12797 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12798 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12799 </td>
12800
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12801 <td class="entry_tags">
12802 <ul class="entry_tags">
12803 <li><a href="#tag_DNG">DNG</a></li>
12804 </ul>
12805 </td>
12806
12807 </tr>
12808 <tr class="entries_header">
12809 <th class="th_details" colspan="5">Details</th>
12810 </tr>
12811 <tr class="entry_cont">
12812 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12813 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12814channel,<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]12815<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12816the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12817are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12818between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12819<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12820defined points.<wbr/> The points will be listed in increasing
12821order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
128220.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12823for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
128240.<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]12825 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12826 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12827
12828
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12829 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12830 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12831
12832
12833 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12834 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12835 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12836 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12837 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12838 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12839
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12840 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12841
12842 <ul class="entry_type_enum">
12843 <li>
12844 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12845 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
12846android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12847 </li>
12848 <li>
12849 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12850 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
12851bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12852 </li>
12853 <li>
12854 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12855 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
12856quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12857 </li>
12858 </ul>
12859
12860 </td> <!-- entry_type -->
12861
12862 <td class="entry_description">
12863 </td>
12864
12865 <td class="entry_units">
12866 </td>
12867
12868 <td class="entry_range">
12869 </td>
12870
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12871 <td class="entry_tags">
12872 </td>
12873
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12874 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12875
12876
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12877 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12878 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12879
12880
12881
12882 <!-- end of kind -->
12883 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12884 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12885
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12886 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12887 <tr>
12888 <th class="th_name">Property Name</th>
12889 <th class="th_type">Type</th>
12890 <th class="th_description">Description</th>
12891 <th class="th_units">Units</th>
12892 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12893 <th class="th_tags">Tags</th>
12894 </tr>
12895 </thead>
12896
12897 <tbody>
12898
12899
12900
12901
12902
12903
12904
12905
12906
12907
12908 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12909 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12910 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12911 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12912 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12913 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12914
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12915 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12916
12917
12918 </td> <!-- entry_type -->
12919
12920 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12921 <p>Maximum number of supported points in the
12922tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12923 </td>
12924
12925 <td class="entry_units">
12926 </td>
12927
12928 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]12929 <p>&gt;= 128</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12930 </td>
12931
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12932 <td class="entry_tags">
12933 </td>
12934
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12935 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12936
12937
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12938 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12939 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12940
12941
12942
12943 <!-- end of kind -->
12944 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12945 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12946
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12947 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12948 <tr>
12949 <th class="th_name">Property Name</th>
12950 <th class="th_type">Type</th>
12951 <th class="th_description">Description</th>
12952 <th class="th_units">Units</th>
12953 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12954 <th class="th_tags">Tags</th>
12955 </tr>
12956 </thead>
12957
12958 <tbody>
12959
12960
12961
12962
12963
12964
12965
12966
12967
12968
12969 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12970 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12971 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12972 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12973 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12974 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12975 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12976
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12977 <span class="entry_type_array">
12978 n x 2
12979 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12980 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12981 <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]12982
12983
12984 </td> <!-- entry_type -->
12985
12986 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12987 <p>Table mapping blue input values to output
12988values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12989 </td>
12990
12991 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12992 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12993 </td>
12994
12995 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12996 <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]12997 </td>
12998
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12999 <td class="entry_tags">
13000 </td>
13001
13002 </tr>
13003 <tr class="entries_header">
13004 <th class="th_details" colspan="5">Details</th>
13005 </tr>
13006 <tr class="entry_cont">
13007 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13008 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13009channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
13010<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]13011 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13012 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13013
13014
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13015 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13016 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13017
13018
13019 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13020 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13021 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13022 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13023 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]13024 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13025 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13026
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13027 <span class="entry_type_array">
13028 n x 2
13029 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13030 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13031 <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]13032
13033
13034 </td> <!-- entry_type -->
13035
13036 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13037 <p>Table mapping green input values to output
13038values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13039 </td>
13040
13041 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13042 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13043 </td>
13044
13045 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13046 <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]13047 </td>
13048
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13049 <td class="entry_tags">
13050 </td>
13051
13052 </tr>
13053 <tr class="entries_header">
13054 <th class="th_details" colspan="5">Details</th>
13055 </tr>
13056 <tr class="entry_cont">
13057 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13058 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13059channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
13060<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]13061 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13062 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13063
13064
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13065 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13066 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13067
13068
13069 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13070 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13071 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13072 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13073 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13074 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13075 <span class="entry_type_container">x</span>
13076
13077 <span class="entry_type_array">
13078 n x 2
13079 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13080 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13081 <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]13082
13083
13084 </td> <!-- entry_type -->
13085
13086 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13087 <p>Table mapping red input values to output
13088values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13089 </td>
13090
13091 <td class="entry_units">
13092 </td>
13093
13094 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13095 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13096 </td>
13097
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13098 <td class="entry_tags">
13099 <ul class="entry_tags">
13100 <li><a href="#tag_DNG">DNG</a></li>
13101 </ul>
13102 </td>
13103
13104 </tr>
13105 <tr class="entries_header">
13106 <th class="th_details" colspan="5">Details</th>
13107 </tr>
13108 <tr class="entry_cont">
13109 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13110 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13111channel,<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]13112<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13113the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13114are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13115between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13116<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13117defined points.<wbr/> The points will be listed in increasing
13118order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
131190.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
13120for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
131210.<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]13122 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13123 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13124
13125
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13126 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13127 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13128
13129
13130 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13131 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13132 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13133 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13134 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13135 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13136
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13137 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13138
13139 <ul class="entry_type_enum">
13140 <li>
13141 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13142 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
13143android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13144 </li>
13145 <li>
13146 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13147 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
13148bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13149 </li>
13150 <li>
13151 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13152 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
13153quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13154 </li>
13155 </ul>
13156
13157 </td> <!-- entry_type -->
13158
13159 <td class="entry_description">
13160 </td>
13161
13162 <td class="entry_units">
13163 </td>
13164
13165 <td class="entry_range">
13166 </td>
13167
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13168 <td class="entry_tags">
13169 </td>
13170
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13171 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13172
13173
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13174 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13175 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13176
13177
13178
13179 <!-- end of kind -->
13180 </tbody>
13181
13182 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13183 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13184
13185
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13186 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13187
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13188 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13189 <tr>
13190 <th class="th_name">Property Name</th>
13191 <th class="th_type">Type</th>
13192 <th class="th_description">Description</th>
13193 <th class="th_units">Units</th>
13194 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13195 <th class="th_tags">Tags</th>
13196 </tr>
13197 </thead>
13198
13199 <tbody>
13200
13201
13202
13203
13204
13205
13206
13207
13208
13209
13210 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13211 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13212 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13213 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13214 <td class="entry_type">
13215 <span class="entry_type_name entry_type_name_enum">byte</span>
13216
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13217 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13218
13219 <ul class="entry_type_enum">
13220 <li>
13221 <span class="entry_type_enum_name">OFF</span>
13222 </li>
13223 <li>
13224 <span class="entry_type_enum_name">ON</span>
13225 </li>
13226 </ul>
13227
13228 </td> <!-- entry_type -->
13229
13230 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13231 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13232that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13233Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13234disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13235any untrusted applications.<wbr/></p>
13236<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
13237transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
13238data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13239<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]13240doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13241 </td>
13242
13243 <td class="entry_units">
13244 </td>
13245
13246 <td class="entry_range">
13247 </td>
13248
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13249 <td class="entry_tags">
13250 </td>
13251
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13252 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13253
13254
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13255 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13256 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13257
13258
13259
13260 <!-- end of kind -->
13261 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13262 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13263
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13264 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13265 <tr>
13266 <th class="th_name">Property Name</th>
13267 <th class="th_type">Type</th>
13268 <th class="th_description">Description</th>
13269 <th class="th_units">Units</th>
13270 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13271 <th class="th_tags">Tags</th>
13272 </tr>
13273 </thead>
13274
13275 <tbody>
13276
13277
13278
13279
13280
13281
13282
13283
13284
13285
13286 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13287 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13288 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13289 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13290 <td class="entry_type">
13291 <span class="entry_type_name entry_type_name_enum">byte</span>
13292
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13293 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13294
13295 <ul class="entry_type_enum">
13296 <li>
13297 <span class="entry_type_enum_name">OFF</span>
13298 </li>
13299 <li>
13300 <span class="entry_type_enum_name">ON</span>
13301 </li>
13302 </ul>
13303
13304 </td> <!-- entry_type -->
13305
13306 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13307 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13308that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13309Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13310disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13311any untrusted applications.<wbr/></p>
13312<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
13313transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
13314data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13315<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]13316doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13317 </td>
13318
13319 <td class="entry_units">
13320 </td>
13321
13322 <td class="entry_range">
13323 </td>
13324
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13325 <td class="entry_tags">
13326 </td>
13327
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13328 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13329
13330
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13331 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13332 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13333
13334
13335
13336 <!-- end of kind -->
13337 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13338 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13339
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13340 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13341 <tr>
13342 <th class="th_name">Property Name</th>
13343 <th class="th_type">Type</th>
13344 <th class="th_description">Description</th>
13345 <th class="th_units">Units</th>
13346 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13347 <th class="th_tags">Tags</th>
13348 </tr>
13349 </thead>
13350
13351 <tbody>
13352
13353
13354
13355
13356
13357
13358
13359
13360
13361
13362 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13363 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13364 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13365 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13366 <td class="entry_type">
13367 <span class="entry_type_name entry_type_name_enum">byte</span>
13368 <span class="entry_type_container">x</span>
13369
13370 <span class="entry_type_array">
13371 n
13372 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13373 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13374
13375 <ul class="entry_type_enum">
13376 <li>
13377 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13378 <span class="entry_type_enum_notes"><p><a href="#controls_android.led.transmit">android.<wbr/>led.<wbr/>transmit</a> control is used</p></span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13379 </li>
13380 </ul>
13381
13382 </td> <!-- entry_type -->
13383
13384 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13385 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13386 </td>
13387
13388 <td class="entry_units">
13389 </td>
13390
13391 <td class="entry_range">
13392 </td>
13393
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13394 <td class="entry_tags">
13395 </td>
13396
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13397 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13398
13399
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13400 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13401 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13402
13403
13404
13405 <!-- end of kind -->
13406 </tbody>
13407
13408 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13409 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13410
13411
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13412 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13413
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13414 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13415 <tr>
13416 <th class="th_name">Property Name</th>
13417 <th class="th_type">Type</th>
13418 <th class="th_description">Description</th>
13419 <th class="th_units">Units</th>
13420 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13421 <th class="th_tags">Tags</th>
13422 </tr>
13423 </thead>
13424
13425 <tbody>
13426
13427
13428
13429
13430
13431
13432
13433
13434
13435
13436 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13437 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13438 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13439 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13440 <td class="entry_type">
13441 <span class="entry_type_name entry_type_name_enum">byte</span>
13442
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13443 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13444
13445 <ul class="entry_type_enum">
13446 <li>
13447 <span class="entry_type_enum_name">LIMITED</span>
13448 </li>
13449 <li>
13450 <span class="entry_type_enum_name">FULL</span>
13451 </li>
13452 </ul>
13453
13454 </td> <!-- entry_type -->
13455
13456 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13457 <p>The camera 3 HAL device can implement one of two possible
13458operational modes; limited and full.<wbr/> Full support is
13459expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13460hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13461camera HAL device v1 implementation,<wbr/> and is expected from
13462older or inexpensive devices.<wbr/> Full is a strict superset of
13463limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
13464<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]13465 </td>
13466
13467 <td class="entry_units">
13468 </td>
13469
13470 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13471 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13472 </td>
13473
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13474 <td class="entry_tags">
13475 </td>
13476
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13477 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13478
13479
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13480 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13481 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13482
13483
13484
13485 <!-- end of kind -->
13486 </tbody>
13487
13488 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13489 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13490
13491
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13492 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13493
13494 <thead class="entries_header">
13495 <tr>
13496 <th class="th_name">Property Name</th>
13497 <th class="th_type">Type</th>
13498 <th class="th_description">Description</th>
13499 <th class="th_units">Units</th>
13500 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13501 <th class="th_tags">Tags</th>
13502 </tr>
13503 </thead>
13504
13505 <tbody>
13506
13507
13508
13509
13510
13511
13512
13513
13514
13515
13516 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13517 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13518 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13519 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13520 <td class="entry_type">
13521 <span class="entry_type_name entry_type_name_enum">byte</span>
13522
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13523 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13524
13525 <ul class="entry_type_enum">
13526 <li>
13527 <span class="entry_type_enum_name">OFF</span>
13528 </li>
13529 <li>
13530 <span class="entry_type_enum_name">ON</span>
13531 </li>
13532 </ul>
13533
13534 </td> <!-- entry_type -->
13535
13536 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13537 <p>Whether black-level compensation is locked
13538to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13539 </td>
13540
13541 <td class="entry_units">
13542 </td>
13543
13544 <td class="entry_range">
13545 </td>
13546
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13547 <td class="entry_tags">
13548 <ul class="entry_tags">
13549 <li><a href="#tag_HAL2">HAL2</a></li>
13550 </ul>
13551 </td>
13552
13553 </tr>
13554 <tr class="entries_header">
13555 <th class="th_details" colspan="5">Details</th>
13556 </tr>
13557 <tr class="entry_cont">
13558 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13559 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13560compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13561OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13562<p>Since changes to certain capture parameters (such as
13563exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13564compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13565the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13566metadata.<wbr/></p>
13567<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13568<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13569<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13570<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13571<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13572<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13573<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13574<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13575</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13576<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13577device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13578result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13579<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13580<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13581<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13582<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13583<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
13584<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13585<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13586</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13587<p>This indicates to the application that on frame 4,<wbr/> black
13588levels were reset due to exposure value changes,<wbr/> and pixel
13589values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13590<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13591possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13592other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13593or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13594 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13595 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13596
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13597 <tr class="entries_header">
13598 <th class="th_details" colspan="5">HAL Implementation Details</th>
13599 </tr>
13600 <tr class="entry_cont">
13601 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13602 <p>If for some reason black level locking is no longer possible
13603(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13604black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13605override this request (and it must report 'OFF' when this
13606does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13607possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13608 </td>
13609 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13610
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13611 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13612 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13613
13614
13615
13616 <!-- end of kind -->
13617 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13618 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13619
13620 <thead class="entries_header">
13621 <tr>
13622 <th class="th_name">Property Name</th>
13623 <th class="th_type">Type</th>
13624 <th class="th_description">Description</th>
13625 <th class="th_units">Units</th>
13626 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13627 <th class="th_tags">Tags</th>
13628 </tr>
13629 </thead>
13630
13631 <tbody>
13632
13633
13634
13635
13636
13637
13638
13639
13640
13641
13642 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13643 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13644 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13645 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13646 <td class="entry_type">
13647 <span class="entry_type_name entry_type_name_enum">byte</span>
13648
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13649 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13650
13651 <ul class="entry_type_enum">
13652 <li>
13653 <span class="entry_type_enum_name">OFF</span>
13654 </li>
13655 <li>
13656 <span class="entry_type_enum_name">ON</span>
13657 </li>
13658 </ul>
13659
13660 </td> <!-- entry_type -->
13661
13662 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13663 <p>Whether black-level compensation is locked
13664to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13665 </td>
13666
13667 <td class="entry_units">
13668 </td>
13669
13670 <td class="entry_range">
13671 </td>
13672
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13673 <td class="entry_tags">
13674 <ul class="entry_tags">
13675 <li><a href="#tag_HAL2">HAL2</a></li>
13676 </ul>
13677 </td>
13678
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13679 </tr>
13680 <tr class="entries_header">
13681 <th class="th_details" colspan="5">Details</th>
13682 </tr>
13683 <tr class="entry_cont">
13684 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13685 <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]13686ON 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]13687a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13688perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13689 </td>
13690 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13691
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13692 <tr class="entries_header">
13693 <th class="th_details" colspan="5">HAL Implementation Details</th>
13694 </tr>
13695 <tr class="entry_cont">
13696 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13697 <p>If for some reason black level locking is no longer possible
13698(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13699black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13700override this request (and it must report 'OFF' when this
13701does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13702possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13703 </td>
13704 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13705
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13706 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13707 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13708
13709
13710
13711 <!-- end of kind -->
13712 </tbody>
13713
13714 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13715<!-- </namespace> -->
13716 </table>
13717
13718 <div class="tags" id="tag_index">
13719 <h2>Tags</h2>
13720 <ul>
13721 <li id="tag_AWB">AWB -
13722 Needed for auto white balance
13723
13724 <ul class="tags_entries">
13725 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13726 </ul>
13727 </li> <!-- tag_AWB -->
13728 <li id="tag_BC">BC -
13729 Needed for backwards compatibility with old Java API
13730
13731 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]13732 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13733 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
13734 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
13735 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
13736 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
13737 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13738 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13739 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
13740 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13741 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13742 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
13743 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13744 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
13745 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
13746 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
13747 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
13748 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
13749 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]13750 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13751 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
13752 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
13753 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
13754 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
13755 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
13756 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
13757 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
13758 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
13759 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
13760 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
13761 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
13762 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
13763 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
13764 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
13765 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
13766 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
13767 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
13768 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
13769 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
13770 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13771 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13772 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
13773 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
13774 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
13775 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
13776 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
13777 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
13778 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]13779 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13780 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
13781 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
13782 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13783 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13784 <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]13785 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13786 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13787 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13788 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
13789 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
13790 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
13791 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
13792 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
13793 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
13794 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
13795 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
13796 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
13797 </ul>
13798 </li> <!-- tag_BC -->
13799 <li id="tag_V1">V1 -
13800 New features for first camera 2 release (API1)
13801
13802 <ul class="tags_entries">
13803 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13804 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13805 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13806 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13807 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13808 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13809 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13810 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13811 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13812 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13813 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13814 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13815 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13816 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13817 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13818 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13819 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13820 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13821 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13822 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13823 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13824 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13825 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13826 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13827 <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]13828 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13829 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13830 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13831 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13832 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13833 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13834 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13835 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13836 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13837 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13838 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13839 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13840 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13841 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13842 </ul>
13843 </li> <!-- tag_V1 -->
13844 <li id="tag_ADV">ADV - None
13845 <ul class="tags_entries">
13846 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13847 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13848 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13849 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13850 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13851 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13852 </ul>
13853 </li> <!-- tag_ADV -->
13854 <li id="tag_DNG">DNG -
13855 Needed for DNG file support
13856
13857 <ul class="tags_entries">
13858 <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]13859 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13860 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13861 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13862 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13863 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13864 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13865 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13866 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13867 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13868 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13869 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13870 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13871 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13872 </ul>
13873 </li> <!-- tag_DNG -->
13874 <li id="tag_EXIF">EXIF - None
13875 <ul class="tags_entries">
13876 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13877 </ul>
13878 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13879 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13880 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13881
13882 <ul class="tags_entries">
13883 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13884 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13885 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13886 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13887 </ul>
13888 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13889 <li id="tag_FULL">FULL -
13890 Entry is required for full hardware level devices, and optional for other hardware levels
13891
13892 <ul class="tags_entries">
13893 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13894 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13895 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13896 </ul>
13897 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13898 </ul>
13899 </div>
13900
13901 [ <a href="#">top</a> ]
13902
13903</body>
13904</html>