Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / ea27bc3e0002389396e9d7e60fc8b1edbbefcb90 / . / camera / docs / docs.html
blob: 9f7883baac1b6f43b72265b8fbebb85e920b3d82 [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">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]2090 <p>Information to the camera device 3A (auto-exposure,<wbr/>
2091auto-focus,<wbr/> auto-white balance) routines about the purpose
2092of this capture,<wbr/> to help the camera device to decide optimal 3A
2093strategy.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2094 </td>
2095
2096 <td class="entry_units">
2097 </td>
2098
2099 <td class="entry_range">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]2100 <p>All must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2101 </td>
2102
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2103 <td class="entry_tags">
2104 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2105 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2106 </ul>
2107 </td>
2108
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2109 </tr>
2110 <tr class="entries_header">
2111 <th class="th_details" colspan="5">Details</th>
2112 </tr>
2113 <tr class="entry_cont">
2114 <td class="entry_details" colspan="5">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]2115 <p>This control is only effective if <code><a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF</code>
2116and any 3A routine is active.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2117 </td>
2118 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2119
2120
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2121 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2122 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2123
2124
2125 <tr class="entry" id="controls_android.control.effectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2126 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2127 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2128 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2129 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2130 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2131
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2132 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2133
2134 <ul class="entry_type_enum">
2135 <li>
2136 <span class="entry_type_enum_name">OFF</span>
2137 </li>
2138 <li>
2139 <span class="entry_type_enum_name">MONO</span>
2140 <span class="entry_type_enum_optional">optional</span>
2141 </li>
2142 <li>
2143 <span class="entry_type_enum_name">NEGATIVE</span>
2144 <span class="entry_type_enum_optional">optional</span>
2145 </li>
2146 <li>
2147 <span class="entry_type_enum_name">SOLARIZE</span>
2148 <span class="entry_type_enum_optional">optional</span>
2149 </li>
2150 <li>
2151 <span class="entry_type_enum_name">SEPIA</span>
2152 <span class="entry_type_enum_optional">optional</span>
2153 </li>
2154 <li>
2155 <span class="entry_type_enum_name">POSTERIZE</span>
2156 <span class="entry_type_enum_optional">optional</span>
2157 </li>
2158 <li>
2159 <span class="entry_type_enum_name">WHITEBOARD</span>
2160 <span class="entry_type_enum_optional">optional</span>
2161 </li>
2162 <li>
2163 <span class="entry_type_enum_name">BLACKBOARD</span>
2164 <span class="entry_type_enum_optional">optional</span>
2165 </li>
2166 <li>
2167 <span class="entry_type_enum_name">AQUA</span>
2168 <span class="entry_type_enum_optional">optional</span>
2169 </li>
2170 </ul>
2171
2172 </td> <!-- entry_type -->
2173
2174 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2175 <p>Whether any special color effect is in use.<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2176Only 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]2177 </td>
2178
2179 <td class="entry_units">
2180 </td>
2181
2182 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2183 <p><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]2184 </td>
2185
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2186 <td class="entry_tags">
2187 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2188 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2189 </ul>
2190 </td>
2191
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2192 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2193
2194
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2195 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2196 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2197
2198
2199 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2200 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2201 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2202 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2203 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2204 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2205
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2206 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2207
2208 <ul class="entry_type_enum">
2209 <li>
2210 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2211 <span class="entry_type_enum_notes"><p>Full application control of pipeline.<wbr/> All 3A
2212routines are disabled,<wbr/> no other settings in
2213android.<wbr/>control.<wbr/>* have any effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2214 </li>
2215 <li>
2216 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2217 <span class="entry_type_enum_notes"><p>Use settings for each individual 3A routine.<wbr/>
2218Manual control of capture parameters is disabled.<wbr/> All
2219controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2220effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2221 </li>
2222 <li>
2223 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2224 <span class="entry_type_enum_notes"><p>Use specific scene mode.<wbr/> Enabling this disables
2225control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
2226controls; the HAL must ignore those settings while
2227USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2228scene mode).<wbr/> Other control entries are still active.<wbr/>
2229This setting can only be used if availableSceneModes !=
2230UNSUPPORTED</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2231 </li>
2232 </ul>
2233
2234 </td> <!-- entry_type -->
2235
2236 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2237 <p>Overall mode of 3A control
2238routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2239 </td>
2240
2241 <td class="entry_units">
2242 </td>
2243
2244 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2245 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2246 </td>
2247
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2248 <td class="entry_tags">
2249 <ul class="entry_tags">
2250 <li><a href="#tag_BC">BC</a></li>
2251 </ul>
2252 </td>
2253
2254 </tr>
2255 <tr class="entries_header">
2256 <th class="th_details" colspan="5">Details</th>
2257 </tr>
2258 <tr class="entry_cont">
2259 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2260 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2261by the camera device is disabled.<wbr/> The application must set the fields for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2262capture parameters itself.<wbr/></p>
2263<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2264android.<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]2265<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2266android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the camera device implements
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2267one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]2268as it wishes.<wbr/> The camera device scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2269<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]2270 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2271 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2272
2273
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2274 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2275 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2276
2277
2278 <tr class="entry" id="controls_android.control.sceneMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2279 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2280 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2281 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2282 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2283 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2284
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2285 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2286
2287 <ul class="entry_type_enum">
2288 <li>
2289 <span class="entry_type_enum_name">UNSUPPORTED</span>
2290 <span class="entry_type_enum_value">0</span>
2291 </li>
2292 <li>
2293 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]2294 <span class="entry_type_enum_notes"><p>if face detection support exists Use face
2295detection data to drive 3A routines.<wbr/> If face detection
2296statistics are disabled,<wbr/> should still operate correctly
2297(but not return face detection statistics to the
2298framework).<wbr/></p>
2299<p>Unlike the other scene modes,<wbr/> aeMode,<wbr/> awbMode,<wbr/> and afMode
2300remain active when FACE_<wbr/>PRIORITY is set.<wbr/> This is due to
2301compatibility concerns with the old camera
2302API</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2303 </li>
2304 <li>
2305 <span class="entry_type_enum_name">ACTION</span>
2306 <span class="entry_type_enum_optional">optional</span>
2307 </li>
2308 <li>
2309 <span class="entry_type_enum_name">PORTRAIT</span>
2310 <span class="entry_type_enum_optional">optional</span>
2311 </li>
2312 <li>
2313 <span class="entry_type_enum_name">LANDSCAPE</span>
2314 <span class="entry_type_enum_optional">optional</span>
2315 </li>
2316 <li>
2317 <span class="entry_type_enum_name">NIGHT</span>
2318 <span class="entry_type_enum_optional">optional</span>
2319 </li>
2320 <li>
2321 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2322 <span class="entry_type_enum_optional">optional</span>
2323 </li>
2324 <li>
2325 <span class="entry_type_enum_name">THEATRE</span>
2326 <span class="entry_type_enum_optional">optional</span>
2327 </li>
2328 <li>
2329 <span class="entry_type_enum_name">BEACH</span>
2330 <span class="entry_type_enum_optional">optional</span>
2331 </li>
2332 <li>
2333 <span class="entry_type_enum_name">SNOW</span>
2334 <span class="entry_type_enum_optional">optional</span>
2335 </li>
2336 <li>
2337 <span class="entry_type_enum_name">SUNSET</span>
2338 <span class="entry_type_enum_optional">optional</span>
2339 </li>
2340 <li>
2341 <span class="entry_type_enum_name">STEADYPHOTO</span>
2342 <span class="entry_type_enum_optional">optional</span>
2343 </li>
2344 <li>
2345 <span class="entry_type_enum_name">FIREWORKS</span>
2346 <span class="entry_type_enum_optional">optional</span>
2347 </li>
2348 <li>
2349 <span class="entry_type_enum_name">SPORTS</span>
2350 <span class="entry_type_enum_optional">optional</span>
2351 </li>
2352 <li>
2353 <span class="entry_type_enum_name">PARTY</span>
2354 <span class="entry_type_enum_optional">optional</span>
2355 </li>
2356 <li>
2357 <span class="entry_type_enum_name">CANDLELIGHT</span>
2358 <span class="entry_type_enum_optional">optional</span>
2359 </li>
2360 <li>
2361 <span class="entry_type_enum_name">BARCODE</span>
2362 <span class="entry_type_enum_optional">optional</span>
2363 </li>
2364 </ul>
2365
2366 </td> <!-- entry_type -->
2367
2368 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2369 <p>Which scene mode is active when
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2370<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]2371 </td>
2372
2373 <td class="entry_units">
2374 </td>
2375
2376 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2377 <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]2378 </td>
2379
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2380 <td class="entry_tags">
2381 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2382 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2383 </ul>
2384 </td>
2385
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2386 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2387
2388
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2389 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2390 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2391
2392
2393 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2394 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2395 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2396 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2397 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2398 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2399
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2400 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2401
2402 <ul class="entry_type_enum">
2403 <li>
2404 <span class="entry_type_enum_name">OFF</span>
2405 </li>
2406 <li>
2407 <span class="entry_type_enum_name">ON</span>
2408 </li>
2409 </ul>
2410
2411 </td> <!-- entry_type -->
2412
2413 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2414 <p>Whether video stabilization is
2415active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2416 </td>
2417
2418 <td class="entry_units">
2419 </td>
2420
2421 <td class="entry_range">
2422 </td>
2423
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2424 <td class="entry_tags">
2425 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2426 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2427 </ul>
2428 </td>
2429
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2430 </tr>
2431 <tr class="entries_header">
2432 <th class="th_details" colspan="5">Details</th>
2433 </tr>
2434 <tr class="entry_cont">
2435 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2436 <p>If enabled,<wbr/> video stabilization can modify the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2437<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]2438stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2439 </td>
2440 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2441
2442
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2443 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2444 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2445
2446
2447
2448 <!-- end of kind -->
2449 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2450 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2451
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2452 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2453 <tr>
2454 <th class="th_name">Property Name</th>
2455 <th class="th_type">Type</th>
2456 <th class="th_description">Description</th>
2457 <th class="th_units">Units</th>
2458 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2459 <th class="th_tags">Tags</th>
2460 </tr>
2461 </thead>
2462
2463 <tbody>
2464
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2475 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2476 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2477 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2478 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2479 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2480 <span class="entry_type_container">x</span>
2481
2482 <span class="entry_type_array">
2483 n
2484 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2485 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2486 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2487
2488
2489 </td> <!-- entry_type -->
2490
2491 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2492 <p>The set of auto-exposure antibanding modes that are
2493supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2494 </td>
2495
2496 <td class="entry_units">
2497 </td>
2498
2499 <td class="entry_range">
2500 </td>
2501
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2502 <td class="entry_tags">
2503 </td>
2504
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2505 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2506 <tr class="entries_header">
2507 <th class="th_details" colspan="5">Details</th>
2508 </tr>
2509 <tr class="entry_cont">
2510 <td class="entry_details" colspan="5">
2511 <p>Not all of the auto-exposure anti-banding modes may be
2512supported by a given camera device.<wbr/> This field lists the
2513valid anti-banding modes that the application may request
2514for this camera device; they must include AUTO.<wbr/></p>
2515 </td>
2516 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2517
2518
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2519 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2520 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2521
2522
2523 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2524 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2525 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2526 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2527 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2528 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2529 <span class="entry_type_container">x</span>
2530
2531 <span class="entry_type_array">
2532 n
2533 </span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2534 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2535 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2536
2537
2538 </td> <!-- entry_type -->
2539
2540 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2541 <p>The set of auto-exposure modes that are supported by this
2542camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2543 </td>
2544
2545 <td class="entry_units">
2546 </td>
2547
2548 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2549 </td>
2550
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2551 <td class="entry_tags">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2552 <ul class="entry_tags">
2553 <li><a href="#tag_BC">BC</a></li>
2554 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2555 </td>
2556
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2557 </tr>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2558 <tr class="entries_header">
2559 <th class="th_details" colspan="5">Details</th>
2560 </tr>
2561 <tr class="entry_cont">
2562 <td class="entry_details" colspan="5">
2563 <p>Not all the auto-exposure modes may be supported by a
2564given camera device,<wbr/> especially if no flash unit is
2565available.<wbr/> This entry lists the valid modes for
2566<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> for this camera device.<wbr/></p>
2567<p>All camera devices support ON,<wbr/> and all camera devices with
2568flash units support ON_<wbr/>AUTO_<wbr/>FLASH and
2569ON_<wbr/>ALWAYS_<wbr/>FLASH.<wbr/></p>
2570<p>Full-capability camera devices always support OFF mode,<wbr/>
2571which enables application control of camera exposure time,<wbr/>
2572sensitivity,<wbr/> and frame duration.<wbr/></p>
2573 </td>
2574 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2575
2576
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2577 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2578 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2579
2580
2581 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2582 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2583 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2584 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2585 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2586 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2587 <span class="entry_type_container">x</span>
2588
2589 <span class="entry_type_array">
2590 2 x n
2591 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2592 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2593 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2594
2595
2596 </td> <!-- entry_type -->
2597
2598 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2599 <p>List of frame rate ranges supported by the
2600AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2601 </td>
2602
2603 <td class="entry_units">
2604 </td>
2605
2606 <td class="entry_range">
2607 </td>
2608
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2609 <td class="entry_tags">
2610 </td>
2611
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2612 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2613
2614
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2615 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2616 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2617
2618
2619 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2620 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2621 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2622 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2623 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2624 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2625 <span class="entry_type_container">x</span>
2626
2627 <span class="entry_type_array">
2628 2
2629 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2630 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2631
2632
2633 </td> <!-- entry_type -->
2634
2635 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2636 <p>Maximum and minimum exposure compensation
2637setting,<wbr/> in counts of
2638android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2639 </td>
2640
2641 <td class="entry_units">
2642 </td>
2643
2644 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2645 <p>At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2646size)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2647 </td>
2648
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2649 <td class="entry_tags">
2650 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2651 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2652 </ul>
2653 </td>
2654
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2655 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2656
2657
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2658 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2659 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2660
2661
2662 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2663 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2664 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2665 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2666 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2667 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2668
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2669 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2670
2671
2672 </td> <!-- entry_type -->
2673
2674 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2675 <p>Smallest step by which exposure compensation
2676can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2677 </td>
2678
2679 <td class="entry_units">
2680 </td>
2681
2682 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2683 <p>&lt;= 1/<wbr/>2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2684 </td>
2685
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2686 <td class="entry_tags">
2687 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2688 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2689 </ul>
2690 </td>
2691
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2692 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2693
2694
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2695 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2696 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2697
2698
2699 <tr class="entry" id="static_android.control.afAvailableModes">
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2700 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2701 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2702 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2703 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2704 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2705 <span class="entry_type_container">x</span>
2706
2707 <span class="entry_type_array">
2708 n
2709 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2710 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2711 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2712
2713
2714 </td> <!-- entry_type -->
2715
2716 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2717 <p>List of AF modes that can be
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2718selected 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]2719 </td>
2720
2721 <td class="entry_units">
2722 </td>
2723
2724 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2725 </td>
2726
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2727 <td class="entry_tags">
2728 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2729 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2730 </ul>
2731 </td>
2732
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2733 </tr>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2734 <tr class="entries_header">
2735 <th class="th_details" colspan="5">Details</th>
2736 </tr>
2737 <tr class="entry_cont">
2738 <td class="entry_details" colspan="5">
2739 <p>Not all the auto-focus modes may be supported by a
2740given camera device.<wbr/> This entry lists the valid modes for
2741<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> for this camera device.<wbr/></p>
2742<p>All camera devices will support OFF mode,<wbr/> and all camera devices with
2743adjustable 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>)
2744will support AUTO mode.<wbr/></p>
2745 </td>
2746 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2747
2748
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2749 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2750 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2751
2752
2753 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2754 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2755 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2756 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2757 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2758 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2759 <span class="entry_type_container">x</span>
2760
2761 <span class="entry_type_array">
2762 n
2763 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2764 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2765 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2766
2767
2768 </td> <!-- entry_type -->
2769
2770 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2771 <p>what subset of the full color effect enum
2772list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2773 </td>
2774
2775 <td class="entry_units">
2776 </td>
2777
2778 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2779 <p>OFF must be listed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2780 </td>
2781
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2782 <td class="entry_tags">
2783 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2784 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2785 </ul>
2786 </td>
2787
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2788 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2789
2790
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2791 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2792 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2793
2794
2795 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2796 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2797 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2798 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2799 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2800 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2801 <span class="entry_type_container">x</span>
2802
2803 <span class="entry_type_array">
2804 n
2805 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2806 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2807 <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]2808
2809
2810 </td> <!-- entry_type -->
2811
2812 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2813 <p>what subset of the scene mode enum list is
2814supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2815 </td>
2816
2817 <td class="entry_units">
2818 </td>
2819
2820 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2821 <p>SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2822detection is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2823 </td>
2824
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2825 <td class="entry_tags">
2826 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2827 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2828 </ul>
2829 </td>
2830
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2831 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2832
2833
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2834 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2835 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2836
2837
2838 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2839 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2840 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2841 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2842 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2843 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2844 <span class="entry_type_container">x</span>
2845
2846 <span class="entry_type_array">
2847 n
2848 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2849 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2850 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2851
2852
2853 </td> <!-- entry_type -->
2854
2855 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2856 <p>List of video stabilization modes that can
2857be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2858 </td>
2859
2860 <td class="entry_units">
2861 </td>
2862
2863 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2864 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2865 </td>
2866
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2867 <td class="entry_tags">
2868 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2869 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2870 </ul>
2871 </td>
2872
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2873 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2874
2875
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2876 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2877 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2878
2879
2880 <tr class="entry" id="static_android.control.awbAvailableModes">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2881 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2882 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2883 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2884 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2885 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2886 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2887
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2888 <span class="entry_type_array">
2889 n
2890 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2891 <span class="entry_type_visibility"> [public]</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2892 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2893
2894
2895 </td> <!-- entry_type -->
2896
2897 <td class="entry_description">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2898 <p>The set of auto-white-balance modes (<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>)
2899that are supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2900 </td>
2901
2902 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2903 </td>
2904
2905 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2906 </td>
2907
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2908 <td class="entry_tags">
2909 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2910 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2911 </ul>
2912 </td>
2913
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2914 </tr>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]2915 <tr class="entries_header">
2916 <th class="th_details" colspan="5">Details</th>
2917 </tr>
2918 <tr class="entry_cont">
2919 <td class="entry_details" colspan="5">
2920 <p>Not all the auto-white-balance modes may be supported by a
2921given camera device.<wbr/> This entry lists the valid modes for
2922<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> for this camera device.<wbr/></p>
2923<p>All camera devices will support ON mode.<wbr/></p>
2924<p>Full-capability camera devices will always support OFF mode,<wbr/>
2925which enables application control of white balance,<wbr/> by using
2926<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>
2927 </td>
2928 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2929
2930
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2931 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2932 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2933
2934
2935 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2936 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2937 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2938 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2939 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2940 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2941
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2942 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2943
2944
2945 </td> <!-- entry_type -->
2946
2947 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2948 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
2949regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2950 </td>
2951
2952 <td class="entry_units">
2953 </td>
2954
2955 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]2956 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2957 </td>
2958
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2959 <td class="entry_tags">
2960 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2961 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2962 </ul>
2963 </td>
2964
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2965 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2966
2967
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2968 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2969 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2970
2971
2972 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2973 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2974 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2975 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2976 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2977 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2978 <span class="entry_type_container">x</span>
2979
2980 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2981 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2982 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2983 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2984
2985
2986 </td> <!-- entry_type -->
2987
2988 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2989 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
2990each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2991 </td>
2992
2993 <td class="entry_units">
2994 </td>
2995
2996 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2997 <p>For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
2998awbMode,<wbr/> and afMode that the HAL wants to use for that
2999scene mode.<wbr/></p>
3000<p>For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
3001order of increasing index</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3002 </td>
3003
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3004 <td class="entry_tags">
3005 <ul class="entry_tags">
3006 <li><a href="#tag_BC">BC</a></li>
3007 </ul>
3008 </td>
3009
3010 </tr>
3011 <tr class="entries_header">
3012 <th class="th_details" colspan="5">Details</th>
3013 </tr>
3014 <tr class="entry_cont">
3015 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3016 <p>When a scene mode is enabled,<wbr/> the HAL is expected
3017to override aeMode,<wbr/> awbMode,<wbr/> and afMode with its
3018preferred settings for that scene mode.<wbr/></p>
3019<p>To simplify communication with old camera API applications,<wbr/>
3020the service wants this override list in the static metadata.<wbr/>
3021The order of this list matches that of availableSceneModes,<wbr/>
3022with 3 entires for each scene mode.<wbr/> The overrides listed
3023for SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
3024mode,<wbr/> the application-set aeMode,<wbr/> awbMode,<wbr/> and afMode are
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3025used 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]3026AUTO.<wbr/></p>
3027<p>It is recommended that for FACE_<wbr/>PRIORITY,<wbr/> the overrides
3028should be set to 0.<wbr/> As an example,<wbr/> if availableSceneModes is
3029{ FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT },<wbr/> then the service expects
3030this field to have 9 entries; for example { 0 ,<wbr/> 0,<wbr/> 0,<wbr/>
3031ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
3032INCANDESCENT,<wbr/> AUTO }</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3033 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3034 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3035
3036
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3037 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3038 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3039
3040
3041
3042 <!-- end of kind -->
3043 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3044 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3045
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3046 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3047 <tr>
3048 <th class="th_name">Property Name</th>
3049 <th class="th_type">Type</th>
3050 <th class="th_description">Description</th>
3051 <th class="th_units">Units</th>
3052 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3053 <th class="th_tags">Tags</th>
3054 </tr>
3055 </thead>
3056
3057 <tbody>
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067
3068 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3069 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3070 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3071 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3072 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3073 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3074
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3075 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3076
3077
3078 </td> <!-- entry_type -->
3079
3080 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3081 <p>The ID sent with the latest
3082CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3083 </td>
3084
3085 <td class="entry_units">
3086 </td>
3087
3088 <td class="entry_range">
3089 </td>
3090
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3091 <td class="entry_tags">
3092 </td>
3093
3094 </tr>
3095 <tr class="entries_header">
3096 <th class="th_details" colspan="5">Details</th>
3097 </tr>
3098 <tr class="entry_cont">
3099 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3100 <p>Must be 0 if no
3101CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
3102by HAL.<wbr/> Always updated even if AE algorithm ignores the
3103trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3104 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3105 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3106
3107
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3108 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3109 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3110
3111
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3112 <tr class="entry" id="dynamic_android.control.aeMode">
3113 <td class="entry_name" rowspan="3">
3114 android.<wbr/>control.<wbr/>ae<wbr/>Mode
3115 </td>
3116 <td class="entry_type">
3117 <span class="entry_type_name entry_type_name_enum">byte</span>
3118
3119 <span class="entry_type_visibility"> [public]</span>
3120
3121 <ul class="entry_type_enum">
3122 <li>
3123 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3124 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is disabled;
3125the application-selected <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3126<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> and
3127<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are used by the camera
3128device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
3129a flash unit for this camera device.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3130 </li>
3131 <li>
3132 <span class="entry_type_enum_name">ON</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3133 <span class="entry_type_enum_notes"><p>The camera device's autoexposure routine is active,<wbr/>
3134with no flash control.<wbr/> The application's values for
3135<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3136<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3137<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a> are ignored.<wbr/> The
3138application has control over the various
3139android.<wbr/>flash.<wbr/>* fields.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3140 </li>
3141 <li>
3142 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3143 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
3144the camera's flash unit,<wbr/> firing it in low-light
3145conditions.<wbr/> The flash may be fired during a
3146precapture sequence (triggered by
3147<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and may be fired
3148for captures for which the
3149<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
3150STILL_<wbr/>CAPTURE</p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3151 </li>
3152 <li>
3153 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3154 <span class="entry_type_enum_notes"><p>Like ON,<wbr/> except that the camera device also controls
3155the camera's flash unit,<wbr/> always firing it for still
3156captures.<wbr/> The flash may be fired during a precapture
3157sequence (triggered by
3158<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>) and will always
3159be fired for captures for which the
3160<a href="#controls_android.control.captureIntent">android.<wbr/>control.<wbr/>capture<wbr/>Intent</a> field is set to
3161STILL_<wbr/>CAPTURE</p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3162 </li>
3163 <li>
3164 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3165 <span class="entry_type_enum_notes"><p>Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
3166reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
3167a red eye reduction flash will fire during the
3168precapture sequence.<wbr/></p></span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3169 </li>
3170 </ul>
3171
3172 </td> <!-- entry_type -->
3173
3174 <td class="entry_description">
3175 <p>The desired mode for the camera device's
3176auto-exposure routine.<wbr/></p>
3177 </td>
3178
3179 <td class="entry_units">
3180 </td>
3181
3182 <td class="entry_range">
3183 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
3184 </td>
3185
3186 <td class="entry_tags">
3187 <ul class="entry_tags">
3188 <li><a href="#tag_BC">BC</a></li>
3189 </ul>
3190 </td>
3191
3192 </tr>
3193 <tr class="entries_header">
3194 <th class="th_details" colspan="5">Details</th>
3195 </tr>
3196 <tr class="entry_cont">
3197 <td class="entry_details" colspan="5">
3198 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
3199AUTO.<wbr/></p>
3200<p>When set to any of the ON modes,<wbr/> the camera device's
3201auto-exposure routine is enabled,<wbr/> overriding the
3202application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
3203and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3204<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3205<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
3206is selected,<wbr/> the camera device's flash unit controls are
3207also overridden.<wbr/></p>
3208<p>The FLASH modes are only available if the camera device
3209has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
3210<p>If flash TORCH mode is desired,<wbr/> this field must be set to
3211ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
3212<p>When set to any of the ON modes,<wbr/> the values chosen by the
3213camera device auto-exposure routine for the overridden
3214fields for a given capture will be available in its
3215CaptureResult.<wbr/></p>
3216 </td>
3217 </tr>
3218
3219
3220 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3221 <!-- end of entry -->
3222
3223
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3224 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3225 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3226 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3227 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3228 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3229 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3230 <span class="entry_type_container">x</span>
3231
3232 <span class="entry_type_array">
3233 5 x area_count
3234 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3235 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3236
3237
3238 </td> <!-- entry_type -->
3239
3240 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3241 <p>List of areas to use for
3242metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3243 </td>
3244
3245 <td class="entry_units">
3246 </td>
3247
3248 <td class="entry_range">
3249 </td>
3250
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3251 <td class="entry_tags">
3252 <ul class="entry_tags">
3253 <li><a href="#tag_BC">BC</a></li>
3254 </ul>
3255 </td>
3256
3257 </tr>
3258 <tr class="entries_header">
3259 <th class="th_details" colspan="5">Details</th>
3260 </tr>
3261 <tr class="entry_cont">
3262 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3263 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3264xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3265specified coordinates.<wbr/></p>
3266<p>The coordinate system is based on the active pixel array,<wbr/>
3267with (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]3268(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3269<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]3270bottom-right pixel in the active pixel array.<wbr/> The weight
3271should be nonnegative.<wbr/></p>
3272<p>If all regions have 0 weight,<wbr/> then no specific metering area
3273needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3274outside 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]3275should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3276used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3277 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3278 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3279
3280
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3281 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3282 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3283
3284
3285 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3286 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3287 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3288 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3289 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3290 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3291
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3292 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3293
3294 <ul class="entry_type_enum">
3295 <li>
3296 <span class="entry_type_enum_name">INACTIVE</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3297 <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]3298this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3299 </li>
3300 <li>
3301 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3302 <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]3303for the current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3304 </li>
3305 <li>
3306 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3307 <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]3308current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3309 </li>
3310 <li>
3311 <span class="entry_type_enum_name">LOCKED</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3312 <span class="entry_type_enum_notes"><p>AE has been locked.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3313 </li>
3314 <li>
3315 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3316 <span class="entry_type_enum_notes"><p>AE has a good set of control values,<wbr/> but flash
3317needs to be fired for good quality still
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3318capture.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3319 </li>
3320 <li>
3321 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3322 <span class="entry_type_enum_notes"><p>AE has been asked to do a precapture sequence
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3323(through the <a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a> START),<wbr/>
3324and is currently executing it.<wbr/> Once PRECAPTURE
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3325completes,<wbr/> AE will transition to CONVERGED or
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3326FLASH_<wbr/>REQUIRED as appropriate.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3327 </li>
3328 </ul>
3329
3330 </td> <!-- entry_type -->
3331
3332 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3333 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3334 </td>
3335
3336 <td class="entry_units">
3337 </td>
3338
3339 <td class="entry_range">
3340 </td>
3341
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3342 <td class="entry_tags">
3343 </td>
3344
3345 </tr>
3346 <tr class="entries_header">
3347 <th class="th_details" colspan="5">Details</th>
3348 </tr>
3349 <tr class="entry_cont">
3350 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3351 <p>Switching between or enabling AE modes (<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a>) always
3352resets the AE state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
3353or <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
3354the algorithm states to INACTIVE.<wbr/></p>
3355<p>The camera device can do several state transitions between two results,<wbr/> if it is
3356allowed by the state transition table.<wbr/> For example: INACTIVE may never actually be
3357seen in a result.<wbr/></p>
3358<p>The state in the result is the state for this image (in sync with this image): if
3359AE state becomes CONVERGED,<wbr/> then the image data associated with this result should
3360be good to use.<wbr/></p>
3361<p>Below are state transition tables for different AE modes.<wbr/></p>
3362<table>
3363<thead>
3364<tr>
3365<th align="center">State</th>
3366<th align="center">Transition Cause</th>
3367<th align="center">New State</th>
3368<th align="center">Notes</th>
3369</tr>
3370</thead>
3371<tbody>
3372<tr>
3373<td align="center">INACTIVE</td>
3374<td align="center"></td>
3375<td align="center">INACTIVE</td>
3376<td align="center">Camera device auto exposure algorithm is disabled</td>
3377</tr>
3378</tbody>
3379</table>
3380<p>When <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is AE_<wbr/>MODE_<wbr/>ON_<wbr/>*:</p>
3381<table>
3382<thead>
3383<tr>
3384<th align="center">State</th>
3385<th align="center">Transition Cause</th>
3386<th align="center">New State</th>
3387<th align="center">Notes</th>
3388</tr>
3389</thead>
3390<tbody>
3391<tr>
3392<td align="center">INACTIVE</td>
3393<td align="center">Camera device initiates AE scan</td>
3394<td align="center">SEARCHING</td>
3395<td align="center">Values changing</td>
3396</tr>
3397<tr>
3398<td align="center">INACTIVE</td>
3399<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3400<td align="center">LOCKED</td>
3401<td align="center">Values locked</td>
3402</tr>
3403<tr>
3404<td align="center">SEARCHING</td>
3405<td align="center">Camera device finishes AE scan</td>
3406<td align="center">CONVERGED</td>
3407<td align="center">Good values,<wbr/> not changing</td>
3408</tr>
3409<tr>
3410<td align="center">SEARCHING</td>
3411<td align="center">Camera device finishes AE scan</td>
3412<td align="center">FLASH_<wbr/>REQUIRED</td>
3413<td align="center">Converged but too dark w/<wbr/>o flash</td>
3414</tr>
3415<tr>
3416<td align="center">SEARCHING</td>
3417<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3418<td align="center">LOCKED</td>
3419<td align="center">Values locked</td>
3420</tr>
3421<tr>
3422<td align="center">CONVERGED</td>
3423<td align="center">Camera device initiates AE scan</td>
3424<td align="center">SEARCHING</td>
3425<td align="center">Values changing</td>
3426</tr>
3427<tr>
3428<td align="center">CONVERGED</td>
3429<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3430<td align="center">LOCKED</td>
3431<td align="center">Values locked</td>
3432</tr>
3433<tr>
3434<td align="center">FLASH_<wbr/>REQUIRED</td>
3435<td align="center">Camera device initiates AE scan</td>
3436<td align="center">SEARCHING</td>
3437<td align="center">Values changing</td>
3438</tr>
3439<tr>
3440<td align="center">FLASH_<wbr/>REQUIRED</td>
3441<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3442<td align="center">LOCKED</td>
3443<td align="center">Values locked</td>
3444</tr>
3445<tr>
3446<td align="center">LOCKED</td>
3447<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3448<td align="center">SEARCHING</td>
3449<td align="center">Values not good after unlock</td>
3450</tr>
3451<tr>
3452<td align="center">LOCKED</td>
3453<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3454<td align="center">CONVERGED</td>
3455<td align="center">Values good after unlock</td>
3456</tr>
3457<tr>
3458<td align="center">LOCKED</td>
3459<td align="center"><a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3460<td align="center">FLASH_<wbr/>REQUIRED</td>
3461<td align="center">Exposure good,<wbr/> but too dark</td>
3462</tr>
3463<tr>
3464<td align="center">PRECAPTURE</td>
3465<td align="center">Sequence done.<wbr/> <a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is OFF</td>
3466<td align="center">CONVERGED</td>
3467<td align="center">Ready for high-quality capture</td>
3468</tr>
3469<tr>
3470<td align="center">PRECAPTURE</td>
3471<td align="center">Sequence done.<wbr/> <a href="#controls_android.control.aeLock">android.<wbr/>control.<wbr/>ae<wbr/>Lock</a> is ON</td>
3472<td align="center">LOCKED</td>
3473<td align="center">Ready for high-quality capture</td>
3474</tr>
3475<tr>
3476<td align="center">Any state</td>
3477<td align="center"><a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a> is START</td>
3478<td align="center">PRECAPTURE</td>
3479<td align="center">Start AE precapture metering sequence</td>
3480</tr>
3481</tbody>
3482</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3483 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3484 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3485
3486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3487 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3488 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3489
3490
3491 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3492 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3493 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3494 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3495 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3496 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3497
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3498 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3499
3500 <ul class="entry_type_enum">
3501 <li>
3502 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3503 <span class="entry_type_enum_notes"><p>The auto-focus routine does not control the lens;
3504<a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> is controlled by the
3505application</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3506 </li>
3507 <li>
3508 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3509 <span class="entry_type_enum_notes"><p>If lens is not fixed focus.<wbr/></p>
3510<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
3511is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3512the autofocus trigger action is called.<wbr/> When that trigger
3513is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3514the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/></p>
3515<p>Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3516and sets the AF state to INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3517 </li>
3518 <li>
3519 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3520 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the lens does not move unless the
3521autofocus trigger action is called.<wbr/></p>
3522<p>When that trigger is activated,<wbr/> AF must transition to
3523ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3524NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3525position to default,<wbr/> and sets the AF state to
3526INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3527 </li>
3528 <li>
3529 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3530 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
3531position continually to attempt to provide a
3532constantly-in-focus image stream.<wbr/></p>
3533<p>The focusing behavior should be suitable for good quality
3534video recording; typically this means slower focus
3535movement and no overshoots.<wbr/> When the AF trigger is not
3536involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3537and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3538states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
3539the algorithm should immediately transition into
3540AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3541lens position until a cancel AF trigger is received.<wbr/></p>
3542<p>Once cancel is received,<wbr/> the algorithm should transition
3543back to INACTIVE and resume passive scan.<wbr/> Note that this
3544behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3545ongoing PASSIVE_<wbr/>SCAN must immediately be
3546canceled.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3547 </li>
3548 <li>
3549 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3550 <span class="entry_type_enum_notes"><p>In this mode,<wbr/> the AF algorithm modifies the lens
3551position continually to attempt to provide a
3552constantly-in-focus image stream.<wbr/></p>
3553<p>The focusing behavior should be suitable for still image
3554capture; typically this means focusing as fast as
3555possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3556algorithm should start in INACTIVE state,<wbr/> and then
3557transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3558appropriate as it attempts to maintain focus.<wbr/> When the AF
3559trigger is activated,<wbr/> the algorithm should finish its
3560PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3561AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3562lens position until a cancel AF trigger is received.<wbr/></p>
3563<p>When the AF cancel trigger is activated,<wbr/> the algorithm
3564should transition back to INACTIVE and then act as if it
3565has just been started.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3566 </li>
3567 <li>
3568 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3569 <span class="entry_type_enum_notes"><p>Extended depth of field (digital focus).<wbr/> AF
3570trigger is ignored,<wbr/> AF state should always be
3571INACTIVE.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3572 </li>
3573 </ul>
3574
3575 </td> <!-- entry_type -->
3576
3577 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3578 <p>Whether AF is currently enabled,<wbr/> and what
3579mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3580 </td>
3581
3582 <td class="entry_units">
3583 </td>
3584
3585 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]3586 <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]3587 </td>
3588
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3589 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3590 <ul class="entry_tags">
3591 <li><a href="#tag_BC">BC</a></li>
3592 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3593 </td>
3594
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3595 </tr>
3596 <tr class="entries_header">
3597 <th class="th_details" colspan="5">Details</th>
3598 </tr>
3599 <tr class="entry_cont">
3600 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3601 <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]3602<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
3603the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
3604in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3605 </td>
3606 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3607
3608
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3609 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3610 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3611
3612
3613 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3614 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3615 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3616 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3617 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3618 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3619 <span class="entry_type_container">x</span>
3620
3621 <span class="entry_type_array">
3622 5 x area_count
3623 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3624 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3625
3626
3627 </td> <!-- entry_type -->
3628
3629 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3630 <p>List of areas to use for focus
3631estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3632 </td>
3633
3634 <td class="entry_units">
3635 </td>
3636
3637 <td class="entry_range">
3638 </td>
3639
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3640 <td class="entry_tags">
3641 <ul class="entry_tags">
3642 <li><a href="#tag_BC">BC</a></li>
3643 </ul>
3644 </td>
3645
3646 </tr>
3647 <tr class="entries_header">
3648 <th class="th_details" colspan="5">Details</th>
3649 </tr>
3650 <tr class="entry_cont">
3651 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3652 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3653xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3654specified coordinates.<wbr/></p>
3655<p>The coordinate system is based on the active pixel array,<wbr/>
3656with (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]3657(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3658<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]3659bottom-right pixel in the active pixel array.<wbr/> The weight
3660should be nonnegative.<wbr/></p>
3661<p>If all regions have 0 weight,<wbr/> then no specific focus area
3662needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3663outside 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]3664should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3665used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3666 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3667 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3668
3669
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3670 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3671 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3672
3673
3674 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3675 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3676 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3677 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3678 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3679 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3680
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3681 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3682
3683 <ul class="entry_type_enum">
3684 <li>
3685 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3686 <span class="entry_type_enum_notes"><p>AF off or has not yet tried to scan/<wbr/>been asked
3687to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3688this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3689 </li>
3690 <li>
3691 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3692 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF is
3693currently doing an AF scan initiated by a continuous
3694autofocus mode</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3695 </li>
3696 <li>
3697 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3698 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3699believes it is in focus,<wbr/> but may restart scanning at
3700any time.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3701 </li>
3702 <li>
3703 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3704 <span class="entry_type_enum_notes"><p>if AUTO or MACRO modes are supported.<wbr/> AF is doing
3705an AF scan because it was triggered by AF
3706trigger</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3707 </li>
3708 <li>
3709 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3710 <span class="entry_type_enum_notes"><p>if any AF mode besides OFF is supported.<wbr/> AF
3711believes it is focused correctly and is
3712locked</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3713 </li>
3714 <li>
3715 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3716 <span class="entry_type_enum_notes"><p>if any AF mode besides OFF is supported.<wbr/> AF has
3717failed to focus successfully and is
3718locked</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3719 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3720 <li>
3721 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]3722 <span class="entry_type_enum_notes"><p>if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3723passive scan without finding focus,<wbr/> and may restart
3724scanning at any time.<wbr/></p></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3725 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3726 </ul>
3727
3728 </td> <!-- entry_type -->
3729
3730 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3731 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3732 </td>
3733
3734 <td class="entry_units">
3735 </td>
3736
3737 <td class="entry_range">
3738 </td>
3739
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3740 <td class="entry_tags">
3741 </td>
3742
3743 </tr>
3744 <tr class="entries_header">
3745 <th class="th_details" colspan="5">Details</th>
3746 </tr>
3747 <tr class="entry_cont">
3748 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]3749 <p>Switching between or enabling AF modes (<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>) always
3750resets the AF state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
3751or <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
3752the algorithm states to INACTIVE.<wbr/></p>
3753<p>The camera device can do several state transitions between two results,<wbr/> if it is
3754allowed by the state transition table.<wbr/> For example: INACTIVE may never actually be
3755seen in a result.<wbr/></p>
3756<p>The state in the result is the state for this image (in sync with this image): if
3757AF state becomes FOCUSED,<wbr/> then the image data associated with this result should
3758be sharp.<wbr/></p>
3759<p>Below are state transition tables for different AF modes.<wbr/></p>
3760<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>
3761<table>
3762<thead>
3763<tr>
3764<th align="center">State</th>
3765<th align="center">Transition Cause</th>
3766<th align="center">New State</th>
3767<th align="center">Notes</th>
3768</tr>
3769</thead>
3770<tbody>
3771<tr>
3772<td align="center">INACTIVE</td>
3773<td align="center"></td>
3774<td align="center">INACTIVE</td>
3775<td align="center">Never changes</td>
3776</tr>
3777</tbody>
3778</table>
3779<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>
3780<table>
3781<thead>
3782<tr>
3783<th align="center">State</th>
3784<th align="center">Transition Cause</th>
3785<th align="center">New State</th>
3786<th align="center">Notes</th>
3787</tr>
3788</thead>
3789<tbody>
3790<tr>
3791<td align="center">INACTIVE</td>
3792<td align="center">AF_<wbr/>TRIGGER</td>
3793<td align="center">ACTIVE_<wbr/>SCAN</td>
3794<td align="center">Start AF sweep,<wbr/> Lens now moving</td>
3795</tr>
3796<tr>
3797<td align="center">ACTIVE_<wbr/>SCAN</td>
3798<td align="center">AF sweep done</td>
3799<td align="center">FOCUSED_<wbr/>LOCKED</td>
3800<td align="center">Focused,<wbr/> Lens now locked</td>
3801</tr>
3802<tr>
3803<td align="center">ACTIVE_<wbr/>SCAN</td>
3804<td align="center">AF sweep done</td>
3805<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3806<td align="center">Not focused,<wbr/> Lens now locked</td>
3807</tr>
3808<tr>
3809<td align="center">ACTIVE_<wbr/>SCAN</td>
3810<td align="center">AF_<wbr/>CANCEL</td>
3811<td align="center">INACTIVE</td>
3812<td align="center">Cancel/<wbr/>reset AF,<wbr/> Lens now locked</td>
3813</tr>
3814<tr>
3815<td align="center">FOCUSED_<wbr/>LOCKED</td>
3816<td align="center">AF_<wbr/>CANCEL</td>
3817<td align="center">INACTIVE</td>
3818<td align="center">Cancel/<wbr/>reset AF</td>
3819</tr>
3820<tr>
3821<td align="center">FOCUSED_<wbr/>LOCKED</td>
3822<td align="center">AF_<wbr/>TRIGGER</td>
3823<td align="center">ACTIVE_<wbr/>SCAN</td>
3824<td align="center">Start new sweep,<wbr/> Lens now moving</td>
3825</tr>
3826<tr>
3827<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3828<td align="center">AF_<wbr/>CANCEL</td>
3829<td align="center">INACTIVE</td>
3830<td align="center">Cancel/<wbr/>reset AF</td>
3831</tr>
3832<tr>
3833<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3834<td align="center">AF_<wbr/>TRIGGER</td>
3835<td align="center">ACTIVE_<wbr/>SCAN</td>
3836<td align="center">Start new sweep,<wbr/> Lens now moving</td>
3837</tr>
3838<tr>
3839<td align="center">Any state</td>
3840<td align="center">Mode change</td>
3841<td align="center">INACTIVE</td>
3842<td align="center"></td>
3843</tr>
3844</tbody>
3845</table>
3846<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>
3847<table>
3848<thead>
3849<tr>
3850<th align="center">State</th>
3851<th align="center">Transition Cause</th>
3852<th align="center">New State</th>
3853<th align="center">Notes</th>
3854</tr>
3855</thead>
3856<tbody>
3857<tr>
3858<td align="center">INACTIVE</td>
3859<td align="center">Camera device initiates new scan</td>
3860<td align="center">PASSIVE_<wbr/>SCAN</td>
3861<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3862</tr>
3863<tr>
3864<td align="center">INACTIVE</td>
3865<td align="center">AF_<wbr/>TRIGGER</td>
3866<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3867<td align="center">AF state query,<wbr/> Lens now locked</td>
3868</tr>
3869<tr>
3870<td align="center">PASSIVE_<wbr/>SCAN</td>
3871<td align="center">Camera device completes current scan</td>
3872<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3873<td align="center">End AF scan,<wbr/> Lens now locked</td>
3874</tr>
3875<tr>
3876<td align="center">PASSIVE_<wbr/>SCAN</td>
3877<td align="center">Camera device fails current scan</td>
3878<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3879<td align="center">End AF scan,<wbr/> Lens now locked</td>
3880</tr>
3881<tr>
3882<td align="center">PASSIVE_<wbr/>SCAN</td>
3883<td align="center">AF_<wbr/>TRIGGER</td>
3884<td align="center">FOCUSED_<wbr/>LOCKED</td>
3885<td align="center">Immediate trans.<wbr/> If focus is good,<wbr/> Lens now locked</td>
3886</tr>
3887<tr>
3888<td align="center">PASSIVE_<wbr/>SCAN</td>
3889<td align="center">AF_<wbr/>TRIGGER</td>
3890<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3891<td align="center">Immediate trans.<wbr/> if focus is bad,<wbr/> Lens now locked</td>
3892</tr>
3893<tr>
3894<td align="center">PASSIVE_<wbr/>SCAN</td>
3895<td align="center">AF_<wbr/>CANCEL</td>
3896<td align="center">INACTIVE</td>
3897<td align="center">Reset lens position,<wbr/> Lens now locked</td>
3898</tr>
3899<tr>
3900<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3901<td align="center">Camera device initiates new scan</td>
3902<td align="center">PASSIVE_<wbr/>SCAN</td>
3903<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3904</tr>
3905<tr>
3906<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3907<td align="center">Camera device initiates new scan</td>
3908<td align="center">PASSIVE_<wbr/>SCAN</td>
3909<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3910</tr>
3911<tr>
3912<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3913<td align="center">AF_<wbr/>TRIGGER</td>
3914<td align="center">FOCUSED_<wbr/>LOCKED</td>
3915<td align="center">Immediate trans.<wbr/> Lens now locked</td>
3916</tr>
3917<tr>
3918<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3919<td align="center">AF_<wbr/>TRIGGER</td>
3920<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3921<td align="center">Immediate trans.<wbr/> Lens now locked</td>
3922</tr>
3923<tr>
3924<td align="center">FOCUSED_<wbr/>LOCKED</td>
3925<td align="center">AF_<wbr/>TRIGGER</td>
3926<td align="center">FOCUSED_<wbr/>LOCKED</td>
3927<td align="center">No effect</td>
3928</tr>
3929<tr>
3930<td align="center">FOCUSED_<wbr/>LOCKED</td>
3931<td align="center">AF_<wbr/>CANCEL</td>
3932<td align="center">INACTIVE</td>
3933<td align="center">Restart AF scan</td>
3934</tr>
3935<tr>
3936<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3937<td align="center">AF_<wbr/>TRIGGER</td>
3938<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3939<td align="center">No effect</td>
3940</tr>
3941<tr>
3942<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3943<td align="center">AF_<wbr/>CANCEL</td>
3944<td align="center">INACTIVE</td>
3945<td align="center">Restart AF scan</td>
3946</tr>
3947</tbody>
3948</table>
3949<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>
3950<table>
3951<thead>
3952<tr>
3953<th align="center">State</th>
3954<th align="center">Transition Cause</th>
3955<th align="center">New State</th>
3956<th align="center">Notes</th>
3957</tr>
3958</thead>
3959<tbody>
3960<tr>
3961<td align="center">INACTIVE</td>
3962<td align="center">Camera device initiates new scan</td>
3963<td align="center">PASSIVE_<wbr/>SCAN</td>
3964<td align="center">Start AF scan,<wbr/> Lens now moving</td>
3965</tr>
3966<tr>
3967<td align="center">INACTIVE</td>
3968<td align="center">AF_<wbr/>TRIGGER</td>
3969<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3970<td align="center">AF state query,<wbr/> Lens now locked</td>
3971</tr>
3972<tr>
3973<td align="center">PASSIVE_<wbr/>SCAN</td>
3974<td align="center">Camera device completes current scan</td>
3975<td align="center">PASSIVE_<wbr/>FOCUSED</td>
3976<td align="center">End AF scan,<wbr/> Lens now locked</td>
3977</tr>
3978<tr>
3979<td align="center">PASSIVE_<wbr/>SCAN</td>
3980<td align="center">Camera device fails current scan</td>
3981<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
3982<td align="center">End AF scan,<wbr/> Lens now locked</td>
3983</tr>
3984<tr>
3985<td align="center">PASSIVE_<wbr/>SCAN</td>
3986<td align="center">AF_<wbr/>TRIGGER</td>
3987<td align="center">FOCUSED_<wbr/>LOCKED</td>
3988<td align="center">Eventual trans.<wbr/> once focus good,<wbr/> Lens now locked</td>
3989</tr>
3990<tr>
3991<td align="center">PASSIVE_<wbr/>SCAN</td>
3992<td align="center">AF_<wbr/>TRIGGER</td>
3993<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
3994<td align="center">Eventual trans.<wbr/> if cannot focus,<wbr/> Lens now locked</td>
3995</tr>
3996<tr>
3997<td align="center">PASSIVE_<wbr/>SCAN</td>
3998<td align="center">AF_<wbr/>CANCEL</td>
3999<td align="center">INACTIVE</td>
4000<td align="center">Reset lens position,<wbr/> Lens now locked</td>
4001</tr>
4002<tr>
4003<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4004<td align="center">Camera device initiates new scan</td>
4005<td align="center">PASSIVE_<wbr/>SCAN</td>
4006<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4007</tr>
4008<tr>
4009<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4010<td align="center">Camera device initiates new scan</td>
4011<td align="center">PASSIVE_<wbr/>SCAN</td>
4012<td align="center">Start AF scan,<wbr/> Lens now moving</td>
4013</tr>
4014<tr>
4015<td align="center">PASSIVE_<wbr/>FOCUSED</td>
4016<td align="center">AF_<wbr/>TRIGGER</td>
4017<td align="center">FOCUSED_<wbr/>LOCKED</td>
4018<td align="center">Immediate trans.<wbr/> Lens now locked</td>
4019</tr>
4020<tr>
4021<td align="center">PASSIVE_<wbr/>UNFOCUSED</td>
4022<td align="center">AF_<wbr/>TRIGGER</td>
4023<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4024<td align="center">Immediate trans.<wbr/> Lens now locked</td>
4025</tr>
4026<tr>
4027<td align="center">FOCUSED_<wbr/>LOCKED</td>
4028<td align="center">AF_<wbr/>TRIGGER</td>
4029<td align="center">FOCUSED_<wbr/>LOCKED</td>
4030<td align="center">No effect</td>
4031</tr>
4032<tr>
4033<td align="center">FOCUSED_<wbr/>LOCKED</td>
4034<td align="center">AF_<wbr/>CANCEL</td>
4035<td align="center">INACTIVE</td>
4036<td align="center">Restart AF scan</td>
4037</tr>
4038<tr>
4039<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4040<td align="center">AF_<wbr/>TRIGGER</td>
4041<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4042<td align="center">No effect</td>
4043</tr>
4044<tr>
4045<td align="center">NOT_<wbr/>FOCUSED_<wbr/>LOCKED</td>
4046<td align="center">AF_<wbr/>CANCEL</td>
4047<td align="center">INACTIVE</td>
4048<td align="center">Restart AF scan</td>
4049</tr>
4050</tbody>
4051</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4052 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4053 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4054
4055
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4056 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4057 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4058
4059
4060 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4061 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4062 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4063 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4064 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4065 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4066
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4067 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4068
4069
4070 </td> <!-- entry_type -->
4071
4072 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4073 <p>The ID sent with the latest
4074CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4075 </td>
4076
4077 <td class="entry_units">
4078 </td>
4079
4080 <td class="entry_range">
4081 </td>
4082
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4083 <td class="entry_tags">
4084 </td>
4085
4086 </tr>
4087 <tr class="entries_header">
4088 <th class="th_details" colspan="5">Details</th>
4089 </tr>
4090 <tr class="entry_cont">
4091 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4092 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
4093received yet by HAL.<wbr/> Always updated even if AF algorithm
4094ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4095 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4096 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4097
4098
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4099 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4100 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4101
4102
4103 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4104 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4105 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4106 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4107 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4108 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4109
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4110 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4111
4112 <ul class="entry_type_enum">
4113 <li>
4114 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4115 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4116the application-selected color transform matrix
4117(<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>) and gains
4118(<a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>) are used by the camera
4119device for manual white balance control.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4120 </li>
4121 <li>
4122 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4123 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is active;
4124the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
4125and <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]4126 </li>
4127 <li>
4128 <span class="entry_type_enum_name">INCANDESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4129 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4130the camera device uses incandescent light as the assumed scene
4131illumination for white balance.<wbr/> While the exact white balance
4132transforms are up to the camera device,<wbr/> they will approximately
4133match the CIE standard illuminant A.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4134 </li>
4135 <li>
4136 <span class="entry_type_enum_name">FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4137 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4138the camera device uses fluorescent light as the assumed scene
4139illumination for white balance.<wbr/> While the exact white balance
4140transforms are up to the camera device,<wbr/> they will approximately
4141match the CIE standard illuminant F2.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4142 </li>
4143 <li>
4144 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4145 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4146the camera device uses warm fluorescent light as the assumed scene
4147illumination for white balance.<wbr/> While the exact white balance
4148transforms are up to the camera device,<wbr/> they will approximately
4149match the CIE standard illuminant F4.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4150 </li>
4151 <li>
4152 <span class="entry_type_enum_name">DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4153 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4154the camera device uses daylight light as the assumed scene
4155illumination for white balance.<wbr/> While the exact white balance
4156transforms are up to the camera device,<wbr/> they will approximately
4157match the CIE standard illuminant D65.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4158 </li>
4159 <li>
4160 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4161 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4162the camera device uses cloudy daylight light as the assumed scene
4163illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4164 </li>
4165 <li>
4166 <span class="entry_type_enum_name">TWILIGHT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4167 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4168the camera device uses twilight light as the assumed scene
4169illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4170 </li>
4171 <li>
4172 <span class="entry_type_enum_name">SHADE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4173 <span class="entry_type_enum_notes"><p>The camera device's auto white balance routine is disabled;
4174the camera device uses shade light as the assumed scene
4175illumination for white balance.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4176 </li>
4177 </ul>
4178
4179 </td> <!-- entry_type -->
4180
4181 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4182 <p>Whether AWB is currently setting the color
4183transform fields,<wbr/> and what its illumination target
4184is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4185 </td>
4186
4187 <td class="entry_units">
4188 </td>
4189
4190 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]4191 <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]4192 </td>
4193
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4194 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4195 <ul class="entry_tags">
4196 <li><a href="#tag_BC">BC</a></li>
4197 <li><a href="#tag_AWB">AWB</a></li>
4198 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4199 </td>
4200
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4201 </tr>
4202 <tr class="entries_header">
4203 <th class="th_details" colspan="5">Details</th>
4204 </tr>
4205 <tr class="entry_cont">
4206 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame]4207 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
4208<p>When set to the ON mode,<wbr/> the camera device's auto white balance
4209routine is enabled,<wbr/> overriding the application's selected
4210<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
4211<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
4212<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
4213routine is disabled.<wbr/> The applicantion manually controls the white
4214balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
4215and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
4216<p>When set to any other modes,<wbr/> the camera device's auto white balance
4217routine is disabled.<wbr/> The camera device uses each particular illumination
4218target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4219 </td>
4220 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4221
4222
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4223 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4224 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4225
4226
4227 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4228 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4229 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4230 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4231 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4232 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4233 <span class="entry_type_container">x</span>
4234
4235 <span class="entry_type_array">
4236 5 x area_count
4237 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4238 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4239
4240
4241 </td> <!-- entry_type -->
4242
4243 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4244 <p>List of areas to use for illuminant
4245estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4246 </td>
4247
4248 <td class="entry_units">
4249 </td>
4250
4251 <td class="entry_range">
4252 </td>
4253
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4254 <td class="entry_tags">
4255 <ul class="entry_tags">
4256 <li><a href="#tag_BC">BC</a></li>
4257 </ul>
4258 </td>
4259
4260 </tr>
4261 <tr class="entries_header">
4262 <th class="th_details" colspan="5">Details</th>
4263 </tr>
4264 <tr class="entry_cont">
4265 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4266 <p>Only used in AUTO mode.<wbr/></p>
4267<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
4268xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
4269specified coordinates.<wbr/></p>
4270<p>The coordinate system is based on the active pixel array,<wbr/>
4271with (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]4272(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
4273<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]4274bottom-right pixel in the active pixel array.<wbr/> The weight
4275should be nonnegative.<wbr/></p>
4276<p>If all regions have 0 weight,<wbr/> then no specific metering area
4277needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4278outside 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]4279should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4280used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4281 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4282 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4283
4284
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4285 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4286 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4287
4288
4289 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4290 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4291 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4292 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4293 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4294 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4295
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4296 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4297
4298 <ul class="entry_type_enum">
4299 <li>
4300 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4301 <span class="entry_type_enum_notes"><p>AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
4302starts in this state.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4303 </li>
4304 <li>
4305 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4306 <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]4307values for the current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4308 </li>
4309 <li>
4310 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4311 <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]4312current scene.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4313 </li>
4314 <li>
4315 <span class="entry_type_enum_name">LOCKED</span>
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]4316 <span class="entry_type_enum_notes"><p>AWB has been locked.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4317 </li>
4318 </ul>
4319
4320 </td> <!-- entry_type -->
4321
4322 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4323 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4324 </td>
4325
4326 <td class="entry_units">
4327 </td>
4328
4329 <td class="entry_range">
4330 </td>
4331
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4332 <td class="entry_tags">
4333 </td>
4334
4335 </tr>
4336 <tr class="entries_header">
4337 <th class="th_details" colspan="5">Details</th>
4338 </tr>
4339 <tr class="entry_cont">
4340 <td class="entry_details" colspan="5">
Zhijun He92e698d2014-01-13 16:24:31 -0800[diff] [blame]4341 <p>Switching between or enabling AWB modes (<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>) always
4342resets the AWB state to INACTIVE.<wbr/> Similarly,<wbr/> switching between <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a>,<wbr/>
4343or <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
4344the algorithm states to INACTIVE.<wbr/></p>
4345<p>The camera device can do several state transitions between two results,<wbr/> if it is
4346allowed by the state transition table.<wbr/> So INACTIVE may never actually be seen in
4347a result.<wbr/></p>
4348<p>The state in the result is the state for this image (in sync with this image): if
4349AWB state becomes CONVERGED,<wbr/> then the image data associated with this result should
4350be good to use.<wbr/></p>
4351<p>Below are state transition tables for different AWB modes.<wbr/></p>
4352<p>When <code><a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> != AWB_<wbr/>MODE_<wbr/>AUTO</code>:</p>
4353<table>
4354<thead>
4355<tr>
4356<th align="center">State</th>
4357<th align="center">Transition Cause</th>
4358<th align="center">New State</th>
4359<th align="center">Notes</th>
4360</tr>
4361</thead>
4362<tbody>
4363<tr>
4364<td align="center">INACTIVE</td>
4365<td align="center"></td>
4366<td align="center">INACTIVE</td>
4367<td align="center">Camera device auto white balance algorithm is disabled</td>
4368</tr>
4369</tbody>
4370</table>
4371<p>When <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> is AWB_<wbr/>MODE_<wbr/>AUTO:</p>
4372<table>
4373<thead>
4374<tr>
4375<th align="center">State</th>
4376<th align="center">Transition Cause</th>
4377<th align="center">New State</th>
4378<th align="center">Notes</th>
4379</tr>
4380</thead>
4381<tbody>
4382<tr>
4383<td align="center">INACTIVE</td>
4384<td align="center">Camera device initiates AWB scan</td>
4385<td align="center">SEARCHING</td>
4386<td align="center">Values changing</td>
4387</tr>
4388<tr>
4389<td align="center">INACTIVE</td>
4390<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4391<td align="center">LOCKED</td>
4392<td align="center">Values locked</td>
4393</tr>
4394<tr>
4395<td align="center">SEARCHING</td>
4396<td align="center">Camera device finishes AWB scan</td>
4397<td align="center">CONVERGED</td>
4398<td align="center">Good values,<wbr/> not changing</td>
4399</tr>
4400<tr>
4401<td align="center">SEARCHING</td>
4402<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4403<td align="center">LOCKED</td>
4404<td align="center">Values locked</td>
4405</tr>
4406<tr>
4407<td align="center">CONVERGED</td>
4408<td align="center">Camera device initiates AWB scan</td>
4409<td align="center">SEARCHING</td>
4410<td align="center">Values changing</td>
4411</tr>
4412<tr>
4413<td align="center">CONVERGED</td>
4414<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is ON</td>
4415<td align="center">LOCKED</td>
4416<td align="center">Values locked</td>
4417</tr>
4418<tr>
4419<td align="center">LOCKED</td>
4420<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is OFF</td>
4421<td align="center">SEARCHING</td>
4422<td align="center">Values not good after unlock</td>
4423</tr>
4424<tr>
4425<td align="center">LOCKED</td>
4426<td align="center"><a href="#controls_android.control.awbLock">android.<wbr/>control.<wbr/>awb<wbr/>Lock</a> is OFF</td>
4427<td align="center">CONVERGED</td>
4428<td align="center">Values good after unlock</td>
4429</tr>
4430</tbody>
4431</table>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4432 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4433 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4434
4435
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4436 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4437 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4438
4439
4440 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4441 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4442 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4443 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4444 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4445 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4446
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4447 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4448
4449 <ul class="entry_type_enum">
4450 <li>
4451 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4452 <span class="entry_type_enum_notes"><p>Full application control of pipeline.<wbr/> All 3A
4453routines are disabled,<wbr/> no other settings in
4454android.<wbr/>control.<wbr/>* have any effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4455 </li>
4456 <li>
4457 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4458 <span class="entry_type_enum_notes"><p>Use settings for each individual 3A routine.<wbr/>
4459Manual control of capture parameters is disabled.<wbr/> All
4460controls in android.<wbr/>control.<wbr/>* besides sceneMode take
4461effect</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4462 </li>
4463 <li>
4464 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4465 <span class="entry_type_enum_notes"><p>Use specific scene mode.<wbr/> Enabling this disables
4466control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
4467controls; the HAL must ignore those settings while
4468USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
4469scene mode).<wbr/> Other control entries are still active.<wbr/>
4470This setting can only be used if availableSceneModes !=
4471UNSUPPORTED</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4472 </li>
4473 </ul>
4474
4475 </td> <!-- entry_type -->
4476
4477 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4478 <p>Overall mode of 3A control
4479routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4480 </td>
4481
4482 <td class="entry_units">
4483 </td>
4484
4485 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4486 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4487 </td>
4488
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4489 <td class="entry_tags">
4490 <ul class="entry_tags">
4491 <li><a href="#tag_BC">BC</a></li>
4492 </ul>
4493 </td>
4494
4495 </tr>
4496 <tr class="entries_header">
4497 <th class="th_details" colspan="5">Details</th>
4498 </tr>
4499 <tr class="entry_cont">
4500 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4501 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4502by the camera device is disabled.<wbr/> The application must set the fields for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4503capture parameters itself.<wbr/></p>
4504<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4505android.<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]4506<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4507android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the camera device implements
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4508one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4509as it wishes.<wbr/> The camera device scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4510<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]4511 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4512 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4513
4514
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4515 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4516 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4517
4518
4519
4520 <!-- end of kind -->
4521 </tbody>
4522
4523 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4524 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4525
4526
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4527 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4528
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4529 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4530 <tr>
4531 <th class="th_name">Property Name</th>
4532 <th class="th_type">Type</th>
4533 <th class="th_description">Description</th>
4534 <th class="th_units">Units</th>
4535 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4536 <th class="th_tags">Tags</th>
4537 </tr>
4538 </thead>
4539
4540 <tbody>
4541
4542
4543
4544
4545
4546
4547
4548
4549
4550
4551 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4552 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4553 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4554 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4555 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4556 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4557
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4558 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4559
4560 <ul class="entry_type_enum">
4561 <li>
4562 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4563 <span class="entry_type_enum_notes"><p>Minimal or no slowdown of frame rate compared to
4564Bayer RAW output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4565 </li>
4566 <li>
4567 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4568 <span class="entry_type_enum_notes"><p>High-quality may reduce output frame
4569rate</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4570 </li>
4571 </ul>
4572
4573 </td> <!-- entry_type -->
4574
4575 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4576 <p>Controls the quality of the demosaicing
4577processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4578 </td>
4579
4580 <td class="entry_units">
4581 </td>
4582
4583 <td class="entry_range">
4584 </td>
4585
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4586 <td class="entry_tags">
4587 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4588 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4589 </ul>
4590 </td>
4591
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4592 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4593
4594
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4595 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4596 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4597
4598
4599
4600 <!-- end of kind -->
4601 </tbody>
4602
4603 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4604 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4605
4606
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4607 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4608
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4609 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4610 <tr>
4611 <th class="th_name">Property Name</th>
4612 <th class="th_type">Type</th>
4613 <th class="th_description">Description</th>
4614 <th class="th_units">Units</th>
4615 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4616 <th class="th_tags">Tags</th>
4617 </tr>
4618 </thead>
4619
4620 <tbody>
4621
4622
4623
4624
4625
4626
4627
4628
4629
4630
4631 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4632 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4633 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4634 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4635 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4636 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4637
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4638 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4639
4640 <ul class="entry_type_enum">
4641 <li>
4642 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4643 <span class="entry_type_enum_notes"><p>No edge enhancement is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4644 </li>
4645 <li>
4646 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4647 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
4648output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4649 </li>
4650 <li>
4651 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4652 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4653quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4654 </li>
4655 </ul>
4656
4657 </td> <!-- entry_type -->
4658
4659 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4660 <p>Operation mode for edge
4661enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4662 </td>
4663
4664 <td class="entry_units">
4665 </td>
4666
4667 <td class="entry_range">
4668 </td>
4669
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4670 <td class="entry_tags">
4671 </td>
4672
4673 </tr>
4674 <tr class="entries_header">
4675 <th class="th_details" colspan="5">Details</th>
4676 </tr>
4677 <tr class="entry_cont">
4678 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4679 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4680enhancement will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4681<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined enhancement
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4682will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4683camera device will use the highest-quality enhancement algorithms,<wbr/>
4684even if it slows down capture rate.<wbr/> FAST means the camera device will
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4685not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4686 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4687 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4688
4689
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4690 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4691 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4692
4693
4694 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4695 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4696 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4697 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4698 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4699 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4700
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4701 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4702
4703
4704 </td> <!-- entry_type -->
4705
4706 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4707 <p>Control the amount of edge enhancement
4708applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4709 </td>
4710
4711 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4712 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4713 </td>
4714
4715 <td class="entry_range">
4716 </td>
4717
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4718 <td class="entry_tags">
4719 </td>
4720
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4721 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4722
4723
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4724 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4725 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4726
4727
4728
4729 <!-- end of kind -->
4730 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4731 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4732
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4733 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4734 <tr>
4735 <th class="th_name">Property Name</th>
4736 <th class="th_type">Type</th>
4737 <th class="th_description">Description</th>
4738 <th class="th_units">Units</th>
4739 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4740 <th class="th_tags">Tags</th>
4741 </tr>
4742 </thead>
4743
4744 <tbody>
4745
4746
4747
4748
4749
4750
4751
4752
4753
4754
4755 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4756 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4757 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4758 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4759 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4760 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4761
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4762 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4763
4764 <ul class="entry_type_enum">
4765 <li>
4766 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4767 <span class="entry_type_enum_notes"><p>No edge enhancement is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4768 </li>
4769 <li>
4770 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4771 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
4772output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4773 </li>
4774 <li>
4775 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]4776 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
4777quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4778 </li>
4779 </ul>
4780
4781 </td> <!-- entry_type -->
4782
4783 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4784 <p>Operation mode for edge
4785enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4786 </td>
4787
4788 <td class="entry_units">
4789 </td>
4790
4791 <td class="entry_range">
4792 </td>
4793
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4794 <td class="entry_tags">
4795 </td>
4796
4797 </tr>
4798 <tr class="entries_header">
4799 <th class="th_details" colspan="5">Details</th>
4800 </tr>
4801 <tr class="entry_cont">
4802 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4803 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4804enhancement will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4805<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined enhancement
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4806will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]4807camera device will use the highest-quality enhancement algorithms,<wbr/>
4808even if it slows down capture rate.<wbr/> FAST means the camera device will
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4809not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4810 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4811 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4812
4813
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4814 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4815 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4816
4817
4818
4819 <!-- end of kind -->
4820 </tbody>
4821
4822 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4823 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4824
4825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4826 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4827
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4828 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4829 <tr>
4830 <th class="th_name">Property Name</th>
4831 <th class="th_type">Type</th>
4832 <th class="th_description">Description</th>
4833 <th class="th_units">Units</th>
4834 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4835 <th class="th_tags">Tags</th>
4836 </tr>
4837 </thead>
4838
4839 <tbody>
4840
4841
4842
4843
4844
4845
4846
4847
4848
4849
4850 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4851 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4852 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4853 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4854 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4855 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4856
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4857 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4858
4859
4860 </td> <!-- entry_type -->
4861
4862 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4863 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4864 </td>
4865
4866 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4867 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4868 </td>
4869
4870 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4871 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4872 </td>
4873
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4874 <td class="entry_tags">
4875 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4876 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4877 </ul>
4878 </td>
4879
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4880 </tr>
4881 <tr class="entries_header">
4882 <th class="th_details" colspan="5">Details</th>
4883 </tr>
4884 <tr class="entry_cont">
4885 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4886 <p>Power for snapshot may use a different scale than
4887for torch mode.<wbr/> Only one entry for torch mode will be
4888used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4889 </td>
4890 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4891
4892
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4893 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4894 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4895
4896
4897 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4898 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4899 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4900 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4901 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4902 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4903
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4904 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4905
4906
4907 </td> <!-- entry_type -->
4908
4909 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4910 <p>Firing time of flash relative to start of
4911exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4912 </td>
4913
4914 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4915 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4916 </td>
4917
4918 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4919 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4920 </td>
4921
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4922 <td class="entry_tags">
4923 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4924 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4925 </ul>
4926 </td>
4927
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4928 </tr>
4929 <tr class="entries_header">
4930 <th class="th_details" colspan="5">Details</th>
4931 </tr>
4932 <tr class="entry_cont">
4933 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4934 <p>Clamped to (0,<wbr/> exposure time - flash
4935duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4936 </td>
4937 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4938
4939
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4940 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4941 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4942
4943
4944 <tr class="entry" id="controls_android.flash.mode">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]4945 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4946 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4947 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4948 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4949 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4950
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4951 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4952
4953 <ul class="entry_type_enum">
4954 <li>
4955 <span class="entry_type_enum_name">OFF</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]4956 <span class="entry_type_enum_notes"><p>Do not fire the flash for this capture.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4957 </li>
4958 <li>
4959 <span class="entry_type_enum_name">SINGLE</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]4960 <span class="entry_type_enum_notes"><p>If the flash is available and charged,<wbr/> fire flash
4961for this capture based on <a href="#controls_android.flash.firingPower">android.<wbr/>flash.<wbr/>firing<wbr/>Power</a> and
4962<a href="#controls_android.flash.firingTime">android.<wbr/>flash.<wbr/>firing<wbr/>Time</a>.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4963 </li>
4964 <li>
4965 <span class="entry_type_enum_name">TORCH</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]4966 <span class="entry_type_enum_notes"><p>Transition flash to continuously on.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4967 </li>
4968 </ul>
4969
4970 </td> <!-- entry_type -->
4971
4972 <td class="entry_description">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]4973 <p>The desired mode for for the camera device's flash control.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4974 </td>
4975
4976 <td class="entry_units">
4977 </td>
4978
4979 <td class="entry_range">
4980 </td>
4981
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4982 <td class="entry_tags">
4983 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4984 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4985 </ul>
4986 </td>
4987
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4988 </tr>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]4989 <tr class="entries_header">
4990 <th class="th_details" colspan="5">Details</th>
4991 </tr>
4992 <tr class="entry_cont">
4993 <td class="entry_details" colspan="5">
4994 <p>This control is only effective when flash unit is available
4995(<code><a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> != 0</code>).<wbr/></p>
4996<p>When this control is used,<wbr/> the <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> must be set to ON or OFF.<wbr/>
4997Otherwise,<wbr/> the camera device auto-exposure related flash control (ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
4998ON_<wbr/>ALWAYS_<wbr/>FLASH,<wbr/> or ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE) will override this control.<wbr/></p>
4999<p>When set to OFF,<wbr/> the camera device will not fire flash for this capture.<wbr/></p>
5000<p>When set to SINGLE,<wbr/> the camera device will fire flash regardless of the camera
5001device's auto-exposure routine's result.<wbr/> When used in still capture case,<wbr/> this
5002control should be used along with AE precapture metering sequence
5003(<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>),<wbr/> otherwise,<wbr/> the image may be incorrectly exposed.<wbr/></p>
5004<p>When set to TORCH,<wbr/> the flash will be on continuously.<wbr/> This mode can be used
5005for use cases such as preview,<wbr/> auto-focus assist,<wbr/> still capture,<wbr/> or video recording.<wbr/></p>
5006 </td>
5007 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5008
5009
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5010 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5011 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5012
5013
5014
5015 <!-- end of kind -->
5016 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5017 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5018
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5019 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5020 <tr>
5021 <th class="th_name">Property Name</th>
5022 <th class="th_type">Type</th>
5023 <th class="th_description">Description</th>
5024 <th class="th_units">Units</th>
5025 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5026 <th class="th_tags">Tags</th>
5027 </tr>
5028 </thead>
5029
5030 <tbody>
5031
5032
5033
5034
5035
5036
5037
5038
5039
5040
5041
5042
5043 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5044 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5045 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5046 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5047 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5048 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5049
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5050 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5051
5052
5053 </td> <!-- entry_type -->
5054
5055 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5056 <p>Whether this camera has a
5057flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5058 </td>
5059
5060 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5061 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5062 </td>
5063
5064 <td class="entry_range">
5065 </td>
5066
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5067 <td class="entry_tags">
5068 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5069 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5070 </ul>
5071 </td>
5072
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5073 </tr>
5074 <tr class="entries_header">
5075 <th class="th_details" colspan="5">Details</th>
5076 </tr>
5077 <tr class="entry_cont">
5078 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5079 <p>If no flash,<wbr/> none of the flash controls do
5080anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5081 </td>
5082 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5083
5084
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5085 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5086 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5087
5088
5089 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5090 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5091 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5092 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5093 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5094 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5095
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5096 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5097
5098
5099 </td> <!-- entry_type -->
5100
5101 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5102 <p>Time taken before flash can fire
5103again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5104 </td>
5105
5106 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5107 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5108 </td>
5109
5110 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5111 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5112 </td>
5113
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5114 <td class="entry_tags">
5115 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5116 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5117 </ul>
5118 </td>
5119
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5120 </tr>
5121 <tr class="entries_header">
5122 <th class="th_details" colspan="5">Details</th>
5123 </tr>
5124 <tr class="entry_cont">
5125 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5126 <p>1 second too long/<wbr/>too short for recharge? Should
5127this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5128 </td>
5129 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5130
5131
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5132 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5133 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5134
5135
5136
5137
5138
5139 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5140 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5141 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5142 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5143 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5144 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5145
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5146 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5147
5148
5149 </td> <!-- entry_type -->
5150
5151 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5152 <p>The x,<wbr/>y whitepoint of the
5153flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5154 </td>
5155
5156 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5157 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5158 </td>
5159
5160 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5161 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5162 </td>
5163
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5164 <td class="entry_tags">
5165 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5166 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5167 </ul>
5168 </td>
5169
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5170 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5171
5172
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5173 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5174 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5175
5176
5177 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5178 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5179 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5180 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5181 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5182 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5183
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5184 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5185
5186
5187 </td> <!-- entry_type -->
5188
5189 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5190 <p>Max energy output of the flash for a full
5191power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5192 </td>
5193
5194 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5195 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5196 </td>
5197
5198 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]5199 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5200 </td>
5201
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5202 <td class="entry_tags">
5203 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5204 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5205 </ul>
5206 </td>
5207
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5208 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5209
5210
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5211 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5212 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5213
5214
5215
5216 <!-- end of kind -->
5217 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5218 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5219
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5220 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5221 <tr>
5222 <th class="th_name">Property Name</th>
5223 <th class="th_type">Type</th>
5224 <th class="th_description">Description</th>
5225 <th class="th_units">Units</th>
5226 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5227 <th class="th_tags">Tags</th>
5228 </tr>
5229 </thead>
5230
5231 <tbody>
5232
5233
5234
5235
5236
5237
5238
5239
5240
5241
5242 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5243 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5244 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5245 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5246 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5247 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5248
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5249 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5250
5251
5252 </td> <!-- entry_type -->
5253
5254 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5255 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5256 </td>
5257
5258 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5259 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5260 </td>
5261
5262 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5263 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5264 </td>
5265
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5266 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5267 <ul class="entry_tags">
5268 <li><a href="#tag_V1">V1</a></li>
5269 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5270 </td>
5271
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5272 </tr>
5273 <tr class="entries_header">
5274 <th class="th_details" colspan="5">Details</th>
5275 </tr>
5276 <tr class="entry_cont">
5277 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5278 <p>Power for snapshot may use a different scale than
5279for torch mode.<wbr/> Only one entry for torch mode will be
5280used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5281 </td>
5282 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5283
5284
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5285 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5286 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5287
5288
5289 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5290 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5291 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5292 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5293 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5294 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5295
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5296 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5297
5298
5299 </td> <!-- entry_type -->
5300
5301 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5302 <p>Firing time of flash relative to start of
5303exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5304 </td>
5305
5306 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5307 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5308 </td>
5309
5310 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5311 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5312 </td>
5313
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5314 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5315 <ul class="entry_tags">
5316 <li><a href="#tag_V1">V1</a></li>
5317 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5318 </td>
5319
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5320 </tr>
5321 <tr class="entries_header">
5322 <th class="th_details" colspan="5">Details</th>
5323 </tr>
5324 <tr class="entry_cont">
5325 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5326 <p>Clamped to (0,<wbr/> exposure time - flash
5327duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5328 </td>
5329 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5330
5331
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5332 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5333 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5334
5335
5336 <tr class="entry" id="dynamic_android.flash.mode">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]5337 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5338 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5339 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5340 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5341 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5342
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5343 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5344
5345 <ul class="entry_type_enum">
5346 <li>
5347 <span class="entry_type_enum_name">OFF</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]5348 <span class="entry_type_enum_notes"><p>Do not fire the flash for this capture.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5349 </li>
5350 <li>
5351 <span class="entry_type_enum_name">SINGLE</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]5352 <span class="entry_type_enum_notes"><p>If the flash is available and charged,<wbr/> fire flash
5353for this capture based on <a href="#controls_android.flash.firingPower">android.<wbr/>flash.<wbr/>firing<wbr/>Power</a> and
5354<a href="#controls_android.flash.firingTime">android.<wbr/>flash.<wbr/>firing<wbr/>Time</a>.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5355 </li>
5356 <li>
5357 <span class="entry_type_enum_name">TORCH</span>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]5358 <span class="entry_type_enum_notes"><p>Transition flash to continuously on.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5359 </li>
5360 </ul>
5361
5362 </td> <!-- entry_type -->
5363
5364 <td class="entry_description">
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]5365 <p>The desired mode for for the camera device's flash control.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5366 </td>
5367
5368 <td class="entry_units">
5369 </td>
5370
5371 <td class="entry_range">
5372 </td>
5373
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5374 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5375 <ul class="entry_tags">
5376 <li><a href="#tag_BC">BC</a></li>
5377 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5378 </td>
5379
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5380 </tr>
Zhijun Heea27bc32014-01-15 13:47:59 -0800[diff] [blame^]5381 <tr class="entries_header">
5382 <th class="th_details" colspan="5">Details</th>
5383 </tr>
5384 <tr class="entry_cont">
5385 <td class="entry_details" colspan="5">
5386 <p>This control is only effective when flash unit is available
5387(<code><a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> != 0</code>).<wbr/></p>
5388<p>When this control is used,<wbr/> the <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> must be set to ON or OFF.<wbr/>
5389Otherwise,<wbr/> the camera device auto-exposure related flash control (ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
5390ON_<wbr/>ALWAYS_<wbr/>FLASH,<wbr/> or ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE) will override this control.<wbr/></p>
5391<p>When set to OFF,<wbr/> the camera device will not fire flash for this capture.<wbr/></p>
5392<p>When set to SINGLE,<wbr/> the camera device will fire flash regardless of the camera
5393device's auto-exposure routine's result.<wbr/> When used in still capture case,<wbr/> this
5394control should be used along with AE precapture metering sequence
5395(<a href="#controls_android.control.aePrecaptureTrigger">android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger</a>),<wbr/> otherwise,<wbr/> the image may be incorrectly exposed.<wbr/></p>
5396<p>When set to TORCH,<wbr/> the flash will be on continuously.<wbr/> This mode can be used
5397for use cases such as preview,<wbr/> auto-focus assist,<wbr/> still capture,<wbr/> or video recording.<wbr/></p>
5398 </td>
5399 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5400
5401
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5402 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5403 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5404
5405
5406 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5407 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5408 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5409 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5410 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5411 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5412
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5413 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5414
5415 <ul class="entry_type_enum">
5416 <li>
5417 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5418 <span class="entry_type_enum_notes"><p>No flash on camera</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5419 </li>
5420 <li>
5421 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5422 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash is
5423charging and cannot be fired</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5424 </li>
5425 <li>
5426 <span class="entry_type_enum_name">READY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5427 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash is
5428ready to fire</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5429 </li>
5430 <li>
5431 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5432 <span class="entry_type_enum_notes"><p>if android.<wbr/>flash.<wbr/>available is true Flash fired
5433for this capture</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5434 </li>
5435 </ul>
5436
5437 </td> <!-- entry_type -->
5438
5439 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5440 <p>Current state of the flash
5441unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5442 </td>
5443
5444 <td class="entry_units">
5445 </td>
5446
5447 <td class="entry_range">
5448 </td>
5449
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5450 <td class="entry_tags">
5451 </td>
5452
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5453 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5454
5455
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5456 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5457 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5458
5459
5460
5461 <!-- end of kind -->
5462 </tbody>
5463
5464 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5465 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5466
5467
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5468 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5469
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5470 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5471 <tr>
5472 <th class="th_name">Property Name</th>
5473 <th class="th_type">Type</th>
5474 <th class="th_description">Description</th>
5475 <th class="th_units">Units</th>
5476 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5477 <th class="th_tags">Tags</th>
5478 </tr>
5479 </thead>
5480
5481 <tbody>
5482
5483
5484
5485
5486
5487
5488
5489
5490
5491
5492 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5493 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5494 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5495 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5496 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5497 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5498
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5499 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5500
5501 <ul class="entry_type_enum">
5502 <li>
5503 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5504 <span class="entry_type_enum_notes"><p>No geometric correction is
5505applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5506 </li>
5507 <li>
5508 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5509 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
5510bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5511 </li>
5512 <li>
5513 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5514 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5515quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5516 </li>
5517 </ul>
5518
5519 </td> <!-- entry_type -->
5520
5521 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5522 <p>Operating mode of geometric
5523correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5524 </td>
5525
5526 <td class="entry_units">
5527 </td>
5528
5529 <td class="entry_range">
5530 </td>
5531
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5532 <td class="entry_tags">
5533 </td>
5534
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5535 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5536
5537
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5538 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5539 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5540
5541
5542 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5543 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5544 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5545 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5546 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5547 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5548
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5549 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5550
5551
5552 </td> <!-- entry_type -->
5553
5554 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5555 <p>Control the amount of shading correction
5556applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5557 </td>
5558
5559 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5560 unitless: 1-10; 10 is full shading
5561 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5562 </td>
5563
5564 <td class="entry_range">
5565 </td>
5566
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5567 <td class="entry_tags">
5568 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5569 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5570 </ul>
5571 </td>
5572
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5573 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5574
5575
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5576 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5577 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5578
5579
5580
5581 <!-- end of kind -->
5582 </tbody>
5583
5584 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5585 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5586
5587
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5588 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5589
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5590 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5591 <tr>
5592 <th class="th_name">Property Name</th>
5593 <th class="th_type">Type</th>
5594 <th class="th_description">Description</th>
5595 <th class="th_units">Units</th>
5596 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5597 <th class="th_tags">Tags</th>
5598 </tr>
5599 </thead>
5600
5601 <tbody>
5602
5603
5604
5605
5606
5607
5608
5609
5610
5611
5612 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5613 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5614 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5615 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5616 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5617 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5618
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5619 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5620
5621 <ul class="entry_type_enum">
5622 <li>
5623 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5624 <span class="entry_type_enum_notes"><p>No hot pixel correction can be
5625applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5626 </li>
5627 <li>
5628 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5629 <span class="entry_type_enum_notes"><p>Frame rate must not be reduced compared to raw
5630Bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5631 </li>
5632 <li>
5633 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5634 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5635quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5636 </li>
5637 </ul>
5638
5639 </td> <!-- entry_type -->
5640
5641 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5642 <p>Set operational mode for hot pixel
5643correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5644 </td>
5645
5646 <td class="entry_units">
5647 </td>
5648
5649 <td class="entry_range">
5650 </td>
5651
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5652 <td class="entry_tags">
5653 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5654 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5655 </ul>
5656 </td>
5657
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5658 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5659
5660
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5661 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5662 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5663
5664
5665
5666 <!-- end of kind -->
5667 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5668 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5669
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5670 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5671 <tr>
5672 <th class="th_name">Property Name</th>
5673 <th class="th_type">Type</th>
5674 <th class="th_description">Description</th>
5675 <th class="th_units">Units</th>
5676 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5677 <th class="th_tags">Tags</th>
5678 </tr>
5679 </thead>
5680
5681 <tbody>
5682
5683
5684
5685
5686
5687
5688
5689
5690
5691
5692
5693
5694 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5695 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5696 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5697 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5698 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5699 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5700 <span class="entry_type_container">x</span>
5701
5702 <span class="entry_type_array">
5703 2 x n
5704 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5705 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5706 <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]5707
5708
5709 </td> <!-- entry_type -->
5710
5711 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5712 <p>Location of hot/<wbr/>defective pixels on
5713sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5714 </td>
5715
5716 <td class="entry_units">
5717 </td>
5718
5719 <td class="entry_range">
5720 </td>
5721
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5722 <td class="entry_tags">
5723 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5724 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5725 </ul>
5726 </td>
5727
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5728 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5729
5730
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5731 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5732 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5733
5734
5735
5736
5737
5738
5739 <!-- end of kind -->
5740 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5741 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5742
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5743 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5744 <tr>
5745 <th class="th_name">Property Name</th>
5746 <th class="th_type">Type</th>
5747 <th class="th_description">Description</th>
5748 <th class="th_units">Units</th>
5749 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5750 <th class="th_tags">Tags</th>
5751 </tr>
5752 </thead>
5753
5754 <tbody>
5755
5756
5757
5758
5759
5760
5761
5762
5763
5764
5765 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5766 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5767 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5768 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5769 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5770 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5771
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5772 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5773
5774 <ul class="entry_type_enum">
5775 <li>
5776 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5777 <span class="entry_type_enum_notes"><p>No hot pixel correction can be
5778applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5779 </li>
5780 <li>
5781 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5782 <span class="entry_type_enum_notes"><p>Frame rate must not be reduced compared to raw
5783Bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5784 </li>
5785 <li>
5786 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]5787 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
5788quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5789 </li>
5790 </ul>
5791
5792 </td> <!-- entry_type -->
5793
5794 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5795 <p>Set operational mode for hot pixel
5796correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5797 </td>
5798
5799 <td class="entry_units">
5800 </td>
5801
5802 <td class="entry_range">
5803 </td>
5804
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5805 <td class="entry_tags">
5806 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5807 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5808 </ul>
5809 </td>
5810
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5811 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5812
5813
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5814 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5815 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5816
5817
5818
5819 <!-- end of kind -->
5820 </tbody>
5821
5822 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5823 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5824
5825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5826 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5827
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5828 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5829 <tr>
5830 <th class="th_name">Property Name</th>
5831 <th class="th_type">Type</th>
5832 <th class="th_description">Description</th>
5833 <th class="th_units">Units</th>
5834 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5835 <th class="th_tags">Tags</th>
5836 </tr>
5837 </thead>
5838
5839 <tbody>
5840
5841
5842
5843
5844
5845
5846
5847
5848
5849
5850 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5851 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5852 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5853 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5854 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5855 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5856 <span class="entry_type_container">x</span>
5857
5858 <span class="entry_type_array">
5859 3
5860 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5861 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5862 <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]5863
5864
5865 </td> <!-- entry_type -->
5866
5867 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5868 <p>GPS coordinates to include in output JPEG
5869EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5870 </td>
5871
5872 <td class="entry_units">
5873 </td>
5874
5875 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5876 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5877 </td>
5878
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5879 <td class="entry_tags">
5880 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5881 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5882 </ul>
5883 </td>
5884
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5885 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5886
5887
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5888 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5889 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5890
5891
5892 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5893 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5894 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5895 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5896 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5897 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5898
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5899 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5900
5901
5902 </td> <!-- entry_type -->
5903
5904 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5905 <p>32 characters describing GPS algorithm to
5906include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5907 </td>
5908
5909 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5910 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5911 </td>
5912
5913 <td class="entry_range">
5914 </td>
5915
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5916 <td class="entry_tags">
5917 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5918 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5919 </ul>
5920 </td>
5921
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5922 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5923
5924
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5925 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5926 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5927
5928
5929 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5930 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5931 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5932 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5933 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5934 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5935
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5936 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5937
5938
5939 </td> <!-- entry_type -->
5940
5941 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5942 <p>Time GPS fix was made to include in
5943EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5944 </td>
5945
5946 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5947 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5948 </td>
5949
5950 <td class="entry_range">
5951 </td>
5952
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5953 <td class="entry_tags">
5954 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5955 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5956 </ul>
5957 </td>
5958
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5959 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5960
5961
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5962 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5963 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5964
5965
5966 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5967 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5968 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5969 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5970 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5971 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5972
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5973 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5974
5975
5976 </td> <!-- entry_type -->
5977
5978 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5979 <p>Orientation of JPEG image to
5980write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5981 </td>
5982
5983 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5984 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5985 </td>
5986
5987 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5988 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5989 </td>
5990
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5991 <td class="entry_tags">
5992 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5993 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5994 </ul>
5995 </td>
5996
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5997 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5998
5999
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6000 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6001 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6002
6003
6004 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6005 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6006 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6007 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6008 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6009 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6010
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6011 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6012
6013
6014 </td> <!-- entry_type -->
6015
6016 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6017 <p>Compression quality of the final JPEG
6018image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6019 </td>
6020
6021 <td class="entry_units">
6022 </td>
6023
6024 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6025 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6026 </td>
6027
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6028 <td class="entry_tags">
6029 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6030 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6031 </ul>
6032 </td>
6033
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6034 </tr>
6035 <tr class="entries_header">
6036 <th class="th_details" colspan="5">Details</th>
6037 </tr>
6038 <tr class="entry_cont">
6039 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6040 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6041 </td>
6042 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6043
6044
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6045 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6046 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6047
6048
6049 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6050 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6051 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6052 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6053 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6054 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6055
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6056 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6057
6058
6059 </td> <!-- entry_type -->
6060
6061 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6062 <p>Compression quality of JPEG
6063thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6064 </td>
6065
6066 <td class="entry_units">
6067 </td>
6068
6069 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6070 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6071 </td>
6072
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6073 <td class="entry_tags">
6074 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6075 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6076 </ul>
6077 </td>
6078
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6079 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6080
6081
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6082 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6083 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6084
6085
6086 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6087 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6088 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6089 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6090 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6091 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6092 <span class="entry_type_container">x</span>
6093
6094 <span class="entry_type_array">
6095 2
6096 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6097 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6098
6099
6100 </td> <!-- entry_type -->
6101
6102 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6103 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6104 </td>
6105
6106 <td class="entry_units">
6107 </td>
6108
6109 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6110 <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]6111 </td>
6112
6113 <td class="entry_tags">
6114 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6115 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6116 </ul>
6117 </td>
6118
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6119 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6120 <tr class="entries_header">
6121 <th class="th_details" colspan="5">Details</th>
6122 </tr>
6123 <tr class="entry_cont">
6124 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6125 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF will not contain thumbnail,<wbr/>
6126but the captured JPEG will still be a valid image.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6127<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6128the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6129 </td>
6130 </tr>
6131
6132
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6133 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6134 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6135
6136
6137
6138 <!-- end of kind -->
6139 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6140 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6141
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6142 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6143 <tr>
6144 <th class="th_name">Property Name</th>
6145 <th class="th_type">Type</th>
6146 <th class="th_description">Description</th>
6147 <th class="th_units">Units</th>
6148 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6149 <th class="th_tags">Tags</th>
6150 </tr>
6151 </thead>
6152
6153 <tbody>
6154
6155
6156
6157
6158
6159
6160
6161
6162
6163
6164 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6165 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6166 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6167 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6168 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6169 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6170 <span class="entry_type_container">x</span>
6171
6172 <span class="entry_type_array">
6173 2 x n
6174 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6175 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6176
6177
6178 </td> <!-- entry_type -->
6179
6180 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6181 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6182 </td>
6183
6184 <td class="entry_units">
6185 </td>
6186
6187 <td class="entry_range">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6188 <p>Will include at least one valid resolution,<wbr/> plus
6189(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]6190 </td>
6191
6192 <td class="entry_tags">
6193 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6194 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6195 </ul>
6196 </td>
6197
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6198 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6199 <tr class="entries_header">
6200 <th class="th_details" colspan="5">Details</th>
6201 </tr>
6202 <tr class="entry_cont">
6203 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6204 <p>Below condiditions will be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6205<ul>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6206<li>The sizes will be sorted by increasing pixel area (width x height).<wbr/>
6207If several resolutions have the same area,<wbr/> they will be sorted by increasing width.<wbr/></li>
6208<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]6209aspect 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]6210The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6211in a given size list.<wbr/></li>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6212<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]6213one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
6214and vice versa.<wbr/></li>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6215<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]6216</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6217 </td>
6218 </tr>
6219
6220
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6221 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6222 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6223
6224
6225 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6226 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6227 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6228 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6229 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6230 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6231
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6232 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6233
6234
6235 </td> <!-- entry_type -->
6236
6237 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6238 <p>Maximum size in bytes for the compressed
6239JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6240 </td>
6241
6242 <td class="entry_units">
6243 </td>
6244
6245 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6246 <p>Must be large enough to fit any JPEG produced by
6247the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6248 </td>
6249
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6250 <td class="entry_tags">
6251 </td>
6252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6253 </tr>
6254 <tr class="entries_header">
6255 <th class="th_details" colspan="5">Details</th>
6256 </tr>
6257 <tr class="entry_cont">
6258 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6259 <p>This is used for sizing the gralloc buffers for
6260JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6261 </td>
6262 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6263
6264
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6265 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6266 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6267
6268
6269
6270 <!-- end of kind -->
6271 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6272 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6273
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6274 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6275 <tr>
6276 <th class="th_name">Property Name</th>
6277 <th class="th_type">Type</th>
6278 <th class="th_description">Description</th>
6279 <th class="th_units">Units</th>
6280 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6281 <th class="th_tags">Tags</th>
6282 </tr>
6283 </thead>
6284
6285 <tbody>
6286
6287
6288
6289
6290
6291
6292
6293
6294
6295
6296 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6297 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6298 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6299 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6300 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6301 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6302 <span class="entry_type_container">x</span>
6303
6304 <span class="entry_type_array">
6305 3
6306 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6307 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6308 <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]6309
6310
6311 </td> <!-- entry_type -->
6312
6313 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6314 <p>GPS coordinates to include in output JPEG
6315EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6316 </td>
6317
6318 <td class="entry_units">
6319 </td>
6320
6321 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6322 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6323 </td>
6324
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6325 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6326 <ul class="entry_tags">
6327 <li><a href="#tag_BC">BC</a></li>
6328 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6329 </td>
6330
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6331 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6332
6333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6334 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6335 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6336
6337
6338 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6339 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6340 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6341 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6342 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6343 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6344
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6345 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6346
6347
6348 </td> <!-- entry_type -->
6349
6350 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6351 <p>32 characters describing GPS algorithm to
6352include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6353 </td>
6354
6355 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6356 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6357 </td>
6358
6359 <td class="entry_range">
6360 </td>
6361
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6362 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6363 <ul class="entry_tags">
6364 <li><a href="#tag_BC">BC</a></li>
6365 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6366 </td>
6367
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6368 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6369
6370
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6371 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6372 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6373
6374
6375 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6376 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6377 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6378 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6379 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6380 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6381
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6382 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6383
6384
6385 </td> <!-- entry_type -->
6386
6387 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6388 <p>Time GPS fix was made to include in
6389EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6390 </td>
6391
6392 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6393 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6394 </td>
6395
6396 <td class="entry_range">
6397 </td>
6398
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6399 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6400 <ul class="entry_tags">
6401 <li><a href="#tag_BC">BC</a></li>
6402 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6403 </td>
6404
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6405 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6406
6407
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6408 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6409 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6410
6411
6412 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6413 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6414 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6415 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6416 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6417 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6418
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6419 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6420
6421
6422 </td> <!-- entry_type -->
6423
6424 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6425 <p>Orientation of JPEG image to
6426write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6427 </td>
6428
6429 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6430 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6431 </td>
6432
6433 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6434 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6435 </td>
6436
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6437 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6438 <ul class="entry_tags">
6439 <li><a href="#tag_BC">BC</a></li>
6440 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6441 </td>
6442
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6443 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6444
6445
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6446 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6447 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6448
6449
6450 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6451 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6452 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6453 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6454 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6455 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6456
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6457 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6458
6459
6460 </td> <!-- entry_type -->
6461
6462 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6463 <p>Compression quality of the final JPEG
6464image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6465 </td>
6466
6467 <td class="entry_units">
6468 </td>
6469
6470 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6471 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6472 </td>
6473
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6474 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6475 <ul class="entry_tags">
6476 <li><a href="#tag_BC">BC</a></li>
6477 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6478 </td>
6479
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6480 </tr>
6481 <tr class="entries_header">
6482 <th class="th_details" colspan="5">Details</th>
6483 </tr>
6484 <tr class="entry_cont">
6485 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6486 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6487 </td>
6488 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6489
6490
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6491 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6492 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6493
6494
6495 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6496 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6497 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6498 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6499 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6500 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6501
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6502 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6503
6504
6505 </td> <!-- entry_type -->
6506
6507 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6508 <p>The size of the compressed JPEG image,<wbr/> in
6509bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6510 </td>
6511
6512 <td class="entry_units">
6513 </td>
6514
6515 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6516 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6517 </td>
6518
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6519 <td class="entry_tags">
6520 </td>
6521
6522 </tr>
6523 <tr class="entries_header">
6524 <th class="th_details" colspan="5">Details</th>
6525 </tr>
6526 <tr class="entry_cont">
6527 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6528 <p>If no JPEG output is produced for the request,<wbr/>
6529this must be 0.<wbr/></p>
6530<p>Otherwise,<wbr/> this describes the real size of the compressed
6531JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6532if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
6533has <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]6534the JPEG stream will be 1000000 bytes,<wbr/> of which the first
6535500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6536 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6537 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6538
6539
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6540 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6541 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6542
6543
6544 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6545 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6546 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6547 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6548 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6549 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6550
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6551 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6552
6553
6554 </td> <!-- entry_type -->
6555
6556 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6557 <p>Compression quality of JPEG
6558thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6559 </td>
6560
6561 <td class="entry_units">
6562 </td>
6563
6564 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6565 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6566 </td>
6567
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6568 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6569 <ul class="entry_tags">
6570 <li><a href="#tag_BC">BC</a></li>
6571 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6572 </td>
6573
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6574 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6575
6576
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6577 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6578 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6579
6580
6581 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6582 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6583 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6584 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6585 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6586 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6587 <span class="entry_type_container">x</span>
6588
6589 <span class="entry_type_array">
6590 2
6591 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6592 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6593
6594
6595 </td> <!-- entry_type -->
6596
6597 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6598 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6599 </td>
6600
6601 <td class="entry_units">
6602 </td>
6603
6604 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6605 <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]6606 </td>
6607
6608 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6609 <ul class="entry_tags">
6610 <li><a href="#tag_BC">BC</a></li>
6611 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6612 </td>
6613
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6614 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6615 <tr class="entries_header">
6616 <th class="th_details" colspan="5">Details</th>
6617 </tr>
6618 <tr class="entry_cont">
6619 <td class="entry_details" colspan="5">
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]6620 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF will not contain thumbnail,<wbr/>
6621but the captured JPEG will still be a valid image.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6622<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6623the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6624 </td>
6625 </tr>
6626
6627
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6628 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6629 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6630
6631
6632
6633 <!-- end of kind -->
6634 </tbody>
6635
6636 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6637 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6638
6639
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6640 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6641
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6642 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6643 <tr>
6644 <th class="th_name">Property Name</th>
6645 <th class="th_type">Type</th>
6646 <th class="th_description">Description</th>
6647 <th class="th_units">Units</th>
6648 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6649 <th class="th_tags">Tags</th>
6650 </tr>
6651 </thead>
6652
6653 <tbody>
6654
6655
6656
6657
6658
6659
6660
6661
6662
6663
6664 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6665 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6666 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6667 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6668 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6669 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6670
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6671 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6672
6673
6674 </td> <!-- entry_type -->
6675
6676 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6677 <p>The ratio of lens focal length to the effective
6678aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6679 </td>
6680
6681 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6682 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6683 </td>
6684
6685 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6686 <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]6687 </td>
6688
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6689 <td class="entry_tags">
6690 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6691 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6692 </ul>
6693 </td>
6694
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6695 </tr>
6696 <tr class="entries_header">
6697 <th class="th_details" colspan="5">Details</th>
6698 </tr>
6699 <tr class="entry_cont">
6700 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6701 <p>This will only be supported on the camera devices that
6702have variable aperture lens.<wbr/> The aperture value can only be
6703one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
6704<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
6705this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
6706<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
6707to achieve manual exposure control.<wbr/></p>
6708<p>The requested aperture value may take several frames to reach the
6709requested value; the camera device will report the current (intermediate)
6710aperture size in capture result metadata while the aperture is changing.<wbr/></p>
6711<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
6712the ON modes,<wbr/> this will be overridden by the camera device
6713auto-exposure algorithm,<wbr/> the overridden values are then provided
6714back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6715 </td>
6716 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6717
6718
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6719 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6720 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6721
6722
6723 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6724 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6725 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6726 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6727 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6728 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6729
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6730 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6731
6732
6733 </td> <!-- entry_type -->
6734
6735 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6736 <p>State of lens neutral density
6737filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6738 </td>
6739
6740 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6741 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6742 </td>
6743
6744 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6745 <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]6746 </td>
6747
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6748 <td class="entry_tags">
6749 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6750 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6751 </ul>
6752 </td>
6753
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6754 </tr>
6755 <tr class="entries_header">
6756 <th class="th_details" colspan="5">Details</th>
6757 </tr>
6758 <tr class="entry_cont">
6759 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6760 <p>Will not be supported on most devices.<wbr/> Can only
6761pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6762 </td>
6763 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6764
6765
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6766 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6767 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6768
6769
6770 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6771 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6772 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6773 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6774 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6775 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6776
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6777 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6778
6779
6780 </td> <!-- entry_type -->
6781
6782 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6783 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6784 </td>
6785
6786 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6787 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6788 </td>
6789
6790 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6791 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6792 </td>
6793
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6794 <td class="entry_tags">
6795 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6796 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6797 </ul>
6798 </td>
6799
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6800 </tr>
6801 <tr class="entries_header">
6802 <th class="th_details" colspan="5">Details</th>
6803 </tr>
6804 <tr class="entry_cont">
6805 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6806 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6807 </td>
6808 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6809
6810
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6811 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6812 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6813
6814
6815 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6816 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6817 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6818 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6819 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6820 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6821
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6822 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6823
6824
6825 </td> <!-- entry_type -->
6826
6827 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6828 <p>Distance to plane of sharpest focus,<wbr/>
6829measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6830 </td>
6831
6832 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6833 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6834 </td>
6835
6836 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6837 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6838 </td>
6839
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6840 <td class="entry_tags">
6841 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6842 <li><a href="#tag_BC">BC</a></li>
6843 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6844 </ul>
6845 </td>
6846
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6847 </tr>
6848 <tr class="entries_header">
6849 <th class="th_details" colspan="5">Details</th>
6850 </tr>
6851 <tr class="entry_cont">
6852 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6853 <p>0 = infinity focus.<wbr/> Used value should be clamped
6854to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6855 </td>
6856 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6857
6858
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6859 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6860 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6861
6862
6863 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6864 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6865 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6866 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6867 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6868 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6869
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6870 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6871
6872 <ul class="entry_type_enum">
6873 <li>
6874 <span class="entry_type_enum_name">OFF</span>
6875 </li>
6876 <li>
6877 <span class="entry_type_enum_name">ON</span>
6878 <span class="entry_type_enum_optional">optional</span>
6879 </li>
6880 </ul>
6881
6882 </td> <!-- entry_type -->
6883
6884 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6885 <p>Whether optical image stabilization is
6886enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6887 </td>
6888
6889 <td class="entry_units">
6890 </td>
6891
6892 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6893 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6894 </td>
6895
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6896 <td class="entry_tags">
6897 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6898 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6899 </ul>
6900 </td>
6901
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6902 </tr>
6903 <tr class="entries_header">
6904 <th class="th_details" colspan="5">Details</th>
6905 </tr>
6906 <tr class="entry_cont">
6907 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6908 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6909 </td>
6910 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6911
6912
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6913 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6914 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6915
6916
6917
6918 <!-- end of kind -->
6919 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6920 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6921
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6922 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6923 <tr>
6924 <th class="th_name">Property Name</th>
6925 <th class="th_type">Type</th>
6926 <th class="th_description">Description</th>
6927 <th class="th_units">Units</th>
6928 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6929 <th class="th_tags">Tags</th>
6930 </tr>
6931 </thead>
6932
6933 <tbody>
6934
6935
6936
6937
6938
6939
6940
6941
6942
6943
6944
6945
6946 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6947 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6948 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6949 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6950 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6951 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6952 <span class="entry_type_container">x</span>
6953
6954 <span class="entry_type_array">
6955 n
6956 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6957 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6958
6959
6960 </td> <!-- entry_type -->
6961
6962 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6963 <p>List of supported aperture
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6964values.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6965 </td>
6966
6967 <td class="entry_units">
6968 </td>
6969
6970 <td class="entry_range">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6971 <p>one entry required,<wbr/> &amp;&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6972 </td>
6973
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6974 <td class="entry_tags">
6975 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6976 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6977 </ul>
6978 </td>
6979
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6980 </tr>
6981 <tr class="entries_header">
6982 <th class="th_details" colspan="5">Details</th>
6983 </tr>
6984 <tr class="entry_cont">
6985 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6986 <p>If the camera device doesn't support variable apertures,<wbr/>
6987listed value will be the fixed aperture.<wbr/></p>
6988<p>If the camera device supports variable apertures,<wbr/> the aperture value
6989in this list will be sorted in ascending order.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6990 </td>
6991 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6992
6993
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6994 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6995 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6996
6997
6998 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6999 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7000 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7001 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7002 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7003 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7004 <span class="entry_type_container">x</span>
7005
7006 <span class="entry_type_array">
7007 n
7008 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7009 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7010
7011
7012 </td> <!-- entry_type -->
7013
7014 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7015 <p>List of supported ND filter
7016values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7017 </td>
7018
7019 <td class="entry_units">
7020 </td>
7021
7022 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7023 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7024 </td>
7025
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7026 <td class="entry_tags">
7027 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7028 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7029 </ul>
7030 </td>
7031
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7032 </tr>
7033 <tr class="entries_header">
7034 <th class="th_details" colspan="5">Details</th>
7035 </tr>
7036 <tr class="entry_cont">
7037 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7038 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7039lists the available exposure index values for dimming
7040(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7041light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7042 </td>
7043 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7044
7045
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7046 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7047 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7048
7049
7050 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7051 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7052 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7053 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7054 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7055 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7056 <span class="entry_type_container">x</span>
7057
7058 <span class="entry_type_array">
7059 n
7060 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7061 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7062 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7063
7064
7065 </td> <!-- entry_type -->
7066
7067 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7068 <p>If fitted with optical zoom,<wbr/> what focal
7069lengths are available.<wbr/> If not,<wbr/> the static focal
7070length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7071 </td>
7072
7073 <td class="entry_units">
7074 </td>
7075
7076 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7077 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7078 </td>
7079
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7080 <td class="entry_tags">
7081 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7082 <li><a href="#tag_BC">BC</a></li>
7083 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7084 </ul>
7085 </td>
7086
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7087 </tr>
7088 <tr class="entries_header">
7089 <th class="th_details" colspan="5">Details</th>
7090 </tr>
7091 <tr class="entry_cont">
7092 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7093 <p>If optical zoom not supported,<wbr/> only one value
7094should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7095 </td>
7096 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7097
7098
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7099 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7100 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7101
7102
7103 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7104 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7105 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7106 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7107 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7108 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7109 <span class="entry_type_container">x</span>
7110
7111 <span class="entry_type_array">
7112 n
7113 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7114 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7115 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7116
7117
7118 </td> <!-- entry_type -->
7119
7120 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7121 <p>List of supported optical image
7122stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7123 </td>
7124
7125 <td class="entry_units">
7126 </td>
7127
7128 <td class="entry_range">
7129 </td>
7130
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7131 <td class="entry_tags">
7132 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7133 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7134 </ul>
7135 </td>
7136
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7137 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7138
7139
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7140 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7141 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7142
7143
7144 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7145 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7146 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7147 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7148 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7149 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7150 <span class="entry_type_container">x</span>
7151
7152 <span class="entry_type_array">
7153 2 x 3 x n x m
7154 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7155 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7156 <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]7157
7158
7159 </td> <!-- entry_type -->
7160
7161 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7162 <p>A low-resolution map for correction of
7163geometric distortions and chromatic aberrations,<wbr/> per
7164color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7165 </td>
7166
7167 <td class="entry_units">
7168 </td>
7169
7170 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7171 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7172 </td>
7173
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7174 <td class="entry_tags">
7175 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7176 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7177 </ul>
7178 </td>
7179
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7180 </tr>
7181 <tr class="entries_header">
7182 <th class="th_details" colspan="5">Details</th>
7183 </tr>
7184 <tr class="entry_cont">
7185 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7186 <p>[DNG wants a function instead].<wbr/> What's easiest
7187for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
7188j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
7189j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
7190entry 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]7191 </td>
7192 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7193
7194
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7195 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7196 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7197
7198
7199 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7200 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7201 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7202 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7203 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7204 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7205 <span class="entry_type_container">x</span>
7206
7207 <span class="entry_type_array">
7208 2
7209 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7210 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7211 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7212
7213
7214 </td> <!-- entry_type -->
7215
7216 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7217 <p>Dimensions of geometric correction
7218map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7219 </td>
7220
7221 <td class="entry_units">
7222 </td>
7223
7224 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7225 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7226 </td>
7227
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7228 <td class="entry_tags">
7229 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7230 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7231 </ul>
7232 </td>
7233
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7234 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7235
7236
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7237 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7238 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7239
7240
7241 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7242 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7243 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7244 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7245 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7246 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7247
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7248 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7249
7250
7251 </td> <!-- entry_type -->
7252
7253 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7254 <p>Hyperfocal distance for this lens; set to
72550 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7256 </td>
7257
7258 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7259 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7260 </td>
7261
7262 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7263 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7264 </td>
7265
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7266 <td class="entry_tags">
7267 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7268 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7269 </ul>
7270 </td>
7271
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7272 </tr>
7273 <tr class="entries_header">
7274 <th class="th_details" colspan="5">Details</th>
7275 </tr>
7276 <tr class="entry_cont">
7277 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7278 <p>The hyperfocal distance is used for the old
7279API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7280 </td>
7281 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7282
7283
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7284 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7285 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7286
7287
7288 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7289 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7290 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7291 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7292 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7293 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7294
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7295 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7296
7297
7298 </td> <!-- entry_type -->
7299
7300 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7301 <p>Shortest distance from frontmost surface
7302of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7303 </td>
7304
7305 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7306 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7307 </td>
7308
7309 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7310 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7311 </td>
7312
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7313 <td class="entry_tags">
7314 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7315 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7316 </ul>
7317 </td>
7318
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7319 </tr>
7320 <tr class="entries_header">
7321 <th class="th_details" colspan="5">Details</th>
7322 </tr>
7323 <tr class="entry_cont">
7324 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7325 <p>If the lens is fixed-focus,<wbr/> this should be
73260</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7327 </td>
7328 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7329
7330
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7331 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7332 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7333
7334
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7335 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7336 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7337 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7338 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7339 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7340 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7341 <span class="entry_type_container">x</span>
7342
7343 <span class="entry_type_array">
7344 2
7345 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7346 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7347 <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]7348
7349
7350 </td> <!-- entry_type -->
7351
7352 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7353 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7354 </td>
7355
7356 <td class="entry_units">
7357 </td>
7358
7359 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7360 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7361 </td>
7362
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7363 <td class="entry_tags">
7364 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7365 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7366 </ul>
7367 </td>
7368
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7369 </tr>
7370 <tr class="entries_header">
7371 <th class="th_details" colspan="5">Details</th>
7372 </tr>
7373 <tr class="entry_cont">
7374 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7375 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
7376must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7377 </td>
7378 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7379
7380
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7381 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7382 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7383
7384
7385
7386
7387
7388 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7389 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7390 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7391 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7392 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7393 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7394
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7395 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7396
7397 <ul class="entry_type_enum">
7398 <li>
7399 <span class="entry_type_enum_name">FRONT</span>
7400 </li>
7401 <li>
7402 <span class="entry_type_enum_name">BACK</span>
7403 </li>
7404 </ul>
7405
7406 </td> <!-- entry_type -->
7407
7408 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7409 <p>Direction the camera faces relative to
7410device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7411 </td>
7412
7413 <td class="entry_units">
7414 </td>
7415
7416 <td class="entry_range">
7417 </td>
7418
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7419 <td class="entry_tags">
7420 </td>
7421
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7422 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7423
7424
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7425 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7426 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7427
7428
7429 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7430 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7431 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7432 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7433 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7434 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7435 <span class="entry_type_container">x</span>
7436
7437 <span class="entry_type_array">
7438 2
7439 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7440 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7441 <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]7442
7443
7444 </td> <!-- entry_type -->
7445
7446 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7447 <p>Relative angle of camera optical axis to the
7448perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7449 </td>
7450
7451 <td class="entry_units">
7452 </td>
7453
7454 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7455 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7456 </td>
7457
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7458 <td class="entry_tags">
7459 <ul class="entry_tags">
7460 <li><a href="#tag_ADV">ADV</a></li>
7461 </ul>
7462 </td>
7463
7464 </tr>
7465 <tr class="entries_header">
7466 <th class="th_details" colspan="5">Details</th>
7467 </tr>
7468 <tr class="entry_cont">
7469 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7470 <p>Examples:</p>
7471<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7472is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7473<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7474device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7475<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
7476the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7477<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7478direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7479 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7480 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7481
7482
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7483 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7484 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7485
7486
7487 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7488 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7489 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7490 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7491 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7492 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7493 <span class="entry_type_container">x</span>
7494
7495 <span class="entry_type_array">
7496 3, location in mm, in the sensor coordinate
7497 system
7498 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7499 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7500
7501
7502 </td> <!-- entry_type -->
7503
7504 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7505 <p>Coordinates of camera optical axis on
7506device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7507 </td>
7508
7509 <td class="entry_units">
7510 </td>
7511
7512 <td class="entry_range">
7513 </td>
7514
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7515 <td class="entry_tags">
7516 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7517 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7518 </ul>
7519 </td>
7520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7521 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7522
7523
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7524 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7525 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7526
7527
7528
7529 <!-- end of kind -->
7530 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7531 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7532
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7533 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7534 <tr>
7535 <th class="th_name">Property Name</th>
7536 <th class="th_type">Type</th>
7537 <th class="th_description">Description</th>
7538 <th class="th_units">Units</th>
7539 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7540 <th class="th_tags">Tags</th>
7541 </tr>
7542 </thead>
7543
7544 <tbody>
7545
7546
7547
7548
7549
7550
7551
7552
7553
7554
7555 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7556 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7557 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7558 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7559 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7560 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7561
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7562 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7563
7564
7565 </td> <!-- entry_type -->
7566
7567 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7568 <p>The ratio of lens focal length to the effective
7569aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7570 </td>
7571
7572 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7573 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7574 </td>
7575
7576 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7577 <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]7578 </td>
7579
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7580 <td class="entry_tags">
7581 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7582 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7583 </ul>
7584 </td>
7585
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7586 </tr>
7587 <tr class="entries_header">
7588 <th class="th_details" colspan="5">Details</th>
7589 </tr>
7590 <tr class="entry_cont">
7591 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7592 <p>This will only be supported on the camera devices that
7593have variable aperture lens.<wbr/> The aperture value can only be
7594one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
7595<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
7596this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
7597<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
7598to achieve manual exposure control.<wbr/></p>
7599<p>The requested aperture value may take several frames to reach the
7600requested value; the camera device will report the current (intermediate)
7601aperture size in capture result metadata while the aperture is changing.<wbr/></p>
7602<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
7603the ON modes,<wbr/> this will be overridden by the camera device
7604auto-exposure algorithm,<wbr/> the overridden values are then provided
7605back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7606 </td>
7607 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7608
7609
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7610 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7611 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7612
7613
7614 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7615 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7616 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7617 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7618 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7619 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7620
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7621 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7622
7623
7624 </td> <!-- entry_type -->
7625
7626 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7627 <p>State of lens neutral density
7628filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7629 </td>
7630
7631 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7632 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7633 </td>
7634
7635 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7636 <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]7637 </td>
7638
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7639 <td class="entry_tags">
7640 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7641 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7642 </ul>
7643 </td>
7644
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7645 </tr>
7646 <tr class="entries_header">
7647 <th class="th_details" colspan="5">Details</th>
7648 </tr>
7649 <tr class="entry_cont">
7650 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7651 <p>Will not be supported on most devices.<wbr/> Can only
7652pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7653 </td>
7654 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7655
7656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7657 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7658 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7659
7660
7661 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7662 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7663 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7664 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7665 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7666 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7667
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7668 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7669
7670
7671 </td> <!-- entry_type -->
7672
7673 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7674 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7675 </td>
7676
7677 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7678 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7679 </td>
7680
7681 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7682 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7683 </td>
7684
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7685 <td class="entry_tags">
7686 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7687 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7688 </ul>
7689 </td>
7690
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7691 </tr>
7692 <tr class="entries_header">
7693 <th class="th_details" colspan="5">Details</th>
7694 </tr>
7695 <tr class="entry_cont">
7696 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7697 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7698 </td>
7699 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7700
7701
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7702 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7703 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7704
7705
7706 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7707 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7708 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7709 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7710 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7711 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7712
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7713 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7714
7715
7716 </td> <!-- entry_type -->
7717
7718 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7719 <p>Distance to plane of sharpest focus,<wbr/>
7720measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7721 </td>
7722
7723 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7724 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7725 </td>
7726
7727 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7728 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7729 </td>
7730
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7731 <td class="entry_tags">
7732 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7733 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7734 </ul>
7735 </td>
7736
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7737 </tr>
7738 <tr class="entries_header">
7739 <th class="th_details" colspan="5">Details</th>
7740 </tr>
7741 <tr class="entry_cont">
7742 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7743 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7744 </td>
7745 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7746
7747
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7748 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7749 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7750
7751
7752 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7753 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7754 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7755 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7756 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7757 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7758 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7759
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7760 <span class="entry_type_array">
7761 2
7762 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7763 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7764 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7765
7766
7767 </td> <!-- entry_type -->
7768
7769 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7770 <p>The range of scene distances that are in
7771sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7772 </td>
7773
7774 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7775 pair of focus distances in diopters: (near,<wbr/>
7776 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7777 </td>
7778
7779 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7780 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7781 </td>
7782
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7783 <td class="entry_tags">
7784 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7785 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7786 </ul>
7787 </td>
7788
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7789 </tr>
7790 <tr class="entries_header">
7791 <th class="th_details" colspan="5">Details</th>
7792 </tr>
7793 <tr class="entry_cont">
7794 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7795 <p>If variable focus not supported,<wbr/> can still report
7796fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7797 </td>
7798 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7799
7800
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7801 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7802 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7803
7804
7805 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7806 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7807 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7808 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7809 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7810 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7811
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7812 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7813
7814 <ul class="entry_type_enum">
7815 <li>
7816 <span class="entry_type_enum_name">OFF</span>
7817 </li>
7818 <li>
7819 <span class="entry_type_enum_name">ON</span>
7820 <span class="entry_type_enum_optional">optional</span>
7821 </li>
7822 </ul>
7823
7824 </td> <!-- entry_type -->
7825
7826 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7827 <p>Whether optical image stabilization is
7828enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7829 </td>
7830
7831 <td class="entry_units">
7832 </td>
7833
7834 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7835 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7836 </td>
7837
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7838 <td class="entry_tags">
7839 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7840 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7841 </ul>
7842 </td>
7843
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7844 </tr>
7845 <tr class="entries_header">
7846 <th class="th_details" colspan="5">Details</th>
7847 </tr>
7848 <tr class="entry_cont">
7849 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7850 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7851 </td>
7852 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7853
7854
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7855 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7856 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7857
7858
7859 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7860 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7861 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7862 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7863 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7864 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7865
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7866 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7867
7868 <ul class="entry_type_enum">
7869 <li>
7870 <span class="entry_type_enum_name">STATIONARY</span>
7871 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7872 <li>
7873 <span class="entry_type_enum_name">MOVING</span>
7874 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7875 </ul>
7876
7877 </td> <!-- entry_type -->
7878
7879 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7880 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7881 </td>
7882
7883 <td class="entry_units">
7884 </td>
7885
7886 <td class="entry_range">
7887 </td>
7888
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7889 <td class="entry_tags">
7890 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7891 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7892 </ul>
7893 </td>
7894
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7895 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7896
7897
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7898 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7899 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7900
7901
7902
7903 <!-- end of kind -->
7904 </tbody>
7905
7906 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7907 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7908
7909
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7910 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7911
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7912 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7913 <tr>
7914 <th class="th_name">Property Name</th>
7915 <th class="th_type">Type</th>
7916 <th class="th_description">Description</th>
7917 <th class="th_units">Units</th>
7918 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7919 <th class="th_tags">Tags</th>
7920 </tr>
7921 </thead>
7922
7923 <tbody>
7924
7925
7926
7927
7928
7929
7930
7931
7932
7933
7934 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7935 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7936 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7937 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7938 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7939 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7940
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7941 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7942
7943 <ul class="entry_type_enum">
7944 <li>
7945 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7946 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7947 </li>
7948 <li>
7949 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7950 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
7951output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7952 </li>
7953 <li>
7954 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7955 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
7956quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7957 </li>
7958 </ul>
7959
7960 </td> <!-- entry_type -->
7961
7962 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7963 <p>Mode of operation for the noise reduction
7964algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7965 </td>
7966
7967 <td class="entry_units">
7968 </td>
7969
7970 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7971 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7972 </td>
7973
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7974 <td class="entry_tags">
7975 <ul class="entry_tags">
7976 <li><a href="#tag_V1">V1</a></li>
7977 </ul>
7978 </td>
7979
7980 </tr>
7981 <tr class="entries_header">
7982 <th class="th_details" colspan="5">Details</th>
7983 </tr>
7984 <tr class="entry_cont">
7985 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7986 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7987will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]7988<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
7989will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
7990will use the highest-quality noise filtering algorithms,<wbr/>
7991even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7992slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7993 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7994 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7995
7996
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7997 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7998 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7999
8000
8001 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8002 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8003 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8004 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8005 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8006 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8007
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8008 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8009
8010
8011 </td> <!-- entry_type -->
8012
8013 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8014 <p>Control the amount of noise reduction
8015applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8016 </td>
8017
8018 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8019 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8020 </td>
8021
8022 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8023 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8024 </td>
8025
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8026 <td class="entry_tags">
8027 </td>
8028
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8029 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8030
8031
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8032 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8033 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8034
8035
8036
8037 <!-- end of kind -->
8038 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8039 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8040
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8041 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8042 <tr>
8043 <th class="th_name">Property Name</th>
8044 <th class="th_type">Type</th>
8045 <th class="th_description">Description</th>
8046 <th class="th_units">Units</th>
8047 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8048 <th class="th_tags">Tags</th>
8049 </tr>
8050 </thead>
8051
8052 <tbody>
8053
8054
8055
8056
8057
8058
8059
8060
8061
8062
8063 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8064 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8065 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8066 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8067 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8068 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8069
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8070 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8071
8072 <ul class="entry_type_enum">
8073 <li>
8074 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8075 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8076 </li>
8077 <li>
8078 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8079 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
8080output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8081 </li>
8082 <li>
8083 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8084 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
8085quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8086 </li>
8087 </ul>
8088
8089 </td> <!-- entry_type -->
8090
8091 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8092 <p>Mode of operation for the noise reduction
8093algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8094 </td>
8095
8096 <td class="entry_units">
8097 </td>
8098
8099 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8100 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8101 </td>
8102
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8103 <td class="entry_tags">
8104 <ul class="entry_tags">
8105 <li><a href="#tag_V1">V1</a></li>
8106 </ul>
8107 </td>
8108
8109 </tr>
8110 <tr class="entries_header">
8111 <th class="th_details" colspan="5">Details</th>
8112 </tr>
8113 <tr class="entry_cont">
8114 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8115 <p>Noise filtering control.<wbr/> OFF means no noise reduction
8116will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]8117<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
8118will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
8119will use the highest-quality noise filtering algorithms,<wbr/>
8120even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8121slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8122 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8123 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8124
8125
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8126 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8127 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8128
8129
8130
8131 <!-- end of kind -->
8132 </tbody>
8133
8134 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8135 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8136
8137
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8138 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8139
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8140 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8141 <tr>
8142 <th class="th_name">Property Name</th>
8143 <th class="th_type">Type</th>
8144 <th class="th_description">Description</th>
8145 <th class="th_units">Units</th>
8146 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8147 <th class="th_tags">Tags</th>
8148 </tr>
8149 </thead>
8150
8151 <tbody>
8152
8153
8154
8155
8156
8157
8158
8159
8160
8161
8162 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8163 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8164 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8165 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8166 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8167 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8168
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8169 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8170
8171
8172 </td> <!-- entry_type -->
8173
8174 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8175 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8176scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8177region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
8178and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8179 </td>
8180
8181 <td class="entry_units">
8182 </td>
8183
8184 <td class="entry_range">
8185 </td>
8186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8187 <td class="entry_tags">
8188 </td>
8189
8190 </tr>
8191 <tr class="entries_header">
8192 <th class="th_details" colspan="5">Details</th>
8193 </tr>
8194 <tr class="entry_cont">
8195 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8196 <p>Normalized coordinates refer to those in the
8197(-1000,<wbr/>1000) range mentioned in the
8198android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8199<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8200sensor array-relative coordinates for all region data.<wbr/> Does
8201not need to be listed in static metadata.<wbr/> Support will be
8202removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8203 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8204 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8205
8206
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8207 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8208 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8209
8210
8211 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8212 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8213 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8214 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8215 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8216 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8217
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8218 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8219
8220
8221 </td> <!-- entry_type -->
8222
8223 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8224 <p>If set to 1,<wbr/> then the camera service always
8225switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
8226trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8227 </td>
8228
8229 <td class="entry_units">
8230 </td>
8231
8232 <td class="entry_range">
8233 </td>
8234
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8235 <td class="entry_tags">
8236 </td>
8237
8238 </tr>
8239 <tr class="entries_header">
8240 <th class="th_details" colspan="5">Details</th>
8241 </tr>
8242 <tr class="entry_cont">
8243 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8244 <p>HAL implementations should implement AF trigger
8245modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
8246CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
8247not need to be listed in static metadata.<wbr/> Support will be
8248removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8249 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8250 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8251
8252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8253 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8254 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8255
8256
8257 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8258 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8259 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8260 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8261 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8262 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8263
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8264 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8265
8266
8267 </td> <!-- entry_type -->
8268
8269 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8270 <p>If set to 1,<wbr/> the camera service uses
8271CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
8272HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
8273shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8274 </td>
8275
8276 <td class="entry_units">
8277 </td>
8278
8279 <td class="entry_range">
8280 </td>
8281
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8282 <td class="entry_tags">
8283 </td>
8284
8285 </tr>
8286 <tr class="entries_header">
8287 <th class="th_details" colspan="5">Details</th>
8288 </tr>
8289 <tr class="entry_cont">
8290 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8291 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8292to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8293zero-shutter-lag,<wbr/> instead of relying on an explicit
8294format setting.<wbr/> Does not need to be listed in static
8295metadata.<wbr/> Support will be removed in future versions of
8296camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8297 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8298 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8299
8300
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8301 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8302 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8303
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8304
8305 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8306 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8307 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8308 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8309 <td class="entry_type">
8310 <span class="entry_type_name">byte</span>
8311
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]8312 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8313
8314
8315 </td> <!-- entry_type -->
8316
8317 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8318 <p>If set to 1,<wbr/> the HAL will always split result
8319metadata for a single capture into multiple buffers,<wbr/>
8320returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8321 </td>
8322
8323 <td class="entry_units">
8324 </td>
8325
8326 <td class="entry_range">
8327 </td>
8328
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8329 <td class="entry_tags">
8330 </td>
8331
8332 </tr>
8333 <tr class="entries_header">
8334 <th class="th_details" colspan="5">Details</th>
8335 </tr>
8336 <tr class="entry_cont">
8337 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8338 <p>Does not need to be listed in static
8339metadata.<wbr/> Support for partial results will be reworked in
8340future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8341working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8342consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8343 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8344 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8345
8346
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8347 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8348 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8349
8350
8351
8352 <!-- end of kind -->
8353 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8354 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8355
8356 <thead class="entries_header">
8357 <tr>
8358 <th class="th_name">Property Name</th>
8359 <th class="th_type">Type</th>
8360 <th class="th_description">Description</th>
8361 <th class="th_units">Units</th>
8362 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8363 <th class="th_tags">Tags</th>
8364 </tr>
8365 </thead>
8366
8367 <tbody>
8368
8369
8370
8371
8372
8373
8374
8375
8376
8377
8378 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8379 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8380 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8381 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8382 <td class="entry_type">
8383 <span class="entry_type_name entry_type_name_enum">byte</span>
8384
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]8385 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8386
8387 <ul class="entry_type_enum">
8388 <li>
8389 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8390 <span class="entry_type_enum_notes"><p>The last or only metadata result buffer
8391for this capture.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8392 </li>
8393 <li>
8394 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8395 <span class="entry_type_enum_notes"><p>A partial buffer of result metadata for this
8396capture.<wbr/> More result buffers for this capture will be sent
8397by the HAL,<wbr/> the last of which will be marked
8398FINAL.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8399 </li>
8400 </ul>
8401
8402 </td> <!-- entry_type -->
8403
8404 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8405 <p>Whether a result given to the framework is the
8406final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8407subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8408values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8409 </td>
8410
8411 <td class="entry_units">
8412 </td>
8413
8414 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8415 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8416 </td>
8417
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8418 <td class="entry_tags">
8419 </td>
8420
8421 </tr>
8422 <tr class="entries_header">
8423 <th class="th_details" colspan="5">Details</th>
8424 </tr>
8425 <tr class="entry_cont">
8426 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8427 <p>The entries in the result metadata buffers for a
8428single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8429FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8430requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
8431always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
8432before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
8433in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
8434capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
8435only 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]8436 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8437 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8438
8439
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8440 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8441 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8442
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8443
8444
8445 <!-- end of kind -->
8446 </tbody>
8447
8448 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8449 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8450
8451
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8452 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8453
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8454 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8455 <tr>
8456 <th class="th_name">Property Name</th>
8457 <th class="th_type">Type</th>
8458 <th class="th_description">Description</th>
8459 <th class="th_units">Units</th>
8460 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8461 <th class="th_tags">Tags</th>
8462 </tr>
8463 </thead>
8464
8465 <tbody>
8466
8467
8468
8469
8470
8471
8472
8473
8474
8475
8476 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8477 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8478 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8479 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8480 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8481 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8482
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8483 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8484
8485
8486 </td> <!-- entry_type -->
8487
8488 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8489 <p>A frame counter set by the framework.<wbr/> Must
8490be maintained unchanged in output frame.<wbr/> This value monotonically
8491increases with every new result (that is,<wbr/> each new result has a unique
8492frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8493 </td>
8494
8495 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8496 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8497 </td>
8498
8499 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8500 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8501 </td>
8502
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8503 <td class="entry_tags">
8504 </td>
8505
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8506 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8507
8508
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8509 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8510 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8511
8512
8513 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8514 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8515 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8516 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8517 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8518 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8519
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8520 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8521
8522
8523 </td> <!-- entry_type -->
8524
8525 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8526 <p>An application-specified ID for the current
8527request.<wbr/> Must be maintained unchanged in output
8528frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8529 </td>
8530
8531 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8532 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8533 </td>
8534
8535 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8536 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8537 </td>
8538
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8539 <td class="entry_tags">
8540 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8541 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8542 </ul>
8543 </td>
8544
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8545 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8546
8547
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8548 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8549 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8550
8551
8552 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8553 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8554 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8555 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8556 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8557 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8558 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8559
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8560 <span class="entry_type_array">
8561 n
8562 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8563 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8564
8565
8566 </td> <!-- entry_type -->
8567
8568 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8569 <p>List which camera reprocess stream is used
8570for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8571 </td>
8572
8573 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8574 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8575 </td>
8576
8577 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8578 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
8579reprocess stream ID.<wbr/></p>
8580<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
8581reprocess streams may be included in a single request; they
8582must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8583 </td>
8584
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8585 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8586 <ul class="entry_tags">
8587 <li><a href="#tag_HAL2">HAL2</a></li>
8588 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8589 </td>
8590
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8591 </tr>
8592 <tr class="entries_header">
8593 <th class="th_details" colspan="5">Details</th>
8594 </tr>
8595 <tr class="entry_cont">
8596 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8597 <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]8598REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8599 </td>
8600 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8601
8602
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8603 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8604 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8605
8606
8607 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8608 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8609 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8610 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8611 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8612 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8613
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8614 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8615
8616 <ul class="entry_type_enum">
8617 <li>
8618 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8619 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
8620for application-bound buffer data.<wbr/> If no
8621application-bound streams exist,<wbr/> no frame should be
8622placed in the output frame queue.<wbr/> If such streams
8623exist,<wbr/> a frame should be placed on the output queue
8624with null metadata but with the necessary output buffer
8625information.<wbr/> Timestamp information should still be
8626included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8627 </li>
8628 <li>
8629 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8630 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
8631only be produced if they are separately
8632enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8633 </li>
8634 </ul>
8635
8636 </td> <!-- entry_type -->
8637
8638 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8639 <p>How much metadata to produce on
8640output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8641 </td>
8642
8643 <td class="entry_units">
8644 </td>
8645
8646 <td class="entry_range">
8647 </td>
8648
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8649 <td class="entry_tags">
8650 </td>
8651
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8652 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8653
8654
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8655 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8656 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8657
8658
8659 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8660 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8661 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8662 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8663 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8664 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8665 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8666
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8667 <span class="entry_type_array">
8668 n
8669 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8670 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8671
8672
8673 </td> <!-- entry_type -->
8674
8675 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8676 <p>Lists which camera output streams image data
8677from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8678 </td>
8679
8680 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8681 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8682 </td>
8683
8684 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8685 <p>List must only include streams that have been
8686created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8687 </td>
8688
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8689 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8690 <ul class="entry_tags">
8691 <li><a href="#tag_HAL2">HAL2</a></li>
8692 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8693 </td>
8694
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8695 </tr>
8696 <tr class="entries_header">
8697 <th class="th_details" colspan="5">Details</th>
8698 </tr>
8699 <tr class="entry_cont">
8700 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8701 <p>If no output streams are listed,<wbr/> then the image
8702data should simply be discarded.<wbr/> The image data must
8703still be captured for metadata and statistics production,<wbr/>
8704and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8705 </td>
8706 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8707
8708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8709 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8710 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8711
8712
8713 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8714 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8715 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8716 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8717 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8718 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8719
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8720 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8721
8722 <ul class="entry_type_enum">
8723 <li>
8724 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8725 <span class="entry_type_enum_notes"><p>Capture a new image from the imaging hardware,<wbr/>
8726and process it according to the
8727settings</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8728 </li>
8729 <li>
8730 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8731 <span class="entry_type_enum_notes"><p>Process previously captured data; the
8732android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
8733source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
8734needed for reprocessing with [RP]</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8735 </li>
8736 </ul>
8737
8738 </td> <!-- entry_type -->
8739
8740 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8741 <p>The type of the request; either CAPTURE or
8742REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8743 </td>
8744
8745 <td class="entry_units">
8746 </td>
8747
8748 <td class="entry_range">
8749 </td>
8750
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8751 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8752 <ul class="entry_tags">
8753 <li><a href="#tag_HAL2">HAL2</a></li>
8754 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8755 </td>
8756
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8757 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8758
8759
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8760 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8761 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8762
8763
8764
8765 <!-- end of kind -->
8766 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8767 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8768
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8769 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8770 <tr>
8771 <th class="th_name">Property Name</th>
8772 <th class="th_type">Type</th>
8773 <th class="th_description">Description</th>
8774 <th class="th_units">Units</th>
8775 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8776 <th class="th_tags">Tags</th>
8777 </tr>
8778 </thead>
8779
8780 <tbody>
8781
8782
8783
8784
8785
8786
8787
8788
8789
8790
8791 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8792 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8793 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8794 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8795 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8796 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8797 <span class="entry_type_container">x</span>
8798
8799 <span class="entry_type_array">
8800 3
8801 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8802 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8803
8804
8805 </td> <!-- entry_type -->
8806
8807 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8808 <p>How many output streams can be allocated at
8809the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8810 </td>
8811
8812 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8813 The number of raw sensor streams; the number of
8814 processed,<wbr/> uncompressed streams; and the number of
8815 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8816 </td>
8817
8818 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8819 <p>&gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8820for processed,<wbr/> uncompressed streams</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8821 </td>
8822
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8823 <td class="entry_tags">
8824 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8825 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8826 </ul>
8827 </td>
8828
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8829 </tr>
8830 <tr class="entries_header">
8831 <th class="th_details" colspan="5">Details</th>
8832 </tr>
8833 <tr class="entry_cont">
8834 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8835 <p>Video snapshot with preview callbacks requires 3
8836processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8837one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8838 </td>
8839 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8840
8841
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8842 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8843 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8844
8845
8846 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8847 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8848 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8849 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8850 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8851 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8852 <span class="entry_type_container">x</span>
8853
8854 <span class="entry_type_array">
8855 1
8856 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8857 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8858
8859
8860 </td> <!-- entry_type -->
8861
8862 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8863 <p>How many reprocessing streams of any type
8864can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8865 </td>
8866
8867 <td class="entry_units">
8868 </td>
8869
8870 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8871 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8872 </td>
8873
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8874 <td class="entry_tags">
8875 </td>
8876
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8877 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8878
8879
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8880 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8881 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8882
8883
8884
8885 <!-- end of kind -->
8886 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8887 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8888
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8889 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8890 <tr>
8891 <th class="th_name">Property Name</th>
8892 <th class="th_type">Type</th>
8893 <th class="th_description">Description</th>
8894 <th class="th_units">Units</th>
8895 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8896 <th class="th_tags">Tags</th>
8897 </tr>
8898 </thead>
8899
8900 <tbody>
8901
8902
8903
8904
8905
8906
8907
8908
8909
8910
8911 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8912 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8913 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8914 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8915 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8916 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8917
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8918 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8919
8920
8921 </td> <!-- entry_type -->
8922
8923 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8924 <p>A frame counter set by the framework.<wbr/> This value monotonically
8925increases with every new result (that is,<wbr/> each new result has a unique
8926frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8927 </td>
8928
8929 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8930 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8931 </td>
8932
8933 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8934 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8935 </td>
8936
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8937 <td class="entry_tags">
8938 </td>
8939
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8940 </tr>
8941 <tr class="entries_header">
8942 <th class="th_details" colspan="5">Details</th>
8943 </tr>
8944 <tr class="entry_cont">
8945 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8946 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8947 </td>
8948 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8949
8950
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8951 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8952 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8953
8954
8955 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8956 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8957 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8958 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8959 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8960 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8961
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8962 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8963
8964
8965 </td> <!-- entry_type -->
8966
8967 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8968 <p>An application-specified ID for the current
8969request.<wbr/> Must be maintained unchanged in output
8970frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8971 </td>
8972
8973 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8974 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8975 </td>
8976
8977 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8978 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8979 </td>
8980
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8981 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8982 <ul class="entry_tags">
8983 <li><a href="#tag_V1">V1</a></li>
8984 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8985 </td>
8986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8987 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8988
8989
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8990 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8991 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8992
8993
8994 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8995 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8996 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8997 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8998 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8999 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9000
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9001 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9002
9003 <ul class="entry_type_enum">
9004 <li>
9005 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9006 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
9007for application-bound buffer data.<wbr/> If no
9008application-bound streams exist,<wbr/> no frame should be
9009placed in the output frame queue.<wbr/> If such streams
9010exist,<wbr/> a frame should be placed on the output queue
9011with null metadata but with the necessary output buffer
9012information.<wbr/> Timestamp information should still be
9013included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9014 </li>
9015 <li>
9016 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9017 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
9018only be produced if they are separately
9019enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9020 </li>
9021 </ul>
9022
9023 </td> <!-- entry_type -->
9024
9025 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9026 <p>How much metadata to produce on
9027output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9028 </td>
9029
9030 <td class="entry_units">
9031 </td>
9032
9033 <td class="entry_range">
9034 </td>
9035
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9036 <td class="entry_tags">
9037 </td>
9038
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9039 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9040
9041
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9042 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9043 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9044
9045
9046 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9047 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9048 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9049 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9050 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]9051 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9052 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9053
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9054 <span class="entry_type_array">
9055 n
9056 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9057 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9058
9059
9060 </td> <!-- entry_type -->
9061
9062 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9063 <p>Lists which camera output streams image data
9064from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9065 </td>
9066
9067 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9068 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9069 </td>
9070
9071 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9072 <p>List must only include streams that have been
9073created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9074 </td>
9075
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9076 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9077 <ul class="entry_tags">
9078 <li><a href="#tag_HAL2">HAL2</a></li>
9079 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9080 </td>
9081
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9082 </tr>
9083 <tr class="entries_header">
9084 <th class="th_details" colspan="5">Details</th>
9085 </tr>
9086 <tr class="entry_cont">
9087 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9088 <p>If no output streams are listed,<wbr/> then the image
9089data should simply be discarded.<wbr/> The image data must
9090still be captured for metadata and statistics production,<wbr/>
9091and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9092 </td>
9093 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9094
9095
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9096 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9097 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9098
9099
9100
9101 <!-- end of kind -->
9102 </tbody>
9103
9104 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9105 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9106
9107
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9108 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9109
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9110 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9111 <tr>
9112 <th class="th_name">Property Name</th>
9113 <th class="th_type">Type</th>
9114 <th class="th_description">Description</th>
9115 <th class="th_units">Units</th>
9116 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9117 <th class="th_tags">Tags</th>
9118 </tr>
9119 </thead>
9120
9121 <tbody>
9122
9123
9124
9125
9126
9127
9128
9129
9130
9131
9132 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9133 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9134 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9135 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9136 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9137 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9138 <span class="entry_type_container">x</span>
9139
9140 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9141 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9142 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9143 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9144
9145
9146 </td> <!-- entry_type -->
9147
9148 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9149 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9150<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9151(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9152output.<wbr/> Each stream must use this rectangle to produce its
9153output,<wbr/> cropping to a smaller region if necessary to
9154maintain the stream's aspect ratio.<wbr/></p>
9155<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9156 </td>
9157
9158 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9159 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9160 in pixels; (0,<wbr/>0) is top-left corner of
9161 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9162 </td>
9163
9164 <td class="entry_range">
9165 </td>
9166
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9167 <td class="entry_tags">
9168 <ul class="entry_tags">
9169 <li><a href="#tag_BC">BC</a></li>
9170 </ul>
9171 </td>
9172
9173 </tr>
9174 <tr class="entries_header">
9175 <th class="th_details" colspan="5">Details</th>
9176 </tr>
9177 <tr class="entry_cont">
9178 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9179 <p>Any additional per-stream cropping must be done to
9180maximize the final pixel area of the stream.<wbr/></p>
9181<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9182ratio,<wbr/> then 4:3 streams should use the exact crop
9183region.<wbr/> 16:9 streams should further crop vertically
9184(letterbox).<wbr/></p>
9185<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9186outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9187streams should match exactly.<wbr/> These additional crops must
9188be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9189<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9190times,<wbr/> no matter what the relative aspect ratios of the
9191crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9192corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9193larger than active pixel array.<wbr/> Width and height may be
9194rounded to nearest larger supportable width,<wbr/> especially
9195for raw output,<wbr/> where only a few fixed scales may be
9196possible.<wbr/> The width and height of the crop region cannot
9197be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9198android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9199activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9200respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9201 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9202 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9203
9204
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9205 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9206 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9207
9208
9209
9210 <!-- end of kind -->
9211 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9212 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9213
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9214 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9215 <tr>
9216 <th class="th_name">Property Name</th>
9217 <th class="th_type">Type</th>
9218 <th class="th_description">Description</th>
9219 <th class="th_units">Units</th>
9220 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9221 <th class="th_tags">Tags</th>
9222 </tr>
9223 </thead>
9224
9225 <tbody>
9226
9227
9228
9229
9230
9231
9232
9233
9234
9235
9236 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9237 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9238 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9239 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9240 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9241 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9242 <span class="entry_type_container">x</span>
9243
9244 <span class="entry_type_array">
9245 n
9246 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]9247 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9248 <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]9249
9250 <ul class="entry_type_enum">
9251 <li>
9252 <span class="entry_type_enum_name">RAW_SENSOR</span>
9253 <span class="entry_type_enum_value">0x20</span>
9254 </li>
9255 <li>
9256 <span class="entry_type_enum_name">YV12</span>
9257 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9258 <span class="entry_type_enum_notes"><p>YCrCb 4:2:0 Planar</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9259 </li>
9260 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9261 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9262 <span class="entry_type_enum_value">0x11</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9263 <span class="entry_type_enum_notes"><p>NV21</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9264 </li>
9265 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9266 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
9267 <span class="entry_type_enum_value">0x22</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9268 <span class="entry_type_enum_notes"><p>Hal Implementation Defined</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9269 </li>
9270 <li>
9271 <span class="entry_type_enum_name">YCbCr_420_888</span>
9272 <span class="entry_type_enum_value">0x23</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9273 <span class="entry_type_enum_notes"><p>Flexible YUV420 Format</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9274 </li>
9275 <li>
9276 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9277 <span class="entry_type_enum_value">0x21</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9278 <span class="entry_type_enum_notes"><p>JPEG</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9279 </li>
9280 </ul>
9281
9282 </td> <!-- entry_type -->
9283
9284 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9285 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9286 </td>
9287
9288 <td class="entry_units">
9289 </td>
9290
9291 <td class="entry_range">
9292 </td>
9293
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9294 <td class="entry_tags">
9295 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9296 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9297 </ul>
9298 </td>
9299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9300 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9301
9302
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9303 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9304 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9305
9306
9307 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9308 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9309 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9310 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9311 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9312 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9313 <span class="entry_type_container">x</span>
9314
9315 <span class="entry_type_array">
9316 n
9317 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9318 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9319
9320
9321 </td> <!-- entry_type -->
9322
9323 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9324 <p>The minimum frame duration that is supported
9325for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9326correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9327stream is active and captured in a burst,<wbr/> with all
9328processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9329 </td>
9330
9331 <td class="entry_units">
9332 </td>
9333
9334 <td class="entry_range">
9335 </td>
9336
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9337 <td class="entry_tags">
9338 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9339 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9340 </ul>
9341 </td>
9342
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9343 </tr>
9344 <tr class="entries_header">
9345 <th class="th_details" colspan="5">Details</th>
9346 </tr>
9347 <tr class="entry_cont">
9348 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9349 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9350frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9351durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9352 </td>
9353 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9354
9355
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9356 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9357 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9358
9359
9360 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9361 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9362 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9363 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9364 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9365 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9366 <span class="entry_type_container">x</span>
9367
9368 <span class="entry_type_array">
9369 n x 2
9370 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9371 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9372
9373
9374 </td> <!-- entry_type -->
9375
9376 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9377 <p>The resolutions available for output from
9378the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9379 </td>
9380
9381 <td class="entry_units">
9382 </td>
9383
9384 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9385 <p>Must include: - sensor maximum resolution Should
9386include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9387 </td>
9388
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9389 <td class="entry_tags">
9390 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9391 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9392 </ul>
9393 </td>
9394
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9395 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9396
9397
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9398 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9399 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9400
9401
9402 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9403 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9404 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9405 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9406 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]9407 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9408
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9409 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9410
9411
9412 </td> <!-- entry_type -->
9413
9414 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9415 <p>The maximum ratio between active area width
9416and crop region width,<wbr/> or between active area height and
9417crop region height,<wbr/> if the crop region height is larger
9418than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9419 </td>
9420
9421 <td class="entry_units">
9422 </td>
9423
9424 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9425 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9426 </td>
9427
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9428 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]9429 <ul class="entry_tags">
9430 <li><a href="#tag_BC">BC</a></li>
9431 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9432 </td>
9433
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9434 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9435
9436
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9437 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9438 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9439
9440
9441 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9442 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9443 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9444 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9445 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9446 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9447 <span class="entry_type_container">x</span>
9448
9449 <span class="entry_type_array">
9450 n
9451 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9452 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9453
9454
9455 </td> <!-- entry_type -->
9456
9457 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9458 <p>The minimum frame duration that is supported
9459for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9460correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9461stream is active,<wbr/> with all processing set to
9462FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9463 </td>
9464
9465 <td class="entry_units">
9466 </td>
9467
9468 <td class="entry_range">
9469 </td>
9470
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9471 <td class="entry_tags">
9472 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9473 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9474 </ul>
9475 </td>
9476
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9477 </tr>
9478 <tr class="entries_header">
9479 <th class="th_details" colspan="5">Details</th>
9480 </tr>
9481 <tr class="entry_cont">
9482 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9483 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9484frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9485durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9486 </td>
9487 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9488
9489
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9490 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9491 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9492
9493
9494 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9495 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9496 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9497 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9498 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9499 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9500 <span class="entry_type_container">x</span>
9501
9502 <span class="entry_type_array">
9503 n x 2
9504 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9505 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9506
9507
9508 </td> <!-- entry_type -->
9509
9510 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9511 <p>The resolutions available for use with
9512processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
9513platform opaque YUV/<wbr/>RGB streams to the GPU or video
9514encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9515 </td>
9516
9517 <td class="entry_units">
9518 </td>
9519
9520 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9521 <p>Must include: - sensor maximum resolution -
9522standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
9523resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9524 </td>
9525
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9526 <td class="entry_tags">
9527 <ul class="entry_tags">
9528 <li><a href="#tag_BC">BC</a></li>
9529 </ul>
9530 </td>
9531
9532 </tr>
9533 <tr class="entries_header">
9534 <th class="th_details" colspan="5">Details</th>
9535 </tr>
9536 <tr class="entry_cont">
9537 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9538 <p>The actual supported resolution list may be limited by
9539consumer end points for different use cases.<wbr/> For example,<wbr/> for
9540recording use case,<wbr/> the largest supported resolution may be
9541limited by max supported size from encoder,<wbr/> for preview use
9542case,<wbr/> the largest supported resolution may be limited by max
9543resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9544 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9545 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9546
9547
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9548 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9549 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9550
9551
9552 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9553 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9554 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9555 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9556 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9557 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9558 <span class="entry_type_container">x</span>
9559
9560 <span class="entry_type_array">
9561 n
9562 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9563 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9564
9565
9566 </td> <!-- entry_type -->
9567
9568 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9569 <p>The minimum frame duration that is supported
9570for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9571correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9572is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9573 </td>
9574
9575 <td class="entry_units">
9576 </td>
9577
9578 <td class="entry_range">
9579 </td>
9580
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9581 <td class="entry_tags">
9582 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9583 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9584 </ul>
9585 </td>
9586
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9587 </tr>
9588 <tr class="entries_header">
9589 <th class="th_details" colspan="5">Details</th>
9590 </tr>
9591 <tr class="entry_cont">
9592 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9593 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9594frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9595durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9596 </td>
9597 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9598
9599
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9600 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9601 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9602
9603
9604 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9605 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9606 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9607 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9608 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9609 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9610 <span class="entry_type_container">x</span>
9611
9612 <span class="entry_type_array">
9613 n x 2
9614 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9615 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9616
9617
9618 </td> <!-- entry_type -->
9619
9620 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9621 <p>The resolutions available for use with raw
9622sensor output streams,<wbr/> listed as width,<wbr/>
9623height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9624 </td>
9625
9626 <td class="entry_units">
9627 </td>
9628
9629 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9630 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9631 </td>
9632
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9633 <td class="entry_tags">
9634 </td>
9635
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9636 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9637
9638
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9639 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9640 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9641
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9642
9643
9644 <!-- end of kind -->
9645 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9646 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9647
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9648 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9649 <tr>
9650 <th class="th_name">Property Name</th>
9651 <th class="th_type">Type</th>
9652 <th class="th_description">Description</th>
9653 <th class="th_units">Units</th>
9654 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9655 <th class="th_tags">Tags</th>
9656 </tr>
9657 </thead>
9658
9659 <tbody>
9660
9661
9662
9663
9664
9665
9666
9667
9668
9669
9670 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9671 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9672 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9673 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9674 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9675 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9676 <span class="entry_type_container">x</span>
9677
9678 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9679 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9680 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9681 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9682
9683
9684 </td> <!-- entry_type -->
9685
9686 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9687 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9688<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9689(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9690output.<wbr/> Each stream must use this rectangle to produce its
9691output,<wbr/> cropping to a smaller region if necessary to
9692maintain the stream's aspect ratio.<wbr/></p>
9693<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9694 </td>
9695
9696 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9697 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9698 in pixels; (0,<wbr/>0) is top-left corner of
9699 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9700 </td>
9701
9702 <td class="entry_range">
9703 </td>
9704
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9705 <td class="entry_tags">
9706 <ul class="entry_tags">
9707 <li><a href="#tag_BC">BC</a></li>
9708 </ul>
9709 </td>
9710
9711 </tr>
9712 <tr class="entries_header">
9713 <th class="th_details" colspan="5">Details</th>
9714 </tr>
9715 <tr class="entry_cont">
9716 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9717 <p>Any additional per-stream cropping must be done to
9718maximize the final pixel area of the stream.<wbr/></p>
9719<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9720ratio,<wbr/> then 4:3 streams should use the exact crop
9721region.<wbr/> 16:9 streams should further crop vertically
9722(letterbox).<wbr/></p>
9723<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9724outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9725streams should match exactly.<wbr/> These additional crops must
9726be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9727<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9728times,<wbr/> no matter what the relative aspect ratios of the
9729crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9730corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9731larger than active pixel array.<wbr/> Width and height may be
9732rounded to nearest larger supportable width,<wbr/> especially
9733for raw output,<wbr/> where only a few fixed scales may be
9734possible.<wbr/> The width and height of the crop region cannot
9735be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9736android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9737activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9738respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9739 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9740 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9741
9742
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9743 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9744 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9745
9746
9747
9748 <!-- end of kind -->
9749 </tbody>
9750
9751 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9752 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9753
9754
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9755 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9756
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9757 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9758 <tr>
9759 <th class="th_name">Property Name</th>
9760 <th class="th_type">Type</th>
9761 <th class="th_description">Description</th>
9762 <th class="th_units">Units</th>
9763 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9764 <th class="th_tags">Tags</th>
9765 </tr>
9766 </thead>
9767
9768 <tbody>
9769
9770
9771
9772
9773
9774
9775
9776
9777
9778
9779 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9780 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9781 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9782 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9783 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9784 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9785
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9786 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9787
9788
9789 </td> <!-- entry_type -->
9790
9791 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9792 <p>Duration each pixel is exposed to
9793light.<wbr/></p>
9794<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
9795duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9796 </td>
9797
9798 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9799 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9800 </td>
9801
9802 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9803 <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]9804 </td>
9805
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9806 <td class="entry_tags">
9807 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9808 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9809 </ul>
9810 </td>
9811
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9812 </tr>
9813 <tr class="entries_header">
9814 <th class="th_details" colspan="5">Details</th>
9815 </tr>
9816 <tr class="entry_cont">
9817 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9818 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9819 </td>
9820 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9821
9822
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9823 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9824 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9825
9826
9827 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9828 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9829 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9830 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9831 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9832 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9833
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9834 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9835
9836
9837 </td> <!-- entry_type -->
9838
9839 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9840 <p>Duration from start of frame exposure to
9841start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9842 </td>
9843
9844 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9845 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9846 </td>
9847
9848 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9849 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9850android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9851 </td>
9852
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9853 <td class="entry_tags">
9854 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9855 <li><a href="#tag_V1">V1</a></li>
9856 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9857 </ul>
9858 </td>
9859
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9860 </tr>
9861 <tr class="entries_header">
9862 <th class="th_details" colspan="5">Details</th>
9863 </tr>
9864 <tr class="entry_cont">
9865 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9866 <p>Exposure time has priority,<wbr/> so duration is set to
9867max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9868 </td>
9869 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9870
9871
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9872 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9873 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9874
9875
9876 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9877 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9878 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9879 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9880 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9881 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9882
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9883 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9884
9885
9886 </td> <!-- entry_type -->
9887
9888 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9889 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9890implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9891below 'maximum analog sensitivity'.<wbr/></p>
9892<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9893gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9894 </td>
9895
9896 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9897 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9898 </td>
9899
9900 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9901 <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]9902 </td>
9903
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9904 <td class="entry_tags">
9905 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9906 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9907 </ul>
9908 </td>
9909
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9910 </tr>
9911 <tr class="entries_header">
9912 <th class="th_details" colspan="5">Details</th>
9913 </tr>
9914 <tr class="entry_cont">
9915 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9916 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9917 </td>
9918 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9919
9920
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9921 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9922 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9923
9924
9925
9926 <!-- end of kind -->
9927 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9928 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9929
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9930 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9931 <tr>
9932 <th class="th_name">Property Name</th>
9933 <th class="th_type">Type</th>
9934 <th class="th_description">Description</th>
9935 <th class="th_units">Units</th>
9936 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9937 <th class="th_tags">Tags</th>
9938 </tr>
9939 </thead>
9940
9941 <tbody>
9942
9943
9944
9945
9946
9947
9948
9949
9950
9951
9952
9953
9954 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9955 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9956 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9957 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9958 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9959 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9960 <span class="entry_type_container">x</span>
9961
9962 <span class="entry_type_array">
9963 4
9964 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9965 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9966 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9967
9968
9969 </td> <!-- entry_type -->
9970
9971 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9972 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9973active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9974pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9975 </td>
9976
9977 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9978 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9979 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9980 </td>
9981
9982 <td class="entry_range">
9983 </td>
9984
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9985 <td class="entry_tags">
9986 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9987 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9988 </ul>
9989 </td>
9990
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9991 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9992
9993
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9994 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9995 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9996
9997
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9998 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9999 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10000 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10001 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10002 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10003 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10004 <span class="entry_type_container">x</span>
10005
10006 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10007 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10008 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10009 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10010 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10011
10012
10013 </td> <!-- entry_type -->
10014
10015 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10016 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10017 </td>
10018
10019 <td class="entry_units">
10020 </td>
10021
10022 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10023 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10024 </td>
10025
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10026 <td class="entry_tags">
10027 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10028 <li><a href="#tag_BC">BC</a></li>
10029 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10030 </ul>
10031 </td>
10032
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10033 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10034
10035
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10036 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10037 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10038
10039
10040 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10041 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10042 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10043 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10044 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10045 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10046
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10047 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10048
10049 <ul class="entry_type_enum">
10050 <li>
10051 <span class="entry_type_enum_name">RGGB</span>
10052 </li>
10053 <li>
10054 <span class="entry_type_enum_name">GRBG</span>
10055 </li>
10056 <li>
10057 <span class="entry_type_enum_name">GBRG</span>
10058 </li>
10059 <li>
10060 <span class="entry_type_enum_name">BGGR</span>
10061 </li>
10062 <li>
10063 <span class="entry_type_enum_name">RGB</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10064 <span class="entry_type_enum_notes"><p>Sensor is not Bayer; output has 3 16-bit
10065values for each pixel,<wbr/> instead of just 1 16-bit value
10066per pixel.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10067 </li>
10068 </ul>
10069
10070 </td> <!-- entry_type -->
10071
10072 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10073 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10074represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10075the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10076 </td>
10077
10078 <td class="entry_units">
10079 </td>
10080
10081 <td class="entry_range">
10082 </td>
10083
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10084 <td class="entry_tags">
10085 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10086 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10087 </ul>
10088 </td>
10089
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10090 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10091
10092
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10093 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10094 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10095
10096
10097 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10098 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10099 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10100 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10101 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10102 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10103 <span class="entry_type_container">x</span>
10104
10105 <span class="entry_type_array">
10106 2
10107 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10108 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10109 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10110
10111
10112 </td> <!-- entry_type -->
10113
10114 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10115 <p>Range of valid exposure
10116times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10117 </td>
10118
10119 <td class="entry_units">
10120 </td>
10121
10122 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10123 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
10124sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10125 </td>
10126
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10127 <td class="entry_tags">
10128 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10129 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10130 </ul>
10131 </td>
10132
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10133 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10134
10135
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10136 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10137 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10138
10139
10140 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10141 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10142 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10143 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10144 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10145 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10146
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10147 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10148
10149
10150 </td> <!-- entry_type -->
10151
10152 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10153 <p>Maximum possible frame duration (minimum frame
10154rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10155 </td>
10156
10157 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10158 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10159 </td>
10160
10161 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10162 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10163 </td>
10164
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10165 <td class="entry_tags">
10166 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10167 <li><a href="#tag_BC">BC</a></li>
10168 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10169 </ul>
10170 </td>
10171
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10172 </tr>
10173 <tr class="entries_header">
10174 <th class="th_details" colspan="5">Details</th>
10175 </tr>
10176 <tr class="entry_cont">
10177 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10178 <p>Minimum duration is a function of resolution,<wbr/>
10179processing settings.<wbr/> See
10180android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
10181android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10182<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]10183 </td>
10184 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10185
10186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10187 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10188 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10189
10190
10191 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10192 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10193 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10194 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10195 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10196 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10197 <span class="entry_type_container">x</span>
10198
10199 <span class="entry_type_array">
10200 2
10201 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]10202 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10203 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10204
10205
10206 </td> <!-- entry_type -->
10207
10208 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10209 <p>The physical dimensions of the full pixel
10210array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10211 </td>
10212
10213 <td class="entry_units">
10214 </td>
10215
10216 <td class="entry_range">
10217 </td>
10218
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10219 <td class="entry_tags">
10220 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10221 <li><a href="#tag_V1">V1</a></li>
10222 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10223 </ul>
10224 </td>
10225
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10226 </tr>
10227 <tr class="entries_header">
10228 <th class="th_details" colspan="5">Details</th>
10229 </tr>
10230 <tr class="entry_cont">
10231 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10232 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10233 </td>
10234 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10235
10236
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10237 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10238 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10239
10240
10241 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10242 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10243 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10244 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10245 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10246 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10247 <span class="entry_type_container">x</span>
10248
10249 <span class="entry_type_array">
10250 2
10251 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10252 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10253
10254
10255 </td> <!-- entry_type -->
10256
10257 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10258 <p>Dimensions of full pixel array,<wbr/> possibly
10259including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10260 </td>
10261
10262 <td class="entry_units">
10263 </td>
10264
10265 <td class="entry_range">
10266 </td>
10267
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10268 <td class="entry_tags">
10269 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10270 <li><a href="#tag_DNG">DNG</a></li>
10271 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10272 </ul>
10273 </td>
10274
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10275 </tr>
10276 <tr class="entries_header">
10277 <th class="th_details" colspan="5">Details</th>
10278 </tr>
10279 <tr class="entry_cont">
10280 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10281 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10282match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10283android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10284 </td>
10285 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10286
10287
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10288 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10289 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10290
10291
10292 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10293 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10294 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10295 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10296 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10297 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10298
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10299 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10300
10301
10302 </td> <!-- entry_type -->
10303
10304 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10305 <p>Maximum raw value output by
10306sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10307 </td>
10308
10309 <td class="entry_units">
10310 </td>
10311
10312 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10313 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10314 </td>
10315
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10316 <td class="entry_tags">
10317 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10318 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10319 </ul>
10320 </td>
10321
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10322 </tr>
10323 <tr class="entries_header">
10324 <th class="th_details" colspan="5">Details</th>
10325 </tr>
10326 <tr class="entry_cont">
10327 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10328 <p>Defines sensor bit depth (10-14 bits is
10329expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10330 </td>
10331 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10332
10333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10334 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10335 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10336
10337
10338
10339
10340
10341 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10342 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10343 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10344 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10345 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10346 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10347
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10348 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10349
10350
10351 </td> <!-- entry_type -->
10352
10353 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10354 <p>Gain factor from electrons to raw units when
10355ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10356 </td>
10357
10358 <td class="entry_units">
10359 </td>
10360
10361 <td class="entry_range">
10362 </td>
10363
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10364 <td class="entry_tags">
10365 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10366 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10367 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10368 </ul>
10369 </td>
10370
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10371 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10372
10373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10374 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10375 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10376
10377
10378 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10379 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10380 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10381 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10382 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10383 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10384 <span class="entry_type_container">x</span>
10385
10386 <span class="entry_type_array">
10387 4
10388 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10389 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10390 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10391
10392
10393 </td> <!-- entry_type -->
10394
10395 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10396 <p>A fixed black level offset for each of the
10397Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10398 </td>
10399
10400 <td class="entry_units">
10401 </td>
10402
10403 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10404 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10405 </td>
10406
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10407 <td class="entry_tags">
10408 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10409 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10410 </ul>
10411 </td>
10412
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10413 </tr>
10414 <tr class="entries_header">
10415 <th class="th_details" colspan="5">Details</th>
10416 </tr>
10417 <tr class="entry_cont">
10418 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10419 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
10420tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10421 </td>
10422 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10423
10424
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10425 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10426 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10427
10428
10429 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10430 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10431 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10432 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10433 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10434 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10435 <span class="entry_type_container">x</span>
10436
10437 <span class="entry_type_array">
10438 9
10439 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10440 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10441 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10442
10443
10444 </td> <!-- entry_type -->
10445
10446 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10447 <p>Per-device calibration on top of color space
10448transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10449 </td>
10450
10451 <td class="entry_units">
10452 </td>
10453
10454 <td class="entry_range">
10455 </td>
10456
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10457 <td class="entry_tags">
10458 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10459 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10460 </ul>
10461 </td>
10462
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10463 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10464
10465
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10466 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10467 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10468
10469
10470 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10471 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10472 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10473 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10474 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10475 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10476 <span class="entry_type_container">x</span>
10477
10478 <span class="entry_type_array">
10479 9
10480 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10481 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10482 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10483
10484
10485 </td> <!-- entry_type -->
10486
10487 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10488 <p>Per-device calibration on top of color space
10489transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10490 </td>
10491
10492 <td class="entry_units">
10493 </td>
10494
10495 <td class="entry_range">
10496 </td>
10497
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10498 <td class="entry_tags">
10499 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10500 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10501 </ul>
10502 </td>
10503
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10504 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10505
10506
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10507 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10508 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10509
10510
10511 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10512 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10513 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10514 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10515 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10516 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10517 <span class="entry_type_container">x</span>
10518
10519 <span class="entry_type_array">
10520 9
10521 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10522 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10523 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10524
10525
10526 </td> <!-- entry_type -->
10527
10528 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10529 <p>Linear mapping from XYZ (D50) color space to
10530reference linear sensor color,<wbr/> for first reference
10531illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10532 </td>
10533
10534 <td class="entry_units">
10535 </td>
10536
10537 <td class="entry_range">
10538 </td>
10539
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10540 <td class="entry_tags">
10541 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10542 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10543 </ul>
10544 </td>
10545
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10546 </tr>
10547 <tr class="entries_header">
10548 <th class="th_details" colspan="5">Details</th>
10549 </tr>
10550 <tr class="entry_cont">
10551 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10552 <p>Use as follows XYZ = inv(transform) * clip( (raw -
10553black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
10554At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10555 </td>
10556 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10557
10558
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10559 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10560 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10561
10562
10563 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10564 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10565 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10566 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10567 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10568 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10569 <span class="entry_type_container">x</span>
10570
10571 <span class="entry_type_array">
10572 9
10573 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10574 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10575 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10576
10577
10578 </td> <!-- entry_type -->
10579
10580 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10581 <p>Linear mapping from XYZ (D50) color space to
10582reference linear sensor color,<wbr/> for second reference
10583illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10584 </td>
10585
10586 <td class="entry_units">
10587 </td>
10588
10589 <td class="entry_range">
10590 </td>
10591
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10592 <td class="entry_tags">
10593 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10594 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10595 </ul>
10596 </td>
10597
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10598 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10599
10600
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10601 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10602 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10603
10604
10605 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10606 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10607 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10608 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10609 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10610 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10611 <span class="entry_type_container">x</span>
10612
10613 <span class="entry_type_array">
10614 9
10615 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10616 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10617 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10618
10619
10620 </td> <!-- entry_type -->
10621
10622 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10623 <p>Used by DNG for better WB
10624adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10625 </td>
10626
10627 <td class="entry_units">
10628 </td>
10629
10630 <td class="entry_range">
10631 </td>
10632
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10633 <td class="entry_tags">
10634 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10635 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10636 </ul>
10637 </td>
10638
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10639 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10640
10641
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10642 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10643 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10644
10645
10646 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10647 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10648 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10649 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10650 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10651 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10652 <span class="entry_type_container">x</span>
10653
10654 <span class="entry_type_array">
10655 9
10656 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10657 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10658 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10659
10660
10661 </td> <!-- entry_type -->
10662
10663 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10664 <p>Used by DNG for better WB
10665adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10666 </td>
10667
10668 <td class="entry_units">
10669 </td>
10670
10671 <td class="entry_range">
10672 </td>
10673
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10674 <td class="entry_tags">
10675 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10676 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10677 </ul>
10678 </td>
10679
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10680 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10681
10682
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10683 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10684 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10685
10686
10687 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10688 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10689 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10690 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10691 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10692 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10693
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10694 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10695
10696
10697 </td> <!-- entry_type -->
10698
10699 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10700 <p>Maximum sensitivity that is implemented
10701purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10702 </td>
10703
10704 <td class="entry_units">
10705 </td>
10706
10707 <td class="entry_range">
10708 </td>
10709
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10710 <td class="entry_tags">
10711 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10712 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10713 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10714 </ul>
10715 </td>
10716
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10717 </tr>
10718 <tr class="entries_header">
10719 <th class="th_details" colspan="5">Details</th>
10720 </tr>
10721 <tr class="entry_cont">
10722 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10723 <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]10724equal to this,<wbr/> all applied gain must be analog.<wbr/> For
10725values above this,<wbr/> it can be a mix of analog and
10726digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10727 </td>
10728 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10729
10730
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10731 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10732 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10733
10734
10735 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10736 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10737 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10738 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10739 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10740 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10741 <span class="entry_type_container">x</span>
10742
10743 <span class="entry_type_array">
10744 2
10745 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10746 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10747 <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]10748
10749
10750 </td> <!-- entry_type -->
10751
10752 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10753 <p>Estimation of sensor noise
10754characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10755 </td>
10756
10757 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10758 var(raw pixel value) = electrons * (baseGainFactor
10759 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
10760 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10761 </td>
10762
10763 <td class="entry_range">
10764 </td>
10765
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10766 <td class="entry_tags">
10767 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10768 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10769 </ul>
10770 </td>
10771
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10772 </tr>
10773 <tr class="entries_header">
10774 <th class="th_details" colspan="5">Details</th>
10775 </tr>
10776 <tr class="entry_cont">
10777 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10778 <p>A represents sensor read noise before analog
10779amplification; B represents noise from A/<wbr/>D conversion and
10780other circuits after amplification.<wbr/> Both noise sources
10781are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
10782across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10783 </td>
10784 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10785
10786
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10787 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10788 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10789
10790
10791 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10792 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10793 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10794 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10795 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10796 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10797
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10798 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10799
10800
10801 </td> <!-- entry_type -->
10802
10803 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10804 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10805image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10806screen in its native orientation.<wbr/> Also defines the
10807direction of rolling shutter readout,<wbr/> which is from top
10808to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10809 </td>
10810
10811 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10812 degrees clockwise rotation,<wbr/> only multiples of
10813 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10814 </td>
10815
10816 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10817 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10818 </td>
10819
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10820 <td class="entry_tags">
10821 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10822 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10823 </ul>
10824 </td>
10825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10826 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10827
10828
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10829 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10830 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10831
10832
10833 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10834 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10835 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10836 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10837 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10838 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10839
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10840 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10841
10842 <ul class="entry_type_enum">
10843 <li>
10844 <span class="entry_type_enum_name">DAYLIGHT</span>
10845 <span class="entry_type_enum_value">1</span>
10846 </li>
10847 <li>
10848 <span class="entry_type_enum_name">FLUORESCENT</span>
10849 <span class="entry_type_enum_value">2</span>
10850 </li>
10851 <li>
10852 <span class="entry_type_enum_name">TUNGSTEN</span>
10853 <span class="entry_type_enum_value">3</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10854 <span class="entry_type_enum_notes"><p>Incandescent light</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10855 </li>
10856 <li>
10857 <span class="entry_type_enum_name">FLASH</span>
10858 <span class="entry_type_enum_value">4</span>
10859 </li>
10860 <li>
10861 <span class="entry_type_enum_name">FINE_WEATHER</span>
10862 <span class="entry_type_enum_value">9</span>
10863 </li>
10864 <li>
10865 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10866 <span class="entry_type_enum_value">10</span>
10867 </li>
10868 <li>
10869 <span class="entry_type_enum_name">SHADE</span>
10870 <span class="entry_type_enum_value">11</span>
10871 </li>
10872 <li>
10873 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10874 <span class="entry_type_enum_value">12</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10875 <span class="entry_type_enum_notes"><p>D 5700 - 7100K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10876 </li>
10877 <li>
10878 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10879 <span class="entry_type_enum_value">13</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10880 <span class="entry_type_enum_notes"><p>N 4600 - 5400K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10881 </li>
10882 <li>
10883 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10884 <span class="entry_type_enum_value">14</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10885 <span class="entry_type_enum_notes"><p>W 3900 - 4500K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10886 </li>
10887 <li>
10888 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10889 <span class="entry_type_enum_value">15</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10890 <span class="entry_type_enum_notes"><p>WW 3200 - 3700K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10891 </li>
10892 <li>
10893 <span class="entry_type_enum_name">STANDARD_A</span>
10894 <span class="entry_type_enum_value">17</span>
10895 </li>
10896 <li>
10897 <span class="entry_type_enum_name">STANDARD_B</span>
10898 <span class="entry_type_enum_value">18</span>
10899 </li>
10900 <li>
10901 <span class="entry_type_enum_name">STANDARD_C</span>
10902 <span class="entry_type_enum_value">19</span>
10903 </li>
10904 <li>
10905 <span class="entry_type_enum_name">D55</span>
10906 <span class="entry_type_enum_value">20</span>
10907 </li>
10908 <li>
10909 <span class="entry_type_enum_name">D65</span>
10910 <span class="entry_type_enum_value">21</span>
10911 </li>
10912 <li>
10913 <span class="entry_type_enum_name">D75</span>
10914 <span class="entry_type_enum_value">22</span>
10915 </li>
10916 <li>
10917 <span class="entry_type_enum_name">D50</span>
10918 <span class="entry_type_enum_value">23</span>
10919 </li>
10920 <li>
10921 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10922 <span class="entry_type_enum_value">24</span>
10923 </li>
10924 </ul>
10925
10926 </td> <!-- entry_type -->
10927
10928 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10929 <p>Light source used to define transform
109301</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10931 </td>
10932
10933 <td class="entry_units">
10934 </td>
10935
10936 <td class="entry_range">
10937 </td>
10938
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10939 <td class="entry_tags">
10940 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10941 <li><a href="#tag_DNG">DNG</a></li>
10942 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10943 </ul>
10944 </td>
10945
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10946 </tr>
10947 <tr class="entries_header">
10948 <th class="th_details" colspan="5">Details</th>
10949 </tr>
10950 <tr class="entry_cont">
10951 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10952 <p>[EXIF LightSource tag] Must all these be
10953supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10954 </td>
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 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10963 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10964 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10965 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10966 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10967 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10968
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10969 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10970
10971
10972 </td> <!-- entry_type -->
10973
10974 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10975 <p>Light source used to define transform
109762</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10977 </td>
10978
10979 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10980 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10981 </td>
10982
10983 <td class="entry_range">
10984 </td>
10985
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10986 <td class="entry_tags">
10987 </td>
10988
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10989 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10990
10991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10992 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10993 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10994
10995
10996
10997 <!-- end of kind -->
10998 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10999 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11000
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11001 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11002 <tr>
11003 <th class="th_name">Property Name</th>
11004 <th class="th_type">Type</th>
11005 <th class="th_description">Description</th>
11006 <th class="th_units">Units</th>
11007 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11008 <th class="th_tags">Tags</th>
11009 </tr>
11010 </thead>
11011
11012 <tbody>
11013
11014
11015
11016
11017
11018
11019
11020
11021
11022
11023 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11024 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11025 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11026 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11027 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11028 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11029
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11030 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11031
11032
11033 </td> <!-- entry_type -->
11034
11035 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11036 <p>Duration each pixel is exposed to
11037light.<wbr/></p>
11038<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
11039duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11040 </td>
11041
11042 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11043 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11044 </td>
11045
11046 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11047 <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]11048 </td>
11049
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11050 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11051 <ul class="entry_tags">
11052 <li><a href="#tag_V1">V1</a></li>
11053 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11054 </td>
11055
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11056 </tr>
11057 <tr class="entries_header">
11058 <th class="th_details" colspan="5">Details</th>
11059 </tr>
11060 <tr class="entry_cont">
11061 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11062 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11063 </td>
11064 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11065
11066
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11067 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11068 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11069
11070
11071 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11072 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11073 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11074 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11075 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11076 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11077
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11078 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11079
11080
11081 </td> <!-- entry_type -->
11082
11083 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11084 <p>Duration from start of frame exposure to
11085start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11086 </td>
11087
11088 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11089 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11090 </td>
11091
11092 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11093 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
11094android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11095 </td>
11096
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11097 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11098 <ul class="entry_tags">
11099 <li><a href="#tag_V1">V1</a></li>
11100 <li><a href="#tag_BC">BC</a></li>
11101 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11102 </td>
11103
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11104 </tr>
11105 <tr class="entries_header">
11106 <th class="th_details" colspan="5">Details</th>
11107 </tr>
11108 <tr class="entry_cont">
11109 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11110 <p>Exposure time has priority,<wbr/> so duration is set to
11111max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11112 </td>
11113 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11114
11115
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11116 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11117 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11118
11119
11120 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11121 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11122 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11123 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11124 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11125 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11126
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11127 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11128
11129
11130 </td> <!-- entry_type -->
11131
11132 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11133 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11134implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11135below 'maximum analog sensitivity'.<wbr/></p>
11136<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
11137gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11138 </td>
11139
11140 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11141 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11142 </td>
11143
11144 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11145 <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]11146 </td>
11147
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11148 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11149 <ul class="entry_tags">
11150 <li><a href="#tag_V1">V1</a></li>
11151 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11152 </td>
11153
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11154 </tr>
11155 <tr class="entries_header">
11156 <th class="th_details" colspan="5">Details</th>
11157 </tr>
11158 <tr class="entry_cont">
11159 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11160 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11161 </td>
11162 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11163
11164
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11165 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11166 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11167
11168
11169 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11170 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11171 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11172 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11173 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11174 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11175
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11176 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11177
11178
11179 </td> <!-- entry_type -->
11180
11181 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11182 <p>Time at start of exposure of first
11183row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11184 </td>
11185
11186 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11187 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11188 </td>
11189
11190 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11191 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11192 </td>
11193
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11194 <td class="entry_tags">
11195 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11196 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11197 </ul>
11198 </td>
11199
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11200 </tr>
11201 <tr class="entries_header">
11202 <th class="th_details" colspan="5">Details</th>
11203 </tr>
11204 <tr class="entry_cont">
11205 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11206 <p>Monotonic,<wbr/> should be synced to other timestamps in
11207system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11208 </td>
11209 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11210
11211
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11212 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11213 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11214
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11215
11216 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11217 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11218 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11219 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11220 <td class="entry_type">
11221 <span class="entry_type_name">float</span>
11222
11223 <span class="entry_type_visibility"> [public]</span>
11224
11225
11226 </td> <!-- entry_type -->
11227
11228 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11229 <p>The temperature of the sensor,<wbr/> sampled at the time
11230exposure began for this frame.<wbr/></p>
11231<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
11232somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11233 </td>
11234
11235 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11236 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11237 </td>
11238
11239 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11240 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11241 </td>
11242
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11243 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]11244 <ul class="entry_tags">
11245 <li><a href="#tag_FULL">FULL</a></li>
11246 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11247 </td>
11248
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11249 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11250
11251
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11252 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11253 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11254
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11255
11256
11257 <!-- end of kind -->
11258 </tbody>
11259
11260 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11261 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11262
11263
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11264 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11265
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11266 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11267 <tr>
11268 <th class="th_name">Property Name</th>
11269 <th class="th_type">Type</th>
11270 <th class="th_description">Description</th>
11271 <th class="th_units">Units</th>
11272 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11273 <th class="th_tags">Tags</th>
11274 </tr>
11275 </thead>
11276
11277 <tbody>
11278
11279
11280
11281
11282
11283
11284
11285
11286
11287
11288 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11289 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11290 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11291 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11292 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11293 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11294
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11295 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11296
11297 <ul class="entry_type_enum">
11298 <li>
11299 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11300 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11301 </li>
11302 <li>
11303 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11304 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
11305bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11306 </li>
11307 <li>
11308 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11309 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
11310quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11311 </li>
11312 </ul>
11313
11314 </td> <!-- entry_type -->
11315
11316 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11317 <p>Quality of lens shading correction applied
11318to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11319 </td>
11320
11321 <td class="entry_units">
11322 </td>
11323
11324 <td class="entry_range">
11325 </td>
11326
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11327 <td class="entry_tags">
11328 </td>
11329
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11330 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11331
11332
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11333 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11334 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11335
11336
11337 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11338 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11339 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11340 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11341 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11342 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11343
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11344 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11345
11346
11347 </td> <!-- entry_type -->
11348
11349 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11350 <p>Control the amount of shading correction
11351applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11352 </td>
11353
11354 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11355 unitless: 1-10; 10 is full shading
11356 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11357 </td>
11358
11359 <td class="entry_range">
11360 </td>
11361
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11362 <td class="entry_tags">
11363 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11364 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11365 </ul>
11366 </td>
11367
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11368 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11369
11370
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11371 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11372 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11373
11374
11375
11376 <!-- end of kind -->
11377 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11378 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11379
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11380 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11381 <tr>
11382 <th class="th_name">Property Name</th>
11383 <th class="th_type">Type</th>
11384 <th class="th_description">Description</th>
11385 <th class="th_units">Units</th>
11386 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11387 <th class="th_tags">Tags</th>
11388 </tr>
11389 </thead>
11390
11391 <tbody>
11392
11393
11394
11395
11396
11397
11398
11399
11400
11401
11402 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11403 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11404 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11405 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11406 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11407 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11408
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11409 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11410
11411 <ul class="entry_type_enum">
11412 <li>
11413 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11414 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11415 </li>
11416 <li>
11417 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11418 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
11419bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11420 </li>
11421 <li>
11422 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11423 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
11424quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11425 </li>
11426 </ul>
11427
11428 </td> <!-- entry_type -->
11429
11430 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11431 <p>Quality of lens shading correction applied
11432to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11433 </td>
11434
11435 <td class="entry_units">
11436 </td>
11437
11438 <td class="entry_range">
11439 </td>
11440
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11441 <td class="entry_tags">
11442 </td>
11443
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11444 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11445
11446
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11447 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11448 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11449
11450
11451
11452 <!-- end of kind -->
11453 </tbody>
11454
11455 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11456 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11457
11458
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11459 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11460
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11461 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11462 <tr>
11463 <th class="th_name">Property Name</th>
11464 <th class="th_type">Type</th>
11465 <th class="th_description">Description</th>
11466 <th class="th_units">Units</th>
11467 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11468 <th class="th_tags">Tags</th>
11469 </tr>
11470 </thead>
11471
11472 <tbody>
11473
11474
11475
11476
11477
11478
11479
11480
11481
11482
11483 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11484 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11485 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11486 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11487 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11488 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11489
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11490 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11491
11492 <ul class="entry_type_enum">
11493 <li>
11494 <span class="entry_type_enum_name">OFF</span>
11495 </li>
11496 <li>
11497 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11498 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
11499only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11500 </li>
11501 <li>
11502 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11503 <span class="entry_type_enum_notes"><p>Optional Return all face
11504metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11505 </li>
11506 </ul>
11507
11508 </td> <!-- entry_type -->
11509
11510 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11511 <p>State of the face detector
11512unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11513 </td>
11514
11515 <td class="entry_units">
11516 </td>
11517
11518 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11519 <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]11520 </td>
11521
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11522 <td class="entry_tags">
11523 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11524 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11525 </ul>
11526 </td>
11527
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11528 </tr>
11529 <tr class="entries_header">
11530 <th class="th_details" colspan="5">Details</th>
11531 </tr>
11532 <tr class="entry_cont">
11533 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11534 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11535should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11536fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11537<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]11538 </td>
11539 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11540
11541
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11542 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11543 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11544
11545
11546 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11547 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11548 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11549 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11550 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11551 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11552
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11553 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11554
11555 <ul class="entry_type_enum">
11556 <li>
11557 <span class="entry_type_enum_name">OFF</span>
11558 </li>
11559 <li>
11560 <span class="entry_type_enum_name">ON</span>
11561 </li>
11562 </ul>
11563
11564 </td> <!-- entry_type -->
11565
11566 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11567 <p>Operating mode for histogram
11568generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11569 </td>
11570
11571 <td class="entry_units">
11572 </td>
11573
11574 <td class="entry_range">
11575 </td>
11576
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11577 <td class="entry_tags">
11578 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11579 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11580 </ul>
11581 </td>
11582
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11583 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11584
11585
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11586 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11587 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11588
11589
11590 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11591 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11592 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11593 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11594 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11595 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11596
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11597 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11598
11599 <ul class="entry_type_enum">
11600 <li>
11601 <span class="entry_type_enum_name">OFF</span>
11602 </li>
11603 <li>
11604 <span class="entry_type_enum_name">ON</span>
11605 </li>
11606 </ul>
11607
11608 </td> <!-- entry_type -->
11609
11610 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11611 <p>Operating mode for sharpness map
11612generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11613 </td>
11614
11615 <td class="entry_units">
11616 </td>
11617
11618 <td class="entry_range">
11619 </td>
11620
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11621 <td class="entry_tags">
11622 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11623 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11624 </ul>
11625 </td>
11626
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11627 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11628
11629
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11630 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11631 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11632
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11633
11634 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11635 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11636 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11637 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11638 <td class="entry_type">
11639 <span class="entry_type_name entry_type_name_enum">byte</span>
11640
11641 <span class="entry_type_visibility"> [public]</span>
11642
11643 <ul class="entry_type_enum">
11644 <li>
11645 <span class="entry_type_enum_name">OFF</span>
11646 </li>
11647 <li>
11648 <span class="entry_type_enum_name">ON</span>
11649 </li>
11650 </ul>
11651
11652 </td> <!-- entry_type -->
11653
11654 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11655 <p>Whether the HAL needs to output the lens
11656shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11657 </td>
11658
11659 <td class="entry_units">
11660 </td>
11661
11662 <td class="entry_range">
11663 </td>
11664
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11665 <td class="entry_tags">
11666 </td>
11667
11668 </tr>
11669 <tr class="entries_header">
11670 <th class="th_details" colspan="5">Details</th>
11671 </tr>
11672 <tr class="entry_cont">
11673 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11674 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11675<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]11676the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11677 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11678 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11679
11680
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11681 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11682 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11683
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11684
11685
11686 <!-- end of kind -->
11687 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11688 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11689
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11690 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11691 <tr>
11692 <th class="th_name">Property Name</th>
11693 <th class="th_type">Type</th>
11694 <th class="th_description">Description</th>
11695 <th class="th_units">Units</th>
11696 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11697 <th class="th_tags">Tags</th>
11698 </tr>
11699 </thead>
11700
11701 <tbody>
11702
11703
11704
11705
11706
11707
11708
11709
11710
11711
11712
11713
11714 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11715 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11716 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11717 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11718 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11719 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11720 <span class="entry_type_container">x</span>
11721
11722 <span class="entry_type_array">
11723 n
11724 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11725 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11726 <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]11727
11728
11729 </td> <!-- entry_type -->
11730
11731 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11732 <p>Which face detection modes are available,<wbr/>
11733if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11734 </td>
11735
11736 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11737 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11738 OFF
11739 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11740 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11741 </td>
11742
11743 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11744 </td>
11745
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11746 <td class="entry_tags">
11747 </td>
11748
11749 </tr>
11750 <tr class="entries_header">
11751 <th class="th_details" colspan="5">Details</th>
11752 </tr>
11753 <tr class="entry_cont">
11754 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11755 <p>OFF means face detection is disabled,<wbr/> it must
11756be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11757<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11758<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
11759<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]11760<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11761<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
11762<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]11763 </td>
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.histogramBucketCount">
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/>histogram<wbr/>Bucket<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"> [system]</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>Number of histogram buckets
11785supported</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;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11793 </td>
11794
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11795 <td class="entry_tags">
11796 </td>
11797
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11798 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11799
11800
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11801 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11802 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11803
11804
11805 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11806 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11807 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11808 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11809 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11810 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11811
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11812 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11813
11814
11815 </td> <!-- entry_type -->
11816
11817 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11818 <p>Maximum number of simultaneously detectable
11819faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11820 </td>
11821
11822 <td class="entry_units">
11823 </td>
11824
11825 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11826 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11827modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11828 </td>
11829
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11830 <td class="entry_tags">
11831 </td>
11832
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11833 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11834
11835
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11836 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11837 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11838
11839
11840 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11841 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11842 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11843 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11844 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11845 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11846
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11847 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11848
11849
11850 </td> <!-- entry_type -->
11851
11852 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11853 <p>Maximum value possible for a histogram
11854bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11855 </td>
11856
11857 <td class="entry_units">
11858 </td>
11859
11860 <td class="entry_range">
11861 </td>
11862
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11863 <td class="entry_tags">
11864 </td>
11865
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11866 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11867
11868
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11869 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11870 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11871
11872
11873 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11874 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11875 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11876 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11877 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11878 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11879
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11880 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11881
11882
11883 </td> <!-- entry_type -->
11884
11885 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11886 <p>Maximum value possible for a sharpness map
11887region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11888 </td>
11889
11890 <td class="entry_units">
11891 </td>
11892
11893 <td class="entry_range">
11894 </td>
11895
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11896 <td class="entry_tags">
11897 </td>
11898
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11899 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11900
11901
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11902 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11903 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11904
11905
11906 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11907 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11908 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11909 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11910 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11911 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11912 <span class="entry_type_container">x</span>
11913
11914 <span class="entry_type_array">
11915 2
11916 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11917 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11918 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11919
11920
11921 </td> <!-- entry_type -->
11922
11923 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11924 <p>Dimensions of the sharpness
11925map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11926 </td>
11927
11928 <td class="entry_units">
11929 </td>
11930
11931 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11932 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11933 </td>
11934
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11935 <td class="entry_tags">
11936 </td>
11937
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11938 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11939
11940
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11941 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11942 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11943
11944
11945
11946
11947
11948
11949 <!-- end of kind -->
11950 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11951 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11952
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11953 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11954 <tr>
11955 <th class="th_name">Property Name</th>
11956 <th class="th_type">Type</th>
11957 <th class="th_description">Description</th>
11958 <th class="th_units">Units</th>
11959 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11960 <th class="th_tags">Tags</th>
11961 </tr>
11962 </thead>
11963
11964 <tbody>
11965
11966
11967
11968
11969
11970
11971
11972
11973
11974
11975 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11976 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11977 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11978 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11979 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11980 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11981
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11982 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11983
11984 <ul class="entry_type_enum">
11985 <li>
11986 <span class="entry_type_enum_name">OFF</span>
11987 </li>
11988 <li>
11989 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11990 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
11991only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11992 </li>
11993 <li>
11994 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11995 <span class="entry_type_enum_notes"><p>Optional Return all face
11996metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11997 </li>
11998 </ul>
11999
12000 </td> <!-- entry_type -->
12001
12002 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12003 <p>State of the face detector
12004unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12005 </td>
12006
12007 <td class="entry_units">
12008 </td>
12009
12010 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12011 <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]12012 </td>
12013
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12014 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12015 <ul class="entry_tags">
12016 <li><a href="#tag_BC">BC</a></li>
12017 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12018 </td>
12019
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12020 </tr>
12021 <tr class="entries_header">
12022 <th class="th_details" colspan="5">Details</th>
12023 </tr>
12024 <tr class="entry_cont">
12025 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12026 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12027should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12028fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12029<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]12030 </td>
12031 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12032
12033
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12034 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12035 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12036
12037
12038 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12039 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12040 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12041 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12042 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12043 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12044 <span class="entry_type_container">x</span>
12045
12046 <span class="entry_type_array">
12047 n
12048 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12049 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12050
12051
12052 </td> <!-- entry_type -->
12053
12054 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12055 <p>List of unique IDs for detected
12056faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12057 </td>
12058
12059 <td class="entry_units">
12060 </td>
12061
12062 <td class="entry_range">
12063 </td>
12064
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12065 <td class="entry_tags">
12066 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12067 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12068 </ul>
12069 </td>
12070
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12071 </tr>
12072 <tr class="entries_header">
12073 <th class="th_details" colspan="5">Details</th>
12074 </tr>
12075 <tr class="entry_cont">
12076 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12077 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12078 </td>
12079 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12080
12081
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12082 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12083 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12084
12085
12086 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12087 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12088 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12089 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12090 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12091 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12092 <span class="entry_type_container">x</span>
12093
12094 <span class="entry_type_array">
12095 n x 6
12096 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12097 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12098 <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]12099
12100
12101 </td> <!-- entry_type -->
12102
12103 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12104 <p>List of landmarks for detected
12105faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12106 </td>
12107
12108 <td class="entry_units">
12109 </td>
12110
12111 <td class="entry_range">
12112 </td>
12113
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12114 <td class="entry_tags">
12115 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12116 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12117 </ul>
12118 </td>
12119
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12120 </tr>
12121 <tr class="entries_header">
12122 <th class="th_details" colspan="5">Details</th>
12123 </tr>
12124 <tr class="entry_cont">
12125 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12126 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12127 </td>
12128 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12129
12130
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12131 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12132 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12133
12134
12135 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12136 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12137 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12138 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12139 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12140 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12141 <span class="entry_type_container">x</span>
12142
12143 <span class="entry_type_array">
12144 n x 4
12145 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12146 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12147 <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]12148
12149
12150 </td> <!-- entry_type -->
12151
12152 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12153 <p>List of the bounding rectangles for detected
12154faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12155 </td>
12156
12157 <td class="entry_units">
12158 </td>
12159
12160 <td class="entry_range">
12161 </td>
12162
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12163 <td class="entry_tags">
12164 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12165 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12166 </ul>
12167 </td>
12168
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12169 </tr>
12170 <tr class="entries_header">
12171 <th class="th_details" colspan="5">Details</th>
12172 </tr>
12173 <tr class="entry_cont">
12174 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12175 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12176 </td>
12177 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12178
12179
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12180 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12181 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12182
12183
12184 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12185 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12186 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12187 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12188 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12189 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12190 <span class="entry_type_container">x</span>
12191
12192 <span class="entry_type_array">
12193 n
12194 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12195 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12196
12197
12198 </td> <!-- entry_type -->
12199
12200 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12201 <p>List of the face confidence scores for
12202detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12203 </td>
12204
12205 <td class="entry_units">
12206 </td>
12207
12208 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12209 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12210 </td>
12211
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12212 <td class="entry_tags">
12213 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12214 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12215 </ul>
12216 </td>
12217
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12218 </tr>
12219 <tr class="entries_header">
12220 <th class="th_details" colspan="5">Details</th>
12221 </tr>
12222 <tr class="entry_cont">
12223 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12224 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
12225meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12226 </td>
12227 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12228
12229
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12230 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12231 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12232
12233
12234 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12235 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12236 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12237 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12238 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12239 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12240 <span class="entry_type_container">x</span>
12241
12242 <span class="entry_type_array">
12243 n x 3
12244 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12245 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12246 <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]12247
12248
12249 </td> <!-- entry_type -->
12250
12251 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12252 <p>A 3-channel histogram based on the raw
12253sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12254 </td>
12255
12256 <td class="entry_units">
12257 </td>
12258
12259 <td class="entry_range">
12260 </td>
12261
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12262 <td class="entry_tags">
12263 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12264 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12265 </ul>
12266 </td>
12267
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12268 </tr>
12269 <tr class="entries_header">
12270 <th class="th_details" colspan="5">Details</th>
12271 </tr>
12272 <tr class="entry_cont">
12273 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12274 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12275(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]12276(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
12277supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12278 </td>
12279 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12280
12281
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12282 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12283 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12284
12285
12286 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12287 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12288 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12289 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12290 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12291 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12292
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12293 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12294
12295 <ul class="entry_type_enum">
12296 <li>
12297 <span class="entry_type_enum_name">OFF</span>
12298 </li>
12299 <li>
12300 <span class="entry_type_enum_name">ON</span>
12301 </li>
12302 </ul>
12303
12304 </td> <!-- entry_type -->
12305
12306 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12307 <p>Operating mode for histogram
12308generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12309 </td>
12310
12311 <td class="entry_units">
12312 </td>
12313
12314 <td class="entry_range">
12315 </td>
12316
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12317 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12318 <ul class="entry_tags">
12319 <li><a href="#tag_V1">V1</a></li>
12320 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12321 </td>
12322
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12323 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12324
12325
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12326 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12327 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12328
12329
12330 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12331 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12332 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12333 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12334 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12335 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12336 <span class="entry_type_container">x</span>
12337
12338 <span class="entry_type_array">
12339 n x m x 3
12340 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12341 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12342 <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]12343
12344
12345 </td> <!-- entry_type -->
12346
12347 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12348 <p>A 3-channel sharpness map,<wbr/> based on the raw
12349sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12350 </td>
12351
12352 <td class="entry_units">
12353 </td>
12354
12355 <td class="entry_range">
12356 </td>
12357
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12358 <td class="entry_tags">
12359 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12360 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12361 </ul>
12362 </td>
12363
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12364 </tr>
12365 <tr class="entries_header">
12366 <th class="th_details" colspan="5">Details</th>
12367 </tr>
12368 <tr class="entry_cont">
12369 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12370 <p>If only a monochrome sharpness map is supported,<wbr/>
12371all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12372 </td>
12373 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12374
12375
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12376 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12377 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12378
12379
12380 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12381 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12382 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12383 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12384 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12385 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12386
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12387 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12388
12389 <ul class="entry_type_enum">
12390 <li>
12391 <span class="entry_type_enum_name">OFF</span>
12392 </li>
12393 <li>
12394 <span class="entry_type_enum_name">ON</span>
12395 </li>
12396 </ul>
12397
12398 </td> <!-- entry_type -->
12399
12400 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12401 <p>Operating mode for sharpness map
12402generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12403 </td>
12404
12405 <td class="entry_units">
12406 </td>
12407
12408 <td class="entry_range">
12409 </td>
12410
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12411 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12412 <ul class="entry_tags">
12413 <li><a href="#tag_V1">V1</a></li>
12414 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12415 </td>
12416
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12417 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12418
12419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12420 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12421 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12422
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12423
12424 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12425 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12426 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12427 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12428 <td class="entry_type">
12429 <span class="entry_type_name">float</span>
12430 <span class="entry_type_container">x</span>
12431
12432 <span class="entry_type_array">
12433 4 x n x m
12434 </span>
12435 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12436 <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]12437
12438
12439 </td> <!-- entry_type -->
12440
12441 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12442 <p>The shading map is a low-resolution floating-point map
12443that lists the coefficients used to correct for vignetting,<wbr/> for each
12444Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12445 </td>
12446
12447 <td class="entry_units">
12448 </td>
12449
12450 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12451 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12452 </td>
12453
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12454 <td class="entry_tags">
12455 </td>
12456
12457 </tr>
12458 <tr class="entries_header">
12459 <th class="th_details" colspan="5">Details</th>
12460 </tr>
12461 <tr class="entry_cont">
12462 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12463 <p>The least shaded section of the image should have a gain factor
12464of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12465<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]12466must take into account the colorCorrection settings.<wbr/></p>
12467<p>The shading map is for the entire active pixel array,<wbr/> and is not
12468affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]12469entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12470pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
12471map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
12472(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
12473pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
12474The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
12475<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
12476channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
12477The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12478is 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]12479<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
12480and must be smaller than 64x64.<wbr/></p>
12481<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12482<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
12483<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]12484[ 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/>
12485 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/>
12486 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/>
12487 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/>
12488 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/>
12489 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]12490</code></pre>
12491<p>The low-resolution scaling map images for each channel are
12492(displayed using nearest-neighbor interpolation):</p>
12493<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
12494<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
12495<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
12496<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]12497<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]12498image 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]12499<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]12500 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12501 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12502
12503
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12504 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12505 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12506
12507
12508 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12509 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12510 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12511 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12512 <td class="entry_type">
12513 <span class="entry_type_name">float</span>
12514 <span class="entry_type_container">x</span>
12515
12516 <span class="entry_type_array">
12517 4
12518 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12519 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12520 <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]12521
12522
12523 </td> <!-- entry_type -->
12524
12525 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12526 <p>The best-fit color channel gains calculated
12527by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12528 </td>
12529
12530 <td class="entry_units">
12531 </td>
12532
12533 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12534 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12535 </td>
12536
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12537 <td class="entry_tags">
12538 </td>
12539
12540 </tr>
12541 <tr class="entries_header">
12542 <th class="th_details" colspan="5">Details</th>
12543 </tr>
12544 <tr class="entry_cont">
12545 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12546 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12547since statistics processing on data from a new frame
12548typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12549applied to that frame.<wbr/></p>
12550<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12551see <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]12552<p>This value should always be calculated by the AWB block,<wbr/>
12553regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12554 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12555 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12556
12557
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12558 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12559 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12560
12561
12562 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12563 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12564 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12565 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12566 <td class="entry_type">
12567 <span class="entry_type_name">rational</span>
12568 <span class="entry_type_container">x</span>
12569
12570 <span class="entry_type_array">
12571 3 x 3
12572 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12573 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12574 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12575
12576
12577 </td> <!-- entry_type -->
12578
12579 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12580 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12581calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12582output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12583 </td>
12584
12585 <td class="entry_units">
12586 </td>
12587
12588 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12589 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12590 </td>
12591
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12592 <td class="entry_tags">
12593 </td>
12594
12595 </tr>
12596 <tr class="entries_header">
12597 <th class="th_details" colspan="5">Details</th>
12598 </tr>
12599 <tr class="entry_cont">
12600 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12601 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12602statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12603for the next frame.<wbr/> These are the values the HAL believes
12604are the best fit for the current output frame.<wbr/> This may
12605be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12606statistics processing on data from a new frame typically
12607completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12608that frame.<wbr/></p>
12609<p>These estimates must be provided for all frames,<wbr/> even if
12610capture settings and color transforms are set by the application.<wbr/></p>
12611<p>This value should always be calculated by the AWB block,<wbr/>
12612regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12613 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12614 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12615
12616
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12617 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12618 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12619
12620
12621 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12622 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12623 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12624 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12625 <td class="entry_type">
12626 <span class="entry_type_name entry_type_name_enum">byte</span>
12627
12628 <span class="entry_type_visibility"> [public]</span>
12629
12630 <ul class="entry_type_enum">
12631 <li>
12632 <span class="entry_type_enum_name">NONE</span>
12633 </li>
12634 <li>
12635 <span class="entry_type_enum_name">50HZ</span>
12636 </li>
12637 <li>
12638 <span class="entry_type_enum_name">60HZ</span>
12639 </li>
12640 </ul>
12641
12642 </td> <!-- entry_type -->
12643
12644 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12645 <p>The HAL estimated scene illumination lighting
12646frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12647 </td>
12648
12649 <td class="entry_units">
12650 </td>
12651
12652 <td class="entry_range">
12653 </td>
12654
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12655 <td class="entry_tags">
12656 </td>
12657
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12658 </tr>
12659 <tr class="entries_header">
12660 <th class="th_details" colspan="5">Details</th>
12661 </tr>
12662 <tr class="entry_cont">
12663 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12664 <p>Report NONE if there doesn't appear to be flickering
12665illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12666 </td>
12667 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12668
12669
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12670 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12671 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12672
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12673
12674
12675 <!-- end of kind -->
12676 </tbody>
12677
12678 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12679 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12680
12681
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12682 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12683
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12684 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12685 <tr>
12686 <th class="th_name">Property Name</th>
12687 <th class="th_type">Type</th>
12688 <th class="th_description">Description</th>
12689 <th class="th_units">Units</th>
12690 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12691 <th class="th_tags">Tags</th>
12692 </tr>
12693 </thead>
12694
12695 <tbody>
12696
12697
12698
12699
12700
12701
12702
12703
12704
12705
12706 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12707 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12708 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12709 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12710 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12711 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12712 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12713
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12714 <span class="entry_type_array">
12715 n x 2
12716 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12717 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12718 <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]12719
12720
12721 </td> <!-- entry_type -->
12722
12723 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12724 <p>Table mapping blue input values to output
12725values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12726 </td>
12727
12728 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12729 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12730 </td>
12731
12732 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12733 <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]12734 </td>
12735
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12736 <td class="entry_tags">
12737 </td>
12738
12739 </tr>
12740 <tr class="entries_header">
12741 <th class="th_details" colspan="5">Details</th>
12742 </tr>
12743 <tr class="entry_cont">
12744 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12745 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12746channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12747<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]12748 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12749 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12750
12751
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12752 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12753 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12754
12755
12756 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12757 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12758 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12759 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12760 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12761 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12762 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12763
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12764 <span class="entry_type_array">
12765 n x 2
12766 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12767 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12768 <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]12769
12770
12771 </td> <!-- entry_type -->
12772
12773 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12774 <p>Table mapping green input values to output
12775values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12776 </td>
12777
12778 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12779 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12780 </td>
12781
12782 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12783 <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]12784 </td>
12785
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12786 <td class="entry_tags">
12787 </td>
12788
12789 </tr>
12790 <tr class="entries_header">
12791 <th class="th_details" colspan="5">Details</th>
12792 </tr>
12793 <tr class="entry_cont">
12794 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12795 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12796channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12797<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]12798 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12799 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12800
12801
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12802 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12803 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12804
12805
12806 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12807 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12808 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12809 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12810 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12811 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12812 <span class="entry_type_container">x</span>
12813
12814 <span class="entry_type_array">
12815 n x 2
12816 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12817 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12818 <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]12819
12820
12821 </td> <!-- entry_type -->
12822
12823 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12824 <p>Table mapping red input values to output
12825values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12826 </td>
12827
12828 <td class="entry_units">
12829 </td>
12830
12831 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12832 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12833 </td>
12834
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12835 <td class="entry_tags">
12836 <ul class="entry_tags">
12837 <li><a href="#tag_DNG">DNG</a></li>
12838 </ul>
12839 </td>
12840
12841 </tr>
12842 <tr class="entries_header">
12843 <th class="th_details" colspan="5">Details</th>
12844 </tr>
12845 <tr class="entry_cont">
12846 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12847 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12848channel,<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]12849<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12850the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12851are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12852between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12853<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12854defined points.<wbr/> The points will be listed in increasing
12855order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
128560.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12857for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
128580.<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]12859 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12860 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12861
12862
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12863 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12864 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12865
12866
12867 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12868 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12869 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12870 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12871 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12872 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12873
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12874 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12875
12876 <ul class="entry_type_enum">
12877 <li>
12878 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12879 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
12880android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12881 </li>
12882 <li>
12883 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12884 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
12885bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12886 </li>
12887 <li>
12888 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12889 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
12890quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12891 </li>
12892 </ul>
12893
12894 </td> <!-- entry_type -->
12895
12896 <td class="entry_description">
12897 </td>
12898
12899 <td class="entry_units">
12900 </td>
12901
12902 <td class="entry_range">
12903 </td>
12904
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12905 <td class="entry_tags">
12906 </td>
12907
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12908 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12909
12910
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12911 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12912 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12913
12914
12915
12916 <!-- end of kind -->
12917 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12918 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12919
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12920 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12921 <tr>
12922 <th class="th_name">Property Name</th>
12923 <th class="th_type">Type</th>
12924 <th class="th_description">Description</th>
12925 <th class="th_units">Units</th>
12926 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12927 <th class="th_tags">Tags</th>
12928 </tr>
12929 </thead>
12930
12931 <tbody>
12932
12933
12934
12935
12936
12937
12938
12939
12940
12941
12942 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12943 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12944 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12945 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12946 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12947 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12948
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12949 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12950
12951
12952 </td> <!-- entry_type -->
12953
12954 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12955 <p>Maximum number of supported points in the
12956tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12957 </td>
12958
12959 <td class="entry_units">
12960 </td>
12961
12962 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]12963 <p>&gt;= 128</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12964 </td>
12965
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12966 <td class="entry_tags">
12967 </td>
12968
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12969 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12970
12971
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12972 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12973 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12974
12975
12976
12977 <!-- end of kind -->
12978 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12979 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12980
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12981 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12982 <tr>
12983 <th class="th_name">Property Name</th>
12984 <th class="th_type">Type</th>
12985 <th class="th_description">Description</th>
12986 <th class="th_units">Units</th>
12987 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12988 <th class="th_tags">Tags</th>
12989 </tr>
12990 </thead>
12991
12992 <tbody>
12993
12994
12995
12996
12997
12998
12999
13000
13001
13002
13003 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13004 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13005 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13006 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13007 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]13008 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13009 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13010
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13011 <span class="entry_type_array">
13012 n x 2
13013 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13014 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13015 <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]13016
13017
13018 </td> <!-- entry_type -->
13019
13020 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13021 <p>Table mapping blue input values to output
13022values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13023 </td>
13024
13025 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13026 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13027 </td>
13028
13029 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13030 <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]13031 </td>
13032
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13033 <td class="entry_tags">
13034 </td>
13035
13036 </tr>
13037 <tr class="entries_header">
13038 <th class="th_details" colspan="5">Details</th>
13039 </tr>
13040 <tr class="entry_cont">
13041 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13042 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13043channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
13044<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]13045 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13046 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13047
13048
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13049 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13050 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13051
13052
13053 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13054 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13055 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13056 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13057 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]13058 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13059 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13060
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13061 <span class="entry_type_array">
13062 n x 2
13063 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13064 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13065 <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]13066
13067
13068 </td> <!-- entry_type -->
13069
13070 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13071 <p>Table mapping green input values to output
13072values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13073 </td>
13074
13075 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13076 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13077 </td>
13078
13079 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13080 <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]13081 </td>
13082
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13083 <td class="entry_tags">
13084 </td>
13085
13086 </tr>
13087 <tr class="entries_header">
13088 <th class="th_details" colspan="5">Details</th>
13089 </tr>
13090 <tr class="entry_cont">
13091 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13092 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13093channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
13094<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]13095 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13096 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13097
13098
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13099 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13100 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13101
13102
13103 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13104 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13105 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13106 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13107 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13108 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13109 <span class="entry_type_container">x</span>
13110
13111 <span class="entry_type_array">
13112 n x 2
13113 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13114 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13115 <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]13116
13117
13118 </td> <!-- entry_type -->
13119
13120 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13121 <p>Table mapping red input values to output
13122values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13123 </td>
13124
13125 <td class="entry_units">
13126 </td>
13127
13128 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13129 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13130 </td>
13131
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13132 <td class="entry_tags">
13133 <ul class="entry_tags">
13134 <li><a href="#tag_DNG">DNG</a></li>
13135 </ul>
13136 </td>
13137
13138 </tr>
13139 <tr class="entries_header">
13140 <th class="th_details" colspan="5">Details</th>
13141 </tr>
13142 <tr class="entry_cont">
13143 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13144 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13145channel,<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]13146<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13147the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13148are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13149between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13150<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13151defined points.<wbr/> The points will be listed in increasing
13152order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
131530.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
13154for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
131550.<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]13156 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13157 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13158
13159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13160 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13161 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13162
13163
13164 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13165 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13166 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13167 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13168 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13169 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13170
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13171 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13172
13173 <ul class="entry_type_enum">
13174 <li>
13175 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13176 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
13177android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13178 </li>
13179 <li>
13180 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13181 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
13182bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13183 </li>
13184 <li>
13185 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13186 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
13187quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13188 </li>
13189 </ul>
13190
13191 </td> <!-- entry_type -->
13192
13193 <td class="entry_description">
13194 </td>
13195
13196 <td class="entry_units">
13197 </td>
13198
13199 <td class="entry_range">
13200 </td>
13201
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13202 <td class="entry_tags">
13203 </td>
13204
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13205 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13206
13207
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13208 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13209 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13210
13211
13212
13213 <!-- end of kind -->
13214 </tbody>
13215
13216 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13217 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13218
13219
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13220 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13221
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13222 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13223 <tr>
13224 <th class="th_name">Property Name</th>
13225 <th class="th_type">Type</th>
13226 <th class="th_description">Description</th>
13227 <th class="th_units">Units</th>
13228 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13229 <th class="th_tags">Tags</th>
13230 </tr>
13231 </thead>
13232
13233 <tbody>
13234
13235
13236
13237
13238
13239
13240
13241
13242
13243
13244 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13245 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13246 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13247 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13248 <td class="entry_type">
13249 <span class="entry_type_name entry_type_name_enum">byte</span>
13250
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13251 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13252
13253 <ul class="entry_type_enum">
13254 <li>
13255 <span class="entry_type_enum_name">OFF</span>
13256 </li>
13257 <li>
13258 <span class="entry_type_enum_name">ON</span>
13259 </li>
13260 </ul>
13261
13262 </td> <!-- entry_type -->
13263
13264 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13265 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13266that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13267Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13268disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13269any untrusted applications.<wbr/></p>
13270<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
13271transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
13272data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13273<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]13274doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13275 </td>
13276
13277 <td class="entry_units">
13278 </td>
13279
13280 <td class="entry_range">
13281 </td>
13282
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13283 <td class="entry_tags">
13284 </td>
13285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13286 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13287
13288
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13289 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13290 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13291
13292
13293
13294 <!-- end of kind -->
13295 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13296 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13297
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13298 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13299 <tr>
13300 <th class="th_name">Property Name</th>
13301 <th class="th_type">Type</th>
13302 <th class="th_description">Description</th>
13303 <th class="th_units">Units</th>
13304 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13305 <th class="th_tags">Tags</th>
13306 </tr>
13307 </thead>
13308
13309 <tbody>
13310
13311
13312
13313
13314
13315
13316
13317
13318
13319
13320 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13321 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13322 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13323 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13324 <td class="entry_type">
13325 <span class="entry_type_name entry_type_name_enum">byte</span>
13326
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13327 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13328
13329 <ul class="entry_type_enum">
13330 <li>
13331 <span class="entry_type_enum_name">OFF</span>
13332 </li>
13333 <li>
13334 <span class="entry_type_enum_name">ON</span>
13335 </li>
13336 </ul>
13337
13338 </td> <!-- entry_type -->
13339
13340 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13341 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13342that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13343Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13344disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13345any untrusted applications.<wbr/></p>
13346<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
13347transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
13348data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13349<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]13350doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13351 </td>
13352
13353 <td class="entry_units">
13354 </td>
13355
13356 <td class="entry_range">
13357 </td>
13358
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13359 <td class="entry_tags">
13360 </td>
13361
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13362 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13363
13364
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13365 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13366 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13367
13368
13369
13370 <!-- end of kind -->
13371 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13372 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13373
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13374 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13375 <tr>
13376 <th class="th_name">Property Name</th>
13377 <th class="th_type">Type</th>
13378 <th class="th_description">Description</th>
13379 <th class="th_units">Units</th>
13380 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13381 <th class="th_tags">Tags</th>
13382 </tr>
13383 </thead>
13384
13385 <tbody>
13386
13387
13388
13389
13390
13391
13392
13393
13394
13395
13396 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13397 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13398 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13399 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13400 <td class="entry_type">
13401 <span class="entry_type_name entry_type_name_enum">byte</span>
13402 <span class="entry_type_container">x</span>
13403
13404 <span class="entry_type_array">
13405 n
13406 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13407 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13408
13409 <ul class="entry_type_enum">
13410 <li>
13411 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13412 <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]13413 </li>
13414 </ul>
13415
13416 </td> <!-- entry_type -->
13417
13418 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13419 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13420 </td>
13421
13422 <td class="entry_units">
13423 </td>
13424
13425 <td class="entry_range">
13426 </td>
13427
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13428 <td class="entry_tags">
13429 </td>
13430
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13431 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13432
13433
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13434 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13435 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13436
13437
13438
13439 <!-- end of kind -->
13440 </tbody>
13441
13442 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13443 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13444
13445
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13446 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13447
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13448 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13449 <tr>
13450 <th class="th_name">Property Name</th>
13451 <th class="th_type">Type</th>
13452 <th class="th_description">Description</th>
13453 <th class="th_units">Units</th>
13454 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13455 <th class="th_tags">Tags</th>
13456 </tr>
13457 </thead>
13458
13459 <tbody>
13460
13461
13462
13463
13464
13465
13466
13467
13468
13469
13470 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13471 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13472 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13473 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13474 <td class="entry_type">
13475 <span class="entry_type_name entry_type_name_enum">byte</span>
13476
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13477 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13478
13479 <ul class="entry_type_enum">
13480 <li>
13481 <span class="entry_type_enum_name">LIMITED</span>
13482 </li>
13483 <li>
13484 <span class="entry_type_enum_name">FULL</span>
13485 </li>
13486 </ul>
13487
13488 </td> <!-- entry_type -->
13489
13490 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13491 <p>The camera 3 HAL device can implement one of two possible
13492operational modes; limited and full.<wbr/> Full support is
13493expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13494hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13495camera HAL device v1 implementation,<wbr/> and is expected from
13496older or inexpensive devices.<wbr/> Full is a strict superset of
13497limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
13498<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]13499 </td>
13500
13501 <td class="entry_units">
13502 </td>
13503
13504 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13505 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13506 </td>
13507
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13508 <td class="entry_tags">
13509 </td>
13510
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13511 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13512
13513
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13514 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13515 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13516
13517
13518
13519 <!-- end of kind -->
13520 </tbody>
13521
13522 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13523 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13524
13525
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13526 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13527
13528 <thead class="entries_header">
13529 <tr>
13530 <th class="th_name">Property Name</th>
13531 <th class="th_type">Type</th>
13532 <th class="th_description">Description</th>
13533 <th class="th_units">Units</th>
13534 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13535 <th class="th_tags">Tags</th>
13536 </tr>
13537 </thead>
13538
13539 <tbody>
13540
13541
13542
13543
13544
13545
13546
13547
13548
13549
13550 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13551 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13552 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13553 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13554 <td class="entry_type">
13555 <span class="entry_type_name entry_type_name_enum">byte</span>
13556
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13557 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13558
13559 <ul class="entry_type_enum">
13560 <li>
13561 <span class="entry_type_enum_name">OFF</span>
13562 </li>
13563 <li>
13564 <span class="entry_type_enum_name">ON</span>
13565 </li>
13566 </ul>
13567
13568 </td> <!-- entry_type -->
13569
13570 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13571 <p>Whether black-level compensation is locked
13572to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13573 </td>
13574
13575 <td class="entry_units">
13576 </td>
13577
13578 <td class="entry_range">
13579 </td>
13580
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13581 <td class="entry_tags">
13582 <ul class="entry_tags">
13583 <li><a href="#tag_HAL2">HAL2</a></li>
13584 </ul>
13585 </td>
13586
13587 </tr>
13588 <tr class="entries_header">
13589 <th class="th_details" colspan="5">Details</th>
13590 </tr>
13591 <tr class="entry_cont">
13592 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13593 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13594compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13595OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13596<p>Since changes to certain capture parameters (such as
13597exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13598compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13599the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13600metadata.<wbr/></p>
13601<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13602<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13603<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13604<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13605<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13606<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13607<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13608<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13609</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13610<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13611device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13612result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13613<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13614<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13615<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13616<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13617<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
13618<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13619<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13620</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13621<p>This indicates to the application that on frame 4,<wbr/> black
13622levels were reset due to exposure value changes,<wbr/> and pixel
13623values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13624<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13625possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13626other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13627or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13628 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13629 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13630
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13631 <tr class="entries_header">
13632 <th class="th_details" colspan="5">HAL Implementation Details</th>
13633 </tr>
13634 <tr class="entry_cont">
13635 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13636 <p>If for some reason black level locking is no longer possible
13637(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13638black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13639override this request (and it must report 'OFF' when this
13640does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13641possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13642 </td>
13643 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13644
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13645 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13646 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13647
13648
13649
13650 <!-- end of kind -->
13651 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13652 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13653
13654 <thead class="entries_header">
13655 <tr>
13656 <th class="th_name">Property Name</th>
13657 <th class="th_type">Type</th>
13658 <th class="th_description">Description</th>
13659 <th class="th_units">Units</th>
13660 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13661 <th class="th_tags">Tags</th>
13662 </tr>
13663 </thead>
13664
13665 <tbody>
13666
13667
13668
13669
13670
13671
13672
13673
13674
13675
13676 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13677 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13678 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13679 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13680 <td class="entry_type">
13681 <span class="entry_type_name entry_type_name_enum">byte</span>
13682
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13683 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13684
13685 <ul class="entry_type_enum">
13686 <li>
13687 <span class="entry_type_enum_name">OFF</span>
13688 </li>
13689 <li>
13690 <span class="entry_type_enum_name">ON</span>
13691 </li>
13692 </ul>
13693
13694 </td> <!-- entry_type -->
13695
13696 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13697 <p>Whether black-level compensation is locked
13698to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13699 </td>
13700
13701 <td class="entry_units">
13702 </td>
13703
13704 <td class="entry_range">
13705 </td>
13706
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13707 <td class="entry_tags">
13708 <ul class="entry_tags">
13709 <li><a href="#tag_HAL2">HAL2</a></li>
13710 </ul>
13711 </td>
13712
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13713 </tr>
13714 <tr class="entries_header">
13715 <th class="th_details" colspan="5">Details</th>
13716 </tr>
13717 <tr class="entry_cont">
13718 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13719 <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]13720ON 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]13721a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13722perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13723 </td>
13724 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13725
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13726 <tr class="entries_header">
13727 <th class="th_details" colspan="5">HAL Implementation Details</th>
13728 </tr>
13729 <tr class="entry_cont">
13730 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13731 <p>If for some reason black level locking is no longer possible
13732(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13733black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13734override this request (and it must report 'OFF' when this
13735does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13736possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13737 </td>
13738 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13739
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13740 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13741 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13742
13743
13744
13745 <!-- end of kind -->
13746 </tbody>
13747
13748 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13749<!-- </namespace> -->
13750 </table>
13751
13752 <div class="tags" id="tag_index">
13753 <h2>Tags</h2>
13754 <ul>
13755 <li id="tag_AWB">AWB -
13756 Needed for auto white balance
13757
13758 <ul class="tags_entries">
13759 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13760 </ul>
13761 </li> <!-- tag_AWB -->
13762 <li id="tag_BC">BC -
13763 Needed for backwards compatibility with old Java API
13764
13765 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]13766 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13767 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
13768 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
13769 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
13770 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
13771 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13772 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13773 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
13774 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13775 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13776 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
13777 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13778 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
13779 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
13780 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
13781 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
13782 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
13783 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]13784 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13785 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
13786 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
13787 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
13788 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
13789 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
13790 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
13791 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
13792 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
13793 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
13794 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
13795 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
13796 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
13797 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
13798 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
13799 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
13800 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
13801 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
13802 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
13803 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
13804 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13805 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13806 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
13807 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
13808 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
13809 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
13810 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
13811 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
13812 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]13813 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13814 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
13815 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
13816 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13817 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13818 <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]13819 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13820 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13821 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13822 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
13823 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
13824 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
13825 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
13826 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
13827 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
13828 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
13829 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
13830 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
13831 </ul>
13832 </li> <!-- tag_BC -->
13833 <li id="tag_V1">V1 -
13834 New features for first camera 2 release (API1)
13835
13836 <ul class="tags_entries">
13837 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13838 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13839 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13840 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13841 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13842 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13843 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13844 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13845 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13846 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13847 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13848 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13849 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13850 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13851 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13852 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13853 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13854 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13855 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13856 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13857 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13858 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13859 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13860 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13861 <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]13862 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13863 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13864 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13865 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13866 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13867 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13868 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13869 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13870 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13871 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13872 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13873 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13874 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13875 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13876 </ul>
13877 </li> <!-- tag_V1 -->
13878 <li id="tag_ADV">ADV - None
13879 <ul class="tags_entries">
13880 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13881 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13882 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13883 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13884 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13885 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13886 </ul>
13887 </li> <!-- tag_ADV -->
13888 <li id="tag_DNG">DNG -
13889 Needed for DNG file support
13890
13891 <ul class="tags_entries">
13892 <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]13893 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13894 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13895 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13896 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13897 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13898 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13899 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13900 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13901 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13902 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13903 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13904 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13905 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13906 </ul>
13907 </li> <!-- tag_DNG -->
13908 <li id="tag_EXIF">EXIF - None
13909 <ul class="tags_entries">
13910 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13911 </ul>
13912 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13913 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13914 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13915
13916 <ul class="tags_entries">
13917 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13918 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13919 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13920 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13921 </ul>
13922 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13923 <li id="tag_FULL">FULL -
13924 Entry is required for full hardware level devices, and optional for other hardware levels
13925
13926 <ul class="tags_entries">
13927 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13928 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13929 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13930 </ul>
13931 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13932 </ul>
13933 </div>
13934
13935 [ <a href="#">top</a> ]
13936
13937</body>
13938</html>