Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / ac9bbb9375b5518136ea1eb5e7163bf7d24a54d2 / . / camera / docs / docs.html
blob: 3528f5ba21b0a2ad189038d4a820ca72b5f12d47 [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">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame^]6783 <p>The current lens focal length; used for optical zoom.<wbr/></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">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame^]6791 <p><a href="#static_android.lens.info.availableFocalLengths">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths</a></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">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame^]6806 <p>This setting controls the physical focal length of the camera
6807device's lens.<wbr/> Changing the focal length changes the field of
6808view of the camera device,<wbr/> and is usually used for optical zoom.<wbr/></p>
6809<p>Like <a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> and <a href="#controls_android.lens.aperture">android.<wbr/>lens.<wbr/>aperture</a>,<wbr/> this
6810setting won't be applied instantaneously,<wbr/> and it may take several
6811frames before the lens can move to the requested focal length.<wbr/>
6812While the focal length is still changing,<wbr/> <a href="#dynamic_android.lens.state">android.<wbr/>lens.<wbr/>state</a> will
6813be set to MOVING.<wbr/></p>
6814<p>This is expected not to be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6815 </td>
6816 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6817
6818
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6819 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6820 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6821
6822
6823 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6824 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6825 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6826 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6827 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6828 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6829
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6830 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6831
6832
6833 </td> <!-- entry_type -->
6834
6835 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6836 <p>Distance to plane of sharpest focus,<wbr/>
6837measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6838 </td>
6839
6840 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6841 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6842 </td>
6843
6844 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6845 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6846 </td>
6847
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6848 <td class="entry_tags">
6849 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6850 <li><a href="#tag_BC">BC</a></li>
6851 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6852 </ul>
6853 </td>
6854
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6855 </tr>
6856 <tr class="entries_header">
6857 <th class="th_details" colspan="5">Details</th>
6858 </tr>
6859 <tr class="entry_cont">
6860 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6861 <p>0 = infinity focus.<wbr/> Used value should be clamped
6862to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6863 </td>
6864 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6865
6866
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6867 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6868 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6869
6870
6871 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6872 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6873 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6874 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6875 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6876 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6877
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6878 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6879
6880 <ul class="entry_type_enum">
6881 <li>
6882 <span class="entry_type_enum_name">OFF</span>
6883 </li>
6884 <li>
6885 <span class="entry_type_enum_name">ON</span>
6886 <span class="entry_type_enum_optional">optional</span>
6887 </li>
6888 </ul>
6889
6890 </td> <!-- entry_type -->
6891
6892 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6893 <p>Whether optical image stabilization is
6894enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6895 </td>
6896
6897 <td class="entry_units">
6898 </td>
6899
6900 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6901 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6902 </td>
6903
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6904 <td class="entry_tags">
6905 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6906 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6907 </ul>
6908 </td>
6909
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6910 </tr>
6911 <tr class="entries_header">
6912 <th class="th_details" colspan="5">Details</th>
6913 </tr>
6914 <tr class="entry_cont">
6915 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6916 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6917 </td>
6918 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6919
6920
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6921 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6922 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6923
6924
6925
6926 <!-- end of kind -->
6927 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6928 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6929
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6930 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6931 <tr>
6932 <th class="th_name">Property Name</th>
6933 <th class="th_type">Type</th>
6934 <th class="th_description">Description</th>
6935 <th class="th_units">Units</th>
6936 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6937 <th class="th_tags">Tags</th>
6938 </tr>
6939 </thead>
6940
6941 <tbody>
6942
6943
6944
6945
6946
6947
6948
6949
6950
6951
6952
6953
6954 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6955 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6956 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6957 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6958 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6959 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6960 <span class="entry_type_container">x</span>
6961
6962 <span class="entry_type_array">
6963 n
6964 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6965 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6966
6967
6968 </td> <!-- entry_type -->
6969
6970 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6971 <p>List of supported aperture
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6972values.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6973 </td>
6974
6975 <td class="entry_units">
6976 </td>
6977
6978 <td class="entry_range">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6979 <p>one entry required,<wbr/> &amp;&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6980 </td>
6981
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6982 <td class="entry_tags">
6983 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6984 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6985 </ul>
6986 </td>
6987
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6988 </tr>
6989 <tr class="entries_header">
6990 <th class="th_details" colspan="5">Details</th>
6991 </tr>
6992 <tr class="entry_cont">
6993 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6994 <p>If the camera device doesn't support variable apertures,<wbr/>
6995listed value will be the fixed aperture.<wbr/></p>
6996<p>If the camera device supports variable apertures,<wbr/> the aperture value
6997in this list will be sorted in ascending order.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6998 </td>
6999 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7000
7001
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7002 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7003 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7004
7005
7006 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7007 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7008 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7009 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7010 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7011 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7012 <span class="entry_type_container">x</span>
7013
7014 <span class="entry_type_array">
7015 n
7016 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7017 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7018
7019
7020 </td> <!-- entry_type -->
7021
7022 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7023 <p>List of supported ND filter
7024values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7025 </td>
7026
7027 <td class="entry_units">
7028 </td>
7029
7030 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7031 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7032 </td>
7033
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7034 <td class="entry_tags">
7035 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7036 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7037 </ul>
7038 </td>
7039
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7040 </tr>
7041 <tr class="entries_header">
7042 <th class="th_details" colspan="5">Details</th>
7043 </tr>
7044 <tr class="entry_cont">
7045 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7046 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7047lists the available exposure index values for dimming
7048(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7049light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7050 </td>
7051 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7052
7053
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7054 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7055 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7056
7057
7058 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7059 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7060 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7061 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7062 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7063 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7064 <span class="entry_type_container">x</span>
7065
7066 <span class="entry_type_array">
7067 n
7068 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7069 <span class="entry_type_visibility"> [public]</span>
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame^]7070 <div class="entry_type_notes">The list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7071
7072
7073 </td> <!-- entry_type -->
7074
7075 <td class="entry_description">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame^]7076 <p>The available focal lengths for this device for use with
7077<a href="#controls_android.lens.focalLength">android.<wbr/>lens.<wbr/>focal<wbr/>Length</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7078 </td>
7079
7080 <td class="entry_units">
7081 </td>
7082
7083 <td class="entry_range">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame^]7084 <p>Each value in this list must be &gt; 0.<wbr/> This list must
7085contain at least one value.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7086 </td>
7087
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7088 <td class="entry_tags">
7089 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7090 <li><a href="#tag_BC">BC</a></li>
7091 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7092 </ul>
7093 </td>
7094
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7095 </tr>
7096 <tr class="entries_header">
7097 <th class="th_details" colspan="5">Details</th>
7098 </tr>
7099 <tr class="entry_cont">
7100 <td class="entry_details" colspan="5">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame^]7101 <p>If optical zoom is not supported,<wbr/> this will only report
7102a single value corresponding to the static focal length of the
7103device.<wbr/> Otherwise,<wbr/> this will report every focal length supported
7104by the device.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7105 </td>
7106 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7107
7108
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7109 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7110 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7111
7112
7113 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7114 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7115 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7116 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7117 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7118 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7119 <span class="entry_type_container">x</span>
7120
7121 <span class="entry_type_array">
7122 n
7123 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7124 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7125 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7126
7127
7128 </td> <!-- entry_type -->
7129
7130 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7131 <p>List of supported optical image
7132stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7133 </td>
7134
7135 <td class="entry_units">
7136 </td>
7137
7138 <td class="entry_range">
7139 </td>
7140
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7141 <td class="entry_tags">
7142 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7143 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7144 </ul>
7145 </td>
7146
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7147 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7148
7149
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7150 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7151 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7152
7153
7154 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7155 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7156 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7157 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7158 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7159 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7160 <span class="entry_type_container">x</span>
7161
7162 <span class="entry_type_array">
7163 2 x 3 x n x m
7164 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7165 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7166 <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]7167
7168
7169 </td> <!-- entry_type -->
7170
7171 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7172 <p>A low-resolution map for correction of
7173geometric distortions and chromatic aberrations,<wbr/> per
7174color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7175 </td>
7176
7177 <td class="entry_units">
7178 </td>
7179
7180 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7181 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7182 </td>
7183
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7184 <td class="entry_tags">
7185 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7186 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7187 </ul>
7188 </td>
7189
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7190 </tr>
7191 <tr class="entries_header">
7192 <th class="th_details" colspan="5">Details</th>
7193 </tr>
7194 <tr class="entry_cont">
7195 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7196 <p>[DNG wants a function instead].<wbr/> What's easiest
7197for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
7198j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
7199j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
7200entry 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]7201 </td>
7202 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7203
7204
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7205 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7206 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7207
7208
7209 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7210 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7211 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7212 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7213 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7214 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7215 <span class="entry_type_container">x</span>
7216
7217 <span class="entry_type_array">
7218 2
7219 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7220 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7221 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7222
7223
7224 </td> <!-- entry_type -->
7225
7226 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7227 <p>Dimensions of geometric correction
7228map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7229 </td>
7230
7231 <td class="entry_units">
7232 </td>
7233
7234 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7235 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7236 </td>
7237
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7238 <td class="entry_tags">
7239 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7240 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7241 </ul>
7242 </td>
7243
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7244 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7245
7246
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7247 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7248 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7249
7250
7251 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7252 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7253 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7254 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7255 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7256 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7257
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7258 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7259
7260
7261 </td> <!-- entry_type -->
7262
7263 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7264 <p>Hyperfocal distance for this lens; set to
72650 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7266 </td>
7267
7268 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7269 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7270 </td>
7271
7272 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7273 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7274 </td>
7275
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7276 <td class="entry_tags">
7277 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7278 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7279 </ul>
7280 </td>
7281
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7282 </tr>
7283 <tr class="entries_header">
7284 <th class="th_details" colspan="5">Details</th>
7285 </tr>
7286 <tr class="entry_cont">
7287 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7288 <p>The hyperfocal distance is used for the old
7289API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7290 </td>
7291 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7292
7293
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7294 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7295 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7296
7297
7298 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7299 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7300 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7301 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7302 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7303 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7304
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7305 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7306
7307
7308 </td> <!-- entry_type -->
7309
7310 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7311 <p>Shortest distance from frontmost surface
7312of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7313 </td>
7314
7315 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7316 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7317 </td>
7318
7319 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7320 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7321 </td>
7322
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7323 <td class="entry_tags">
7324 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7325 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7326 </ul>
7327 </td>
7328
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7329 </tr>
7330 <tr class="entries_header">
7331 <th class="th_details" colspan="5">Details</th>
7332 </tr>
7333 <tr class="entry_cont">
7334 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7335 <p>If the lens is fixed-focus,<wbr/> this should be
73360</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7337 </td>
7338 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7339
7340
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7341 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7342 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7343
7344
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7345 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7346 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7347 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7348 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7349 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7350 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7351 <span class="entry_type_container">x</span>
7352
7353 <span class="entry_type_array">
7354 2
7355 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7356 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7357 <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]7358
7359
7360 </td> <!-- entry_type -->
7361
7362 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7363 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7364 </td>
7365
7366 <td class="entry_units">
7367 </td>
7368
7369 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7370 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7371 </td>
7372
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7373 <td class="entry_tags">
7374 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7375 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7376 </ul>
7377 </td>
7378
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7379 </tr>
7380 <tr class="entries_header">
7381 <th class="th_details" colspan="5">Details</th>
7382 </tr>
7383 <tr class="entry_cont">
7384 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7385 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
7386must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7387 </td>
7388 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7389
7390
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7391 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7392 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7393
7394
7395
7396
7397
7398 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7399 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7400 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7401 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7402 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7403 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7404
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7405 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7406
7407 <ul class="entry_type_enum">
7408 <li>
7409 <span class="entry_type_enum_name">FRONT</span>
7410 </li>
7411 <li>
7412 <span class="entry_type_enum_name">BACK</span>
7413 </li>
7414 </ul>
7415
7416 </td> <!-- entry_type -->
7417
7418 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7419 <p>Direction the camera faces relative to
7420device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7421 </td>
7422
7423 <td class="entry_units">
7424 </td>
7425
7426 <td class="entry_range">
7427 </td>
7428
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7429 <td class="entry_tags">
7430 </td>
7431
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7432 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7433
7434
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7435 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7436 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7437
7438
7439 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7440 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7441 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7442 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7443 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7444 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7445 <span class="entry_type_container">x</span>
7446
7447 <span class="entry_type_array">
7448 2
7449 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7450 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7451 <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]7452
7453
7454 </td> <!-- entry_type -->
7455
7456 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7457 <p>Relative angle of camera optical axis to the
7458perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7459 </td>
7460
7461 <td class="entry_units">
7462 </td>
7463
7464 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7465 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7466 </td>
7467
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7468 <td class="entry_tags">
7469 <ul class="entry_tags">
7470 <li><a href="#tag_ADV">ADV</a></li>
7471 </ul>
7472 </td>
7473
7474 </tr>
7475 <tr class="entries_header">
7476 <th class="th_details" colspan="5">Details</th>
7477 </tr>
7478 <tr class="entry_cont">
7479 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7480 <p>Examples:</p>
7481<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7482is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7483<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7484device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7485<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
7486the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7487<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7488direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7489 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7490 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7491
7492
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7493 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7494 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7495
7496
7497 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7498 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7499 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7500 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7501 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7502 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7503 <span class="entry_type_container">x</span>
7504
7505 <span class="entry_type_array">
7506 3, location in mm, in the sensor coordinate
7507 system
7508 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7509 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7510
7511
7512 </td> <!-- entry_type -->
7513
7514 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7515 <p>Coordinates of camera optical axis on
7516device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7517 </td>
7518
7519 <td class="entry_units">
7520 </td>
7521
7522 <td class="entry_range">
7523 </td>
7524
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7525 <td class="entry_tags">
7526 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7527 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7528 </ul>
7529 </td>
7530
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7531 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7532
7533
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7534 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7535 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7536
7537
7538
7539 <!-- end of kind -->
7540 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7541 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7542
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7543 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7544 <tr>
7545 <th class="th_name">Property Name</th>
7546 <th class="th_type">Type</th>
7547 <th class="th_description">Description</th>
7548 <th class="th_units">Units</th>
7549 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7550 <th class="th_tags">Tags</th>
7551 </tr>
7552 </thead>
7553
7554 <tbody>
7555
7556
7557
7558
7559
7560
7561
7562
7563
7564
7565 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7566 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7567 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7568 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7569 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7570 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7571
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7572 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7573
7574
7575 </td> <!-- entry_type -->
7576
7577 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7578 <p>The ratio of lens focal length to the effective
7579aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7580 </td>
7581
7582 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7583 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7584 </td>
7585
7586 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7587 <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]7588 </td>
7589
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7590 <td class="entry_tags">
7591 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7592 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7593 </ul>
7594 </td>
7595
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7596 </tr>
7597 <tr class="entries_header">
7598 <th class="th_details" colspan="5">Details</th>
7599 </tr>
7600 <tr class="entry_cont">
7601 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7602 <p>This will only be supported on the camera devices that
7603have variable aperture lens.<wbr/> The aperture value can only be
7604one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
7605<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
7606this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
7607<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
7608to achieve manual exposure control.<wbr/></p>
7609<p>The requested aperture value may take several frames to reach the
7610requested value; the camera device will report the current (intermediate)
7611aperture size in capture result metadata while the aperture is changing.<wbr/></p>
7612<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
7613the ON modes,<wbr/> this will be overridden by the camera device
7614auto-exposure algorithm,<wbr/> the overridden values are then provided
7615back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7616 </td>
7617 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7618
7619
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7620 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7621 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7622
7623
7624 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7625 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7626 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7627 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7628 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7629 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7630
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7631 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7632
7633
7634 </td> <!-- entry_type -->
7635
7636 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7637 <p>State of lens neutral density
7638filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7639 </td>
7640
7641 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7642 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7643 </td>
7644
7645 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7646 <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]7647 </td>
7648
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7649 <td class="entry_tags">
7650 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7651 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7652 </ul>
7653 </td>
7654
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7655 </tr>
7656 <tr class="entries_header">
7657 <th class="th_details" colspan="5">Details</th>
7658 </tr>
7659 <tr class="entry_cont">
7660 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7661 <p>Will not be supported on most devices.<wbr/> Can only
7662pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7663 </td>
7664 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7665
7666
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7667 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7668 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7669
7670
7671 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7672 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7673 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7674 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7675 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7676 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7677
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7678 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7679
7680
7681 </td> <!-- entry_type -->
7682
7683 <td class="entry_description">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame^]7684 <p>The current lens focal length; used for optical zoom.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7685 </td>
7686
7687 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7688 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7689 </td>
7690
7691 <td class="entry_range">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame^]7692 <p><a href="#static_android.lens.info.availableFocalLengths">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7693 </td>
7694
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7695 <td class="entry_tags">
7696 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7697 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7698 </ul>
7699 </td>
7700
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7701 </tr>
7702 <tr class="entries_header">
7703 <th class="th_details" colspan="5">Details</th>
7704 </tr>
7705 <tr class="entry_cont">
7706 <td class="entry_details" colspan="5">
Ruben Brunkac9bbb92014-01-15 18:39:35 -0800[diff] [blame^]7707 <p>This setting controls the physical focal length of the camera
7708device's lens.<wbr/> Changing the focal length changes the field of
7709view of the camera device,<wbr/> and is usually used for optical zoom.<wbr/></p>
7710<p>Like <a href="#controls_android.lens.focusDistance">android.<wbr/>lens.<wbr/>focus<wbr/>Distance</a> and <a href="#controls_android.lens.aperture">android.<wbr/>lens.<wbr/>aperture</a>,<wbr/> this
7711setting won't be applied instantaneously,<wbr/> and it may take several
7712frames before the lens can move to the requested focal length.<wbr/>
7713While the focal length is still changing,<wbr/> <a href="#dynamic_android.lens.state">android.<wbr/>lens.<wbr/>state</a> will
7714be set to MOVING.<wbr/></p>
7715<p>This is expected not to be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7716 </td>
7717 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7718
7719
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7720 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7721 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7722
7723
7724 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7725 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7726 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7727 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7728 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7729 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7730
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7731 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7732
7733
7734 </td> <!-- entry_type -->
7735
7736 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7737 <p>Distance to plane of sharpest focus,<wbr/>
7738measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7739 </td>
7740
7741 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7742 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7743 </td>
7744
7745 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7746 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7747 </td>
7748
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7749 <td class="entry_tags">
7750 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7751 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7752 </ul>
7753 </td>
7754
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7755 </tr>
7756 <tr class="entries_header">
7757 <th class="th_details" colspan="5">Details</th>
7758 </tr>
7759 <tr class="entry_cont">
7760 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7761 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7762 </td>
7763 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7764
7765
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7766 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7767 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7768
7769
7770 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7771 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7772 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7773 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7774 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7775 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7776 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7777
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7778 <span class="entry_type_array">
7779 2
7780 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7781 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7782 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7783
7784
7785 </td> <!-- entry_type -->
7786
7787 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7788 <p>The range of scene distances that are in
7789sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7790 </td>
7791
7792 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7793 pair of focus distances in diopters: (near,<wbr/>
7794 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7795 </td>
7796
7797 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7798 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7799 </td>
7800
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7801 <td class="entry_tags">
7802 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7803 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7804 </ul>
7805 </td>
7806
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7807 </tr>
7808 <tr class="entries_header">
7809 <th class="th_details" colspan="5">Details</th>
7810 </tr>
7811 <tr class="entry_cont">
7812 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7813 <p>If variable focus not supported,<wbr/> can still report
7814fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7815 </td>
7816 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7817
7818
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7819 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7820 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7821
7822
7823 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7824 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7825 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7826 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7827 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7828 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7829
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7830 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7831
7832 <ul class="entry_type_enum">
7833 <li>
7834 <span class="entry_type_enum_name">OFF</span>
7835 </li>
7836 <li>
7837 <span class="entry_type_enum_name">ON</span>
7838 <span class="entry_type_enum_optional">optional</span>
7839 </li>
7840 </ul>
7841
7842 </td> <!-- entry_type -->
7843
7844 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7845 <p>Whether optical image stabilization is
7846enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7847 </td>
7848
7849 <td class="entry_units">
7850 </td>
7851
7852 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7853 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7854 </td>
7855
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7856 <td class="entry_tags">
7857 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7858 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7859 </ul>
7860 </td>
7861
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7862 </tr>
7863 <tr class="entries_header">
7864 <th class="th_details" colspan="5">Details</th>
7865 </tr>
7866 <tr class="entry_cont">
7867 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7868 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7869 </td>
7870 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7871
7872
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7873 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7874 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7875
7876
7877 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7878 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7879 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7880 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7881 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7882 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7883
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7884 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7885
7886 <ul class="entry_type_enum">
7887 <li>
7888 <span class="entry_type_enum_name">STATIONARY</span>
7889 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7890 <li>
7891 <span class="entry_type_enum_name">MOVING</span>
7892 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7893 </ul>
7894
7895 </td> <!-- entry_type -->
7896
7897 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7898 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7899 </td>
7900
7901 <td class="entry_units">
7902 </td>
7903
7904 <td class="entry_range">
7905 </td>
7906
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7907 <td class="entry_tags">
7908 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7909 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7910 </ul>
7911 </td>
7912
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7913 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7914
7915
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7916 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7917 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7918
7919
7920
7921 <!-- end of kind -->
7922 </tbody>
7923
7924 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7925 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7926
7927
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7928 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7929
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7930 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7931 <tr>
7932 <th class="th_name">Property Name</th>
7933 <th class="th_type">Type</th>
7934 <th class="th_description">Description</th>
7935 <th class="th_units">Units</th>
7936 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7937 <th class="th_tags">Tags</th>
7938 </tr>
7939 </thead>
7940
7941 <tbody>
7942
7943
7944
7945
7946
7947
7948
7949
7950
7951
7952 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7953 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7954 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7955 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7956 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7957 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7958
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7959 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7960
7961 <ul class="entry_type_enum">
7962 <li>
7963 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7964 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7965 </li>
7966 <li>
7967 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7968 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
7969output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7970 </li>
7971 <li>
7972 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]7973 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
7974quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7975 </li>
7976 </ul>
7977
7978 </td> <!-- entry_type -->
7979
7980 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7981 <p>Mode of operation for the noise reduction
7982algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7983 </td>
7984
7985 <td class="entry_units">
7986 </td>
7987
7988 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7989 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7990 </td>
7991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7992 <td class="entry_tags">
7993 <ul class="entry_tags">
7994 <li><a href="#tag_V1">V1</a></li>
7995 </ul>
7996 </td>
7997
7998 </tr>
7999 <tr class="entries_header">
8000 <th class="th_details" colspan="5">Details</th>
8001 </tr>
8002 <tr class="entry_cont">
8003 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8004 <p>Noise filtering control.<wbr/> OFF means no noise reduction
8005will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]8006<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
8007will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
8008will use the highest-quality noise filtering algorithms,<wbr/>
8009even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8010slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8011 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8012 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8013
8014
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8015 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8016 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8017
8018
8019 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8020 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8021 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8022 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8023 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8024 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8025
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8026 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8027
8028
8029 </td> <!-- entry_type -->
8030
8031 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8032 <p>Control the amount of noise reduction
8033applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8034 </td>
8035
8036 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8037 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8038 </td>
8039
8040 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8041 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8042 </td>
8043
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8044 <td class="entry_tags">
8045 </td>
8046
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8047 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8048
8049
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8050 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8051 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8052
8053
8054
8055 <!-- end of kind -->
8056 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8057 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8058
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8059 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8060 <tr>
8061 <th class="th_name">Property Name</th>
8062 <th class="th_type">Type</th>
8063 <th class="th_description">Description</th>
8064 <th class="th_units">Units</th>
8065 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8066 <th class="th_tags">Tags</th>
8067 </tr>
8068 </thead>
8069
8070 <tbody>
8071
8072
8073
8074
8075
8076
8077
8078
8079
8080
8081 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8082 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8083 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8084 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8085 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8086 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8087
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8088 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8089
8090 <ul class="entry_type_enum">
8091 <li>
8092 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8093 <span class="entry_type_enum_notes"><p>No noise reduction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8094 </li>
8095 <li>
8096 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8097 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to sensor
8098output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8099 </li>
8100 <li>
8101 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8102 <span class="entry_type_enum_notes"><p>May slow down frame rate to provide highest
8103quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8104 </li>
8105 </ul>
8106
8107 </td> <!-- entry_type -->
8108
8109 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8110 <p>Mode of operation for the noise reduction
8111algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8112 </td>
8113
8114 <td class="entry_units">
8115 </td>
8116
8117 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8118 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8119 </td>
8120
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8121 <td class="entry_tags">
8122 <ul class="entry_tags">
8123 <li><a href="#tag_V1">V1</a></li>
8124 </ul>
8125 </td>
8126
8127 </tr>
8128 <tr class="entries_header">
8129 <th class="th_details" colspan="5">Details</th>
8130 </tr>
8131 <tr class="entry_cont">
8132 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8133 <p>Noise filtering control.<wbr/> OFF means no noise reduction
8134will be applied by the HAL.<wbr/></p>
Zhijun Hef90eeaf2014-01-16 12:13:35 -0800[diff] [blame]8135<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean camera device determined noise filtering
8136will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the camera device
8137will use the highest-quality noise filtering algorithms,<wbr/>
8138even if it slows down capture rate.<wbr/> FAST means the camera device should not
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8139slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8140 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8141 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8142
8143
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8144 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8145 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8146
8147
8148
8149 <!-- end of kind -->
8150 </tbody>
8151
8152 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8153 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8154
8155
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8156 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8157
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8158 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8159 <tr>
8160 <th class="th_name">Property Name</th>
8161 <th class="th_type">Type</th>
8162 <th class="th_description">Description</th>
8163 <th class="th_units">Units</th>
8164 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8165 <th class="th_tags">Tags</th>
8166 </tr>
8167 </thead>
8168
8169 <tbody>
8170
8171
8172
8173
8174
8175
8176
8177
8178
8179
8180 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8181 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8182 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8183 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8184 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8185 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8186
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8187 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8188
8189
8190 </td> <!-- entry_type -->
8191
8192 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8193 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8194scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8195region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
8196and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8197 </td>
8198
8199 <td class="entry_units">
8200 </td>
8201
8202 <td class="entry_range">
8203 </td>
8204
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8205 <td class="entry_tags">
8206 </td>
8207
8208 </tr>
8209 <tr class="entries_header">
8210 <th class="th_details" colspan="5">Details</th>
8211 </tr>
8212 <tr class="entry_cont">
8213 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8214 <p>Normalized coordinates refer to those in the
8215(-1000,<wbr/>1000) range mentioned in the
8216android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8217<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8218sensor array-relative coordinates for all region data.<wbr/> Does
8219not need to be listed in static metadata.<wbr/> Support will be
8220removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8221 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8222 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8223
8224
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8225 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8226 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8227
8228
8229 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8230 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8231 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8232 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8233 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8234 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8235
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8236 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8237
8238
8239 </td> <!-- entry_type -->
8240
8241 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8242 <p>If set to 1,<wbr/> then the camera service always
8243switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
8244trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8245 </td>
8246
8247 <td class="entry_units">
8248 </td>
8249
8250 <td class="entry_range">
8251 </td>
8252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8253 <td class="entry_tags">
8254 </td>
8255
8256 </tr>
8257 <tr class="entries_header">
8258 <th class="th_details" colspan="5">Details</th>
8259 </tr>
8260 <tr class="entry_cont">
8261 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8262 <p>HAL implementations should implement AF trigger
8263modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
8264CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
8265not need to be listed in static metadata.<wbr/> Support will be
8266removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8267 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8268 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8269
8270
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8271 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8272 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8273
8274
8275 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8276 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8277 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8278 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8279 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8280 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8281
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8282 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8283
8284
8285 </td> <!-- entry_type -->
8286
8287 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8288 <p>If set to 1,<wbr/> the camera service uses
8289CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
8290HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
8291shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8292 </td>
8293
8294 <td class="entry_units">
8295 </td>
8296
8297 <td class="entry_range">
8298 </td>
8299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8300 <td class="entry_tags">
8301 </td>
8302
8303 </tr>
8304 <tr class="entries_header">
8305 <th class="th_details" colspan="5">Details</th>
8306 </tr>
8307 <tr class="entry_cont">
8308 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8309 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8310to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8311zero-shutter-lag,<wbr/> instead of relying on an explicit
8312format setting.<wbr/> Does not need to be listed in static
8313metadata.<wbr/> Support will be removed in future versions of
8314camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8315 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8316 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8317
8318
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8319 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8320 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8321
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8322
8323 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8324 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8325 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8326 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8327 <td class="entry_type">
8328 <span class="entry_type_name">byte</span>
8329
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]8330 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8331
8332
8333 </td> <!-- entry_type -->
8334
8335 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8336 <p>If set to 1,<wbr/> the HAL will always split result
8337metadata for a single capture into multiple buffers,<wbr/>
8338returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8339 </td>
8340
8341 <td class="entry_units">
8342 </td>
8343
8344 <td class="entry_range">
8345 </td>
8346
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8347 <td class="entry_tags">
8348 </td>
8349
8350 </tr>
8351 <tr class="entries_header">
8352 <th class="th_details" colspan="5">Details</th>
8353 </tr>
8354 <tr class="entry_cont">
8355 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8356 <p>Does not need to be listed in static
8357metadata.<wbr/> Support for partial results will be reworked in
8358future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8359working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8360consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8361 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8362 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8363
8364
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8365 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8366 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8367
8368
8369
8370 <!-- end of kind -->
8371 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8372 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8373
8374 <thead class="entries_header">
8375 <tr>
8376 <th class="th_name">Property Name</th>
8377 <th class="th_type">Type</th>
8378 <th class="th_description">Description</th>
8379 <th class="th_units">Units</th>
8380 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8381 <th class="th_tags">Tags</th>
8382 </tr>
8383 </thead>
8384
8385 <tbody>
8386
8387
8388
8389
8390
8391
8392
8393
8394
8395
8396 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8397 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8398 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8399 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8400 <td class="entry_type">
8401 <span class="entry_type_name entry_type_name_enum">byte</span>
8402
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]8403 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8404
8405 <ul class="entry_type_enum">
8406 <li>
8407 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8408 <span class="entry_type_enum_notes"><p>The last or only metadata result buffer
8409for this capture.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8410 </li>
8411 <li>
8412 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8413 <span class="entry_type_enum_notes"><p>A partial buffer of result metadata for this
8414capture.<wbr/> More result buffers for this capture will be sent
8415by the HAL,<wbr/> the last of which will be marked
8416FINAL.<wbr/></p></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8417 </li>
8418 </ul>
8419
8420 </td> <!-- entry_type -->
8421
8422 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8423 <p>Whether a result given to the framework is the
8424final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8425subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8426values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8427 </td>
8428
8429 <td class="entry_units">
8430 </td>
8431
8432 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8433 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8434 </td>
8435
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8436 <td class="entry_tags">
8437 </td>
8438
8439 </tr>
8440 <tr class="entries_header">
8441 <th class="th_details" colspan="5">Details</th>
8442 </tr>
8443 <tr class="entry_cont">
8444 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8445 <p>The entries in the result metadata buffers for a
8446single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8447FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8448requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
8449always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
8450before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
8451in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
8452capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
8453only 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]8454 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8455 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8456
8457
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8458 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8459 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]8460
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8461
8462
8463 <!-- end of kind -->
8464 </tbody>
8465
8466 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8467 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8468
8469
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8470 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8471
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8472 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8473 <tr>
8474 <th class="th_name">Property Name</th>
8475 <th class="th_type">Type</th>
8476 <th class="th_description">Description</th>
8477 <th class="th_units">Units</th>
8478 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8479 <th class="th_tags">Tags</th>
8480 </tr>
8481 </thead>
8482
8483 <tbody>
8484
8485
8486
8487
8488
8489
8490
8491
8492
8493
8494 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8495 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8496 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8497 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8498 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8499 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8500
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8501 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8502
8503
8504 </td> <!-- entry_type -->
8505
8506 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8507 <p>A frame counter set by the framework.<wbr/> Must
8508be maintained unchanged in output frame.<wbr/> This value monotonically
8509increases with every new result (that is,<wbr/> each new result has a unique
8510frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8511 </td>
8512
8513 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8514 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8515 </td>
8516
8517 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8518 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8519 </td>
8520
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8521 <td class="entry_tags">
8522 </td>
8523
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8524 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8525
8526
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8527 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8528 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8529
8530
8531 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8532 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8533 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8534 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8535 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8536 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8537
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8538 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8539
8540
8541 </td> <!-- entry_type -->
8542
8543 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8544 <p>An application-specified ID for the current
8545request.<wbr/> Must be maintained unchanged in output
8546frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8547 </td>
8548
8549 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8550 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8551 </td>
8552
8553 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8554 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8555 </td>
8556
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8557 <td class="entry_tags">
8558 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8559 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8560 </ul>
8561 </td>
8562
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8563 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8564
8565
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8566 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8567 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8568
8569
8570 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8571 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8572 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8573 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8574 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8575 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8576 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8577
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8578 <span class="entry_type_array">
8579 n
8580 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8581 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8582
8583
8584 </td> <!-- entry_type -->
8585
8586 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8587 <p>List which camera reprocess stream is used
8588for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8589 </td>
8590
8591 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8592 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8593 </td>
8594
8595 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8596 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
8597reprocess stream ID.<wbr/></p>
8598<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
8599reprocess streams may be included in a single request; they
8600must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8601 </td>
8602
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8603 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8604 <ul class="entry_tags">
8605 <li><a href="#tag_HAL2">HAL2</a></li>
8606 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8607 </td>
8608
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8609 </tr>
8610 <tr class="entries_header">
8611 <th class="th_details" colspan="5">Details</th>
8612 </tr>
8613 <tr class="entry_cont">
8614 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8615 <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]8616REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8617 </td>
8618 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8619
8620
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8621 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8622 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8623
8624
8625 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8626 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8627 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8628 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8629 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8630 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8631
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8632 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8633
8634 <ul class="entry_type_enum">
8635 <li>
8636 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8637 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
8638for application-bound buffer data.<wbr/> If no
8639application-bound streams exist,<wbr/> no frame should be
8640placed in the output frame queue.<wbr/> If such streams
8641exist,<wbr/> a frame should be placed on the output queue
8642with null metadata but with the necessary output buffer
8643information.<wbr/> Timestamp information should still be
8644included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8645 </li>
8646 <li>
8647 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8648 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
8649only be produced if they are separately
8650enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8651 </li>
8652 </ul>
8653
8654 </td> <!-- entry_type -->
8655
8656 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8657 <p>How much metadata to produce on
8658output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8659 </td>
8660
8661 <td class="entry_units">
8662 </td>
8663
8664 <td class="entry_range">
8665 </td>
8666
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8667 <td class="entry_tags">
8668 </td>
8669
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8670 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8671
8672
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8673 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8674 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8675
8676
8677 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8678 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8679 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8680 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8681 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8682 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8683 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8684
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8685 <span class="entry_type_array">
8686 n
8687 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8688 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8689
8690
8691 </td> <!-- entry_type -->
8692
8693 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8694 <p>Lists which camera output streams image data
8695from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8696 </td>
8697
8698 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8699 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8700 </td>
8701
8702 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8703 <p>List must only include streams that have been
8704created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8705 </td>
8706
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8707 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8708 <ul class="entry_tags">
8709 <li><a href="#tag_HAL2">HAL2</a></li>
8710 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8711 </td>
8712
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8713 </tr>
8714 <tr class="entries_header">
8715 <th class="th_details" colspan="5">Details</th>
8716 </tr>
8717 <tr class="entry_cont">
8718 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8719 <p>If no output streams are listed,<wbr/> then the image
8720data should simply be discarded.<wbr/> The image data must
8721still be captured for metadata and statistics production,<wbr/>
8722and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8723 </td>
8724 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8725
8726
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8727 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8728 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8729
8730
8731 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8732 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8733 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8734 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8735 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8736 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8737
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8738 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8739
8740 <ul class="entry_type_enum">
8741 <li>
8742 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8743 <span class="entry_type_enum_notes"><p>Capture a new image from the imaging hardware,<wbr/>
8744and process it according to the
8745settings</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8746 </li>
8747 <li>
8748 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]8749 <span class="entry_type_enum_notes"><p>Process previously captured data; the
8750android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
8751source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
8752needed for reprocessing with [RP]</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8753 </li>
8754 </ul>
8755
8756 </td> <!-- entry_type -->
8757
8758 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8759 <p>The type of the request; either CAPTURE or
8760REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8761 </td>
8762
8763 <td class="entry_units">
8764 </td>
8765
8766 <td class="entry_range">
8767 </td>
8768
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8769 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8770 <ul class="entry_tags">
8771 <li><a href="#tag_HAL2">HAL2</a></li>
8772 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8773 </td>
8774
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8775 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8776
8777
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8778 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8779 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8780
8781
8782
8783 <!-- end of kind -->
8784 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8785 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8786
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8787 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8788 <tr>
8789 <th class="th_name">Property Name</th>
8790 <th class="th_type">Type</th>
8791 <th class="th_description">Description</th>
8792 <th class="th_units">Units</th>
8793 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8794 <th class="th_tags">Tags</th>
8795 </tr>
8796 </thead>
8797
8798 <tbody>
8799
8800
8801
8802
8803
8804
8805
8806
8807
8808
8809 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8810 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8811 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8812 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8813 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8814 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8815 <span class="entry_type_container">x</span>
8816
8817 <span class="entry_type_array">
8818 3
8819 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8820 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8821
8822
8823 </td> <!-- entry_type -->
8824
8825 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8826 <p>How many output streams can be allocated at
8827the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8828 </td>
8829
8830 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8831 The number of raw sensor streams; the number of
8832 processed,<wbr/> uncompressed streams; and the number of
8833 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8834 </td>
8835
8836 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8837 <p>&gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8838for processed,<wbr/> uncompressed streams</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8839 </td>
8840
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8841 <td class="entry_tags">
8842 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8843 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8844 </ul>
8845 </td>
8846
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8847 </tr>
8848 <tr class="entries_header">
8849 <th class="th_details" colspan="5">Details</th>
8850 </tr>
8851 <tr class="entry_cont">
8852 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8853 <p>Video snapshot with preview callbacks requires 3
8854processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8855one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8856 </td>
8857 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8858
8859
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8860 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8861 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8862
8863
8864 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8865 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8866 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8867 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8868 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8869 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8870 <span class="entry_type_container">x</span>
8871
8872 <span class="entry_type_array">
8873 1
8874 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8875 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8876
8877
8878 </td> <!-- entry_type -->
8879
8880 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8881 <p>How many reprocessing streams of any type
8882can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8883 </td>
8884
8885 <td class="entry_units">
8886 </td>
8887
8888 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8889 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8890 </td>
8891
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8892 <td class="entry_tags">
8893 </td>
8894
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8895 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8896
8897
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8898 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8899 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8900
8901
8902
8903 <!-- end of kind -->
8904 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8905 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8906
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8907 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8908 <tr>
8909 <th class="th_name">Property Name</th>
8910 <th class="th_type">Type</th>
8911 <th class="th_description">Description</th>
8912 <th class="th_units">Units</th>
8913 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8914 <th class="th_tags">Tags</th>
8915 </tr>
8916 </thead>
8917
8918 <tbody>
8919
8920
8921
8922
8923
8924
8925
8926
8927
8928
8929 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8930 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8931 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8932 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8933 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8934 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8935
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8936 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8937
8938
8939 </td> <!-- entry_type -->
8940
8941 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8942 <p>A frame counter set by the framework.<wbr/> This value monotonically
8943increases with every new result (that is,<wbr/> each new result has a unique
8944frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8945 </td>
8946
8947 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8948 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8949 </td>
8950
8951 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8952 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8953 </td>
8954
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8955 <td class="entry_tags">
8956 </td>
8957
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8958 </tr>
8959 <tr class="entries_header">
8960 <th class="th_details" colspan="5">Details</th>
8961 </tr>
8962 <tr class="entry_cont">
8963 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8964 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8965 </td>
8966 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8967
8968
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8969 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8970 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8971
8972
8973 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8974 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8975 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8976 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8977 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8978 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8979
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8980 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8981
8982
8983 </td> <!-- entry_type -->
8984
8985 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8986 <p>An application-specified ID for the current
8987request.<wbr/> Must be maintained unchanged in output
8988frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8989 </td>
8990
8991 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8992 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8993 </td>
8994
8995 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8996 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8997 </td>
8998
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8999 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9000 <ul class="entry_tags">
9001 <li><a href="#tag_V1">V1</a></li>
9002 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9003 </td>
9004
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9005 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9006
9007
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9008 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9009 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9010
9011
9012 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9013 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9014 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9015 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9016 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9017 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9018
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9019 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9020
9021 <ul class="entry_type_enum">
9022 <li>
9023 <span class="entry_type_enum_name">NONE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9024 <span class="entry_type_enum_notes"><p>No metadata should be produced on output,<wbr/> except
9025for application-bound buffer data.<wbr/> If no
9026application-bound streams exist,<wbr/> no frame should be
9027placed in the output frame queue.<wbr/> If such streams
9028exist,<wbr/> a frame should be placed on the output queue
9029with null metadata but with the necessary output buffer
9030information.<wbr/> Timestamp information should still be
9031included with any output stream buffers</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9032 </li>
9033 <li>
9034 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9035 <span class="entry_type_enum_notes"><p>All metadata should be produced.<wbr/> Statistics will
9036only be produced if they are separately
9037enabled</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9038 </li>
9039 </ul>
9040
9041 </td> <!-- entry_type -->
9042
9043 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9044 <p>How much metadata to produce on
9045output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9046 </td>
9047
9048 <td class="entry_units">
9049 </td>
9050
9051 <td class="entry_range">
9052 </td>
9053
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9054 <td class="entry_tags">
9055 </td>
9056
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9057 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9058
9059
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9060 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9061 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9062
9063
9064 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9065 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9066 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9067 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9068 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]9069 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9070 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9071
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9072 <span class="entry_type_array">
9073 n
9074 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9075 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9076
9077
9078 </td> <!-- entry_type -->
9079
9080 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9081 <p>Lists which camera output streams image data
9082from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9083 </td>
9084
9085 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9086 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9087 </td>
9088
9089 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9090 <p>List must only include streams that have been
9091created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9092 </td>
9093
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9094 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]9095 <ul class="entry_tags">
9096 <li><a href="#tag_HAL2">HAL2</a></li>
9097 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9098 </td>
9099
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9100 </tr>
9101 <tr class="entries_header">
9102 <th class="th_details" colspan="5">Details</th>
9103 </tr>
9104 <tr class="entry_cont">
9105 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9106 <p>If no output streams are listed,<wbr/> then the image
9107data should simply be discarded.<wbr/> The image data must
9108still be captured for metadata and statistics production,<wbr/>
9109and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9110 </td>
9111 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9112
9113
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9114 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9115 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9116
9117
9118
9119 <!-- end of kind -->
9120 </tbody>
9121
9122 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9123 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9124
9125
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9126 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9127
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9128 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9129 <tr>
9130 <th class="th_name">Property Name</th>
9131 <th class="th_type">Type</th>
9132 <th class="th_description">Description</th>
9133 <th class="th_units">Units</th>
9134 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9135 <th class="th_tags">Tags</th>
9136 </tr>
9137 </thead>
9138
9139 <tbody>
9140
9141
9142
9143
9144
9145
9146
9147
9148
9149
9150 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9151 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9152 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9153 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9154 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9155 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9156 <span class="entry_type_container">x</span>
9157
9158 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9159 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9160 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9161 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9162
9163
9164 </td> <!-- entry_type -->
9165
9166 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9167 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9168<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9169(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9170output.<wbr/> Each stream must use this rectangle to produce its
9171output,<wbr/> cropping to a smaller region if necessary to
9172maintain the stream's aspect ratio.<wbr/></p>
9173<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9174 </td>
9175
9176 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9177 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9178 in pixels; (0,<wbr/>0) is top-left corner of
9179 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9180 </td>
9181
9182 <td class="entry_range">
9183 </td>
9184
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9185 <td class="entry_tags">
9186 <ul class="entry_tags">
9187 <li><a href="#tag_BC">BC</a></li>
9188 </ul>
9189 </td>
9190
9191 </tr>
9192 <tr class="entries_header">
9193 <th class="th_details" colspan="5">Details</th>
9194 </tr>
9195 <tr class="entry_cont">
9196 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9197 <p>Any additional per-stream cropping must be done to
9198maximize the final pixel area of the stream.<wbr/></p>
9199<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9200ratio,<wbr/> then 4:3 streams should use the exact crop
9201region.<wbr/> 16:9 streams should further crop vertically
9202(letterbox).<wbr/></p>
9203<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9204outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9205streams should match exactly.<wbr/> These additional crops must
9206be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9207<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9208times,<wbr/> no matter what the relative aspect ratios of the
9209crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9210corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9211larger than active pixel array.<wbr/> Width and height may be
9212rounded to nearest larger supportable width,<wbr/> especially
9213for raw output,<wbr/> where only a few fixed scales may be
9214possible.<wbr/> The width and height of the crop region cannot
9215be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9216android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9217activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9218respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9219 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9220 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9221
9222
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9223 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9224 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9225
9226
9227
9228 <!-- end of kind -->
9229 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9230 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9231
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9232 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9233 <tr>
9234 <th class="th_name">Property Name</th>
9235 <th class="th_type">Type</th>
9236 <th class="th_description">Description</th>
9237 <th class="th_units">Units</th>
9238 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9239 <th class="th_tags">Tags</th>
9240 </tr>
9241 </thead>
9242
9243 <tbody>
9244
9245
9246
9247
9248
9249
9250
9251
9252
9253
9254 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9255 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9256 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9257 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9258 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9259 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9260 <span class="entry_type_container">x</span>
9261
9262 <span class="entry_type_array">
9263 n
9264 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]9265 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9266 <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]9267
9268 <ul class="entry_type_enum">
9269 <li>
9270 <span class="entry_type_enum_name">RAW_SENSOR</span>
9271 <span class="entry_type_enum_value">0x20</span>
9272 </li>
9273 <li>
9274 <span class="entry_type_enum_name">YV12</span>
9275 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9276 <span class="entry_type_enum_notes"><p>YCrCb 4:2:0 Planar</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9277 </li>
9278 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9279 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9280 <span class="entry_type_enum_value">0x11</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9281 <span class="entry_type_enum_notes"><p>NV21</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9282 </li>
9283 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9284 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
9285 <span class="entry_type_enum_value">0x22</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9286 <span class="entry_type_enum_notes"><p>Hal Implementation Defined</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9287 </li>
9288 <li>
9289 <span class="entry_type_enum_name">YCbCr_420_888</span>
9290 <span class="entry_type_enum_value">0x23</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9291 <span class="entry_type_enum_notes"><p>Flexible YUV420 Format</p></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]9292 </li>
9293 <li>
9294 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9295 <span class="entry_type_enum_value">0x21</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]9296 <span class="entry_type_enum_notes"><p>JPEG</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9297 </li>
9298 </ul>
9299
9300 </td> <!-- entry_type -->
9301
9302 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9303 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9304 </td>
9305
9306 <td class="entry_units">
9307 </td>
9308
9309 <td class="entry_range">
9310 </td>
9311
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9312 <td class="entry_tags">
9313 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9314 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9315 </ul>
9316 </td>
9317
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9318 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9319
9320
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9321 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9322 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9323
9324
9325 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9326 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9327 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9328 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9329 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9330 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9331 <span class="entry_type_container">x</span>
9332
9333 <span class="entry_type_array">
9334 n
9335 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9336 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9337
9338
9339 </td> <!-- entry_type -->
9340
9341 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9342 <p>The minimum frame duration that is supported
9343for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9344correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9345stream is active and captured in a burst,<wbr/> with all
9346processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9347 </td>
9348
9349 <td class="entry_units">
9350 </td>
9351
9352 <td class="entry_range">
9353 </td>
9354
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9355 <td class="entry_tags">
9356 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9357 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9358 </ul>
9359 </td>
9360
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9361 </tr>
9362 <tr class="entries_header">
9363 <th class="th_details" colspan="5">Details</th>
9364 </tr>
9365 <tr class="entry_cont">
9366 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9367 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9368frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9369durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9370 </td>
9371 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9372
9373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9374 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9375 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9376
9377
9378 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9379 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9380 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9381 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9382 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9383 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9384 <span class="entry_type_container">x</span>
9385
9386 <span class="entry_type_array">
9387 n x 2
9388 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9389 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9390
9391
9392 </td> <!-- entry_type -->
9393
9394 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9395 <p>The resolutions available for output from
9396the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9397 </td>
9398
9399 <td class="entry_units">
9400 </td>
9401
9402 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9403 <p>Must include: - sensor maximum resolution Should
9404include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9405 </td>
9406
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9407 <td class="entry_tags">
9408 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9409 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9410 </ul>
9411 </td>
9412
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9413 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9414
9415
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9416 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9417 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9418
9419
9420 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9421 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9422 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9423 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9424 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]9425 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9426
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9427 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9428
9429
9430 </td> <!-- entry_type -->
9431
9432 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9433 <p>The maximum ratio between active area width
9434and crop region width,<wbr/> or between active area height and
9435crop region height,<wbr/> if the crop region height is larger
9436than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9437 </td>
9438
9439 <td class="entry_units">
9440 </td>
9441
9442 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9443 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9444 </td>
9445
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9446 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]9447 <ul class="entry_tags">
9448 <li><a href="#tag_BC">BC</a></li>
9449 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9450 </td>
9451
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9452 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9453
9454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9455 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9456 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9457
9458
9459 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9460 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9461 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9462 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9463 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9464 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9465 <span class="entry_type_container">x</span>
9466
9467 <span class="entry_type_array">
9468 n
9469 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9470 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9471
9472
9473 </td> <!-- entry_type -->
9474
9475 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9476 <p>The minimum frame duration that is supported
9477for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9478correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9479stream is active,<wbr/> with all processing set to
9480FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9481 </td>
9482
9483 <td class="entry_units">
9484 </td>
9485
9486 <td class="entry_range">
9487 </td>
9488
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9489 <td class="entry_tags">
9490 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9491 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9492 </ul>
9493 </td>
9494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9495 </tr>
9496 <tr class="entries_header">
9497 <th class="th_details" colspan="5">Details</th>
9498 </tr>
9499 <tr class="entry_cont">
9500 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9501 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9502frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9503durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9504 </td>
9505 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9506
9507
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9508 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9509 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9510
9511
9512 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9513 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9514 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9515 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9516 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9517 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9518 <span class="entry_type_container">x</span>
9519
9520 <span class="entry_type_array">
9521 n x 2
9522 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9523 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9524
9525
9526 </td> <!-- entry_type -->
9527
9528 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9529 <p>The resolutions available for use with
9530processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
9531platform opaque YUV/<wbr/>RGB streams to the GPU or video
9532encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9533 </td>
9534
9535 <td class="entry_units">
9536 </td>
9537
9538 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9539 <p>Must include: - sensor maximum resolution -
9540standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
9541resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9542 </td>
9543
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9544 <td class="entry_tags">
9545 <ul class="entry_tags">
9546 <li><a href="#tag_BC">BC</a></li>
9547 </ul>
9548 </td>
9549
9550 </tr>
9551 <tr class="entries_header">
9552 <th class="th_details" colspan="5">Details</th>
9553 </tr>
9554 <tr class="entry_cont">
9555 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9556 <p>The actual supported resolution list may be limited by
9557consumer end points for different use cases.<wbr/> For example,<wbr/> for
9558recording use case,<wbr/> the largest supported resolution may be
9559limited by max supported size from encoder,<wbr/> for preview use
9560case,<wbr/> the largest supported resolution may be limited by max
9561resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9562 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9563 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9564
9565
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9566 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9567 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9568
9569
9570 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9571 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9572 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9573 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9574 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9575 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9576 <span class="entry_type_container">x</span>
9577
9578 <span class="entry_type_array">
9579 n
9580 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9581 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9582
9583
9584 </td> <!-- entry_type -->
9585
9586 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9587 <p>The minimum frame duration that is supported
9588for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9589correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9590is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9591 </td>
9592
9593 <td class="entry_units">
9594 </td>
9595
9596 <td class="entry_range">
9597 </td>
9598
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9599 <td class="entry_tags">
9600 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9601 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9602 </ul>
9603 </td>
9604
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9605 </tr>
9606 <tr class="entries_header">
9607 <th class="th_details" colspan="5">Details</th>
9608 </tr>
9609 <tr class="entry_cont">
9610 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9611 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9612frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9613durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9614 </td>
9615 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9616
9617
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9618 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9619 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9620
9621
9622 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9623 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9624 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9625 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9626 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9627 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9628 <span class="entry_type_container">x</span>
9629
9630 <span class="entry_type_array">
9631 n x 2
9632 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9633 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9634
9635
9636 </td> <!-- entry_type -->
9637
9638 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9639 <p>The resolutions available for use with raw
9640sensor output streams,<wbr/> listed as width,<wbr/>
9641height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9642 </td>
9643
9644 <td class="entry_units">
9645 </td>
9646
9647 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9648 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9649 </td>
9650
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9651 <td class="entry_tags">
9652 </td>
9653
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9654 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9655
9656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9657 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9658 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9659
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9660
9661
9662 <!-- end of kind -->
9663 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9664 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9665
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9666 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9667 <tr>
9668 <th class="th_name">Property Name</th>
9669 <th class="th_type">Type</th>
9670 <th class="th_description">Description</th>
9671 <th class="th_units">Units</th>
9672 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9673 <th class="th_tags">Tags</th>
9674 </tr>
9675 </thead>
9676
9677 <tbody>
9678
9679
9680
9681
9682
9683
9684
9685
9686
9687
9688 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9689 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9690 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9691 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9692 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9693 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9694 <span class="entry_type_container">x</span>
9695
9696 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9697 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9698 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9699 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9700
9701
9702 </td> <!-- entry_type -->
9703
9704 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9705 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9706<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9707(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9708output.<wbr/> Each stream must use this rectangle to produce its
9709output,<wbr/> cropping to a smaller region if necessary to
9710maintain the stream's aspect ratio.<wbr/></p>
9711<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9712 </td>
9713
9714 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9715 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9716 in pixels; (0,<wbr/>0) is top-left corner of
9717 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9718 </td>
9719
9720 <td class="entry_range">
9721 </td>
9722
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9723 <td class="entry_tags">
9724 <ul class="entry_tags">
9725 <li><a href="#tag_BC">BC</a></li>
9726 </ul>
9727 </td>
9728
9729 </tr>
9730 <tr class="entries_header">
9731 <th class="th_details" colspan="5">Details</th>
9732 </tr>
9733 <tr class="entry_cont">
9734 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9735 <p>Any additional per-stream cropping must be done to
9736maximize the final pixel area of the stream.<wbr/></p>
9737<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9738ratio,<wbr/> then 4:3 streams should use the exact crop
9739region.<wbr/> 16:9 streams should further crop vertically
9740(letterbox).<wbr/></p>
9741<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9742outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9743streams should match exactly.<wbr/> These additional crops must
9744be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9745<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9746times,<wbr/> no matter what the relative aspect ratios of the
9747crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9748corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9749larger than active pixel array.<wbr/> Width and height may be
9750rounded to nearest larger supportable width,<wbr/> especially
9751for raw output,<wbr/> where only a few fixed scales may be
9752possible.<wbr/> The width and height of the crop region cannot
9753be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9754android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9755activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9756respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9757 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9758 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9759
9760
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9761 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9762 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9763
9764
9765
9766 <!-- end of kind -->
9767 </tbody>
9768
9769 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9770 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9771
9772
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9773 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9774
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9775 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9776 <tr>
9777 <th class="th_name">Property Name</th>
9778 <th class="th_type">Type</th>
9779 <th class="th_description">Description</th>
9780 <th class="th_units">Units</th>
9781 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9782 <th class="th_tags">Tags</th>
9783 </tr>
9784 </thead>
9785
9786 <tbody>
9787
9788
9789
9790
9791
9792
9793
9794
9795
9796
9797 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9798 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9799 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9800 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9801 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9802 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9803
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9804 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9805
9806
9807 </td> <!-- entry_type -->
9808
9809 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9810 <p>Duration each pixel is exposed to
9811light.<wbr/></p>
9812<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
9813duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9814 </td>
9815
9816 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9817 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9818 </td>
9819
9820 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9821 <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]9822 </td>
9823
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9824 <td class="entry_tags">
9825 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9826 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9827 </ul>
9828 </td>
9829
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9830 </tr>
9831 <tr class="entries_header">
9832 <th class="th_details" colspan="5">Details</th>
9833 </tr>
9834 <tr class="entry_cont">
9835 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9836 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9837 </td>
9838 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9839
9840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9841 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9842 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9843
9844
9845 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9846 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9847 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9848 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9849 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9850 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9851
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9852 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9853
9854
9855 </td> <!-- entry_type -->
9856
9857 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9858 <p>Duration from start of frame exposure to
9859start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9860 </td>
9861
9862 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9863 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9864 </td>
9865
9866 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9867 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9868android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9869 </td>
9870
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9871 <td class="entry_tags">
9872 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9873 <li><a href="#tag_V1">V1</a></li>
9874 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9875 </ul>
9876 </td>
9877
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9878 </tr>
9879 <tr class="entries_header">
9880 <th class="th_details" colspan="5">Details</th>
9881 </tr>
9882 <tr class="entry_cont">
9883 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9884 <p>Exposure time has priority,<wbr/> so duration is set to
9885max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9886 </td>
9887 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9888
9889
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9890 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9891 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9892
9893
9894 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9895 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9896 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9897 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9898 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9899 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9900
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9901 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9902
9903
9904 </td> <!-- entry_type -->
9905
9906 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9907 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9908implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9909below 'maximum analog sensitivity'.<wbr/></p>
9910<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9911gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9912 </td>
9913
9914 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9915 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9916 </td>
9917
9918 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9919 <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]9920 </td>
9921
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9922 <td class="entry_tags">
9923 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9924 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9925 </ul>
9926 </td>
9927
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9928 </tr>
9929 <tr class="entries_header">
9930 <th class="th_details" colspan="5">Details</th>
9931 </tr>
9932 <tr class="entry_cont">
9933 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9934 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9935 </td>
9936 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9937
9938
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9939 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9940 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9941
9942
9943
9944 <!-- end of kind -->
9945 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9946 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9947
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9948 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9949 <tr>
9950 <th class="th_name">Property Name</th>
9951 <th class="th_type">Type</th>
9952 <th class="th_description">Description</th>
9953 <th class="th_units">Units</th>
9954 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9955 <th class="th_tags">Tags</th>
9956 </tr>
9957 </thead>
9958
9959 <tbody>
9960
9961
9962
9963
9964
9965
9966
9967
9968
9969
9970
9971
9972 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9973 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9974 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9975 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9976 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9977 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9978 <span class="entry_type_container">x</span>
9979
9980 <span class="entry_type_array">
9981 4
9982 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9983 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9984 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9985
9986
9987 </td> <!-- entry_type -->
9988
9989 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9990 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9991active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9992pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9993 </td>
9994
9995 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9996 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9997 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9998 </td>
9999
10000 <td class="entry_range">
10001 </td>
10002
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10003 <td class="entry_tags">
10004 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10005 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10006 </ul>
10007 </td>
10008
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10009 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10010
10011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10012 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10013 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10014
10015
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10016 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10017 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10018 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10019 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10020 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10021 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10022 <span class="entry_type_container">x</span>
10023
10024 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10025 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10026 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10027 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10028 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10029
10030
10031 </td> <!-- entry_type -->
10032
10033 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10034 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10035 </td>
10036
10037 <td class="entry_units">
10038 </td>
10039
10040 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10041 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10042 </td>
10043
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10044 <td class="entry_tags">
10045 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10046 <li><a href="#tag_BC">BC</a></li>
10047 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10048 </ul>
10049 </td>
10050
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10051 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10052
10053
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10054 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10055 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10056
10057
10058 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10059 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10060 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10061 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10062 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10063 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10064
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10065 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10066
10067 <ul class="entry_type_enum">
10068 <li>
10069 <span class="entry_type_enum_name">RGGB</span>
10070 </li>
10071 <li>
10072 <span class="entry_type_enum_name">GRBG</span>
10073 </li>
10074 <li>
10075 <span class="entry_type_enum_name">GBRG</span>
10076 </li>
10077 <li>
10078 <span class="entry_type_enum_name">BGGR</span>
10079 </li>
10080 <li>
10081 <span class="entry_type_enum_name">RGB</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10082 <span class="entry_type_enum_notes"><p>Sensor is not Bayer; output has 3 16-bit
10083values for each pixel,<wbr/> instead of just 1 16-bit value
10084per pixel.<wbr/></p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10085 </li>
10086 </ul>
10087
10088 </td> <!-- entry_type -->
10089
10090 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10091 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10092represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10093the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10094 </td>
10095
10096 <td class="entry_units">
10097 </td>
10098
10099 <td class="entry_range">
10100 </td>
10101
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10102 <td class="entry_tags">
10103 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10104 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10105 </ul>
10106 </td>
10107
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10108 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10109
10110
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10111 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10112 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10113
10114
10115 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10116 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10117 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10118 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10119 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10120 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10121 <span class="entry_type_container">x</span>
10122
10123 <span class="entry_type_array">
10124 2
10125 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10126 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10127 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10128
10129
10130 </td> <!-- entry_type -->
10131
10132 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10133 <p>Range of valid exposure
10134times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10135 </td>
10136
10137 <td class="entry_units">
10138 </td>
10139
10140 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10141 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
10142sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10143 </td>
10144
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10145 <td class="entry_tags">
10146 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10147 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10148 </ul>
10149 </td>
10150
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10151 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10152
10153
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10154 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10155 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10156
10157
10158 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10159 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10160 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10161 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10162 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10163 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10164
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10165 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10166
10167
10168 </td> <!-- entry_type -->
10169
10170 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10171 <p>Maximum possible frame duration (minimum frame
10172rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10173 </td>
10174
10175 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10176 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10177 </td>
10178
10179 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10180 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10181 </td>
10182
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10183 <td class="entry_tags">
10184 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10185 <li><a href="#tag_BC">BC</a></li>
10186 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10187 </ul>
10188 </td>
10189
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10190 </tr>
10191 <tr class="entries_header">
10192 <th class="th_details" colspan="5">Details</th>
10193 </tr>
10194 <tr class="entry_cont">
10195 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10196 <p>Minimum duration is a function of resolution,<wbr/>
10197processing settings.<wbr/> See
10198android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
10199android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10200<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]10201 </td>
10202 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10203
10204
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10205 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10206 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10207
10208
10209 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10210 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10211 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10212 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10213 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10214 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10215 <span class="entry_type_container">x</span>
10216
10217 <span class="entry_type_array">
10218 2
10219 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]10220 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10221 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10222
10223
10224 </td> <!-- entry_type -->
10225
10226 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10227 <p>The physical dimensions of the full pixel
10228array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10229 </td>
10230
10231 <td class="entry_units">
10232 </td>
10233
10234 <td class="entry_range">
10235 </td>
10236
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10237 <td class="entry_tags">
10238 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10239 <li><a href="#tag_V1">V1</a></li>
10240 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10241 </ul>
10242 </td>
10243
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10244 </tr>
10245 <tr class="entries_header">
10246 <th class="th_details" colspan="5">Details</th>
10247 </tr>
10248 <tr class="entry_cont">
10249 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10250 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10251 </td>
10252 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10253
10254
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10255 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10256 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10257
10258
10259 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10260 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10261 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10262 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10263 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10264 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10265 <span class="entry_type_container">x</span>
10266
10267 <span class="entry_type_array">
10268 2
10269 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10270 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10271
10272
10273 </td> <!-- entry_type -->
10274
10275 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10276 <p>Dimensions of full pixel array,<wbr/> possibly
10277including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10278 </td>
10279
10280 <td class="entry_units">
10281 </td>
10282
10283 <td class="entry_range">
10284 </td>
10285
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10286 <td class="entry_tags">
10287 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10288 <li><a href="#tag_DNG">DNG</a></li>
10289 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10290 </ul>
10291 </td>
10292
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10293 </tr>
10294 <tr class="entries_header">
10295 <th class="th_details" colspan="5">Details</th>
10296 </tr>
10297 <tr class="entry_cont">
10298 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10299 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10300match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10301android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10302 </td>
10303 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10304
10305
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10306 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10307 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10308
10309
10310 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10311 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10312 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10313 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10314 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10315 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10316
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10317 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10318
10319
10320 </td> <!-- entry_type -->
10321
10322 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10323 <p>Maximum raw value output by
10324sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10325 </td>
10326
10327 <td class="entry_units">
10328 </td>
10329
10330 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10331 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10332 </td>
10333
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10334 <td class="entry_tags">
10335 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10336 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10337 </ul>
10338 </td>
10339
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10340 </tr>
10341 <tr class="entries_header">
10342 <th class="th_details" colspan="5">Details</th>
10343 </tr>
10344 <tr class="entry_cont">
10345 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10346 <p>Defines sensor bit depth (10-14 bits is
10347expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10348 </td>
10349 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10350
10351
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10352 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10353 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10354
10355
10356
10357
10358
10359 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10360 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10361 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10362 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10363 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10364 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10365
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10366 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10367
10368
10369 </td> <!-- entry_type -->
10370
10371 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10372 <p>Gain factor from electrons to raw units when
10373ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10374 </td>
10375
10376 <td class="entry_units">
10377 </td>
10378
10379 <td class="entry_range">
10380 </td>
10381
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10382 <td class="entry_tags">
10383 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10384 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10385 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10386 </ul>
10387 </td>
10388
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10389 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10390
10391
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10392 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10393 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10394
10395
10396 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10397 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10398 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10399 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10400 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10401 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10402 <span class="entry_type_container">x</span>
10403
10404 <span class="entry_type_array">
10405 4
10406 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10407 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10408 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10409
10410
10411 </td> <!-- entry_type -->
10412
10413 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10414 <p>A fixed black level offset for each of the
10415Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10416 </td>
10417
10418 <td class="entry_units">
10419 </td>
10420
10421 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10422 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10423 </td>
10424
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10425 <td class="entry_tags">
10426 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10427 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10428 </ul>
10429 </td>
10430
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10431 </tr>
10432 <tr class="entries_header">
10433 <th class="th_details" colspan="5">Details</th>
10434 </tr>
10435 <tr class="entry_cont">
10436 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10437 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
10438tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10439 </td>
10440 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10441
10442
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10443 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10444 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10445
10446
10447 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10448 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10449 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10450 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10451 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10452 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10453 <span class="entry_type_container">x</span>
10454
10455 <span class="entry_type_array">
10456 9
10457 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10458 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10459 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10460
10461
10462 </td> <!-- entry_type -->
10463
10464 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10465 <p>Per-device calibration on top of color space
10466transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10467 </td>
10468
10469 <td class="entry_units">
10470 </td>
10471
10472 <td class="entry_range">
10473 </td>
10474
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10475 <td class="entry_tags">
10476 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10477 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10478 </ul>
10479 </td>
10480
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10481 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10482
10483
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10484 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10485 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10486
10487
10488 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10489 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10490 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10491 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10492 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10493 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10494 <span class="entry_type_container">x</span>
10495
10496 <span class="entry_type_array">
10497 9
10498 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10499 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10500 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10501
10502
10503 </td> <!-- entry_type -->
10504
10505 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10506 <p>Per-device calibration on top of color space
10507transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10508 </td>
10509
10510 <td class="entry_units">
10511 </td>
10512
10513 <td class="entry_range">
10514 </td>
10515
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10516 <td class="entry_tags">
10517 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10518 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10519 </ul>
10520 </td>
10521
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10522 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10523
10524
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10525 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10526 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10527
10528
10529 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10530 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10531 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10532 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10533 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10534 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10535 <span class="entry_type_container">x</span>
10536
10537 <span class="entry_type_array">
10538 9
10539 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10540 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10541 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10542
10543
10544 </td> <!-- entry_type -->
10545
10546 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10547 <p>Linear mapping from XYZ (D50) color space to
10548reference linear sensor color,<wbr/> for first reference
10549illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10550 </td>
10551
10552 <td class="entry_units">
10553 </td>
10554
10555 <td class="entry_range">
10556 </td>
10557
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10558 <td class="entry_tags">
10559 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10560 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10561 </ul>
10562 </td>
10563
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10564 </tr>
10565 <tr class="entries_header">
10566 <th class="th_details" colspan="5">Details</th>
10567 </tr>
10568 <tr class="entry_cont">
10569 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10570 <p>Use as follows XYZ = inv(transform) * clip( (raw -
10571black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
10572At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10573 </td>
10574 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10575
10576
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10577 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10578 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10579
10580
10581 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10582 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10583 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10584 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10585 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10586 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10587 <span class="entry_type_container">x</span>
10588
10589 <span class="entry_type_array">
10590 9
10591 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10592 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10593 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10594
10595
10596 </td> <!-- entry_type -->
10597
10598 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10599 <p>Linear mapping from XYZ (D50) color space to
10600reference linear sensor color,<wbr/> for second reference
10601illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10602 </td>
10603
10604 <td class="entry_units">
10605 </td>
10606
10607 <td class="entry_range">
10608 </td>
10609
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10610 <td class="entry_tags">
10611 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10612 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10613 </ul>
10614 </td>
10615
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10616 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10617
10618
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10619 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10620 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10621
10622
10623 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10624 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10625 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10626 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10627 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10628 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10629 <span class="entry_type_container">x</span>
10630
10631 <span class="entry_type_array">
10632 9
10633 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10634 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10635 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10636
10637
10638 </td> <!-- entry_type -->
10639
10640 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10641 <p>Used by DNG for better WB
10642adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10643 </td>
10644
10645 <td class="entry_units">
10646 </td>
10647
10648 <td class="entry_range">
10649 </td>
10650
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10651 <td class="entry_tags">
10652 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10653 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10654 </ul>
10655 </td>
10656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10657 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10658
10659
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10660 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10661 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10662
10663
10664 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10665 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10666 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10667 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10668 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10669 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10670 <span class="entry_type_container">x</span>
10671
10672 <span class="entry_type_array">
10673 9
10674 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10675 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10676 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10677
10678
10679 </td> <!-- entry_type -->
10680
10681 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10682 <p>Used by DNG for better WB
10683adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10684 </td>
10685
10686 <td class="entry_units">
10687 </td>
10688
10689 <td class="entry_range">
10690 </td>
10691
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10692 <td class="entry_tags">
10693 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10694 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10695 </ul>
10696 </td>
10697
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10698 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10699
10700
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10701 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10702 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10703
10704
10705 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10706 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10707 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10708 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10709 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10710 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10711
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10712 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10713
10714
10715 </td> <!-- entry_type -->
10716
10717 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10718 <p>Maximum sensitivity that is implemented
10719purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10720 </td>
10721
10722 <td class="entry_units">
10723 </td>
10724
10725 <td class="entry_range">
10726 </td>
10727
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10728 <td class="entry_tags">
10729 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10730 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10731 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10732 </ul>
10733 </td>
10734
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10735 </tr>
10736 <tr class="entries_header">
10737 <th class="th_details" colspan="5">Details</th>
10738 </tr>
10739 <tr class="entry_cont">
10740 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10741 <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]10742equal to this,<wbr/> all applied gain must be analog.<wbr/> For
10743values above this,<wbr/> it can be a mix of analog and
10744digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10745 </td>
10746 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10747
10748
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10749 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10750 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10751
10752
10753 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10754 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10755 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10756 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10757 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10758 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10759 <span class="entry_type_container">x</span>
10760
10761 <span class="entry_type_array">
10762 2
10763 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10764 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10765 <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]10766
10767
10768 </td> <!-- entry_type -->
10769
10770 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10771 <p>Estimation of sensor noise
10772characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10773 </td>
10774
10775 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10776 var(raw pixel value) = electrons * (baseGainFactor
10777 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
10778 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10779 </td>
10780
10781 <td class="entry_range">
10782 </td>
10783
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10784 <td class="entry_tags">
10785 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10786 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10787 </ul>
10788 </td>
10789
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10790 </tr>
10791 <tr class="entries_header">
10792 <th class="th_details" colspan="5">Details</th>
10793 </tr>
10794 <tr class="entry_cont">
10795 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10796 <p>A represents sensor read noise before analog
10797amplification; B represents noise from A/<wbr/>D conversion and
10798other circuits after amplification.<wbr/> Both noise sources
10799are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
10800across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10801 </td>
10802 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10803
10804
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10805 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10806 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10807
10808
10809 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10810 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10811 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10812 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10813 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10814 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10815
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10816 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10817
10818
10819 </td> <!-- entry_type -->
10820
10821 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10822 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10823image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10824screen in its native orientation.<wbr/> Also defines the
10825direction of rolling shutter readout,<wbr/> which is from top
10826to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10827 </td>
10828
10829 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10830 degrees clockwise rotation,<wbr/> only multiples of
10831 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10832 </td>
10833
10834 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10835 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10836 </td>
10837
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10838 <td class="entry_tags">
10839 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10840 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10841 </ul>
10842 </td>
10843
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10844 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10845
10846
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10847 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10848 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10849
10850
10851 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10852 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10853 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10854 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10855 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10856 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10857
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10858 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10859
10860 <ul class="entry_type_enum">
10861 <li>
10862 <span class="entry_type_enum_name">DAYLIGHT</span>
10863 <span class="entry_type_enum_value">1</span>
10864 </li>
10865 <li>
10866 <span class="entry_type_enum_name">FLUORESCENT</span>
10867 <span class="entry_type_enum_value">2</span>
10868 </li>
10869 <li>
10870 <span class="entry_type_enum_name">TUNGSTEN</span>
10871 <span class="entry_type_enum_value">3</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10872 <span class="entry_type_enum_notes"><p>Incandescent light</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10873 </li>
10874 <li>
10875 <span class="entry_type_enum_name">FLASH</span>
10876 <span class="entry_type_enum_value">4</span>
10877 </li>
10878 <li>
10879 <span class="entry_type_enum_name">FINE_WEATHER</span>
10880 <span class="entry_type_enum_value">9</span>
10881 </li>
10882 <li>
10883 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10884 <span class="entry_type_enum_value">10</span>
10885 </li>
10886 <li>
10887 <span class="entry_type_enum_name">SHADE</span>
10888 <span class="entry_type_enum_value">11</span>
10889 </li>
10890 <li>
10891 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10892 <span class="entry_type_enum_value">12</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10893 <span class="entry_type_enum_notes"><p>D 5700 - 7100K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10894 </li>
10895 <li>
10896 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10897 <span class="entry_type_enum_value">13</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10898 <span class="entry_type_enum_notes"><p>N 4600 - 5400K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10899 </li>
10900 <li>
10901 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10902 <span class="entry_type_enum_value">14</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10903 <span class="entry_type_enum_notes"><p>W 3900 - 4500K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10904 </li>
10905 <li>
10906 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10907 <span class="entry_type_enum_value">15</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]10908 <span class="entry_type_enum_notes"><p>WW 3200 - 3700K</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10909 </li>
10910 <li>
10911 <span class="entry_type_enum_name">STANDARD_A</span>
10912 <span class="entry_type_enum_value">17</span>
10913 </li>
10914 <li>
10915 <span class="entry_type_enum_name">STANDARD_B</span>
10916 <span class="entry_type_enum_value">18</span>
10917 </li>
10918 <li>
10919 <span class="entry_type_enum_name">STANDARD_C</span>
10920 <span class="entry_type_enum_value">19</span>
10921 </li>
10922 <li>
10923 <span class="entry_type_enum_name">D55</span>
10924 <span class="entry_type_enum_value">20</span>
10925 </li>
10926 <li>
10927 <span class="entry_type_enum_name">D65</span>
10928 <span class="entry_type_enum_value">21</span>
10929 </li>
10930 <li>
10931 <span class="entry_type_enum_name">D75</span>
10932 <span class="entry_type_enum_value">22</span>
10933 </li>
10934 <li>
10935 <span class="entry_type_enum_name">D50</span>
10936 <span class="entry_type_enum_value">23</span>
10937 </li>
10938 <li>
10939 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10940 <span class="entry_type_enum_value">24</span>
10941 </li>
10942 </ul>
10943
10944 </td> <!-- entry_type -->
10945
10946 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10947 <p>Light source used to define transform
109481</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10949 </td>
10950
10951 <td class="entry_units">
10952 </td>
10953
10954 <td class="entry_range">
10955 </td>
10956
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10957 <td class="entry_tags">
10958 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10959 <li><a href="#tag_DNG">DNG</a></li>
10960 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10961 </ul>
10962 </td>
10963
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10964 </tr>
10965 <tr class="entries_header">
10966 <th class="th_details" colspan="5">Details</th>
10967 </tr>
10968 <tr class="entry_cont">
10969 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10970 <p>[EXIF LightSource tag] Must all these be
10971supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10972 </td>
10973 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10974
10975
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10976 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10977 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10978
10979
10980 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10981 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10982 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10983 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10984 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10985 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10986
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10987 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10988
10989
10990 </td> <!-- entry_type -->
10991
10992 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10993 <p>Light source used to define transform
109942</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10995 </td>
10996
10997 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10998 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10999 </td>
11000
11001 <td class="entry_range">
11002 </td>
11003
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11004 <td class="entry_tags">
11005 </td>
11006
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11007 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11008
11009
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11010 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11011 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11012
11013
11014
11015 <!-- end of kind -->
11016 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11017 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11018
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11019 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11020 <tr>
11021 <th class="th_name">Property Name</th>
11022 <th class="th_type">Type</th>
11023 <th class="th_description">Description</th>
11024 <th class="th_units">Units</th>
11025 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11026 <th class="th_tags">Tags</th>
11027 </tr>
11028 </thead>
11029
11030 <tbody>
11031
11032
11033
11034
11035
11036
11037
11038
11039
11040
11041 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11042 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11043 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11044 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11045 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11046 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11047
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11048 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11049
11050
11051 </td> <!-- entry_type -->
11052
11053 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11054 <p>Duration each pixel is exposed to
11055light.<wbr/></p>
11056<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
11057duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11058 </td>
11059
11060 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11061 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11062 </td>
11063
11064 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11065 <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]11066 </td>
11067
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11068 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11069 <ul class="entry_tags">
11070 <li><a href="#tag_V1">V1</a></li>
11071 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11072 </td>
11073
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11074 </tr>
11075 <tr class="entries_header">
11076 <th class="th_details" colspan="5">Details</th>
11077 </tr>
11078 <tr class="entry_cont">
11079 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11080 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11081 </td>
11082 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11083
11084
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11085 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11086 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11087
11088
11089 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11090 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11091 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11092 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11093 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11094 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11095
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11096 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11097
11098
11099 </td> <!-- entry_type -->
11100
11101 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11102 <p>Duration from start of frame exposure to
11103start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11104 </td>
11105
11106 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11107 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11108 </td>
11109
11110 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11111 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
11112android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11113 </td>
11114
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11115 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11116 <ul class="entry_tags">
11117 <li><a href="#tag_V1">V1</a></li>
11118 <li><a href="#tag_BC">BC</a></li>
11119 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11120 </td>
11121
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11122 </tr>
11123 <tr class="entries_header">
11124 <th class="th_details" colspan="5">Details</th>
11125 </tr>
11126 <tr class="entry_cont">
11127 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11128 <p>Exposure time has priority,<wbr/> so duration is set to
11129max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11130 </td>
11131 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11132
11133
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11134 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11135 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11136
11137
11138 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11139 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11140 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11141 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11142 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11143 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11144
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11145 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11146
11147
11148 </td> <!-- entry_type -->
11149
11150 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11151 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11152implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11153below 'maximum analog sensitivity'.<wbr/></p>
11154<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
11155gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11156 </td>
11157
11158 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11159 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11160 </td>
11161
11162 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11163 <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]11164 </td>
11165
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11166 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11167 <ul class="entry_tags">
11168 <li><a href="#tag_V1">V1</a></li>
11169 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11170 </td>
11171
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11172 </tr>
11173 <tr class="entries_header">
11174 <th class="th_details" colspan="5">Details</th>
11175 </tr>
11176 <tr class="entry_cont">
11177 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11178 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11179 </td>
11180 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11181
11182
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11183 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11184 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11185
11186
11187 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11188 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11189 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11190 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11191 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11192 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11193
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11194 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11195
11196
11197 </td> <!-- entry_type -->
11198
11199 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11200 <p>Time at start of exposure of first
11201row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11202 </td>
11203
11204 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11205 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11206 </td>
11207
11208 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11209 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11210 </td>
11211
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11212 <td class="entry_tags">
11213 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11214 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11215 </ul>
11216 </td>
11217
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11218 </tr>
11219 <tr class="entries_header">
11220 <th class="th_details" colspan="5">Details</th>
11221 </tr>
11222 <tr class="entry_cont">
11223 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11224 <p>Monotonic,<wbr/> should be synced to other timestamps in
11225system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11226 </td>
11227 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11228
11229
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11230 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11231 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11232
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11233
11234 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11235 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11236 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11237 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11238 <td class="entry_type">
11239 <span class="entry_type_name">float</span>
11240
11241 <span class="entry_type_visibility"> [public]</span>
11242
11243
11244 </td> <!-- entry_type -->
11245
11246 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11247 <p>The temperature of the sensor,<wbr/> sampled at the time
11248exposure began for this frame.<wbr/></p>
11249<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
11250somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11251 </td>
11252
11253 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11254 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11255 </td>
11256
11257 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11258 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11259 </td>
11260
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11261 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]11262 <ul class="entry_tags">
11263 <li><a href="#tag_FULL">FULL</a></li>
11264 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11265 </td>
11266
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11267 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11268
11269
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11270 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11271 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]11272
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11273
11274
11275 <!-- end of kind -->
11276 </tbody>
11277
11278 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11279 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11280
11281
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11282 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11283
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11284 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11285 <tr>
11286 <th class="th_name">Property Name</th>
11287 <th class="th_type">Type</th>
11288 <th class="th_description">Description</th>
11289 <th class="th_units">Units</th>
11290 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11291 <th class="th_tags">Tags</th>
11292 </tr>
11293 </thead>
11294
11295 <tbody>
11296
11297
11298
11299
11300
11301
11302
11303
11304
11305
11306 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11307 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11308 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11309 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11310 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11311 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11312
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11313 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11314
11315 <ul class="entry_type_enum">
11316 <li>
11317 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11318 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11319 </li>
11320 <li>
11321 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11322 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
11323bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11324 </li>
11325 <li>
11326 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11327 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
11328quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11329 </li>
11330 </ul>
11331
11332 </td> <!-- entry_type -->
11333
11334 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11335 <p>Quality of lens shading correction applied
11336to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11337 </td>
11338
11339 <td class="entry_units">
11340 </td>
11341
11342 <td class="entry_range">
11343 </td>
11344
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11345 <td class="entry_tags">
11346 </td>
11347
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11348 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11349
11350
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11351 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11352 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11353
11354
11355 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11356 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11357 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11358 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11359 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11360 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11361
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11362 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11363
11364
11365 </td> <!-- entry_type -->
11366
11367 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11368 <p>Control the amount of shading correction
11369applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11370 </td>
11371
11372 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11373 unitless: 1-10; 10 is full shading
11374 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11375 </td>
11376
11377 <td class="entry_range">
11378 </td>
11379
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11380 <td class="entry_tags">
11381 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11382 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11383 </ul>
11384 </td>
11385
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11386 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11387
11388
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11389 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11390 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11391
11392
11393
11394 <!-- end of kind -->
11395 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11396 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11397
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11398 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11399 <tr>
11400 <th class="th_name">Property Name</th>
11401 <th class="th_type">Type</th>
11402 <th class="th_description">Description</th>
11403 <th class="th_units">Units</th>
11404 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11405 <th class="th_tags">Tags</th>
11406 </tr>
11407 </thead>
11408
11409 <tbody>
11410
11411
11412
11413
11414
11415
11416
11417
11418
11419
11420 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11421 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11422 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11423 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11424 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11425 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11426
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11427 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11428
11429 <ul class="entry_type_enum">
11430 <li>
11431 <span class="entry_type_enum_name">OFF</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11432 <span class="entry_type_enum_notes"><p>No shading correction is applied</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11433 </li>
11434 <li>
11435 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11436 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
11437bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11438 </li>
11439 <li>
11440 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11441 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
11442quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11443 </li>
11444 </ul>
11445
11446 </td> <!-- entry_type -->
11447
11448 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11449 <p>Quality of lens shading correction applied
11450to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11451 </td>
11452
11453 <td class="entry_units">
11454 </td>
11455
11456 <td class="entry_range">
11457 </td>
11458
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11459 <td class="entry_tags">
11460 </td>
11461
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11462 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11463
11464
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11465 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11466 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11467
11468
11469
11470 <!-- end of kind -->
11471 </tbody>
11472
11473 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11474 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11475
11476
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11477 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11478
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11479 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11480 <tr>
11481 <th class="th_name">Property Name</th>
11482 <th class="th_type">Type</th>
11483 <th class="th_description">Description</th>
11484 <th class="th_units">Units</th>
11485 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11486 <th class="th_tags">Tags</th>
11487 </tr>
11488 </thead>
11489
11490 <tbody>
11491
11492
11493
11494
11495
11496
11497
11498
11499
11500
11501 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11502 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11503 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11504 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11505 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11506 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11507
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11508 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11509
11510 <ul class="entry_type_enum">
11511 <li>
11512 <span class="entry_type_enum_name">OFF</span>
11513 </li>
11514 <li>
11515 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11516 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
11517only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11518 </li>
11519 <li>
11520 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]11521 <span class="entry_type_enum_notes"><p>Optional Return all face
11522metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11523 </li>
11524 </ul>
11525
11526 </td> <!-- entry_type -->
11527
11528 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11529 <p>State of the face detector
11530unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11531 </td>
11532
11533 <td class="entry_units">
11534 </td>
11535
11536 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11537 <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]11538 </td>
11539
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11540 <td class="entry_tags">
11541 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11542 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11543 </ul>
11544 </td>
11545
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11546 </tr>
11547 <tr class="entries_header">
11548 <th class="th_details" colspan="5">Details</th>
11549 </tr>
11550 <tr class="entry_cont">
11551 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11552 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11553should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11554fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11555<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]11556 </td>
11557 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11558
11559
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11560 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11561 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11562
11563
11564 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11565 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11566 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11567 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11568 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11569 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11570
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11571 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11572
11573 <ul class="entry_type_enum">
11574 <li>
11575 <span class="entry_type_enum_name">OFF</span>
11576 </li>
11577 <li>
11578 <span class="entry_type_enum_name">ON</span>
11579 </li>
11580 </ul>
11581
11582 </td> <!-- entry_type -->
11583
11584 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11585 <p>Operating mode for histogram
11586generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11587 </td>
11588
11589 <td class="entry_units">
11590 </td>
11591
11592 <td class="entry_range">
11593 </td>
11594
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11595 <td class="entry_tags">
11596 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11597 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11598 </ul>
11599 </td>
11600
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11601 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11602
11603
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11604 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11605 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11606
11607
11608 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11609 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11610 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11611 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11612 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11613 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11614
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11615 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11616
11617 <ul class="entry_type_enum">
11618 <li>
11619 <span class="entry_type_enum_name">OFF</span>
11620 </li>
11621 <li>
11622 <span class="entry_type_enum_name">ON</span>
11623 </li>
11624 </ul>
11625
11626 </td> <!-- entry_type -->
11627
11628 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11629 <p>Operating mode for sharpness map
11630generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11631 </td>
11632
11633 <td class="entry_units">
11634 </td>
11635
11636 <td class="entry_range">
11637 </td>
11638
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11639 <td class="entry_tags">
11640 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11641 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11642 </ul>
11643 </td>
11644
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11645 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11646
11647
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11648 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11649 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11650
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11651
11652 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11653 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11654 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11655 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11656 <td class="entry_type">
11657 <span class="entry_type_name entry_type_name_enum">byte</span>
11658
11659 <span class="entry_type_visibility"> [public]</span>
11660
11661 <ul class="entry_type_enum">
11662 <li>
11663 <span class="entry_type_enum_name">OFF</span>
11664 </li>
11665 <li>
11666 <span class="entry_type_enum_name">ON</span>
11667 </li>
11668 </ul>
11669
11670 </td> <!-- entry_type -->
11671
11672 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11673 <p>Whether the HAL needs to output the lens
11674shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11675 </td>
11676
11677 <td class="entry_units">
11678 </td>
11679
11680 <td class="entry_range">
11681 </td>
11682
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11683 <td class="entry_tags">
11684 </td>
11685
11686 </tr>
11687 <tr class="entries_header">
11688 <th class="th_details" colspan="5">Details</th>
11689 </tr>
11690 <tr class="entry_cont">
11691 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11692 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11693<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]11694the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11695 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11696 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11697
11698
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11699 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11700 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11701
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11702
11703
11704 <!-- end of kind -->
11705 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11706 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11707
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11708 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11709 <tr>
11710 <th class="th_name">Property Name</th>
11711 <th class="th_type">Type</th>
11712 <th class="th_description">Description</th>
11713 <th class="th_units">Units</th>
11714 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11715 <th class="th_tags">Tags</th>
11716 </tr>
11717 </thead>
11718
11719 <tbody>
11720
11721
11722
11723
11724
11725
11726
11727
11728
11729
11730
11731
11732 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11733 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11734 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11735 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11736 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11737 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11738 <span class="entry_type_container">x</span>
11739
11740 <span class="entry_type_array">
11741 n
11742 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11743 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11744 <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]11745
11746
11747 </td> <!-- entry_type -->
11748
11749 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11750 <p>Which face detection modes are available,<wbr/>
11751if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11752 </td>
11753
11754 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11755 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11756 OFF
11757 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11758 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11759 </td>
11760
11761 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11762 </td>
11763
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11764 <td class="entry_tags">
11765 </td>
11766
11767 </tr>
11768 <tr class="entries_header">
11769 <th class="th_details" colspan="5">Details</th>
11770 </tr>
11771 <tr class="entry_cont">
11772 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11773 <p>OFF means face detection is disabled,<wbr/> it must
11774be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11775<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11776<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
11777<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]11778<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11779<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
11780<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]11781 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11782 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11783
11784
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11785 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11786 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11787
11788
11789 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11790 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11791 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11792 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11793 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11794 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11795
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11796 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11797
11798
11799 </td> <!-- entry_type -->
11800
11801 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11802 <p>Number of histogram buckets
11803supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11804 </td>
11805
11806 <td class="entry_units">
11807 </td>
11808
11809 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11810 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11811 </td>
11812
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11813 <td class="entry_tags">
11814 </td>
11815
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11816 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11817
11818
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11819 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11820 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11821
11822
11823 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11824 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11825 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11826 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11827 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11828 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11829
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11830 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11831
11832
11833 </td> <!-- entry_type -->
11834
11835 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11836 <p>Maximum number of simultaneously detectable
11837faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11838 </td>
11839
11840 <td class="entry_units">
11841 </td>
11842
11843 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11844 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11845modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11846 </td>
11847
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11848 <td class="entry_tags">
11849 </td>
11850
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11851 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11852
11853
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11854 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11855 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11856
11857
11858 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11859 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11860 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11861 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11862 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11863 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11864
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11865 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11866
11867
11868 </td> <!-- entry_type -->
11869
11870 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11871 <p>Maximum value possible for a histogram
11872bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11873 </td>
11874
11875 <td class="entry_units">
11876 </td>
11877
11878 <td class="entry_range">
11879 </td>
11880
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11881 <td class="entry_tags">
11882 </td>
11883
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11884 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11885
11886
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11887 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11888 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11889
11890
11891 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11892 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11893 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11894 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11895 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11896 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11897
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11898 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11899
11900
11901 </td> <!-- entry_type -->
11902
11903 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11904 <p>Maximum value possible for a sharpness map
11905region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11906 </td>
11907
11908 <td class="entry_units">
11909 </td>
11910
11911 <td class="entry_range">
11912 </td>
11913
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11914 <td class="entry_tags">
11915 </td>
11916
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11917 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11918
11919
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11920 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11921 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11922
11923
11924 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11925 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11926 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11927 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11928 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11929 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11930 <span class="entry_type_container">x</span>
11931
11932 <span class="entry_type_array">
11933 2
11934 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11935 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11936 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11937
11938
11939 </td> <!-- entry_type -->
11940
11941 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11942 <p>Dimensions of the sharpness
11943map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11944 </td>
11945
11946 <td class="entry_units">
11947 </td>
11948
11949 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11950 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11951 </td>
11952
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11953 <td class="entry_tags">
11954 </td>
11955
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11956 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11957
11958
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11959 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11960 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11961
11962
11963
11964
11965
11966
11967 <!-- end of kind -->
11968 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11969 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11970
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11971 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11972 <tr>
11973 <th class="th_name">Property Name</th>
11974 <th class="th_type">Type</th>
11975 <th class="th_description">Description</th>
11976 <th class="th_units">Units</th>
11977 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11978 <th class="th_tags">Tags</th>
11979 </tr>
11980 </thead>
11981
11982 <tbody>
11983
11984
11985
11986
11987
11988
11989
11990
11991
11992
11993 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11994 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11995 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11996 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11997 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11998 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11999
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12000 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12001
12002 <ul class="entry_type_enum">
12003 <li>
12004 <span class="entry_type_enum_name">OFF</span>
12005 </li>
12006 <li>
12007 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12008 <span class="entry_type_enum_notes"><p>Optional Return rectangle and confidence
12009only</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12010 </li>
12011 <li>
12012 <span class="entry_type_enum_name">FULL</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12013 <span class="entry_type_enum_notes"><p>Optional Return all face
12014metadata</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12015 </li>
12016 </ul>
12017
12018 </td> <!-- entry_type -->
12019
12020 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12021 <p>State of the face detector
12022unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12023 </td>
12024
12025 <td class="entry_units">
12026 </td>
12027
12028 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12029 <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]12030 </td>
12031
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12032 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12033 <ul class="entry_tags">
12034 <li><a href="#tag_BC">BC</a></li>
12035 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12036 </td>
12037
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12038 </tr>
12039 <tr class="entries_header">
12040 <th class="th_details" colspan="5">Details</th>
12041 </tr>
12042 <tr class="entry_cont">
12043 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12044 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12045should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12046fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12047<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]12048 </td>
12049 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12050
12051
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12052 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12053 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12054
12055
12056 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12057 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12058 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12059 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12060 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12061 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12062 <span class="entry_type_container">x</span>
12063
12064 <span class="entry_type_array">
12065 n
12066 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12067 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12068
12069
12070 </td> <!-- entry_type -->
12071
12072 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12073 <p>List of unique IDs for detected
12074faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12075 </td>
12076
12077 <td class="entry_units">
12078 </td>
12079
12080 <td class="entry_range">
12081 </td>
12082
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12083 <td class="entry_tags">
12084 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12085 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12086 </ul>
12087 </td>
12088
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12089 </tr>
12090 <tr class="entries_header">
12091 <th class="th_details" colspan="5">Details</th>
12092 </tr>
12093 <tr class="entry_cont">
12094 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12095 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12096 </td>
12097 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12098
12099
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12100 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12101 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12102
12103
12104 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12105 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12106 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12107 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12108 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12109 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12110 <span class="entry_type_container">x</span>
12111
12112 <span class="entry_type_array">
12113 n x 6
12114 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12115 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12116 <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]12117
12118
12119 </td> <!-- entry_type -->
12120
12121 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12122 <p>List of landmarks for detected
12123faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12124 </td>
12125
12126 <td class="entry_units">
12127 </td>
12128
12129 <td class="entry_range">
12130 </td>
12131
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12132 <td class="entry_tags">
12133 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12134 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12135 </ul>
12136 </td>
12137
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12138 </tr>
12139 <tr class="entries_header">
12140 <th class="th_details" colspan="5">Details</th>
12141 </tr>
12142 <tr class="entry_cont">
12143 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12144 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12145 </td>
12146 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12147
12148
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12149 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12150 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12151
12152
12153 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12154 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12155 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12156 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12157 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12158 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12159 <span class="entry_type_container">x</span>
12160
12161 <span class="entry_type_array">
12162 n x 4
12163 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12164 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12165 <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]12166
12167
12168 </td> <!-- entry_type -->
12169
12170 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12171 <p>List of the bounding rectangles for detected
12172faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12173 </td>
12174
12175 <td class="entry_units">
12176 </td>
12177
12178 <td class="entry_range">
12179 </td>
12180
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12181 <td class="entry_tags">
12182 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12183 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12184 </ul>
12185 </td>
12186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12187 </tr>
12188 <tr class="entries_header">
12189 <th class="th_details" colspan="5">Details</th>
12190 </tr>
12191 <tr class="entry_cont">
12192 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12193 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12194 </td>
12195 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12196
12197
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12198 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12199 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12200
12201
12202 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12203 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12204 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12205 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12206 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12207 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12208 <span class="entry_type_container">x</span>
12209
12210 <span class="entry_type_array">
12211 n
12212 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]12213 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12214
12215
12216 </td> <!-- entry_type -->
12217
12218 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12219 <p>List of the face confidence scores for
12220detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12221 </td>
12222
12223 <td class="entry_units">
12224 </td>
12225
12226 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12227 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12228 </td>
12229
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12230 <td class="entry_tags">
12231 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12232 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12233 </ul>
12234 </td>
12235
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12236 </tr>
12237 <tr class="entries_header">
12238 <th class="th_details" colspan="5">Details</th>
12239 </tr>
12240 <tr class="entry_cont">
12241 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12242 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
12243meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12244 </td>
12245 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12246
12247
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12248 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12249 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12250
12251
12252 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12253 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12254 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12255 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12256 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12257 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12258 <span class="entry_type_container">x</span>
12259
12260 <span class="entry_type_array">
12261 n x 3
12262 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12263 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12264 <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]12265
12266
12267 </td> <!-- entry_type -->
12268
12269 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12270 <p>A 3-channel histogram based on the raw
12271sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12272 </td>
12273
12274 <td class="entry_units">
12275 </td>
12276
12277 <td class="entry_range">
12278 </td>
12279
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12280 <td class="entry_tags">
12281 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12282 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12283 </ul>
12284 </td>
12285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12286 </tr>
12287 <tr class="entries_header">
12288 <th class="th_details" colspan="5">Details</th>
12289 </tr>
12290 <tr class="entry_cont">
12291 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12292 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12293(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]12294(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
12295supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12296 </td>
12297 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12298
12299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12300 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12301 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12302
12303
12304 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12305 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12306 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12307 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12308 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12309 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12310
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12311 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12312
12313 <ul class="entry_type_enum">
12314 <li>
12315 <span class="entry_type_enum_name">OFF</span>
12316 </li>
12317 <li>
12318 <span class="entry_type_enum_name">ON</span>
12319 </li>
12320 </ul>
12321
12322 </td> <!-- entry_type -->
12323
12324 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12325 <p>Operating mode for histogram
12326generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12327 </td>
12328
12329 <td class="entry_units">
12330 </td>
12331
12332 <td class="entry_range">
12333 </td>
12334
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12335 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12336 <ul class="entry_tags">
12337 <li><a href="#tag_V1">V1</a></li>
12338 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12339 </td>
12340
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12341 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12342
12343
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12344 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12345 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12346
12347
12348 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12349 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12350 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12351 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12352 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12353 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12354 <span class="entry_type_container">x</span>
12355
12356 <span class="entry_type_array">
12357 n x m x 3
12358 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12359 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12360 <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]12361
12362
12363 </td> <!-- entry_type -->
12364
12365 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12366 <p>A 3-channel sharpness map,<wbr/> based on the raw
12367sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12368 </td>
12369
12370 <td class="entry_units">
12371 </td>
12372
12373 <td class="entry_range">
12374 </td>
12375
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12376 <td class="entry_tags">
12377 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12378 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12379 </ul>
12380 </td>
12381
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12382 </tr>
12383 <tr class="entries_header">
12384 <th class="th_details" colspan="5">Details</th>
12385 </tr>
12386 <tr class="entry_cont">
12387 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12388 <p>If only a monochrome sharpness map is supported,<wbr/>
12389all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12390 </td>
12391 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12392
12393
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12394 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12395 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12396
12397
12398 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12399 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12400 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12401 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12402 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12403 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12404
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12405 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12406
12407 <ul class="entry_type_enum">
12408 <li>
12409 <span class="entry_type_enum_name">OFF</span>
12410 </li>
12411 <li>
12412 <span class="entry_type_enum_name">ON</span>
12413 </li>
12414 </ul>
12415
12416 </td> <!-- entry_type -->
12417
12418 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12419 <p>Operating mode for sharpness map
12420generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12421 </td>
12422
12423 <td class="entry_units">
12424 </td>
12425
12426 <td class="entry_range">
12427 </td>
12428
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12429 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]12430 <ul class="entry_tags">
12431 <li><a href="#tag_V1">V1</a></li>
12432 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12433 </td>
12434
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12435 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12436
12437
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12438 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12439 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12440
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12441
12442 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12443 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12444 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12445 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12446 <td class="entry_type">
12447 <span class="entry_type_name">float</span>
12448 <span class="entry_type_container">x</span>
12449
12450 <span class="entry_type_array">
12451 4 x n x m
12452 </span>
12453 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12454 <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]12455
12456
12457 </td> <!-- entry_type -->
12458
12459 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12460 <p>The shading map is a low-resolution floating-point map
12461that lists the coefficients used to correct for vignetting,<wbr/> for each
12462Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12463 </td>
12464
12465 <td class="entry_units">
12466 </td>
12467
12468 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12469 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12470 </td>
12471
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12472 <td class="entry_tags">
12473 </td>
12474
12475 </tr>
12476 <tr class="entries_header">
12477 <th class="th_details" colspan="5">Details</th>
12478 </tr>
12479 <tr class="entry_cont">
12480 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12481 <p>The least shaded section of the image should have a gain factor
12482of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12483<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]12484must take into account the colorCorrection settings.<wbr/></p>
12485<p>The shading map is for the entire active pixel array,<wbr/> and is not
12486affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]12487entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12488pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
12489map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
12490(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
12491pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
12492The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
12493<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
12494channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
12495The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12496is 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]12497<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
12498and must be smaller than 64x64.<wbr/></p>
12499<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12500<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
12501<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]12502[ 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/>
12503 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/>
12504 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/>
12505 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/>
12506 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/>
12507 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]12508</code></pre>
12509<p>The low-resolution scaling map images for each channel are
12510(displayed using nearest-neighbor interpolation):</p>
12511<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
12512<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
12513<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
12514<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]12515<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]12516image 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]12517<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]12518 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12519 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12520
12521
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12522 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12523 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12524
12525
12526 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12527 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12528 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12529 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12530 <td class="entry_type">
12531 <span class="entry_type_name">float</span>
12532 <span class="entry_type_container">x</span>
12533
12534 <span class="entry_type_array">
12535 4
12536 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12537 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12538 <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]12539
12540
12541 </td> <!-- entry_type -->
12542
12543 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12544 <p>The best-fit color channel gains calculated
12545by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12546 </td>
12547
12548 <td class="entry_units">
12549 </td>
12550
12551 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12552 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12553 </td>
12554
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12555 <td class="entry_tags">
12556 </td>
12557
12558 </tr>
12559 <tr class="entries_header">
12560 <th class="th_details" colspan="5">Details</th>
12561 </tr>
12562 <tr class="entry_cont">
12563 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12564 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12565since statistics processing on data from a new frame
12566typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12567applied to that frame.<wbr/></p>
12568<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12569see <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]12570<p>This value should always be calculated by the AWB block,<wbr/>
12571regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12572 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12573 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12574
12575
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12576 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12577 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12578
12579
12580 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12581 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12582 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12583 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12584 <td class="entry_type">
12585 <span class="entry_type_name">rational</span>
12586 <span class="entry_type_container">x</span>
12587
12588 <span class="entry_type_array">
12589 3 x 3
12590 </span>
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12591 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12592 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12593
12594
12595 </td> <!-- entry_type -->
12596
12597 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12598 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12599calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12600output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12601 </td>
12602
12603 <td class="entry_units">
12604 </td>
12605
12606 <td class="entry_range">
Igor Murashkin0fe2f132014-01-13 16:59:47 -0800[diff] [blame]12607 <p><strong>Deprecated</strong>.<wbr/> Do not use.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12608 </td>
12609
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12610 <td class="entry_tags">
12611 </td>
12612
12613 </tr>
12614 <tr class="entries_header">
12615 <th class="th_details" colspan="5">Details</th>
12616 </tr>
12617 <tr class="entry_cont">
12618 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12619 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12620statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12621for the next frame.<wbr/> These are the values the HAL believes
12622are the best fit for the current output frame.<wbr/> This may
12623be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12624statistics processing on data from a new frame typically
12625completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12626that frame.<wbr/></p>
12627<p>These estimates must be provided for all frames,<wbr/> even if
12628capture settings and color transforms are set by the application.<wbr/></p>
12629<p>This value should always be calculated by the AWB block,<wbr/>
12630regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12631 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12632 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12633
12634
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12635 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12636 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12637
12638
12639 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12640 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12641 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12642 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12643 <td class="entry_type">
12644 <span class="entry_type_name entry_type_name_enum">byte</span>
12645
12646 <span class="entry_type_visibility"> [public]</span>
12647
12648 <ul class="entry_type_enum">
12649 <li>
12650 <span class="entry_type_enum_name">NONE</span>
12651 </li>
12652 <li>
12653 <span class="entry_type_enum_name">50HZ</span>
12654 </li>
12655 <li>
12656 <span class="entry_type_enum_name">60HZ</span>
12657 </li>
12658 </ul>
12659
12660 </td> <!-- entry_type -->
12661
12662 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12663 <p>The HAL estimated scene illumination lighting
12664frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12665 </td>
12666
12667 <td class="entry_units">
12668 </td>
12669
12670 <td class="entry_range">
12671 </td>
12672
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12673 <td class="entry_tags">
12674 </td>
12675
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12676 </tr>
12677 <tr class="entries_header">
12678 <th class="th_details" colspan="5">Details</th>
12679 </tr>
12680 <tr class="entry_cont">
12681 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12682 <p>Report NONE if there doesn't appear to be flickering
12683illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12684 </td>
12685 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12686
12687
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12688 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12689 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12690
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12691
12692
12693 <!-- end of kind -->
12694 </tbody>
12695
12696 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12697 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12698
12699
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12700 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12701
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12702 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12703 <tr>
12704 <th class="th_name">Property Name</th>
12705 <th class="th_type">Type</th>
12706 <th class="th_description">Description</th>
12707 <th class="th_units">Units</th>
12708 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12709 <th class="th_tags">Tags</th>
12710 </tr>
12711 </thead>
12712
12713 <tbody>
12714
12715
12716
12717
12718
12719
12720
12721
12722
12723
12724 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12725 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12726 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12727 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12728 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12729 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12730 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12731
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12732 <span class="entry_type_array">
12733 n x 2
12734 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12735 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12736 <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]12737
12738
12739 </td> <!-- entry_type -->
12740
12741 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12742 <p>Table mapping blue input values to output
12743values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12744 </td>
12745
12746 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12747 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12748 </td>
12749
12750 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12751 <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]12752 </td>
12753
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12754 <td class="entry_tags">
12755 </td>
12756
12757 </tr>
12758 <tr class="entries_header">
12759 <th class="th_details" colspan="5">Details</th>
12760 </tr>
12761 <tr class="entry_cont">
12762 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12763 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12764channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12765<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]12766 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12767 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12768
12769
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12770 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12771 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12772
12773
12774 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12775 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12776 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12777 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12778 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12779 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12780 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12781
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12782 <span class="entry_type_array">
12783 n x 2
12784 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12785 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12786 <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]12787
12788
12789 </td> <!-- entry_type -->
12790
12791 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12792 <p>Table mapping green input values to output
12793values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12794 </td>
12795
12796 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12797 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12798 </td>
12799
12800 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12801 <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]12802 </td>
12803
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12804 <td class="entry_tags">
12805 </td>
12806
12807 </tr>
12808 <tr class="entries_header">
12809 <th class="th_details" colspan="5">Details</th>
12810 </tr>
12811 <tr class="entry_cont">
12812 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12813 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12814channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12815<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]12816 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12817 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12818
12819
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12820 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12821 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12822
12823
12824 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12825 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12826 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12827 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12828 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12829 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12830 <span class="entry_type_container">x</span>
12831
12832 <span class="entry_type_array">
12833 n x 2
12834 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12835 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12836 <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]12837
12838
12839 </td> <!-- entry_type -->
12840
12841 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12842 <p>Table mapping red input values to output
12843values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12844 </td>
12845
12846 <td class="entry_units">
12847 </td>
12848
12849 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12850 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12851 </td>
12852
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12853 <td class="entry_tags">
12854 <ul class="entry_tags">
12855 <li><a href="#tag_DNG">DNG</a></li>
12856 </ul>
12857 </td>
12858
12859 </tr>
12860 <tr class="entries_header">
12861 <th class="th_details" colspan="5">Details</th>
12862 </tr>
12863 <tr class="entry_cont">
12864 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12865 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12866channel,<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]12867<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12868the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12869are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12870between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12871<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12872defined points.<wbr/> The points will be listed in increasing
12873order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
128740.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12875for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
128760.<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]12877 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12878 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12879
12880
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12881 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12882 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12883
12884
12885 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12886 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12887 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12888 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12889 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12890 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12891
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12892 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12893
12894 <ul class="entry_type_enum">
12895 <li>
12896 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12897 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
12898android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12899 </li>
12900 <li>
12901 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12902 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
12903bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12904 </li>
12905 <li>
12906 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]12907 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
12908quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12909 </li>
12910 </ul>
12911
12912 </td> <!-- entry_type -->
12913
12914 <td class="entry_description">
12915 </td>
12916
12917 <td class="entry_units">
12918 </td>
12919
12920 <td class="entry_range">
12921 </td>
12922
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12923 <td class="entry_tags">
12924 </td>
12925
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12926 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12927
12928
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12929 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12930 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12931
12932
12933
12934 <!-- end of kind -->
12935 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12936 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12937
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12938 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12939 <tr>
12940 <th class="th_name">Property Name</th>
12941 <th class="th_type">Type</th>
12942 <th class="th_description">Description</th>
12943 <th class="th_units">Units</th>
12944 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12945 <th class="th_tags">Tags</th>
12946 </tr>
12947 </thead>
12948
12949 <tbody>
12950
12951
12952
12953
12954
12955
12956
12957
12958
12959
12960 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12961 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12962 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12963 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12964 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12965 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12966
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12967 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12968
12969
12970 </td> <!-- entry_type -->
12971
12972 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12973 <p>Maximum number of supported points in the
12974tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12975 </td>
12976
12977 <td class="entry_units">
12978 </td>
12979
12980 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]12981 <p>&gt;= 128</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12982 </td>
12983
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12984 <td class="entry_tags">
12985 </td>
12986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12987 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12988
12989
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12990 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12991 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12992
12993
12994
12995 <!-- end of kind -->
12996 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12997 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12998
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12999 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13000 <tr>
13001 <th class="th_name">Property Name</th>
13002 <th class="th_type">Type</th>
13003 <th class="th_description">Description</th>
13004 <th class="th_units">Units</th>
13005 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13006 <th class="th_tags">Tags</th>
13007 </tr>
13008 </thead>
13009
13010 <tbody>
13011
13012
13013
13014
13015
13016
13017
13018
13019
13020
13021 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13022 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13023 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13024 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13025 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]13026 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13027 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13028
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13029 <span class="entry_type_array">
13030 n x 2
13031 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13032 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13033 <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]13034
13035
13036 </td> <!-- entry_type -->
13037
13038 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13039 <p>Table mapping blue input values to output
13040values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13041 </td>
13042
13043 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13044 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13045 </td>
13046
13047 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13048 <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]13049 </td>
13050
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13051 <td class="entry_tags">
13052 </td>
13053
13054 </tr>
13055 <tr class="entries_header">
13056 <th class="th_details" colspan="5">Details</th>
13057 </tr>
13058 <tr class="entry_cont">
13059 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13060 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13061channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
13062<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]13063 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13064 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13065
13066
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13067 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13068 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13069
13070
13071 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13072 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13073 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13074 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13075 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]13076 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13077 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13078
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]13079 <span class="entry_type_array">
13080 n x 2
13081 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13082 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13083 <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]13084
13085
13086 </td> <!-- entry_type -->
13087
13088 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13089 <p>Table mapping green input values to output
13090values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13091 </td>
13092
13093 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13094 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13095 </td>
13096
13097 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13098 <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]13099 </td>
13100
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13101 <td class="entry_tags">
13102 </td>
13103
13104 </tr>
13105 <tr class="entries_header">
13106 <th class="th_details" colspan="5">Details</th>
13107 </tr>
13108 <tr class="entry_cont">
13109 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13110 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13111channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
13112<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]13113 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13114 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13115
13116
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13117 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13118 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13119
13120
13121 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13122 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13123 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13124 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13125 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13126 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13127 <span class="entry_type_container">x</span>
13128
13129 <span class="entry_type_array">
13130 n x 2
13131 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13132 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13133 <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]13134
13135
13136 </td> <!-- entry_type -->
13137
13138 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13139 <p>Table mapping red input values to output
13140values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13141 </td>
13142
13143 <td class="entry_units">
13144 </td>
13145
13146 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13147 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13148 </td>
13149
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13150 <td class="entry_tags">
13151 <ul class="entry_tags">
13152 <li><a href="#tag_DNG">DNG</a></li>
13153 </ul>
13154 </td>
13155
13156 </tr>
13157 <tr class="entries_header">
13158 <th class="th_details" colspan="5">Details</th>
13159 </tr>
13160 <tr class="entry_cont">
13161 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13162 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13163channel,<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]13164<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13165the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13166are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13167between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13168<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13169defined points.<wbr/> The points will be listed in increasing
13170order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
131710.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
13172for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
131730.<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]13174 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13175 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13176
13177
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13178 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13179 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13180
13181
13182 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13183 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13184 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13185 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13186 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]13187 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13188
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13189 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13190
13191 <ul class="entry_type_enum">
13192 <li>
13193 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13194 <span class="entry_type_enum_notes"><p>Use the tone mapping curve specified in
13195android.<wbr/>tonemap.<wbr/>curve</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13196 </li>
13197 <li>
13198 <span class="entry_type_enum_name">FAST</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13199 <span class="entry_type_enum_notes"><p>Must not slow down frame rate relative to raw
13200bayer output</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13201 </li>
13202 <li>
13203 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13204 <span class="entry_type_enum_notes"><p>Frame rate may be reduced by high
13205quality</p></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13206 </li>
13207 </ul>
13208
13209 </td> <!-- entry_type -->
13210
13211 <td class="entry_description">
13212 </td>
13213
13214 <td class="entry_units">
13215 </td>
13216
13217 <td class="entry_range">
13218 </td>
13219
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13220 <td class="entry_tags">
13221 </td>
13222
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13223 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13224
13225
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13226 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13227 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13228
13229
13230
13231 <!-- end of kind -->
13232 </tbody>
13233
13234 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13235 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13236
13237
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13238 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13239
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13240 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13241 <tr>
13242 <th class="th_name">Property Name</th>
13243 <th class="th_type">Type</th>
13244 <th class="th_description">Description</th>
13245 <th class="th_units">Units</th>
13246 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13247 <th class="th_tags">Tags</th>
13248 </tr>
13249 </thead>
13250
13251 <tbody>
13252
13253
13254
13255
13256
13257
13258
13259
13260
13261
13262 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13263 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13264 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13265 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13266 <td class="entry_type">
13267 <span class="entry_type_name entry_type_name_enum">byte</span>
13268
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13269 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13270
13271 <ul class="entry_type_enum">
13272 <li>
13273 <span class="entry_type_enum_name">OFF</span>
13274 </li>
13275 <li>
13276 <span class="entry_type_enum_name">ON</span>
13277 </li>
13278 </ul>
13279
13280 </td> <!-- entry_type -->
13281
13282 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13283 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13284that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13285Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13286disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13287any untrusted applications.<wbr/></p>
13288<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
13289transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
13290data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13291<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]13292doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13293 </td>
13294
13295 <td class="entry_units">
13296 </td>
13297
13298 <td class="entry_range">
13299 </td>
13300
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13301 <td class="entry_tags">
13302 </td>
13303
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13304 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13305
13306
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13307 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13308 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13309
13310
13311
13312 <!-- end of kind -->
13313 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13314 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13315
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13316 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13317 <tr>
13318 <th class="th_name">Property Name</th>
13319 <th class="th_type">Type</th>
13320 <th class="th_description">Description</th>
13321 <th class="th_units">Units</th>
13322 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13323 <th class="th_tags">Tags</th>
13324 </tr>
13325 </thead>
13326
13327 <tbody>
13328
13329
13330
13331
13332
13333
13334
13335
13336
13337
13338 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13339 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13340 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13341 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13342 <td class="entry_type">
13343 <span class="entry_type_name entry_type_name_enum">byte</span>
13344
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13345 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13346
13347 <ul class="entry_type_enum">
13348 <li>
13349 <span class="entry_type_enum_name">OFF</span>
13350 </li>
13351 <li>
13352 <span class="entry_type_enum_name">ON</span>
13353 </li>
13354 </ul>
13355
13356 </td> <!-- entry_type -->
13357
13358 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13359 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13360that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13361Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13362disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13363any untrusted applications.<wbr/></p>
13364<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
13365transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
13366data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13367<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]13368doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13369 </td>
13370
13371 <td class="entry_units">
13372 </td>
13373
13374 <td class="entry_range">
13375 </td>
13376
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13377 <td class="entry_tags">
13378 </td>
13379
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13380 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13381
13382
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13383 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13384 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13385
13386
13387
13388 <!-- end of kind -->
13389 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13390 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13391
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13392 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13393 <tr>
13394 <th class="th_name">Property Name</th>
13395 <th class="th_type">Type</th>
13396 <th class="th_description">Description</th>
13397 <th class="th_units">Units</th>
13398 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13399 <th class="th_tags">Tags</th>
13400 </tr>
13401 </thead>
13402
13403 <tbody>
13404
13405
13406
13407
13408
13409
13410
13411
13412
13413
13414 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13415 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13416 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13417 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13418 <td class="entry_type">
13419 <span class="entry_type_name entry_type_name_enum">byte</span>
13420 <span class="entry_type_container">x</span>
13421
13422 <span class="entry_type_array">
13423 n
13424 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13425 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13426
13427 <ul class="entry_type_enum">
13428 <li>
13429 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkina10351a2014-01-15 17:05:22 -0800[diff] [blame]13430 <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]13431 </li>
13432 </ul>
13433
13434 </td> <!-- entry_type -->
13435
13436 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13437 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13438 </td>
13439
13440 <td class="entry_units">
13441 </td>
13442
13443 <td class="entry_range">
13444 </td>
13445
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13446 <td class="entry_tags">
13447 </td>
13448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13449 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13450
13451
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13452 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13453 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]13454
13455
13456
13457 <!-- end of kind -->
13458 </tbody>
13459
13460 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13461 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13462
13463
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13464 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13465
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13466 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13467 <tr>
13468 <th class="th_name">Property Name</th>
13469 <th class="th_type">Type</th>
13470 <th class="th_description">Description</th>
13471 <th class="th_units">Units</th>
13472 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13473 <th class="th_tags">Tags</th>
13474 </tr>
13475 </thead>
13476
13477 <tbody>
13478
13479
13480
13481
13482
13483
13484
13485
13486
13487
13488 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13489 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13490 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13491 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13492 <td class="entry_type">
13493 <span class="entry_type_name entry_type_name_enum">byte</span>
13494
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13495 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13496
13497 <ul class="entry_type_enum">
13498 <li>
13499 <span class="entry_type_enum_name">LIMITED</span>
13500 </li>
13501 <li>
13502 <span class="entry_type_enum_name">FULL</span>
13503 </li>
13504 </ul>
13505
13506 </td> <!-- entry_type -->
13507
13508 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13509 <p>The camera 3 HAL device can implement one of two possible
13510operational modes; limited and full.<wbr/> Full support is
13511expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13512hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13513camera HAL device v1 implementation,<wbr/> and is expected from
13514older or inexpensive devices.<wbr/> Full is a strict superset of
13515limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
13516<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]13517 </td>
13518
13519 <td class="entry_units">
13520 </td>
13521
13522 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13523 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13524 </td>
13525
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13526 <td class="entry_tags">
13527 </td>
13528
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13529 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13530
13531
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13532 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13533 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13534
13535
13536
13537 <!-- end of kind -->
13538 </tbody>
13539
13540 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13541 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13542
13543
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13544 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13545
13546 <thead class="entries_header">
13547 <tr>
13548 <th class="th_name">Property Name</th>
13549 <th class="th_type">Type</th>
13550 <th class="th_description">Description</th>
13551 <th class="th_units">Units</th>
13552 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13553 <th class="th_tags">Tags</th>
13554 </tr>
13555 </thead>
13556
13557 <tbody>
13558
13559
13560
13561
13562
13563
13564
13565
13566
13567
13568 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13569 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13570 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13571 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13572 <td class="entry_type">
13573 <span class="entry_type_name entry_type_name_enum">byte</span>
13574
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13575 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13576
13577 <ul class="entry_type_enum">
13578 <li>
13579 <span class="entry_type_enum_name">OFF</span>
13580 </li>
13581 <li>
13582 <span class="entry_type_enum_name">ON</span>
13583 </li>
13584 </ul>
13585
13586 </td> <!-- entry_type -->
13587
13588 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13589 <p>Whether black-level compensation is locked
13590to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13591 </td>
13592
13593 <td class="entry_units">
13594 </td>
13595
13596 <td class="entry_range">
13597 </td>
13598
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13599 <td class="entry_tags">
13600 <ul class="entry_tags">
13601 <li><a href="#tag_HAL2">HAL2</a></li>
13602 </ul>
13603 </td>
13604
13605 </tr>
13606 <tr class="entries_header">
13607 <th class="th_details" colspan="5">Details</th>
13608 </tr>
13609 <tr class="entry_cont">
13610 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13611 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13612compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13613OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13614<p>Since changes to certain capture parameters (such as
13615exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13616compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13617the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13618metadata.<wbr/></p>
13619<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13620<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13621<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13622<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13623<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13624<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13625<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13626<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13627</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13628<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13629device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13630result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13631<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13632<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13633<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13634<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13635<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
13636<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13637<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13638</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13639<p>This indicates to the application that on frame 4,<wbr/> black
13640levels were reset due to exposure value changes,<wbr/> and pixel
13641values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13642<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13643possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13644other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13645or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13646 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13647 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13648
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13649 <tr class="entries_header">
13650 <th class="th_details" colspan="5">HAL Implementation Details</th>
13651 </tr>
13652 <tr class="entry_cont">
13653 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13654 <p>If for some reason black level locking is no longer possible
13655(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13656black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13657override this request (and it must report 'OFF' when this
13658does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13659possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13660 </td>
13661 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13662
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13663 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13664 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13665
13666
13667
13668 <!-- end of kind -->
13669 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13670 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13671
13672 <thead class="entries_header">
13673 <tr>
13674 <th class="th_name">Property Name</th>
13675 <th class="th_type">Type</th>
13676 <th class="th_description">Description</th>
13677 <th class="th_units">Units</th>
13678 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13679 <th class="th_tags">Tags</th>
13680 </tr>
13681 </thead>
13682
13683 <tbody>
13684
13685
13686
13687
13688
13689
13690
13691
13692
13693
13694 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13695 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13696 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13697 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13698 <td class="entry_type">
13699 <span class="entry_type_name entry_type_name_enum">byte</span>
13700
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13701 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13702
13703 <ul class="entry_type_enum">
13704 <li>
13705 <span class="entry_type_enum_name">OFF</span>
13706 </li>
13707 <li>
13708 <span class="entry_type_enum_name">ON</span>
13709 </li>
13710 </ul>
13711
13712 </td> <!-- entry_type -->
13713
13714 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13715 <p>Whether black-level compensation is locked
13716to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13717 </td>
13718
13719 <td class="entry_units">
13720 </td>
13721
13722 <td class="entry_range">
13723 </td>
13724
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13725 <td class="entry_tags">
13726 <ul class="entry_tags">
13727 <li><a href="#tag_HAL2">HAL2</a></li>
13728 </ul>
13729 </td>
13730
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13731 </tr>
13732 <tr class="entries_header">
13733 <th class="th_details" colspan="5">Details</th>
13734 </tr>
13735 <tr class="entry_cont">
13736 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13737 <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]13738ON 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]13739a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13740perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13741 </td>
13742 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13743
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13744 <tr class="entries_header">
13745 <th class="th_details" colspan="5">HAL Implementation Details</th>
13746 </tr>
13747 <tr class="entry_cont">
13748 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13749 <p>If for some reason black level locking is no longer possible
13750(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13751black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13752override this request (and it must report 'OFF' when this
13753does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13754possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13755 </td>
13756 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13757
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13758 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13759 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13760
13761
13762
13763 <!-- end of kind -->
13764 </tbody>
13765
13766 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13767<!-- </namespace> -->
13768 </table>
13769
13770 <div class="tags" id="tag_index">
13771 <h2>Tags</h2>
13772 <ul>
13773 <li id="tag_AWB">AWB -
13774 Needed for auto white balance
13775
13776 <ul class="tags_entries">
13777 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13778 </ul>
13779 </li> <!-- tag_AWB -->
13780 <li id="tag_BC">BC -
13781 Needed for backwards compatibility with old Java API
13782
13783 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]13784 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13785 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
13786 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
13787 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
13788 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
13789 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13790 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13791 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
13792 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13793 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13794 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
13795 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13796 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
13797 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
13798 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
13799 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
13800 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
13801 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]13802 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13803 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
13804 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
13805 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
13806 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
13807 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
13808 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
13809 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
13810 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
13811 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
13812 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
13813 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
13814 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
13815 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
13816 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
13817 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
13818 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
13819 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
13820 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
13821 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
13822 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13823 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13824 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
13825 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
13826 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
13827 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
13828 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
13829 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
13830 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]13831 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13832 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
13833 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
13834 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13835 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13836 <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]13837 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13838 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13839 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13840 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
13841 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
13842 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
13843 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
13844 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
13845 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
13846 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
13847 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
13848 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
13849 </ul>
13850 </li> <!-- tag_BC -->
13851 <li id="tag_V1">V1 -
13852 New features for first camera 2 release (API1)
13853
13854 <ul class="tags_entries">
13855 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13856 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13857 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13858 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13859 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13860 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13861 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13862 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13863 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13864 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13865 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13866 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13867 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13868 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13869 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13870 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13871 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13872 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13873 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13874 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13875 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13876 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13877 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13878 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13879 <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]13880 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13881 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13882 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13883 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13884 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13885 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13886 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13887 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13888 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13889 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13890 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13891 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13892 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13893 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13894 </ul>
13895 </li> <!-- tag_V1 -->
13896 <li id="tag_ADV">ADV - None
13897 <ul class="tags_entries">
13898 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13899 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13900 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13901 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13902 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13903 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13904 </ul>
13905 </li> <!-- tag_ADV -->
13906 <li id="tag_DNG">DNG -
13907 Needed for DNG file support
13908
13909 <ul class="tags_entries">
13910 <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]13911 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13912 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13913 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13914 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13915 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13916 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13917 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13918 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13919 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13920 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13921 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13922 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13923 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13924 </ul>
13925 </li> <!-- tag_DNG -->
13926 <li id="tag_EXIF">EXIF - None
13927 <ul class="tags_entries">
13928 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13929 </ul>
13930 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13931 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13932 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13933
13934 <ul class="tags_entries">
13935 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13936 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13937 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13938 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13939 </ul>
13940 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13941 <li id="tag_FULL">FULL -
13942 Entry is required for full hardware level devices, and optional for other hardware levels
13943
13944 <ul class="tags_entries">
13945 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13946 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13947 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13948 </ul>
13949 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13950 </ul>
13951 </div>
13952
13953 [ <a href="#">top</a> ]
13954
13955</body>
13956</html>