Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / 63c0fb27d923a32d9a398471ad318bfe84befbeb / . / camera / docs / docs.html
blob: 27b3cedf7571798eab9b7d5a1a5f1d41af72f92a [file] [log] [blame]
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1<!DOCTYPE html>
2<html>
3<!-- Copyright (C) 2012 The Android Open Source Project
4
5 Licensed under the Apache License, Version 2.0 (the "License");
6 you may not use this file except in compliance with the License.
7 You may obtain a copy of the License at
8
9 http://www.apache.org/licenses/LICENSE-2.0
10
11 Unless required by applicable law or agreed to in writing, software
12 distributed under the License is distributed on an "AS IS" BASIS,
13 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 See the License for the specific language governing permissions and
15 limitations under the License.
16-->
17<head>
18 <!-- automatically generated from html.mako. do NOT edit directly -->
19 <meta charset="utf-8" />
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]20 <title>Android Camera HAL3.0 Properties</title>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]21 <style type="text/css">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]22 body { background-color: #f7f7f7; font-family: Roboto, sans-serif;}
23 h1 { color: #333333; }
24 h2 { color: #333333; }
25 a:link { color: #258aaf; text-decoration: none}
26 a:hover { color: #459aaf; text-decoration: underline }
27 a:visited { color: #154a5f; text-decoration: none}
28 .section { color: #eeeeee; font-size: 1.5em; font-weight: bold; background-color: #888888; padding: 0.5em 0em 0.5em 0.5em; border-width: thick thin thin thin; border-color: #111111 #777777 #777777 #777777}
29 .kind { color: #eeeeee; font-size: 1.2em; font-weight: bold; padding-left: 1.5em; background-color: #aaaaaa }
30 .entry { background-color: #f0f0f0 }
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]31 .entry_cont { background-color: #f0f0f0 }
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]32 .entries_header { background-color: #dddddd; text-align: center}
33
34 /* toc style */
35 .toc_section_header { font-size:1.3em; }
36 .toc_kind_header { font-size:1.2em; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]37
38 /* table column sizes */
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]39 table { border-collapse:collapse; table-layout: fixed; width: 100%; word-wrap: break-word }
40 td,th { border: 1px solid; border-color: #aaaaaa; padding-left: 0.5em; padding-right: 0.5em }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]41 .th_name { width: 20% }
42 .th_units { width: 10% }
43 .th_tags { width: 5% }
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]44 .th_details { width: 25% }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]45 .th_type { width: 20% }
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]46 .th_description { width: 20% }
47 .th_range { width: 10% }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]48 td { font-size: 0.9em; }
49
50 /* hide the first thead, we need it there only to enforce column sizes */
51 .thead_dummy { visibility: hidden; }
52
53 /* Entry flair */
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]54 .entry_name { color: #333333; padding-left:1.0em; font-size:1.1em; font-family: monospace; vertical-align:top; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]55
56 /* Entry type flair */
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]57 .entry_type_name { font-size:1.1em; color: #669900; font-weight: bold;}
58 .entry_type_name_enum:after { color: #669900; font-weight: bold; content:" (enum)" }
59 .entry_type_visibility { font-weight: bolder; padding-left:1em}
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]60 .entry_type_enum_name { font-family: monospace; font-weight: bolder; }
61 .entry_type_enum_notes:before { content:" - " }
62 .entry_type_enum_value:before { content:" = " }
63 .entry_type_enum_value { font-family: monospace; }
64 .entry ul { margin: 0 0 0 0; list-style-position: inside; padding-left: 0.5em; }
65 .entry ul li { padding: 0 0 0 0; margin: 0 0 0 0;}
66
67 /* Entry tags flair */
68 .entry_tags ul { list-style-type: none; }
69
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]70 /* Entry details (full docs) flair */
71 .entry_details_header { font-weight: bold; background-color: #dddddd;
72 text-align: center; font-size: 1.1em; margin-left: 0em; margin-right: 0em; }
73
74 /* Entry spacer flair */
75 .entry_spacer { background-color: transparent; border-style: none; height: 0.5em; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]76
77 /* TODO: generate abbr element for each tag link? */
78 /* TODO for each x.y.z try to link it to the entry */
79
80 </style>
81
82 <style>
83
84 {
85 /* broken...
86 supposedly there is a bug in chrome that it lays out tables before
87 it knows its being printed, so the page-break-* styles are ignored
88 */
89 tr { page-break-after: always; page-break-inside: avoid; }
90 }
91
92 </style>
93</head>
94
95
96
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]97<body>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]98 <h1>Android Camera HAL3.0 Properties</h1>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]99
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]100
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]101 <h2>Table of Contents</h2>
102 <ul class="toc">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]103 <li><a href="#tag_index" class="toc_section_header">Tags</a></li>
104 <li>
105 <span class="toc_section_header"><a href="#section_colorCorrection">colorCorrection</a></span>
106 <ul class="toc_section">
107 <li>
108 <span class="toc_kind_header">controls</span>
109 <ul class="toc_section">
110 <li><a href="#controls_android.colorCorrection.mode">android.colorCorrection.mode</a></li>
111 <li><a href="#controls_android.colorCorrection.transform">android.colorCorrection.transform</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]112 <li><a href="#controls_android.colorCorrection.gains">android.colorCorrection.gains</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]113 </ul>
114 </li>
115 <li>
116 <span class="toc_kind_header">dynamic</span>
117 <ul class="toc_section">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]118 <li><a href="#dynamic_android.colorCorrection.transform">android.colorCorrection.transform</a></li>
119 <li><a href="#dynamic_android.colorCorrection.gains">android.colorCorrection.gains</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]120 </ul>
121 </li>
122 </ul> <!-- toc_section -->
123 </li>
124 <li>
125 <span class="toc_section_header"><a href="#section_control">control</a></span>
126 <ul class="toc_section">
127 <li>
128 <span class="toc_kind_header">controls</span>
129 <ul class="toc_section">
130 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a></li>
131 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a></li>
132 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a></li>
133 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a></li>
134 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a></li>
135 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a></li>
136 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a></li>
137 <li><a href="#controls_android.control.afMode">android.control.afMode</a></li>
138 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a></li>
139 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a></li>
140 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a></li>
141 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a></li>
142 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a></li>
143 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a></li>
144 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a></li>
145 <li><a href="#controls_android.control.mode">android.control.mode</a></li>
146 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a></li>
147 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a></li>
148 </ul>
149 </li>
150 <li>
151 <span class="toc_kind_header">static</span>
152 <ul class="toc_section">
153 <li><a href="#static_android.control.aeAvailableAntibandingModes">android.control.aeAvailableAntibandingModes</a></li>
154 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a></li>
155 <li><a href="#static_android.control.aeAvailableTargetFpsRanges">android.control.aeAvailableTargetFpsRanges</a></li>
156 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a></li>
157 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a></li>
158 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a></li>
159 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a></li>
160 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a></li>
161 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a></li>
162 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a></li>
163 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a></li>
164 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a></li>
165 </ul>
166 </li>
167 <li>
168 <span class="toc_kind_header">dynamic</span>
169 <ul class="toc_section">
170 <li><a href="#dynamic_android.control.aePrecaptureId">android.control.aePrecaptureId</a></li>
171 <li><a href="#dynamic_android.control.aeRegions">android.control.aeRegions</a></li>
172 <li><a href="#dynamic_android.control.aeState">android.control.aeState</a></li>
173 <li><a href="#dynamic_android.control.afMode">android.control.afMode</a></li>
174 <li><a href="#dynamic_android.control.afRegions">android.control.afRegions</a></li>
175 <li><a href="#dynamic_android.control.afState">android.control.afState</a></li>
176 <li><a href="#dynamic_android.control.afTriggerId">android.control.afTriggerId</a></li>
177 <li><a href="#dynamic_android.control.awbMode">android.control.awbMode</a></li>
178 <li><a href="#dynamic_android.control.awbRegions">android.control.awbRegions</a></li>
179 <li><a href="#dynamic_android.control.awbState">android.control.awbState</a></li>
180 <li><a href="#dynamic_android.control.mode">android.control.mode</a></li>
181 </ul>
182 </li>
183 </ul> <!-- toc_section -->
184 </li>
185 <li>
186 <span class="toc_section_header"><a href="#section_demosaic">demosaic</a></span>
187 <ul class="toc_section">
188 <li>
189 <span class="toc_kind_header">controls</span>
190 <ul class="toc_section">
191 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a></li>
192 </ul>
193 </li>
194 </ul> <!-- toc_section -->
195 </li>
196 <li>
197 <span class="toc_section_header"><a href="#section_edge">edge</a></span>
198 <ul class="toc_section">
199 <li>
200 <span class="toc_kind_header">controls</span>
201 <ul class="toc_section">
202 <li><a href="#controls_android.edge.mode">android.edge.mode</a></li>
203 <li><a href="#controls_android.edge.strength">android.edge.strength</a></li>
204 </ul>
205 </li>
206 <li>
207 <span class="toc_kind_header">dynamic</span>
208 <ul class="toc_section">
209 <li><a href="#dynamic_android.edge.mode">android.edge.mode</a></li>
210 </ul>
211 </li>
212 </ul> <!-- toc_section -->
213 </li>
214 <li>
215 <span class="toc_section_header"><a href="#section_flash">flash</a></span>
216 <ul class="toc_section">
217 <li>
218 <span class="toc_kind_header">controls</span>
219 <ul class="toc_section">
220 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a></li>
221 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a></li>
222 <li><a href="#controls_android.flash.mode">android.flash.mode</a></li>
223 </ul>
224 </li>
225 <li>
226 <span class="toc_kind_header">static</span>
227 <ul class="toc_section">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]228
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]229 <li><a href="#static_android.flash.info.available">android.flash.info.available</a></li>
230 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]231
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]232 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a></li>
233 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a></li>
234 </ul>
235 </li>
236 <li>
237 <span class="toc_kind_header">dynamic</span>
238 <ul class="toc_section">
239 <li><a href="#dynamic_android.flash.firingPower">android.flash.firingPower</a></li>
240 <li><a href="#dynamic_android.flash.firingTime">android.flash.firingTime</a></li>
241 <li><a href="#dynamic_android.flash.mode">android.flash.mode</a></li>
242 <li><a href="#dynamic_android.flash.state">android.flash.state</a></li>
243 </ul>
244 </li>
245 </ul> <!-- toc_section -->
246 </li>
247 <li>
248 <span class="toc_section_header"><a href="#section_geometric">geometric</a></span>
249 <ul class="toc_section">
250 <li>
251 <span class="toc_kind_header">controls</span>
252 <ul class="toc_section">
253 <li><a href="#controls_android.geometric.mode">android.geometric.mode</a></li>
254 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a></li>
255 </ul>
256 </li>
257 </ul> <!-- toc_section -->
258 </li>
259 <li>
260 <span class="toc_section_header"><a href="#section_hotPixel">hotPixel</a></span>
261 <ul class="toc_section">
262 <li>
263 <span class="toc_kind_header">controls</span>
264 <ul class="toc_section">
265 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a></li>
266 </ul>
267 </li>
268 <li>
269 <span class="toc_kind_header">static</span>
270 <ul class="toc_section">
271
272 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a></li>
273
274 </ul>
275 </li>
276 <li>
277 <span class="toc_kind_header">dynamic</span>
278 <ul class="toc_section">
279 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a></li>
280 </ul>
281 </li>
282 </ul> <!-- toc_section -->
283 </li>
284 <li>
285 <span class="toc_section_header"><a href="#section_jpeg">jpeg</a></span>
286 <ul class="toc_section">
287 <li>
288 <span class="toc_kind_header">controls</span>
289 <ul class="toc_section">
290 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
291 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
292 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
293 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a></li>
294 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a></li>
295 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
296 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
297 </ul>
298 </li>
299 <li>
300 <span class="toc_kind_header">static</span>
301 <ul class="toc_section">
302 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a></li>
303 <li><a href="#static_android.jpeg.maxSize">android.jpeg.maxSize</a></li>
304 </ul>
305 </li>
306 <li>
307 <span class="toc_kind_header">dynamic</span>
308 <ul class="toc_section">
309 <li><a href="#dynamic_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
310 <li><a href="#dynamic_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
311 <li><a href="#dynamic_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
312 <li><a href="#dynamic_android.jpeg.orientation">android.jpeg.orientation</a></li>
313 <li><a href="#dynamic_android.jpeg.quality">android.jpeg.quality</a></li>
314 <li><a href="#dynamic_android.jpeg.size">android.jpeg.size</a></li>
315 <li><a href="#dynamic_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
316 <li><a href="#dynamic_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
317 </ul>
318 </li>
319 </ul> <!-- toc_section -->
320 </li>
321 <li>
322 <span class="toc_section_header"><a href="#section_lens">lens</a></span>
323 <ul class="toc_section">
324 <li>
325 <span class="toc_kind_header">controls</span>
326 <ul class="toc_section">
327 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a></li>
328 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a></li>
329 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a></li>
330 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a></li>
331 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
332 </ul>
333 </li>
334 <li>
335 <span class="toc_kind_header">static</span>
336 <ul class="toc_section">
337
338 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a></li>
339 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a></li>
340 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a></li>
341 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a></li>
342 <li><a href="#static_android.lens.info.geometricCorrectionMap">android.lens.info.geometricCorrectionMap</a></li>
343 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a></li>
344 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a></li>
345 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]346 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a></li>
347
348 <li><a href="#static_android.lens.facing">android.lens.facing</a></li>
349 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a></li>
350 <li><a href="#static_android.lens.position">android.lens.position</a></li>
351 </ul>
352 </li>
353 <li>
354 <span class="toc_kind_header">dynamic</span>
355 <ul class="toc_section">
356 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a></li>
357 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a></li>
358 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a></li>
359 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a></li>
360 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a></li>
361 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
362 <li><a href="#dynamic_android.lens.state">android.lens.state</a></li>
363 </ul>
364 </li>
365 </ul> <!-- toc_section -->
366 </li>
367 <li>
368 <span class="toc_section_header"><a href="#section_noiseReduction">noiseReduction</a></span>
369 <ul class="toc_section">
370 <li>
371 <span class="toc_kind_header">controls</span>
372 <ul class="toc_section">
373 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
374 <li><a href="#controls_android.noiseReduction.strength">android.noiseReduction.strength</a></li>
375 </ul>
376 </li>
377 <li>
378 <span class="toc_kind_header">dynamic</span>
379 <ul class="toc_section">
380 <li><a href="#dynamic_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
381 </ul>
382 </li>
383 </ul> <!-- toc_section -->
384 </li>
385 <li>
386 <span class="toc_section_header"><a href="#section_quirks">quirks</a></span>
387 <ul class="toc_section">
388 <li>
389 <span class="toc_kind_header">static</span>
390 <ul class="toc_section">
391 <li><a href="#static_android.quirks.meteringCropRegion">android.quirks.meteringCropRegion</a></li>
392 <li><a href="#static_android.quirks.triggerAfWithAuto">android.quirks.triggerAfWithAuto</a></li>
393 <li><a href="#static_android.quirks.useZslFormat">android.quirks.useZslFormat</a></li>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]394 <li><a href="#static_android.quirks.usePartialResult">android.quirks.usePartialResult</a></li>
395 </ul>
396 </li>
397 <li>
398 <span class="toc_kind_header">dynamic</span>
399 <ul class="toc_section">
400 <li><a href="#dynamic_android.quirks.partialResult">android.quirks.partialResult</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]401 </ul>
402 </li>
403 </ul> <!-- toc_section -->
404 </li>
405 <li>
406 <span class="toc_section_header"><a href="#section_request">request</a></span>
407 <ul class="toc_section">
408 <li>
409 <span class="toc_kind_header">controls</span>
410 <ul class="toc_section">
411 <li><a href="#controls_android.request.frameCount">android.request.frameCount</a></li>
412 <li><a href="#controls_android.request.id">android.request.id</a></li>
413 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a></li>
414 <li><a href="#controls_android.request.metadataMode">android.request.metadataMode</a></li>
415 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a></li>
416 <li><a href="#controls_android.request.type">android.request.type</a></li>
417 </ul>
418 </li>
419 <li>
420 <span class="toc_kind_header">static</span>
421 <ul class="toc_section">
422 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a></li>
423 <li><a href="#static_android.request.maxNumReprocessStreams">android.request.maxNumReprocessStreams</a></li>
424 </ul>
425 </li>
426 <li>
427 <span class="toc_kind_header">dynamic</span>
428 <ul class="toc_section">
429 <li><a href="#dynamic_android.request.frameCount">android.request.frameCount</a></li>
430 <li><a href="#dynamic_android.request.id">android.request.id</a></li>
431 <li><a href="#dynamic_android.request.metadataMode">android.request.metadataMode</a></li>
432 <li><a href="#dynamic_android.request.outputStreams">android.request.outputStreams</a></li>
433 </ul>
434 </li>
435 </ul> <!-- toc_section -->
436 </li>
437 <li>
438 <span class="toc_section_header"><a href="#section_scaler">scaler</a></span>
439 <ul class="toc_section">
440 <li>
441 <span class="toc_kind_header">controls</span>
442 <ul class="toc_section">
443 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
444 </ul>
445 </li>
446 <li>
447 <span class="toc_kind_header">static</span>
448 <ul class="toc_section">
449 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a></li>
450 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a></li>
451 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a></li>
452 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a></li>
453 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a></li>
454 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a></li>
455 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a></li>
456 <li><a href="#static_android.scaler.availableRawSizes">android.scaler.availableRawSizes</a></li>
457 </ul>
458 </li>
459 <li>
460 <span class="toc_kind_header">dynamic</span>
461 <ul class="toc_section">
462 <li><a href="#dynamic_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
463 </ul>
464 </li>
465 </ul> <!-- toc_section -->
466 </li>
467 <li>
468 <span class="toc_section_header"><a href="#section_sensor">sensor</a></span>
469 <ul class="toc_section">
470 <li>
471 <span class="toc_kind_header">controls</span>
472 <ul class="toc_section">
473 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
474 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
475 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
476 </ul>
477 </li>
478 <li>
479 <span class="toc_kind_header">static</span>
480 <ul class="toc_section">
481
482 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]483 <li><a href="#static_android.sensor.info.sensitivityRange">android.sensor.info.sensitivityRange</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]484 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a></li>
485 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a></li>
486 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a></li>
487 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a></li>
488 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a></li>
489 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a></li>
490
491 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a></li>
492 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a></li>
493 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a></li>
494 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a></li>
495 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a></li>
496 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a></li>
497 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a></li>
498 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a></li>
499 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a></li>
500 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a></li>
501 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a></li>
502 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a></li>
503 <li><a href="#static_android.sensor.referenceIlluminant2">android.sensor.referenceIlluminant2</a></li>
504 </ul>
505 </li>
506 <li>
507 <span class="toc_kind_header">dynamic</span>
508 <ul class="toc_section">
509 <li><a href="#dynamic_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
510 <li><a href="#dynamic_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
511 <li><a href="#dynamic_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
512 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a></li>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]513 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]514 </ul>
515 </li>
516 </ul> <!-- toc_section -->
517 </li>
518 <li>
519 <span class="toc_section_header"><a href="#section_shading">shading</a></span>
520 <ul class="toc_section">
521 <li>
522 <span class="toc_kind_header">controls</span>
523 <ul class="toc_section">
524 <li><a href="#controls_android.shading.mode">android.shading.mode</a></li>
525 <li><a href="#controls_android.shading.strength">android.shading.strength</a></li>
526 </ul>
527 </li>
528 <li>
529 <span class="toc_kind_header">dynamic</span>
530 <ul class="toc_section">
531 <li><a href="#dynamic_android.shading.mode">android.shading.mode</a></li>
532 </ul>
533 </li>
534 </ul> <!-- toc_section -->
535 </li>
536 <li>
537 <span class="toc_section_header"><a href="#section_statistics">statistics</a></span>
538 <ul class="toc_section">
539 <li>
540 <span class="toc_kind_header">controls</span>
541 <ul class="toc_section">
542 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
543 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
544 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]545 <li><a href="#controls_android.statistics.lensShadingMapMode">android.statistics.lensShadingMapMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]546 </ul>
547 </li>
548 <li>
549 <span class="toc_kind_header">static</span>
550 <ul class="toc_section">
551
552 <li><a href="#static_android.statistics.info.availableFaceDetectModes">android.statistics.info.availableFaceDetectModes</a></li>
553 <li><a href="#static_android.statistics.info.histogramBucketCount">android.statistics.info.histogramBucketCount</a></li>
554 <li><a href="#static_android.statistics.info.maxFaceCount">android.statistics.info.maxFaceCount</a></li>
555 <li><a href="#static_android.statistics.info.maxHistogramCount">android.statistics.info.maxHistogramCount</a></li>
556 <li><a href="#static_android.statistics.info.maxSharpnessMapValue">android.statistics.info.maxSharpnessMapValue</a></li>
557 <li><a href="#static_android.statistics.info.sharpnessMapSize">android.statistics.info.sharpnessMapSize</a></li>
558
559 </ul>
560 </li>
561 <li>
562 <span class="toc_kind_header">dynamic</span>
563 <ul class="toc_section">
564 <li><a href="#dynamic_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
565 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a></li>
566 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a></li>
567 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a></li>
568 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a></li>
569 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a></li>
570 <li><a href="#dynamic_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
571 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a></li>
572 <li><a href="#dynamic_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]573 <li><a href="#dynamic_android.statistics.lensShadingMap">android.statistics.lensShadingMap</a></li>
574 <li><a href="#dynamic_android.statistics.predictedColorGains">android.statistics.predictedColorGains</a></li>
575 <li><a href="#dynamic_android.statistics.predictedColorTransform">android.statistics.predictedColorTransform</a></li>
576 <li><a href="#dynamic_android.statistics.sceneFlicker">android.statistics.sceneFlicker</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]577 </ul>
578 </li>
579 </ul> <!-- toc_section -->
580 </li>
581 <li>
582 <span class="toc_section_header"><a href="#section_tonemap">tonemap</a></span>
583 <ul class="toc_section">
584 <li>
585 <span class="toc_kind_header">controls</span>
586 <ul class="toc_section">
587 <li><a href="#controls_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
588 <li><a href="#controls_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
589 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
590 <li><a href="#controls_android.tonemap.mode">android.tonemap.mode</a></li>
591 </ul>
592 </li>
593 <li>
594 <span class="toc_kind_header">static</span>
595 <ul class="toc_section">
596 <li><a href="#static_android.tonemap.maxCurvePoints">android.tonemap.maxCurvePoints</a></li>
597 </ul>
598 </li>
599 <li>
600 <span class="toc_kind_header">dynamic</span>
601 <ul class="toc_section">
602 <li><a href="#dynamic_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
603 <li><a href="#dynamic_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
604 <li><a href="#dynamic_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
605 <li><a href="#dynamic_android.tonemap.mode">android.tonemap.mode</a></li>
606 </ul>
607 </li>
608 </ul> <!-- toc_section -->
609 </li>
610 <li>
611 <span class="toc_section_header"><a href="#section_led">led</a></span>
612 <ul class="toc_section">
613 <li>
614 <span class="toc_kind_header">controls</span>
615 <ul class="toc_section">
616 <li><a href="#controls_android.led.transmit">android.led.transmit</a></li>
617 </ul>
618 </li>
619 <li>
620 <span class="toc_kind_header">dynamic</span>
621 <ul class="toc_section">
622 <li><a href="#dynamic_android.led.transmit">android.led.transmit</a></li>
623 </ul>
624 </li>
625 <li>
626 <span class="toc_kind_header">static</span>
627 <ul class="toc_section">
628 <li><a href="#static_android.led.availableLeds">android.led.availableLeds</a></li>
629 </ul>
630 </li>
631 </ul> <!-- toc_section -->
632 </li>
633 <li>
634 <span class="toc_section_header"><a href="#section_info">info</a></span>
635 <ul class="toc_section">
636 <li>
637 <span class="toc_kind_header">static</span>
638 <ul class="toc_section">
639 <li><a href="#static_android.info.supportedHardwareLevel">android.info.supportedHardwareLevel</a></li>
640 </ul>
641 </li>
642 </ul> <!-- toc_section -->
643 </li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]644 <li>
645 <span class="toc_section_header"><a href="#section_blackLevel">blackLevel</a></span>
646 <ul class="toc_section">
647 <li>
648 <span class="toc_kind_header">controls</span>
649 <ul class="toc_section">
650 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a></li>
651 </ul>
652 </li>
653 <li>
654 <span class="toc_kind_header">dynamic</span>
655 <ul class="toc_section">
656 <li><a href="#dynamic_android.blackLevel.lock">android.blackLevel.lock</a></li>
657 </ul>
658 </li>
659 </ul> <!-- toc_section -->
660 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]661 </ul>
662
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]663
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]664 <h1>Properties</h1>
665 <table class="properties">
666
667 <thead class="thead_dummy">
668 <tr>
669 <th class="th_name">Property Name</th>
670 <th class="th_type">Type</th>
671 <th class="th_description">Description</th>
672 <th class="th_units">Units</th>
673 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]674 <th class="th_tags">Tags</th>
675 </tr>
676 </thead> <!-- so that the first occurrence of thead is not
677 above the first occurrence of tr -->
678<!-- <namespace name="android"> -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]679 <tr><td colspan="6" id="section_colorCorrection" class="section">colorCorrection</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]680
681
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]682 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]683
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]684 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]685 <tr>
686 <th class="th_name">Property Name</th>
687 <th class="th_type">Type</th>
688 <th class="th_description">Description</th>
689 <th class="th_units">Units</th>
690 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]691 <th class="th_tags">Tags</th>
692 </tr>
693 </thead>
694
695 <tbody>
696
697
698
699
700
701
702
703
704
705
706 <tr class="entry" id="controls_android.colorCorrection.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]707 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]708 android.<wbr/>color<wbr/>Correction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]709 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]710 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]711 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]712
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]713 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]714
715 <ul class="entry_type_enum">
716 <li>
717 <span class="entry_type_enum_name">TRANSFORM_MATRIX</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]718 <span class="entry_type_enum_notes">Use the android.<wbr/>color<wbr/>Correction.<wbr/>transform matrix
719 and android.<wbr/>color<wbr/>Correction.<wbr/>gains to do color conversion</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]720 </li>
721 <li>
722 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]723 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
724 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]725 </li>
726 <li>
727 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]728 <span class="entry_type_enum_notes">Frame rate may be reduced by high
729 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]730 </li>
731 </ul>
732
733 </td> <!-- entry_type -->
734
735 <td class="entry_description">
736 </td>
737
738 <td class="entry_units">
739 </td>
740
741 <td class="entry_range">
742 </td>
743
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]744 <td class="entry_tags">
745 </td>
746
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]747 </tr>
748 <tr class="entries_header">
749 <th class="th_details" colspan="5">Details</th>
750 </tr>
751 <tr class="entry_cont">
752 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]753 <p>When <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> is not OFF,<wbr/> TRANSFORM_<wbr/>MATRIX
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]754should be ignored.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]755 </td>
756 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]757
758
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]759 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
760 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]761
762
763 <tr class="entry" id="controls_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]764 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]765 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]766 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]767 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]768 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]769 <span class="entry_type_container">x</span>
770
771 <span class="entry_type_array">
772 3 x 3
773 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]774 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]775 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]776
777
778 </td> <!-- entry_type -->
779
780 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]781 <p>A color transform matrix to use to transform
782from sensor RGB color space to output linear sRGB color space</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]783 </td>
784
785 <td class="entry_units">
786 </td>
787
788 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]789 <p>Output values are expected to be in the range
790(0,<wbr/>1)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]791 </td>
792
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]793 <td class="entry_tags">
794 </td>
795
796 </tr>
797 <tr class="entries_header">
798 <th class="th_details" colspan="5">Details</th>
799 </tr>
800 <tr class="entry_cont">
801 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]802 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]803<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]804directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]805<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]806<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]807for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]808reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]809 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]810 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]811
812
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]813 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
814 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]815
816
817 <tr class="entry" id="controls_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]818 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]819 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]820 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]821 <td class="entry_type">
822 <span class="entry_type_name">float</span>
823 <span class="entry_type_container">x</span>
824
825 <span class="entry_type_array">
826 4
827 </span>
828 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]829 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]830
831
832 </td> <!-- entry_type -->
833
834 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]835 <p>Gains applying to Bayer color channels for
836white-balance</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]837 </td>
838
839 <td class="entry_units">
840 </td>
841
842 <td class="entry_range">
843 </td>
844
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]845 <td class="entry_tags">
846 </td>
847
848 </tr>
849 <tr class="entries_header">
850 <th class="th_details" colspan="5">Details</th>
851 </tr>
852 <tr class="entry_cont">
853 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]854 <p>The 4-channel white-balance gains are defined in
855the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
856for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
857is the gain for greenpixels on the odd rows.<wbr/> if a HAL
858does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
859it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
860G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]861<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]862<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]863directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]864<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]865<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]866the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]867 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]868 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]869
870
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]871 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
872 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]873
874
875
876 <!-- end of kind -->
877 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]878 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]879
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]880 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]881 <tr>
882 <th class="th_name">Property Name</th>
883 <th class="th_type">Type</th>
884 <th class="th_description">Description</th>
885 <th class="th_units">Units</th>
886 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]887 <th class="th_tags">Tags</th>
888 </tr>
889 </thead>
890
891 <tbody>
892
893
894
895
896
897
898
899
900
901
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]902 <tr class="entry" id="dynamic_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]903 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]904 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]905 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]906 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]907 <span class="entry_type_name">rational</span>
908 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]909
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]910 <span class="entry_type_array">
911 3 x 3
912 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]913 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]914 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]915
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]916
917 </td> <!-- entry_type -->
918
919 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]920 <p>A color transform matrix to use to transform
921from sensor RGB color space to output linear sRGB color space</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]922 </td>
923
924 <td class="entry_units">
925 </td>
926
927 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]928 <p>Output values are expected to be in the range
929(0,<wbr/>1)</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]930 </td>
931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]932 <td class="entry_tags">
933 </td>
934
935 </tr>
936 <tr class="entries_header">
937 <th class="th_details" colspan="5">Details</th>
938 </tr>
939 <tr class="entry_cont">
940 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]941 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]942<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]943directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]944<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]945<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]946for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]947reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]948 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]949 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]950
951
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]952 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
953 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]954
955
956 <tr class="entry" id="dynamic_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]957 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]958 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]959 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]960 <td class="entry_type">
961 <span class="entry_type_name">float</span>
962 <span class="entry_type_container">x</span>
963
964 <span class="entry_type_array">
965 4
966 </span>
967 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]968 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]969
970
971 </td> <!-- entry_type -->
972
973 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]974 <p>Gains applying to Bayer color channels for
975white-balance</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]976 </td>
977
978 <td class="entry_units">
979 </td>
980
981 <td class="entry_range">
982 </td>
983
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]984 <td class="entry_tags">
985 </td>
986
987 </tr>
988 <tr class="entries_header">
989 <th class="th_details" colspan="5">Details</th>
990 </tr>
991 <tr class="entry_cont">
992 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]993 <p>The 4-channel white-balance gains are defined in
994the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
995for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
996is the gain for greenpixels on the odd rows.<wbr/> if a HAL
997does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
998it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
999G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1000<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1001<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1002directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1003<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1004<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1005the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1006 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1007 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1008
1009
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1010 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1011 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1012
1013
1014
1015 <!-- end of kind -->
1016 </tbody>
1017
1018 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1019 <tr><td colspan="6" id="section_control" class="section">control</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1020
1021
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1022 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1023
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1024 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1025 <tr>
1026 <th class="th_name">Property Name</th>
1027 <th class="th_type">Type</th>
1028 <th class="th_description">Description</th>
1029 <th class="th_units">Units</th>
1030 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1031 <th class="th_tags">Tags</th>
1032 </tr>
1033 </thead>
1034
1035 <tbody>
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046 <tr class="entry" id="controls_android.control.aeAntibandingMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1047 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1048 android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1049 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1050 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1051 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1052
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1053 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1054
1055 <ul class="entry_type_enum">
1056 <li>
1057 <span class="entry_type_enum_name">OFF</span>
1058 </li>
1059 <li>
1060 <span class="entry_type_enum_name">50HZ</span>
1061 </li>
1062 <li>
1063 <span class="entry_type_enum_name">60HZ</span>
1064 </li>
1065 <li>
1066 <span class="entry_type_enum_name">AUTO</span>
1067 </li>
1068 </ul>
1069
1070 </td> <!-- entry_type -->
1071
1072 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1073 <p>Enum for controlling
1074antibanding</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1075 </td>
1076
1077 <td class="entry_units">
1078 </td>
1079
1080 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1081 <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]1082 </td>
1083
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1084 <td class="entry_tags">
1085 </td>
1086
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1087 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1088
1089
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1090 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1091 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1092
1093
1094 <tr class="entry" id="controls_android.control.aeExposureCompensation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1095 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1096 android.<wbr/>control.<wbr/>ae<wbr/>Exposure<wbr/>Compensation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1097 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1098 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1099 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1100
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1101 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1102
1103
1104 </td> <!-- entry_type -->
1105
1106 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1107 <p>Adjustment to AE target image
1108brightness</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1109 </td>
1110
1111 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1112 count of positive/<wbr/>negative EV steps
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1113 </td>
1114
1115 <td class="entry_range">
1116 </td>
1117
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1118 <td class="entry_tags">
1119 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1120 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1121 </ul>
1122 </td>
1123
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1124 </tr>
1125 <tr class="entries_header">
1126 <th class="th_details" colspan="5">Details</th>
1127 </tr>
1128 <tr class="entry_cont">
1129 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1130 <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]1131exposure compensation of +2 EV; -3 will mean an exposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1132compensation of -1</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1133 </td>
1134 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1135
1136
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1137 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1138 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1139
1140
1141 <tr class="entry" id="controls_android.control.aeLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1142 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1143 android.<wbr/>control.<wbr/>ae<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1144 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1145 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1146 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1147
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1148 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1149
1150 <ul class="entry_type_enum">
1151 <li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1152 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1153 <span class="entry_type_enum_notes">Autoexposure lock is disabled; the AE algorithm
1154 is free to update its parameters.<wbr/></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1155 </li>
1156 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1157 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1158 <span class="entry_type_enum_notes">Autoexposure lock is enabled; the AE algorithm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1159 must not update the exposure and sensitivity parameters
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1160 while the lock is active</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1161 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1162 </ul>
1163
1164 </td> <!-- entry_type -->
1165
1166 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1167 <p>Whether AE is currently locked to its latest
1168calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1169 </td>
1170
1171 <td class="entry_units">
1172 </td>
1173
1174 <td class="entry_range">
1175 </td>
1176
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1177 <td class="entry_tags">
1178 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1179 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1180 </ul>
1181 </td>
1182
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1183 </tr>
1184 <tr class="entries_header">
1185 <th class="th_details" colspan="5">Details</th>
1186 </tr>
1187 <tr class="entry_cont">
1188 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1189 <p>Note that even when AE is locked,<wbr/> the flash may be
1190fired if the AE mode is ON_<wbr/>AUTO_<wbr/>FLASH /<wbr/> ON_<wbr/>ALWAYS_<wbr/>FLASH /<wbr/>
1191ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1192 </td>
1193 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1194
1195
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1196 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1197 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1198
1199
1200 <tr class="entry" id="controls_android.control.aeMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1201 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1202 android.<wbr/>control.<wbr/>ae<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1203 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1204 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1205 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1206
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1207 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1208
1209 <ul class="entry_type_enum">
1210 <li>
1211 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1212 <span class="entry_type_enum_notes">Autoexposure is disabled; sensor.<wbr/>exposureTime,<wbr/>
1213 sensor.<wbr/>sensitivity and sensor.<wbr/>frameDuration are used</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1214 </li>
1215 <li>
1216 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1217 <span class="entry_type_enum_notes">Autoexposure is active,<wbr/> no flash
1218 control</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1219 </li>
1220 <li>
1221 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1222 <span class="entry_type_enum_notes">If autoexposure is active and flash exists,<wbr/> auto
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1223 flash control; flash may be fired when precapture
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1224 trigger is activated,<wbr/> and for captures for which
1225 captureIntent = STILL_<wbr/>CAPTURE</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1226 </li>
1227 <li>
1228 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1229 <span class="entry_type_enum_notes">If autoexposure is active and flash exists,<wbr/> auto
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1230 flash control for precapture trigger and always flash
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1231 when captureIntent = STILL_<wbr/>CAPTURE</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1232 </li>
1233 <li>
1234 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1235 <span class="entry_type_enum_notes">Optional.<wbr/> Automatic red eye reduction with flash.<wbr/>
1236 If deemed necessary,<wbr/> red eye reduction sequence should
1237 fire when precapture trigger is activated,<wbr/> and final
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1238 flash should fire when captureIntent =
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1239 STILL_<wbr/>CAPTURE</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1240 </li>
1241 </ul>
1242
1243 </td> <!-- entry_type -->
1244
1245 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1246 <p>Whether AE is currently updating the sensor
1247exposure and sensitivity fields</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1248 </td>
1249
1250 <td class="entry_units">
1251 </td>
1252
1253 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1254 <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]1255 </td>
1256
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1257 <td class="entry_tags">
1258 <ul class="entry_tags">
1259 <li><a href="#tag_BC">BC</a></li>
1260 </ul>
1261 </td>
1262
1263 </tr>
1264 <tr class="entries_header">
1265 <th class="th_details" colspan="5">Details</th>
1266 </tr>
1267 <tr class="entry_cont">
1268 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1269 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1270<p>If auto-exposure is active,<wbr/> HAL auto-focus routine is enabled,<wbr/>
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1271then HAL auto-exposure routine overrides the control variables
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1272that relate to auto-exposure routine,<wbr/> and these override values
1273are then available in the result metadata for that capture.<wbr/></p>
1274<p>For example,<wbr/> if auto-exposure is enabled in a request,<wbr/> the HAL should
1275overwrite the exposure,<wbr/> gain,<wbr/> and frame duration fields (and potentially
1276the flash fields,<wbr/> depending on AE mode) of the request.<wbr/> The overridden
1277values are then provided back to the user in the corresponding result.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1278 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1279 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1280
1281
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1282 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1283 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1284
1285
1286 <tr class="entry" id="controls_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1287 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1288 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1289 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1290 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1291 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1292 <span class="entry_type_container">x</span>
1293
1294 <span class="entry_type_array">
1295 5 x area_count
1296 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1297 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1298
1299
1300 </td> <!-- entry_type -->
1301
1302 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1303 <p>List of areas to use for
1304metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1305 </td>
1306
1307 <td class="entry_units">
1308 </td>
1309
1310 <td class="entry_range">
1311 </td>
1312
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1313 <td class="entry_tags">
1314 <ul class="entry_tags">
1315 <li><a href="#tag_BC">BC</a></li>
1316 </ul>
1317 </td>
1318
1319 </tr>
1320 <tr class="entries_header">
1321 <th class="th_details" colspan="5">Details</th>
1322 </tr>
1323 <tr class="entry_cont">
1324 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1325 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1326xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1327specified coordinates.<wbr/></p>
1328<p>The coordinate system is based on the active pixel array,<wbr/>
1329with (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^]1330(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1331<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]1332bottom-right pixel in the active pixel array.<wbr/> The weight
1333should be nonnegative.<wbr/></p>
1334<p>If all regions have 0 weight,<wbr/> then no specific metering area
1335needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1336outside 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]1337should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1338used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1339 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1340 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1341
1342
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1343 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1344 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1345
1346
1347 <tr class="entry" id="controls_android.control.aeTargetFpsRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1348 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1349 android.<wbr/>control.<wbr/>ae<wbr/>Target<wbr/>Fps<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1350 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1351 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1352 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1353 <span class="entry_type_container">x</span>
1354
1355 <span class="entry_type_array">
1356 2
1357 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1358 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1359
1360
1361 </td> <!-- entry_type -->
1362
1363 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1364 <p>Range over which fps can be adjusted to
1365maintain exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1366 </td>
1367
1368 <td class="entry_units">
1369 </td>
1370
1371 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1372 <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]1373 </td>
1374
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1375 <td class="entry_tags">
1376 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1377 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1378 </ul>
1379 </td>
1380
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1381 </tr>
1382 <tr class="entries_header">
1383 <th class="th_details" colspan="5">Details</th>
1384 </tr>
1385 <tr class="entry_cont">
1386 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1387 <p>Only constrains AE algorithm,<wbr/> not manual control
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1388of <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]1389 </td>
1390 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1391
1392
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1393 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1394 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1395
1396
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1397 <tr class="entry" id="controls_android.control.aePrecaptureTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1398 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1399 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1400 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1401 <td class="entry_type">
1402 <span class="entry_type_name entry_type_name_enum">byte</span>
1403
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1404 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1405
1406 <ul class="entry_type_enum">
1407 <li>
1408 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1409 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1410 </li>
1411 <li>
1412 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1413 <span class="entry_type_enum_notes">The precapture metering sequence
1414 must be started.<wbr/> The exact effect of the precapture
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1415 trigger depends on the current AE mode and
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1416 state.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1417 </li>
1418 </ul>
1419
1420 </td> <!-- entry_type -->
1421
1422 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1423 <p>Whether the HAL must trigger precapture
1424metering.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1425 </td>
1426
1427 <td class="entry_units">
1428 </td>
1429
1430 <td class="entry_range">
1431 </td>
1432
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1433 <td class="entry_tags">
1434 <ul class="entry_tags">
1435 <li><a href="#tag_BC">BC</a></li>
1436 </ul>
1437 </td>
1438
1439 </tr>
1440 <tr class="entries_header">
1441 <th class="th_details" colspan="5">Details</th>
1442 </tr>
1443 <tr class="entry_cont">
1444 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1445 <p>This entry is normally set to IDLE,<wbr/> or is not
1446included at all in the request settings.<wbr/> When included and
1447set to START,<wbr/> the HAL must trigger the autoexposure
1448precapture metering sequence.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1449<p>The effect of AE precapture trigger depends on the current
1450AE mode and state; see the camera HAL device v3 header for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1451details.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1452 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1453 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1454
1455
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1456 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1457 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1458
1459
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1460 <tr class="entry" id="controls_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1461 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1462 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1463 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1464 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1465 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1466
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1467 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1468
1469 <ul class="entry_type_enum">
1470 <li>
1471 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1472 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
1473 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
1474 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1475 </li>
1476 <li>
1477 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1478 <span class="entry_type_enum_notes">
1479 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1480
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1481 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
1482 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
1483 the autofocus trigger action is called.<wbr/> When that trigger
1484 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
1485 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1486
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1487 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
1488 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1489 </li>
1490 <li>
1491 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1492 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
1493 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1494
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1495 When that trigger is activated,<wbr/> AF must transition to
1496 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
1497 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
1498 position to default,<wbr/> and sets the AF state to
1499 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1500 </li>
1501 <li>
1502 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1503 <span class="entry_type_enum_notes">In this mode,<wbr/> the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1504 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1505 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1506
1507 The focusing behavior should be suitable for good quality
1508 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1509 movement and no overshoots.<wbr/> When the AF trigger is not
1510 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
1511 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
1512 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1513 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1514 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1515 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1516
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1517 Once cancel is received,<wbr/> the algorithm should transition
1518 back to INACTIVE and resume passive scan.<wbr/> Note that this
1519 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
1520 ongoing PASSIVE_<wbr/>SCAN must immediately be
1521 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1522 </li>
1523 <li>
1524 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1525 <span class="entry_type_enum_notes">In this mode,<wbr/> the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1526 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1527 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1528
1529 The focusing behavior should be suitable for still image
1530 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1531 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
1532 algorithm should start in INACTIVE state,<wbr/> and then
1533 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
1534 appropriate as it attempts to maintain focus.<wbr/> When the AF
1535 trigger is activated,<wbr/> the algorithm should finish its
1536 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
1537 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1538 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1539
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1540 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1541 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1542 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1543 </li>
1544 <li>
1545 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1546 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
1547 trigger is ignored,<wbr/> AF state should always be
1548 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1549 </li>
1550 </ul>
1551
1552 </td> <!-- entry_type -->
1553
1554 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1555 <p>Whether AF is currently enabled,<wbr/> and what
1556mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1557 </td>
1558
1559 <td class="entry_units">
1560 </td>
1561
1562 <td class="entry_range">
1563 </td>
1564
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1565 <td class="entry_tags">
1566 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1567 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1568 </ul>
1569 </td>
1570
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1571 </tr>
1572 <tr class="entries_header">
1573 <th class="th_details" colspan="5">Details</th>
1574 </tr>
1575 <tr class="entry_cont">
1576 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1577 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1578<p>If lens is controlled by HAL auto-focus algorithm,<wbr/> the HAL should
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1579report the current AF status in <a href="#dynamic_android.control.afState">android.<wbr/>control.<wbr/>af<wbr/>State</a> in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1580result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1581 </td>
1582 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1583
1584
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1585 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1586 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1587
1588
1589 <tr class="entry" id="controls_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1590 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1591 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1592 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1593 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1594 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1595 <span class="entry_type_container">x</span>
1596
1597 <span class="entry_type_array">
1598 5 x area_count
1599 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1600 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1601
1602
1603 </td> <!-- entry_type -->
1604
1605 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1606 <p>List of areas to use for focus
1607estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1608 </td>
1609
1610 <td class="entry_units">
1611 </td>
1612
1613 <td class="entry_range">
1614 </td>
1615
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1616 <td class="entry_tags">
1617 <ul class="entry_tags">
1618 <li><a href="#tag_BC">BC</a></li>
1619 </ul>
1620 </td>
1621
1622 </tr>
1623 <tr class="entries_header">
1624 <th class="th_details" colspan="5">Details</th>
1625 </tr>
1626 <tr class="entry_cont">
1627 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1628 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1629xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1630specified coordinates.<wbr/></p>
1631<p>The coordinate system is based on the active pixel array,<wbr/>
1632with (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^]1633(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1634<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]1635bottom-right pixel in the active pixel array.<wbr/> The weight
1636should be nonnegative.<wbr/></p>
1637<p>If all regions have 0 weight,<wbr/> then no specific focus area
1638needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1639outside 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]1640should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1641used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1642 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1643 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1644
1645
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1646 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1647 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1648
1649
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1650 <tr class="entry" id="controls_android.control.afTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1651 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1652 android.<wbr/>control.<wbr/>af<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1653 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1654 <td class="entry_type">
1655 <span class="entry_type_name entry_type_name_enum">byte</span>
1656
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1657 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1658
1659 <ul class="entry_type_enum">
1660 <li>
1661 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1662 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1663 </li>
1664 <li>
1665 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1666 <span class="entry_type_enum_notes">Autofocus must trigger now.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1667 </li>
1668 <li>
1669 <span class="entry_type_enum_name">CANCEL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1670 <span class="entry_type_enum_notes">Autofocus must return to initial
1671 state,<wbr/> and cancel any active trigger.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1672 </li>
1673 </ul>
1674
1675 </td> <!-- entry_type -->
1676
1677 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1678 <p>Whether the HAL must trigger autofocus.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1679 </td>
1680
1681 <td class="entry_units">
1682 </td>
1683
1684 <td class="entry_range">
1685 </td>
1686
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1687 <td class="entry_tags">
1688 <ul class="entry_tags">
1689 <li><a href="#tag_BC">BC</a></li>
1690 </ul>
1691 </td>
1692
1693 </tr>
1694 <tr class="entries_header">
1695 <th class="th_details" colspan="5">Details</th>
1696 </tr>
1697 <tr class="entry_cont">
1698 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1699 <p>This entry is normally set to IDLE,<wbr/> or is not
1700included at all in the request settings.<wbr/></p>
1701<p>When included and set to START,<wbr/> the HAL must trigger the
1702autofocus algorithm.<wbr/> The effect of AF trigger depends on the
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1703current AF mode and state; see the camera HAL device v3
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1704header for details.<wbr/> When set to CANCEL,<wbr/> the HAL must cancel
1705any active trigger,<wbr/> and return to initial AF state.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1706 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1707 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1708
1709
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1710 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1711 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1712
1713
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1714 <tr class="entry" id="controls_android.control.awbLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1715 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1716 android.<wbr/>control.<wbr/>awb<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1717 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1718 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1719 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1720
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1721 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1722
1723 <ul class="entry_type_enum">
1724 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1725 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1726 <span class="entry_type_enum_notes">Auto-whitebalance lock is disabled; the AWB
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1727 algorithm is free to update its parameters if in AUTO
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1728 mode.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1729 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1730 <li>
1731 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1732 <span class="entry_type_enum_notes">Auto-whitebalance lock is enabled; the AWB
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1733 algorithm must not update the exposure and sensitivity
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1734 parameters while the lock is active</span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1735 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1736 </ul>
1737
1738 </td> <!-- entry_type -->
1739
1740 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1741 <p>Whether AWB is currently locked to its
1742latest calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1743 </td>
1744
1745 <td class="entry_units">
1746 </td>
1747
1748 <td class="entry_range">
1749 </td>
1750
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1751 <td class="entry_tags">
1752 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1753 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1754 </ul>
1755 </td>
1756
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1757 </tr>
1758 <tr class="entries_header">
1759 <th class="th_details" colspan="5">Details</th>
1760 </tr>
1761 <tr class="entry_cont">
1762 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1763 <p>Note that AWB lock is only meaningful for AUTO
1764mode; in other modes,<wbr/> AWB is already fixed to a specific
1765setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1766 </td>
1767 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1768
1769
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1770 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1771 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1772
1773
1774 <tr class="entry" id="controls_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1775 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1776 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1777 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1778 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1779 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1780
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1781 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1782
1783 <ul class="entry_type_enum">
1784 <li>
1785 <span class="entry_type_enum_name">OFF</span>
1786 </li>
1787 <li>
1788 <span class="entry_type_enum_name">AUTO</span>
1789 </li>
1790 <li>
1791 <span class="entry_type_enum_name">INCANDESCENT</span>
1792 </li>
1793 <li>
1794 <span class="entry_type_enum_name">FLUORESCENT</span>
1795 </li>
1796 <li>
1797 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
1798 </li>
1799 <li>
1800 <span class="entry_type_enum_name">DAYLIGHT</span>
1801 </li>
1802 <li>
1803 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
1804 </li>
1805 <li>
1806 <span class="entry_type_enum_name">TWILIGHT</span>
1807 </li>
1808 <li>
1809 <span class="entry_type_enum_name">SHADE</span>
1810 </li>
1811 </ul>
1812
1813 </td> <!-- entry_type -->
1814
1815 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1816 <p>Whether AWB is currently setting the color
1817transform fields,<wbr/> and what its illumination target
1818is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1819 </td>
1820
1821 <td class="entry_units">
1822 </td>
1823
1824 <td class="entry_range">
1825 </td>
1826
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1827 <td class="entry_tags">
1828 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1829 <li><a href="#tag_BC">BC</a></li>
1830 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1831 </ul>
1832 </td>
1833
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1834 </tr>
1835 <tr class="entries_header">
1836 <th class="th_details" colspan="5">Details</th>
1837 </tr>
1838 <tr class="entry_cont">
1839 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1840 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1841<p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1842 </td>
1843 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1844
1845
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1846 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1847 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1848
1849
1850 <tr class="entry" id="controls_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1851 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1852 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1853 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1854 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1855 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1856 <span class="entry_type_container">x</span>
1857
1858 <span class="entry_type_array">
1859 5 x area_count
1860 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1861 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1862
1863
1864 </td> <!-- entry_type -->
1865
1866 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1867 <p>List of areas to use for illuminant
1868estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1869 </td>
1870
1871 <td class="entry_units">
1872 </td>
1873
1874 <td class="entry_range">
1875 </td>
1876
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1877 <td class="entry_tags">
1878 <ul class="entry_tags">
1879 <li><a href="#tag_BC">BC</a></li>
1880 </ul>
1881 </td>
1882
1883 </tr>
1884 <tr class="entries_header">
1885 <th class="th_details" colspan="5">Details</th>
1886 </tr>
1887 <tr class="entry_cont">
1888 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1889 <p>Only used in AUTO mode.<wbr/></p>
1890<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1891xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1892specified coordinates.<wbr/></p>
1893<p>The coordinate system is based on the active pixel array,<wbr/>
1894with (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^]1895(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1896<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]1897bottom-right pixel in the active pixel array.<wbr/> The weight
1898should be nonnegative.<wbr/></p>
1899<p>If all regions have 0 weight,<wbr/> then no specific metering area
1900needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1901outside 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]1902should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1903used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1904 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1905 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1906
1907
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1908 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1909 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1910
1911
1912 <tr class="entry" id="controls_android.control.captureIntent">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1913 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1914 android.<wbr/>control.<wbr/>capture<wbr/>Intent
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1915 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1916 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1917 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1918
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1919 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1920
1921 <ul class="entry_type_enum">
1922 <li>
1923 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1924 <span class="entry_type_enum_notes">This request doesn't fall into the other
1925 categories.<wbr/> Default to preview-like
1926 behavior.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1927 </li>
1928 <li>
1929 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1930 <span class="entry_type_enum_notes">This request is for a preview-like usecase.<wbr/> The
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1931 precapture trigger may be used to start off a metering
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1932 w/<wbr/>flash sequence</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1933 </li>
1934 <li>
1935 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1936 <span class="entry_type_enum_notes">This request is for a still capture-type
1937 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1938 </li>
1939 <li>
1940 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1941 <span class="entry_type_enum_notes">This request is for a video recording
1942 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1943 </li>
1944 <li>
1945 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1946 <span class="entry_type_enum_notes">This request is for a video snapshot (still
1947 image while recording video) usecase</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1948 </li>
1949 <li>
1950 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1951 <span class="entry_type_enum_notes">This request is for a ZSL usecase; the
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1952 application will stream full-resolution images and
1953 reprocess one or several later for a final
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1954 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1955 </li>
1956 </ul>
1957
1958 </td> <!-- entry_type -->
1959
1960 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1961 <p>Information to 3A routines about the purpose
1962of this capture,<wbr/> to help decide optimal 3A
1963strategy</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1964 </td>
1965
1966 <td class="entry_units">
1967 </td>
1968
1969 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1970 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1971 </td>
1972
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1973 <td class="entry_tags">
1974 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1975 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1976 </ul>
1977 </td>
1978
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1979 </tr>
1980 <tr class="entries_header">
1981 <th class="th_details" colspan="5">Details</th>
1982 </tr>
1983 <tr class="entry_cont">
1984 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]1985 <p>Only used if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1986 </td>
1987 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1988
1989
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1990 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1991 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1992
1993
1994 <tr class="entry" id="controls_android.control.effectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1995 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1996 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1997 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1998 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1999 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2000
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2001 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2002
2003 <ul class="entry_type_enum">
2004 <li>
2005 <span class="entry_type_enum_name">OFF</span>
2006 </li>
2007 <li>
2008 <span class="entry_type_enum_name">MONO</span>
2009 <span class="entry_type_enum_optional">optional</span>
2010 </li>
2011 <li>
2012 <span class="entry_type_enum_name">NEGATIVE</span>
2013 <span class="entry_type_enum_optional">optional</span>
2014 </li>
2015 <li>
2016 <span class="entry_type_enum_name">SOLARIZE</span>
2017 <span class="entry_type_enum_optional">optional</span>
2018 </li>
2019 <li>
2020 <span class="entry_type_enum_name">SEPIA</span>
2021 <span class="entry_type_enum_optional">optional</span>
2022 </li>
2023 <li>
2024 <span class="entry_type_enum_name">POSTERIZE</span>
2025 <span class="entry_type_enum_optional">optional</span>
2026 </li>
2027 <li>
2028 <span class="entry_type_enum_name">WHITEBOARD</span>
2029 <span class="entry_type_enum_optional">optional</span>
2030 </li>
2031 <li>
2032 <span class="entry_type_enum_name">BLACKBOARD</span>
2033 <span class="entry_type_enum_optional">optional</span>
2034 </li>
2035 <li>
2036 <span class="entry_type_enum_name">AQUA</span>
2037 <span class="entry_type_enum_optional">optional</span>
2038 </li>
2039 </ul>
2040
2041 </td> <!-- entry_type -->
2042
2043 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2044 <p>Whether any special color effect is in use.<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2045Only 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]2046 </td>
2047
2048 <td class="entry_units">
2049 </td>
2050
2051 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2052 <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]2053 </td>
2054
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2055 <td class="entry_tags">
2056 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2057 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2058 </ul>
2059 </td>
2060
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2061 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2062
2063
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2064 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2065 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2066
2067
2068 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2069 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2070 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2071 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2072 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2073 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2074
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2075 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2076
2077 <ul class="entry_type_enum">
2078 <li>
2079 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2080 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
2081 routines are disabled,<wbr/> no other settings in
2082 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2083 </li>
2084 <li>
2085 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2086 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
2087 Manual control of capture parameters is disabled.<wbr/> All
2088 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2089 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2090 </li>
2091 <li>
2092 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2093 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
2094 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2095 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2096 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2097 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2098 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2099 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2100 </li>
2101 </ul>
2102
2103 </td> <!-- entry_type -->
2104
2105 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2106 <p>Overall mode of 3A control
2107routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2108 </td>
2109
2110 <td class="entry_units">
2111 </td>
2112
2113 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2114 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2115 </td>
2116
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2117 <td class="entry_tags">
2118 <ul class="entry_tags">
2119 <li><a href="#tag_BC">BC</a></li>
2120 </ul>
2121 </td>
2122
2123 </tr>
2124 <tr class="entries_header">
2125 <th class="th_details" colspan="5">Details</th>
2126 </tr>
2127 <tr class="entry_cont">
2128 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2129 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
2130by the HAL is disabled.<wbr/> The application must set the fields for
2131capture parameters itself.<wbr/></p>
2132<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2133android.<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]2134<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
2135android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
2136one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
2137as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2138<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]2139 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2140 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2141
2142
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2143 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2144 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2145
2146
2147 <tr class="entry" id="controls_android.control.sceneMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2148 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2149 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2150 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2151 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2152 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2153
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2154 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2155
2156 <ul class="entry_type_enum">
2157 <li>
2158 <span class="entry_type_enum_name">UNSUPPORTED</span>
2159 <span class="entry_type_enum_value">0</span>
2160 </li>
2161 <li>
2162 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2163 <span class="entry_type_enum_notes">if face detection support exists Use face
2164 detection data to drive 3A routines.<wbr/> If face detection
2165 statistics are disabled,<wbr/> should still operate correctly
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2166 (but not return face detection statistics to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2167 framework).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2168
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2169 Unlike the other scene modes,<wbr/> aeMode,<wbr/> awbMode,<wbr/> and afMode
2170 remain active when FACE_<wbr/>PRIORITY is set.<wbr/> This is due to
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2171 compatibility concerns with the old camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2172 API</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2173 </li>
2174 <li>
2175 <span class="entry_type_enum_name">ACTION</span>
2176 <span class="entry_type_enum_optional">optional</span>
2177 </li>
2178 <li>
2179 <span class="entry_type_enum_name">PORTRAIT</span>
2180 <span class="entry_type_enum_optional">optional</span>
2181 </li>
2182 <li>
2183 <span class="entry_type_enum_name">LANDSCAPE</span>
2184 <span class="entry_type_enum_optional">optional</span>
2185 </li>
2186 <li>
2187 <span class="entry_type_enum_name">NIGHT</span>
2188 <span class="entry_type_enum_optional">optional</span>
2189 </li>
2190 <li>
2191 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2192 <span class="entry_type_enum_optional">optional</span>
2193 </li>
2194 <li>
2195 <span class="entry_type_enum_name">THEATRE</span>
2196 <span class="entry_type_enum_optional">optional</span>
2197 </li>
2198 <li>
2199 <span class="entry_type_enum_name">BEACH</span>
2200 <span class="entry_type_enum_optional">optional</span>
2201 </li>
2202 <li>
2203 <span class="entry_type_enum_name">SNOW</span>
2204 <span class="entry_type_enum_optional">optional</span>
2205 </li>
2206 <li>
2207 <span class="entry_type_enum_name">SUNSET</span>
2208 <span class="entry_type_enum_optional">optional</span>
2209 </li>
2210 <li>
2211 <span class="entry_type_enum_name">STEADYPHOTO</span>
2212 <span class="entry_type_enum_optional">optional</span>
2213 </li>
2214 <li>
2215 <span class="entry_type_enum_name">FIREWORKS</span>
2216 <span class="entry_type_enum_optional">optional</span>
2217 </li>
2218 <li>
2219 <span class="entry_type_enum_name">SPORTS</span>
2220 <span class="entry_type_enum_optional">optional</span>
2221 </li>
2222 <li>
2223 <span class="entry_type_enum_name">PARTY</span>
2224 <span class="entry_type_enum_optional">optional</span>
2225 </li>
2226 <li>
2227 <span class="entry_type_enum_name">CANDLELIGHT</span>
2228 <span class="entry_type_enum_optional">optional</span>
2229 </li>
2230 <li>
2231 <span class="entry_type_enum_name">BARCODE</span>
2232 <span class="entry_type_enum_optional">optional</span>
2233 </li>
2234 </ul>
2235
2236 </td> <!-- entry_type -->
2237
2238 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2239 <p>Which scene mode is active when
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2240<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]2241 </td>
2242
2243 <td class="entry_units">
2244 </td>
2245
2246 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2247 <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]2248 </td>
2249
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2250 <td class="entry_tags">
2251 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2252 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2253 </ul>
2254 </td>
2255
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2256 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2257
2258
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2259 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2260 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2261
2262
2263 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2264 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2265 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2266 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2267 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2268 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2269
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2270 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2271
2272 <ul class="entry_type_enum">
2273 <li>
2274 <span class="entry_type_enum_name">OFF</span>
2275 </li>
2276 <li>
2277 <span class="entry_type_enum_name">ON</span>
2278 </li>
2279 </ul>
2280
2281 </td> <!-- entry_type -->
2282
2283 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2284 <p>Whether video stabilization is
2285active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2286 </td>
2287
2288 <td class="entry_units">
2289 </td>
2290
2291 <td class="entry_range">
2292 </td>
2293
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2294 <td class="entry_tags">
2295 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2296 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2297 </ul>
2298 </td>
2299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2300 </tr>
2301 <tr class="entries_header">
2302 <th class="th_details" colspan="5">Details</th>
2303 </tr>
2304 <tr class="entry_cont">
2305 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2306 <p>If enabled,<wbr/> video stabilization can modify the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2307<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]2308stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2309 </td>
2310 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2311
2312
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2313 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2314 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2315
2316
2317
2318 <!-- end of kind -->
2319 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2320 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2321
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2322 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2323 <tr>
2324 <th class="th_name">Property Name</th>
2325 <th class="th_type">Type</th>
2326 <th class="th_description">Description</th>
2327 <th class="th_units">Units</th>
2328 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2329 <th class="th_tags">Tags</th>
2330 </tr>
2331 </thead>
2332
2333 <tbody>
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2345 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2346 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2347 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2348 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2349 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2350 <span class="entry_type_container">x</span>
2351
2352 <span class="entry_type_array">
2353 n
2354 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2355 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2356 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2357
2358
2359 </td> <!-- entry_type -->
2360
2361 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2362 <p>Which set of antibanding modes are
2363supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2364 </td>
2365
2366 <td class="entry_units">
2367 </td>
2368
2369 <td class="entry_range">
2370 </td>
2371
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2372 <td class="entry_tags">
2373 </td>
2374
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2375 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2376
2377
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2378 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2379 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2380
2381
2382 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2383 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2384 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2385 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2386 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2387 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2388 <span class="entry_type_container">x</span>
2389
2390 <span class="entry_type_array">
2391 n
2392 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2393 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2394 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2395
2396
2397 </td> <!-- entry_type -->
2398
2399 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2400 <p>Which subset of AE modes is
2401supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2402 </td>
2403
2404 <td class="entry_units">
2405 </td>
2406
2407 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2408 <p>OFF,<wbr/> ON must be supported.<wbr/>
2409ON_<wbr/>AUTO_<wbr/>FLASH/<wbr/>ON_<wbr/>ALWAYS_<wbr/>FLASH must be supported if flash
2410unit is available</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2411 </td>
2412
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2413 <td class="entry_tags">
2414 </td>
2415
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2416 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2417
2418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2419 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2420 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2421
2422
2423 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2424 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2425 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2426 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2427 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2428 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2429 <span class="entry_type_container">x</span>
2430
2431 <span class="entry_type_array">
2432 2 x n
2433 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2434 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2435 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2436
2437
2438 </td> <!-- entry_type -->
2439
2440 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2441 <p>List of frame rate ranges supported by the
2442AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2443 </td>
2444
2445 <td class="entry_units">
2446 </td>
2447
2448 <td class="entry_range">
2449 </td>
2450
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2451 <td class="entry_tags">
2452 </td>
2453
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2454 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2455
2456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2457 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2458 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2459
2460
2461 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2462 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2463 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2464 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2465 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2466 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2467 <span class="entry_type_container">x</span>
2468
2469 <span class="entry_type_array">
2470 2
2471 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2472 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2473
2474
2475 </td> <!-- entry_type -->
2476
2477 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2478 <p>Maximum and minimum exposure compensation
2479setting,<wbr/> in counts of
2480android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2481 </td>
2482
2483 <td class="entry_units">
2484 </td>
2485
2486 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2487 <p>At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2488size)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2489 </td>
2490
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2491 <td class="entry_tags">
2492 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2493 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2494 </ul>
2495 </td>
2496
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2497 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2498
2499
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2500 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2501 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2502
2503
2504 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2505 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2506 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2507 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2508 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2509 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2510
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2511 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2512
2513
2514 </td> <!-- entry_type -->
2515
2516 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2517 <p>Smallest step by which exposure compensation
2518can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2519 </td>
2520
2521 <td class="entry_units">
2522 </td>
2523
2524 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2525 <p>&lt;= 1/<wbr/>2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2526 </td>
2527
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2528 <td class="entry_tags">
2529 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2530 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2531 </ul>
2532 </td>
2533
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2534 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2535
2536
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2537 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2538 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2539
2540
2541 <tr class="entry" id="static_android.control.afAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2542 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2543 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2544 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2545 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2546 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2547 <span class="entry_type_container">x</span>
2548
2549 <span class="entry_type_array">
2550 n
2551 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2552 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2553 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2554
2555
2556 </td> <!-- entry_type -->
2557
2558 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2559 <p>List of AF modes that can be
2560selected</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2561 </td>
2562
2563 <td class="entry_units">
2564 </td>
2565
2566 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2567 <p>OFF must be included.<wbr/> AUTO must be supported if
2568lens allows for changing focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2569 </td>
2570
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2571 <td class="entry_tags">
2572 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2573 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2574 </ul>
2575 </td>
2576
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2577 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2578
2579
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2580 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2581 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2582
2583
2584 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2585 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2586 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2587 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2588 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2589 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2590 <span class="entry_type_container">x</span>
2591
2592 <span class="entry_type_array">
2593 n
2594 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2595 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2596 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2597
2598
2599 </td> <!-- entry_type -->
2600
2601 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2602 <p>what subset of the full color effect enum
2603list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2604 </td>
2605
2606 <td class="entry_units">
2607 </td>
2608
2609 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2610 <p>OFF must be listed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2611 </td>
2612
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2613 <td class="entry_tags">
2614 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2615 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2616 </ul>
2617 </td>
2618
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2619 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2620
2621
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2622 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2623 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2624
2625
2626 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2627 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2628 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2629 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2630 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2631 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2632 <span class="entry_type_container">x</span>
2633
2634 <span class="entry_type_array">
2635 n
2636 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2637 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2638 <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]2639
2640
2641 </td> <!-- entry_type -->
2642
2643 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2644 <p>what subset of the scene mode enum list is
2645supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2646 </td>
2647
2648 <td class="entry_units">
2649 </td>
2650
2651 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2652 <p>SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2653detection is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2654 </td>
2655
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2656 <td class="entry_tags">
2657 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2658 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2659 </ul>
2660 </td>
2661
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2662 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2663
2664
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2665 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2666 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2667
2668
2669 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2670 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2671 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2672 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2673 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2674 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2675 <span class="entry_type_container">x</span>
2676
2677 <span class="entry_type_array">
2678 n
2679 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2680 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2681 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2682
2683
2684 </td> <!-- entry_type -->
2685
2686 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2687 <p>List of video stabilization modes that can
2688be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2689 </td>
2690
2691 <td class="entry_units">
2692 </td>
2693
2694 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2695 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2696 </td>
2697
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2698 <td class="entry_tags">
2699 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2700 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2701 </ul>
2702 </td>
2703
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2704 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2705
2706
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2707 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2708 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2709
2710
2711 <tr class="entry" id="static_android.control.awbAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2712 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2713 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2714 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2715 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2716 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2717 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2718
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2719 <span class="entry_type_array">
2720 n
2721 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2722 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2723 <div class="entry_type_notes">List of enums (android.<wbr/>control.<wbr/>awb<wbr/>Mode)</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2724
2725
2726 </td> <!-- entry_type -->
2727
2728 <td class="entry_description">
2729 </td>
2730
2731 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2732 </td>
2733
2734 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2735 <p>OFF,<wbr/> AUTO must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2736 </td>
2737
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2738 <td class="entry_tags">
2739 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2740 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2741 </ul>
2742 </td>
2743
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2744 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2745
2746
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2747 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2748 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2749
2750
2751 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2752 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2753 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2754 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2755 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2756 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2757
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2758 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2759
2760
2761 </td> <!-- entry_type -->
2762
2763 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2764 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
2765regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2766 </td>
2767
2768 <td class="entry_units">
2769 </td>
2770
2771 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2772 <blockquote>
2773<p>= 1</p>
2774</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2775 </td>
2776
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2777 <td class="entry_tags">
2778 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2779 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2780 </ul>
2781 </td>
2782
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2783 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2784
2785
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2786 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2787 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2788
2789
2790 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2791 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2792 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2793 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2794 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2795 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2796 <span class="entry_type_container">x</span>
2797
2798 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2799 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2800 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2801 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2802
2803
2804 </td> <!-- entry_type -->
2805
2806 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2807 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
2808each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2809 </td>
2810
2811 <td class="entry_units">
2812 </td>
2813
2814 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2815 <p>For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
2816awbMode,<wbr/> and afMode that the HAL wants to use for that
2817scene mode.<wbr/></p>
2818<p>For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
2819order of increasing index</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2820 </td>
2821
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2822 <td class="entry_tags">
2823 <ul class="entry_tags">
2824 <li><a href="#tag_BC">BC</a></li>
2825 </ul>
2826 </td>
2827
2828 </tr>
2829 <tr class="entries_header">
2830 <th class="th_details" colspan="5">Details</th>
2831 </tr>
2832 <tr class="entry_cont">
2833 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2834 <p>When a scene mode is enabled,<wbr/> the HAL is expected
2835to override aeMode,<wbr/> awbMode,<wbr/> and afMode with its
2836preferred settings for that scene mode.<wbr/></p>
2837<p>To simplify communication with old camera API applications,<wbr/>
2838the service wants this override list in the static metadata.<wbr/>
2839The order of this list matches that of availableSceneModes,<wbr/>
2840with 3 entires for each scene mode.<wbr/> The overrides listed
2841for SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
2842mode,<wbr/> the application-set aeMode,<wbr/> awbMode,<wbr/> and afMode are
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2843used 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]2844AUTO.<wbr/></p>
2845<p>It is recommended that for FACE_<wbr/>PRIORITY,<wbr/> the overrides
2846should be set to 0.<wbr/> As an example,<wbr/> if availableSceneModes is
2847{ FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT },<wbr/> then the service expects
2848this field to have 9 entries; for example { 0 ,<wbr/> 0,<wbr/> 0,<wbr/>
2849ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
2850INCANDESCENT,<wbr/> AUTO }</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2851 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2852 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2853
2854
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2855 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2856 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2857
2858
2859
2860 <!-- end of kind -->
2861 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2862 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2863
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2864 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2865 <tr>
2866 <th class="th_name">Property Name</th>
2867 <th class="th_type">Type</th>
2868 <th class="th_description">Description</th>
2869 <th class="th_units">Units</th>
2870 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2871 <th class="th_tags">Tags</th>
2872 </tr>
2873 </thead>
2874
2875 <tbody>
2876
2877
2878
2879
2880
2881
2882
2883
2884
2885
2886 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2887 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2888 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2889 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2890 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2891 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2892
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2893 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2894
2895
2896 </td> <!-- entry_type -->
2897
2898 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2899 <p>The ID sent with the latest
2900CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2901 </td>
2902
2903 <td class="entry_units">
2904 </td>
2905
2906 <td class="entry_range">
2907 </td>
2908
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2909 <td class="entry_tags">
2910 </td>
2911
2912 </tr>
2913 <tr class="entries_header">
2914 <th class="th_details" colspan="5">Details</th>
2915 </tr>
2916 <tr class="entry_cont">
2917 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2918 <p>Must be 0 if no
2919CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
2920by HAL.<wbr/> Always updated even if AE algorithm ignores the
2921trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2922 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2923 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2924
2925
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2926 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2927 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2928
2929
2930 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2931 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2932 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2933 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2934 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2935 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2936 <span class="entry_type_container">x</span>
2937
2938 <span class="entry_type_array">
2939 5 x area_count
2940 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2941 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2942
2943
2944 </td> <!-- entry_type -->
2945
2946 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2947 <p>List of areas to use for
2948metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2949 </td>
2950
2951 <td class="entry_units">
2952 </td>
2953
2954 <td class="entry_range">
2955 </td>
2956
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2957 <td class="entry_tags">
2958 <ul class="entry_tags">
2959 <li><a href="#tag_BC">BC</a></li>
2960 </ul>
2961 </td>
2962
2963 </tr>
2964 <tr class="entries_header">
2965 <th class="th_details" colspan="5">Details</th>
2966 </tr>
2967 <tr class="entry_cont">
2968 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2969 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
2970xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
2971specified coordinates.<wbr/></p>
2972<p>The coordinate system is based on the active pixel array,<wbr/>
2973with (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^]2974(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
2975<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]2976bottom-right pixel in the active pixel array.<wbr/> The weight
2977should be nonnegative.<wbr/></p>
2978<p>If all regions have 0 weight,<wbr/> then no specific metering area
2979needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]2980outside 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]2981should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2982used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2983 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2984 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2985
2986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2987 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2988 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2989
2990
2991 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2992 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2993 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2994 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2995 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2996 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2997
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2998 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2999
3000 <ul class="entry_type_enum">
3001 <li>
3002 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3003 <span class="entry_type_enum_notes">AE is off.<wbr/> When a camera device is opened,<wbr/> it starts in
3004 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3005 </li>
3006 <li>
3007 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3008 <span class="entry_type_enum_notes">AE doesn't yet have a good set of control values
3009 for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3010 </li>
3011 <li>
3012 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3013 <span class="entry_type_enum_notes">AE has a good set of control values for the
3014 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3015 </li>
3016 <li>
3017 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3018 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3019 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3020 </li>
3021 <li>
3022 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3023 <span class="entry_type_enum_notes">AE has a good set of control values,<wbr/> but flash
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3024 needs to be fired for good quality still
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3025 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3026 </li>
3027 <li>
3028 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3029 <span class="entry_type_enum_notes">AE has been asked to do a precapture sequence
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3030 (through the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3031 trigger_<wbr/>action(CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING)
3032 call),<wbr/> and is currently executing it.<wbr/> Once PRECAPTURE
3033 completes,<wbr/> AE will transition to CONVERGED or
3034 FLASH_<wbr/>REQUIRED as appropriate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3035 </li>
3036 </ul>
3037
3038 </td> <!-- entry_type -->
3039
3040 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3041 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3042 </td>
3043
3044 <td class="entry_units">
3045 </td>
3046
3047 <td class="entry_range">
3048 </td>
3049
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3050 <td class="entry_tags">
3051 </td>
3052
3053 </tr>
3054 <tr class="entries_header">
3055 <th class="th_details" colspan="5">Details</th>
3056 </tr>
3057 <tr class="entry_cont">
3058 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3059 <p>Whenever the AE algorithm state changes,<wbr/> a
3060MSG_<wbr/>AUTOEXPOSURE notification must be send if a
3061notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3062 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3063 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3064
3065
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3066 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3067 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3068
3069
3070 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3071 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3072 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3073 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3074 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3075 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3076
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3077 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3078
3079 <ul class="entry_type_enum">
3080 <li>
3081 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3082 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
3083 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
3084 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3085 </li>
3086 <li>
3087 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3088 <span class="entry_type_enum_notes">
3089 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3090
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3091 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
3092 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3093 the autofocus trigger action is called.<wbr/> When that trigger
3094 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3095 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3096
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3097 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3098 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3099 </li>
3100 <li>
3101 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3102 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
3103 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3104
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3105 When that trigger is activated,<wbr/> AF must transition to
3106 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3107 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3108 position to default,<wbr/> and sets the AF state to
3109 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3110 </li>
3111 <li>
3112 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3113 <span class="entry_type_enum_notes">In this mode,<wbr/> the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3114 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3115 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3116
3117 The focusing behavior should be suitable for good quality
3118 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3119 movement and no overshoots.<wbr/> When the AF trigger is not
3120 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3121 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3122 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3123 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3124 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3125 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3126
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3127 Once cancel is received,<wbr/> the algorithm should transition
3128 back to INACTIVE and resume passive scan.<wbr/> Note that this
3129 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3130 ongoing PASSIVE_<wbr/>SCAN must immediately be
3131 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3132 </li>
3133 <li>
3134 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3135 <span class="entry_type_enum_notes">In this mode,<wbr/> the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3136 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3137 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3138
3139 The focusing behavior should be suitable for still image
3140 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3141 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3142 algorithm should start in INACTIVE state,<wbr/> and then
3143 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3144 appropriate as it attempts to maintain focus.<wbr/> When the AF
3145 trigger is activated,<wbr/> the algorithm should finish its
3146 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3147 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3148 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3149
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3150 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3151 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3152 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3153 </li>
3154 <li>
3155 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3156 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
3157 trigger is ignored,<wbr/> AF state should always be
3158 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3159 </li>
3160 </ul>
3161
3162 </td> <!-- entry_type -->
3163
3164 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3165 <p>Whether AF is currently enabled,<wbr/> and what
3166mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3167 </td>
3168
3169 <td class="entry_units">
3170 </td>
3171
3172 <td class="entry_range">
3173 </td>
3174
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3175 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3176 <ul class="entry_tags">
3177 <li><a href="#tag_BC">BC</a></li>
3178 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3179 </td>
3180
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3181 </tr>
3182 <tr class="entries_header">
3183 <th class="th_details" colspan="5">Details</th>
3184 </tr>
3185 <tr class="entry_cont">
3186 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]3187 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3188<p>If lens is controlled by HAL auto-focus algorithm,<wbr/> the HAL should
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]3189report the current AF status in <a href="#dynamic_android.control.afState">android.<wbr/>control.<wbr/>af<wbr/>State</a> in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3190result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3191 </td>
3192 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3193
3194
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3195 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3196 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3197
3198
3199 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3200 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3201 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3202 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3203 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3204 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3205 <span class="entry_type_container">x</span>
3206
3207 <span class="entry_type_array">
3208 5 x area_count
3209 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3210 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3211
3212
3213 </td> <!-- entry_type -->
3214
3215 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3216 <p>List of areas to use for focus
3217estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3218 </td>
3219
3220 <td class="entry_units">
3221 </td>
3222
3223 <td class="entry_range">
3224 </td>
3225
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3226 <td class="entry_tags">
3227 <ul class="entry_tags">
3228 <li><a href="#tag_BC">BC</a></li>
3229 </ul>
3230 </td>
3231
3232 </tr>
3233 <tr class="entries_header">
3234 <th class="th_details" colspan="5">Details</th>
3235 </tr>
3236 <tr class="entry_cont">
3237 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3238 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3239xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3240specified coordinates.<wbr/></p>
3241<p>The coordinate system is based on the active pixel array,<wbr/>
3242with (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^]3243(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3244<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]3245bottom-right pixel in the active pixel array.<wbr/> The weight
3246should be nonnegative.<wbr/></p>
3247<p>If all regions have 0 weight,<wbr/> then no specific focus area
3248needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]3249outside 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]3250should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3251used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3252 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3253 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3254
3255
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3256 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3257 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3258
3259
3260 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3261 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3262 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3263 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3264 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3265 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3266
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3267 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3268
3269 <ul class="entry_type_enum">
3270 <li>
3271 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3272 <span class="entry_type_enum_notes">AF off or has not yet tried to scan/<wbr/>been asked
3273 to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3274 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3275 </li>
3276 <li>
3277 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3278 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF is
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3279 currently doing an AF scan initiated by a continuous
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3280 autofocus mode</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3281 </li>
3282 <li>
3283 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3284 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3285 believes it is in focus,<wbr/> but may restart scanning at
3286 any time.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3287 </li>
3288 <li>
3289 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3290 <span class="entry_type_enum_notes">if AUTO or MACRO modes are supported.<wbr/> AF is doing
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3291 an AF scan because it was triggered by AF
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3292 trigger</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3293 </li>
3294 <li>
3295 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3296 <span class="entry_type_enum_notes">if any AF mode besides OFF is supported.<wbr/> AF
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3297 believes it is focused correctly and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3298 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3299 </li>
3300 <li>
3301 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3302 <span class="entry_type_enum_notes">if any AF mode besides OFF is supported.<wbr/> AF has
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3303 failed to focus successfully and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3304 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3305 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3306 <li>
3307 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3308 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3309 passive scan without finding focus,<wbr/> and may restart
3310 scanning at any time.<wbr/></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3311 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3312 </ul>
3313
3314 </td> <!-- entry_type -->
3315
3316 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3317 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3318 </td>
3319
3320 <td class="entry_units">
3321 </td>
3322
3323 <td class="entry_range">
3324 </td>
3325
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3326 <td class="entry_tags">
3327 </td>
3328
3329 </tr>
3330 <tr class="entries_header">
3331 <th class="th_details" colspan="5">Details</th>
3332 </tr>
3333 <tr class="entry_cont">
3334 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3335 <p>Whenever the AF algorithm state changes,<wbr/> a
3336MSG_<wbr/>AUTOFOCUS notification must be send if a notification
3337callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3338 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3339 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3340
3341
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3342 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3343 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3344
3345
3346 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3347 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3348 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3349 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3350 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3351 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3352
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3353 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3354
3355
3356 </td> <!-- entry_type -->
3357
3358 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3359 <p>The ID sent with the latest
3360CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3361 </td>
3362
3363 <td class="entry_units">
3364 </td>
3365
3366 <td class="entry_range">
3367 </td>
3368
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3369 <td class="entry_tags">
3370 </td>
3371
3372 </tr>
3373 <tr class="entries_header">
3374 <th class="th_details" colspan="5">Details</th>
3375 </tr>
3376 <tr class="entry_cont">
3377 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3378 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
3379received yet by HAL.<wbr/> Always updated even if AF algorithm
3380ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3381 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3382 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3383
3384
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3385 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3386 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3387
3388
3389 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3390 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3391 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3392 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3393 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3394 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3395
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3396 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3397
3398 <ul class="entry_type_enum">
3399 <li>
3400 <span class="entry_type_enum_name">OFF</span>
3401 </li>
3402 <li>
3403 <span class="entry_type_enum_name">AUTO</span>
3404 </li>
3405 <li>
3406 <span class="entry_type_enum_name">INCANDESCENT</span>
3407 </li>
3408 <li>
3409 <span class="entry_type_enum_name">FLUORESCENT</span>
3410 </li>
3411 <li>
3412 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
3413 </li>
3414 <li>
3415 <span class="entry_type_enum_name">DAYLIGHT</span>
3416 </li>
3417 <li>
3418 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
3419 </li>
3420 <li>
3421 <span class="entry_type_enum_name">TWILIGHT</span>
3422 </li>
3423 <li>
3424 <span class="entry_type_enum_name">SHADE</span>
3425 </li>
3426 </ul>
3427
3428 </td> <!-- entry_type -->
3429
3430 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3431 <p>Whether AWB is currently setting the color
3432transform fields,<wbr/> and what its illumination target
3433is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3434 </td>
3435
3436 <td class="entry_units">
3437 </td>
3438
3439 <td class="entry_range">
3440 </td>
3441
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3442 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3443 <ul class="entry_tags">
3444 <li><a href="#tag_BC">BC</a></li>
3445 <li><a href="#tag_AWB">AWB</a></li>
3446 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3447 </td>
3448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3449 </tr>
3450 <tr class="entries_header">
3451 <th class="th_details" colspan="5">Details</th>
3452 </tr>
3453 <tr class="entry_cont">
3454 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3455 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]3456<p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3457 </td>
3458 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3459
3460
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3461 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3462 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3463
3464
3465 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3466 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3467 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3468 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3469 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3470 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3471 <span class="entry_type_container">x</span>
3472
3473 <span class="entry_type_array">
3474 5 x area_count
3475 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3476 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3477
3478
3479 </td> <!-- entry_type -->
3480
3481 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3482 <p>List of areas to use for illuminant
3483estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3484 </td>
3485
3486 <td class="entry_units">
3487 </td>
3488
3489 <td class="entry_range">
3490 </td>
3491
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3492 <td class="entry_tags">
3493 <ul class="entry_tags">
3494 <li><a href="#tag_BC">BC</a></li>
3495 </ul>
3496 </td>
3497
3498 </tr>
3499 <tr class="entries_header">
3500 <th class="th_details" colspan="5">Details</th>
3501 </tr>
3502 <tr class="entry_cont">
3503 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3504 <p>Only used in AUTO mode.<wbr/></p>
3505<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3506xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3507specified coordinates.<wbr/></p>
3508<p>The coordinate system is based on the active pixel array,<wbr/>
3509with (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^]3510(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3511<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]3512bottom-right pixel in the active pixel array.<wbr/> The weight
3513should be nonnegative.<wbr/></p>
3514<p>If all regions have 0 weight,<wbr/> then no specific metering area
3515needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]3516outside 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]3517should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3518used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3519 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3520 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3521
3522
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3523 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3524 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3525
3526
3527 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3528 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3529 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3530 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3531 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3532 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3533
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3534 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3535
3536 <ul class="entry_type_enum">
3537 <li>
3538 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3539 <span class="entry_type_enum_notes">AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
3540 starts in this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3541 </li>
3542 <li>
3543 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3544 <span class="entry_type_enum_notes">AWB doesn't yet have a good set of control
3545 values for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3546 </li>
3547 <li>
3548 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3549 <span class="entry_type_enum_notes">AWB has a good set of control values for the
3550 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3551 </li>
3552 <li>
3553 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3554 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3555 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3556 </li>
3557 </ul>
3558
3559 </td> <!-- entry_type -->
3560
3561 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3562 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3563 </td>
3564
3565 <td class="entry_units">
3566 </td>
3567
3568 <td class="entry_range">
3569 </td>
3570
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3571 <td class="entry_tags">
3572 </td>
3573
3574 </tr>
3575 <tr class="entries_header">
3576 <th class="th_details" colspan="5">Details</th>
3577 </tr>
3578 <tr class="entry_cont">
3579 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3580 <p>Whenever the AWB algorithm state changes,<wbr/> a
3581MSG_<wbr/>AUTOWHITEBALANCE notification must be send if a
3582notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3583 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3584 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3585
3586
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3587 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3588 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3589
3590
3591 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3592 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3593 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3594 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3595 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3596 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3597
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3598 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3599
3600 <ul class="entry_type_enum">
3601 <li>
3602 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3603 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
3604 routines are disabled,<wbr/> no other settings in
3605 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3606 </li>
3607 <li>
3608 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3609 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
3610 Manual control of capture parameters is disabled.<wbr/> All
3611 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
3612 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3613 </li>
3614 <li>
3615 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3616 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
3617 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3618 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3619 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
3620 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3621 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3622 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3623 </li>
3624 </ul>
3625
3626 </td> <!-- entry_type -->
3627
3628 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3629 <p>Overall mode of 3A control
3630routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3631 </td>
3632
3633 <td class="entry_units">
3634 </td>
3635
3636 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]3637 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]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>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
3653by the HAL is disabled.<wbr/> The application must set the fields for
3654capture parameters itself.<wbr/></p>
3655<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]3656android.<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]3657<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
3658android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
3659one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
3660as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]3661<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]3662 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3663 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3664
3665
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3666 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3667 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3668
3669
3670
3671 <!-- end of kind -->
3672 </tbody>
3673
3674 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3675 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3676
3677
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3678 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3679
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3680 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3681 <tr>
3682 <th class="th_name">Property Name</th>
3683 <th class="th_type">Type</th>
3684 <th class="th_description">Description</th>
3685 <th class="th_units">Units</th>
3686 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3687 <th class="th_tags">Tags</th>
3688 </tr>
3689 </thead>
3690
3691 <tbody>
3692
3693
3694
3695
3696
3697
3698
3699
3700
3701
3702 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3703 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3704 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3705 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3706 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3707 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3708
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3709 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3710
3711 <ul class="entry_type_enum">
3712 <li>
3713 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3714 <span class="entry_type_enum_notes">Minimal or no slowdown of frame rate compared to
3715 Bayer RAW output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3716 </li>
3717 <li>
3718 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3719 <span class="entry_type_enum_notes">High-quality may reduce output frame
3720 rate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3721 </li>
3722 </ul>
3723
3724 </td> <!-- entry_type -->
3725
3726 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3727 <p>Controls the quality of the demosaicing
3728processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3729 </td>
3730
3731 <td class="entry_units">
3732 </td>
3733
3734 <td class="entry_range">
3735 </td>
3736
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3737 <td class="entry_tags">
3738 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3739 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3740 </ul>
3741 </td>
3742
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3743 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3744
3745
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3746 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3747 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3748
3749
3750
3751 <!-- end of kind -->
3752 </tbody>
3753
3754 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3755 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3756
3757
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3758 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3759
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3760 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3761 <tr>
3762 <th class="th_name">Property Name</th>
3763 <th class="th_type">Type</th>
3764 <th class="th_description">Description</th>
3765 <th class="th_units">Units</th>
3766 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3767 <th class="th_tags">Tags</th>
3768 </tr>
3769 </thead>
3770
3771 <tbody>
3772
3773
3774
3775
3776
3777
3778
3779
3780
3781
3782 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3783 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3784 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3785 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3786 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3787 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3788
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3789 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3790
3791 <ul class="entry_type_enum">
3792 <li>
3793 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3794 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3795 </li>
3796 <li>
3797 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3798 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
3799 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3800 </li>
3801 <li>
3802 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3803 <span class="entry_type_enum_notes">Frame rate may be reduced by high
3804 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3805 </li>
3806 </ul>
3807
3808 </td> <!-- entry_type -->
3809
3810 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3811 <p>Operation mode for edge
3812enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3813 </td>
3814
3815 <td class="entry_units">
3816 </td>
3817
3818 <td class="entry_range">
3819 </td>
3820
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3821 <td class="entry_tags">
3822 </td>
3823
3824 </tr>
3825 <tr class="entries_header">
3826 <th class="th_details" colspan="5">Details</th>
3827 </tr>
3828 <tr class="entry_cont">
3829 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3830 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
3831enhancement will be applied by the HAL.<wbr/></p>
3832<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
3833will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
3834HAL should use the highest-quality enhancement algorithms,<wbr/>
3835even if it slows down capture rate.<wbr/> FAST means the HAL should
3836not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3837 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3838 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3839
3840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3841 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3842 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3843
3844
3845 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3846 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3847 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3848 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3849 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3850 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3851
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3852 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3853
3854
3855 </td> <!-- entry_type -->
3856
3857 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3858 <p>Control the amount of edge enhancement
3859applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3860 </td>
3861
3862 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3863 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3864 </td>
3865
3866 <td class="entry_range">
3867 </td>
3868
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3869 <td class="entry_tags">
3870 </td>
3871
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3872 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3873
3874
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3875 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3876 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3877
3878
3879
3880 <!-- end of kind -->
3881 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3882 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3883
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3884 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3885 <tr>
3886 <th class="th_name">Property Name</th>
3887 <th class="th_type">Type</th>
3888 <th class="th_description">Description</th>
3889 <th class="th_units">Units</th>
3890 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3891 <th class="th_tags">Tags</th>
3892 </tr>
3893 </thead>
3894
3895 <tbody>
3896
3897
3898
3899
3900
3901
3902
3903
3904
3905
3906 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3907 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3908 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3909 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3910 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3911 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3912
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3913 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3914
3915 <ul class="entry_type_enum">
3916 <li>
3917 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3918 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3919 </li>
3920 <li>
3921 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3922 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
3923 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3924 </li>
3925 <li>
3926 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3927 <span class="entry_type_enum_notes">Frame rate may be reduced by high
3928 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3929 </li>
3930 </ul>
3931
3932 </td> <!-- entry_type -->
3933
3934 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3935 <p>Operation mode for edge
3936enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3937 </td>
3938
3939 <td class="entry_units">
3940 </td>
3941
3942 <td class="entry_range">
3943 </td>
3944
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3945 <td class="entry_tags">
3946 </td>
3947
3948 </tr>
3949 <tr class="entries_header">
3950 <th class="th_details" colspan="5">Details</th>
3951 </tr>
3952 <tr class="entry_cont">
3953 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3954 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
3955enhancement will be applied by the HAL.<wbr/></p>
3956<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
3957will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
3958HAL should use the highest-quality enhancement algorithms,<wbr/>
3959even if it slows down capture rate.<wbr/> FAST means the HAL should
3960not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3961 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3962 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3963
3964
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3965 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3966 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3967
3968
3969
3970 <!-- end of kind -->
3971 </tbody>
3972
3973 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3974 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3975
3976
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3977 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3978
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3979 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3980 <tr>
3981 <th class="th_name">Property Name</th>
3982 <th class="th_type">Type</th>
3983 <th class="th_description">Description</th>
3984 <th class="th_units">Units</th>
3985 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3986 <th class="th_tags">Tags</th>
3987 </tr>
3988 </thead>
3989
3990 <tbody>
3991
3992
3993
3994
3995
3996
3997
3998
3999
4000
4001 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4002 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4003 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4004 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4005 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4006 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4007
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4008 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4009
4010
4011 </td> <!-- entry_type -->
4012
4013 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4014 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4015 </td>
4016
4017 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4018 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4019 </td>
4020
4021 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]4022 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4023 </td>
4024
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4025 <td class="entry_tags">
4026 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4027 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4028 </ul>
4029 </td>
4030
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4031 </tr>
4032 <tr class="entries_header">
4033 <th class="th_details" colspan="5">Details</th>
4034 </tr>
4035 <tr class="entry_cont">
4036 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4037 <p>Power for snapshot may use a different scale than
4038for torch mode.<wbr/> Only one entry for torch mode will be
4039used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4040 </td>
4041 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4042
4043
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4044 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4045 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4046
4047
4048 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4049 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4050 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4051 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4052 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4053 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4054
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4055 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4056
4057
4058 </td> <!-- entry_type -->
4059
4060 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4061 <p>Firing time of flash relative to start of
4062exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4063 </td>
4064
4065 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4066 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4067 </td>
4068
4069 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]4070 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4071 </td>
4072
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4073 <td class="entry_tags">
4074 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4075 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4076 </ul>
4077 </td>
4078
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4079 </tr>
4080 <tr class="entries_header">
4081 <th class="th_details" colspan="5">Details</th>
4082 </tr>
4083 <tr class="entry_cont">
4084 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4085 <p>Clamped to (0,<wbr/> exposure time - flash
4086duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4087 </td>
4088 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4089
4090
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4091 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4092 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4093
4094
4095 <tr class="entry" id="controls_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4096 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4097 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4098 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4099 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4100 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4101
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4102 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4103
4104 <ul class="entry_type_enum">
4105 <li>
4106 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4107 <span class="entry_type_enum_notes">Do not fire the flash for this
4108 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4109 </li>
4110 <li>
4111 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4112 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4113 for this capture based on firingPower,<wbr/>
4114 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4115 </li>
4116 <li>
4117 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4118 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4119 continuously on,<wbr/> power set by
4120 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4121 </li>
4122 </ul>
4123
4124 </td> <!-- entry_type -->
4125
4126 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4127 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4128 </td>
4129
4130 <td class="entry_units">
4131 </td>
4132
4133 <td class="entry_range">
4134 </td>
4135
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4136 <td class="entry_tags">
4137 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4138 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4139 </ul>
4140 </td>
4141
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4142 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4143
4144
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4145 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4146 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4147
4148
4149
4150 <!-- end of kind -->
4151 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4152 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4153
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4154 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4155 <tr>
4156 <th class="th_name">Property Name</th>
4157 <th class="th_type">Type</th>
4158 <th class="th_description">Description</th>
4159 <th class="th_units">Units</th>
4160 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4161 <th class="th_tags">Tags</th>
4162 </tr>
4163 </thead>
4164
4165 <tbody>
4166
4167
4168
4169
4170
4171
4172
4173
4174
4175
4176
4177
4178 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4179 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4180 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4181 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4182 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4183 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4184
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4185 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4186
4187
4188 </td> <!-- entry_type -->
4189
4190 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4191 <p>Whether this camera has a
4192flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4193 </td>
4194
4195 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4196 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4197 </td>
4198
4199 <td class="entry_range">
4200 </td>
4201
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4202 <td class="entry_tags">
4203 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4204 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4205 </ul>
4206 </td>
4207
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4208 </tr>
4209 <tr class="entries_header">
4210 <th class="th_details" colspan="5">Details</th>
4211 </tr>
4212 <tr class="entry_cont">
4213 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4214 <p>If no flash,<wbr/> none of the flash controls do
4215anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4216 </td>
4217 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4218
4219
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4220 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4221 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4222
4223
4224 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4225 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4226 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4227 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4228 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4229 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4230
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4231 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4232
4233
4234 </td> <!-- entry_type -->
4235
4236 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4237 <p>Time taken before flash can fire
4238again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4239 </td>
4240
4241 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4242 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4243 </td>
4244
4245 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]4246 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4247 </td>
4248
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4249 <td class="entry_tags">
4250 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4251 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4252 </ul>
4253 </td>
4254
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4255 </tr>
4256 <tr class="entries_header">
4257 <th class="th_details" colspan="5">Details</th>
4258 </tr>
4259 <tr class="entry_cont">
4260 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4261 <p>1 second too long/<wbr/>too short for recharge? Should
4262this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4263 </td>
4264 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4265
4266
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4267 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4268 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4269
4270
4271
4272
4273
4274 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4275 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4276 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4277 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4278 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4279 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4280
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4281 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4282
4283
4284 </td> <!-- entry_type -->
4285
4286 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4287 <p>The x,<wbr/>y whitepoint of the
4288flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4289 </td>
4290
4291 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4292 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4293 </td>
4294
4295 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]4296 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4297 </td>
4298
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4299 <td class="entry_tags">
4300 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4301 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4302 </ul>
4303 </td>
4304
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4305 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4306
4307
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4308 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4309 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4310
4311
4312 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4313 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4314 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4315 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4316 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4317 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4318
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4319 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4320
4321
4322 </td> <!-- entry_type -->
4323
4324 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4325 <p>Max energy output of the flash for a full
4326power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4327 </td>
4328
4329 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4330 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4331 </td>
4332
4333 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]4334 <blockquote>
4335<p>= 0</p>
4336</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4337 </td>
4338
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4339 <td class="entry_tags">
4340 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4341 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4342 </ul>
4343 </td>
4344
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4345 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4346
4347
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4348 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4349 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4350
4351
4352
4353 <!-- end of kind -->
4354 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4355 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4356
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4357 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4358 <tr>
4359 <th class="th_name">Property Name</th>
4360 <th class="th_type">Type</th>
4361 <th class="th_description">Description</th>
4362 <th class="th_units">Units</th>
4363 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4364 <th class="th_tags">Tags</th>
4365 </tr>
4366 </thead>
4367
4368 <tbody>
4369
4370
4371
4372
4373
4374
4375
4376
4377
4378
4379 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4380 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4381 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4382 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4383 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4384 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4385
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4386 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4387
4388
4389 </td> <!-- entry_type -->
4390
4391 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4392 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4393 </td>
4394
4395 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4396 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4397 </td>
4398
4399 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]4400 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4401 </td>
4402
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4403 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4404 <ul class="entry_tags">
4405 <li><a href="#tag_V1">V1</a></li>
4406 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4407 </td>
4408
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4409 </tr>
4410 <tr class="entries_header">
4411 <th class="th_details" colspan="5">Details</th>
4412 </tr>
4413 <tr class="entry_cont">
4414 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4415 <p>Power for snapshot may use a different scale than
4416for torch mode.<wbr/> Only one entry for torch mode will be
4417used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4418 </td>
4419 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4420
4421
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4422 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4423 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4424
4425
4426 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4427 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4428 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4429 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4430 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4431 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4432
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4433 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4434
4435
4436 </td> <!-- entry_type -->
4437
4438 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4439 <p>Firing time of flash relative to start of
4440exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4441 </td>
4442
4443 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4444 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4445 </td>
4446
4447 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]4448 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4449 </td>
4450
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4451 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4452 <ul class="entry_tags">
4453 <li><a href="#tag_V1">V1</a></li>
4454 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4455 </td>
4456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4457 </tr>
4458 <tr class="entries_header">
4459 <th class="th_details" colspan="5">Details</th>
4460 </tr>
4461 <tr class="entry_cont">
4462 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4463 <p>Clamped to (0,<wbr/> exposure time - flash
4464duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4465 </td>
4466 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4467
4468
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4469 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4470 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4471
4472
4473 <tr class="entry" id="dynamic_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4474 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4475 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4476 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4477 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4478 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4479
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4480 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4481
4482 <ul class="entry_type_enum">
4483 <li>
4484 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4485 <span class="entry_type_enum_notes">Do not fire the flash for this
4486 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4487 </li>
4488 <li>
4489 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4490 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4491 for this capture based on firingPower,<wbr/>
4492 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4493 </li>
4494 <li>
4495 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4496 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4497 continuously on,<wbr/> power set by
4498 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4499 </li>
4500 </ul>
4501
4502 </td> <!-- entry_type -->
4503
4504 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4505 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4506 </td>
4507
4508 <td class="entry_units">
4509 </td>
4510
4511 <td class="entry_range">
4512 </td>
4513
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4514 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4515 <ul class="entry_tags">
4516 <li><a href="#tag_BC">BC</a></li>
4517 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4518 </td>
4519
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4520 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4521
4522
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4523 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4524 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4525
4526
4527 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4528 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4529 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4530 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4531 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4532 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4533
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4534 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4535
4536 <ul class="entry_type_enum">
4537 <li>
4538 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4539 <span class="entry_type_enum_notes">No flash on camera</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4540 </li>
4541 <li>
4542 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4543 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4544 charging and cannot be fired</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4545 </li>
4546 <li>
4547 <span class="entry_type_enum_name">READY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4548 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4549 ready to fire</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4550 </li>
4551 <li>
4552 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4553 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash fired
4554 for this capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4555 </li>
4556 </ul>
4557
4558 </td> <!-- entry_type -->
4559
4560 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4561 <p>Current state of the flash
4562unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4563 </td>
4564
4565 <td class="entry_units">
4566 </td>
4567
4568 <td class="entry_range">
4569 </td>
4570
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4571 <td class="entry_tags">
4572 </td>
4573
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4574 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4575
4576
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4577 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4578 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4579
4580
4581
4582 <!-- end of kind -->
4583 </tbody>
4584
4585 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4586 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4587
4588
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4589 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4590
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4591 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4592 <tr>
4593 <th class="th_name">Property Name</th>
4594 <th class="th_type">Type</th>
4595 <th class="th_description">Description</th>
4596 <th class="th_units">Units</th>
4597 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4598 <th class="th_tags">Tags</th>
4599 </tr>
4600 </thead>
4601
4602 <tbody>
4603
4604
4605
4606
4607
4608
4609
4610
4611
4612
4613 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4614 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4615 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4616 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4617 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4618 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4619
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4620 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4621
4622 <ul class="entry_type_enum">
4623 <li>
4624 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4625 <span class="entry_type_enum_notes">No geometric correction is
4626 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4627 </li>
4628 <li>
4629 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4630 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
4631 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4632 </li>
4633 <li>
4634 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4635 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4636 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4637 </li>
4638 </ul>
4639
4640 </td> <!-- entry_type -->
4641
4642 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4643 <p>Operating mode of geometric
4644correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4645 </td>
4646
4647 <td class="entry_units">
4648 </td>
4649
4650 <td class="entry_range">
4651 </td>
4652
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4653 <td class="entry_tags">
4654 </td>
4655
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4656 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4657
4658
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4659 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4660 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4661
4662
4663 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4664 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4665 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4666 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4667 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4668 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4669
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4670 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4671
4672
4673 </td> <!-- entry_type -->
4674
4675 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4676 <p>Control the amount of shading correction
4677applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4678 </td>
4679
4680 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4681 unitless: 1-10; 10 is full shading
4682 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4683 </td>
4684
4685 <td class="entry_range">
4686 </td>
4687
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4688 <td class="entry_tags">
4689 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4690 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4691 </ul>
4692 </td>
4693
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4694 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4695
4696
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4697 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4698 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4699
4700
4701
4702 <!-- end of kind -->
4703 </tbody>
4704
4705 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4706 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4707
4708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4709 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4710
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4711 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4712 <tr>
4713 <th class="th_name">Property Name</th>
4714 <th class="th_type">Type</th>
4715 <th class="th_description">Description</th>
4716 <th class="th_units">Units</th>
4717 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4718 <th class="th_tags">Tags</th>
4719 </tr>
4720 </thead>
4721
4722 <tbody>
4723
4724
4725
4726
4727
4728
4729
4730
4731
4732
4733 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4734 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4735 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4736 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4737 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4738 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4739
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4740 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4741
4742 <ul class="entry_type_enum">
4743 <li>
4744 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4745 <span class="entry_type_enum_notes">No hot pixel correction can be
4746 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4747 </li>
4748 <li>
4749 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4750 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
4751 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4752 </li>
4753 <li>
4754 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4755 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4756 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4757 </li>
4758 </ul>
4759
4760 </td> <!-- entry_type -->
4761
4762 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4763 <p>Set operational mode for hot pixel
4764correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4765 </td>
4766
4767 <td class="entry_units">
4768 </td>
4769
4770 <td class="entry_range">
4771 </td>
4772
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4773 <td class="entry_tags">
4774 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4775 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4776 </ul>
4777 </td>
4778
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4779 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4780
4781
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4782 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4783 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4784
4785
4786
4787 <!-- end of kind -->
4788 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4789 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4790
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4791 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4792 <tr>
4793 <th class="th_name">Property Name</th>
4794 <th class="th_type">Type</th>
4795 <th class="th_description">Description</th>
4796 <th class="th_units">Units</th>
4797 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4798 <th class="th_tags">Tags</th>
4799 </tr>
4800 </thead>
4801
4802 <tbody>
4803
4804
4805
4806
4807
4808
4809
4810
4811
4812
4813
4814
4815 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4816 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4817 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4818 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4819 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4820 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4821 <span class="entry_type_container">x</span>
4822
4823 <span class="entry_type_array">
4824 2 x n
4825 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4826 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4827 <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]4828
4829
4830 </td> <!-- entry_type -->
4831
4832 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4833 <p>Location of hot/<wbr/>defective pixels on
4834sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4835 </td>
4836
4837 <td class="entry_units">
4838 </td>
4839
4840 <td class="entry_range">
4841 </td>
4842
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4843 <td class="entry_tags">
4844 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4845 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4846 </ul>
4847 </td>
4848
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4849 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4850
4851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4852 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4853 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4854
4855
4856
4857
4858
4859
4860 <!-- end of kind -->
4861 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4862 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4863
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4864 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4865 <tr>
4866 <th class="th_name">Property Name</th>
4867 <th class="th_type">Type</th>
4868 <th class="th_description">Description</th>
4869 <th class="th_units">Units</th>
4870 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4871 <th class="th_tags">Tags</th>
4872 </tr>
4873 </thead>
4874
4875 <tbody>
4876
4877
4878
4879
4880
4881
4882
4883
4884
4885
4886 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4887 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4888 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4889 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4890 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4891 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4892
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4893 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4894
4895 <ul class="entry_type_enum">
4896 <li>
4897 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4898 <span class="entry_type_enum_notes">No hot pixel correction can be
4899 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4900 </li>
4901 <li>
4902 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4903 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
4904 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4905 </li>
4906 <li>
4907 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4908 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4909 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4910 </li>
4911 </ul>
4912
4913 </td> <!-- entry_type -->
4914
4915 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4916 <p>Set operational mode for hot pixel
4917correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4918 </td>
4919
4920 <td class="entry_units">
4921 </td>
4922
4923 <td class="entry_range">
4924 </td>
4925
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4926 <td class="entry_tags">
4927 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4928 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4929 </ul>
4930 </td>
4931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4932 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4933
4934
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4935 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4936 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4937
4938
4939
4940 <!-- end of kind -->
4941 </tbody>
4942
4943 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4944 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4945
4946
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4947 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4948
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4949 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4950 <tr>
4951 <th class="th_name">Property Name</th>
4952 <th class="th_type">Type</th>
4953 <th class="th_description">Description</th>
4954 <th class="th_units">Units</th>
4955 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4956 <th class="th_tags">Tags</th>
4957 </tr>
4958 </thead>
4959
4960 <tbody>
4961
4962
4963
4964
4965
4966
4967
4968
4969
4970
4971 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4972 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4973 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4974 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4975 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4976 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4977 <span class="entry_type_container">x</span>
4978
4979 <span class="entry_type_array">
4980 3
4981 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4982 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4983 <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]4984
4985
4986 </td> <!-- entry_type -->
4987
4988 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4989 <p>GPS coordinates to include in output JPEG
4990EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4991 </td>
4992
4993 <td class="entry_units">
4994 </td>
4995
4996 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]4997 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4998 </td>
4999
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5000 <td class="entry_tags">
5001 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5002 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5003 </ul>
5004 </td>
5005
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5006 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5007
5008
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5009 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5010 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5011
5012
5013 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5014 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5015 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5016 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5017 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5018 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5019
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5020 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5021
5022
5023 </td> <!-- entry_type -->
5024
5025 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5026 <p>32 characters describing GPS algorithm to
5027include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5028 </td>
5029
5030 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5031 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5032 </td>
5033
5034 <td class="entry_range">
5035 </td>
5036
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5037 <td class="entry_tags">
5038 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5039 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5040 </ul>
5041 </td>
5042
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5043 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5044
5045
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5046 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5047 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5048
5049
5050 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5051 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5052 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5053 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5054 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5055 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5056
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5057 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5058
5059
5060 </td> <!-- entry_type -->
5061
5062 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5063 <p>Time GPS fix was made to include in
5064EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5065 </td>
5066
5067 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5068 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5069 </td>
5070
5071 <td class="entry_range">
5072 </td>
5073
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5074 <td class="entry_tags">
5075 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5076 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5077 </ul>
5078 </td>
5079
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5080 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5081
5082
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5083 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5084 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5085
5086
5087 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5088 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5089 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5090 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5091 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5092 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5093
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5094 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5095
5096
5097 </td> <!-- entry_type -->
5098
5099 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5100 <p>Orientation of JPEG image to
5101write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5102 </td>
5103
5104 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5105 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5106 </td>
5107
5108 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5109 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5110 </td>
5111
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5112 <td class="entry_tags">
5113 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5114 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5115 </ul>
5116 </td>
5117
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5118 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5119
5120
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5121 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5122 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5123
5124
5125 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5126 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5127 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5128 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5129 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5130 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5131
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5132 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5133
5134
5135 </td> <!-- entry_type -->
5136
5137 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5138 <p>Compression quality of the final JPEG
5139image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5140 </td>
5141
5142 <td class="entry_units">
5143 </td>
5144
5145 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5146 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5147 </td>
5148
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5149 <td class="entry_tags">
5150 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5151 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5152 </ul>
5153 </td>
5154
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5155 </tr>
5156 <tr class="entries_header">
5157 <th class="th_details" colspan="5">Details</th>
5158 </tr>
5159 <tr class="entry_cont">
5160 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5161 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5162 </td>
5163 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5164
5165
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5166 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5167 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5168
5169
5170 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5171 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5172 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5173 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5174 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5175 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5176
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5177 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5178
5179
5180 </td> <!-- entry_type -->
5181
5182 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5183 <p>Compression quality of JPEG
5184thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5185 </td>
5186
5187 <td class="entry_units">
5188 </td>
5189
5190 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5191 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5192 </td>
5193
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5194 <td class="entry_tags">
5195 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5196 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5197 </ul>
5198 </td>
5199
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5200 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5201
5202
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5203 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5204 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5205
5206
5207 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5208 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5209 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5210 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5211 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5212 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5213 <span class="entry_type_container">x</span>
5214
5215 <span class="entry_type_array">
5216 2
5217 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5218 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5219
5220
5221 </td> <!-- entry_type -->
5222
5223 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5224 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5225 </td>
5226
5227 <td class="entry_units">
5228 </td>
5229
5230 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5231 <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]5232 </td>
5233
5234 <td class="entry_tags">
5235 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5236 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5237 </ul>
5238 </td>
5239
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5240 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5241 <tr class="entries_header">
5242 <th class="th_details" colspan="5">Details</th>
5243 </tr>
5244 <tr class="entry_cont">
5245 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5246 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5247but the captured JPEG must still be a valid image.<wbr/></p>
5248<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5249the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5250 </td>
5251 </tr>
5252
5253
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5254 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5255 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5256
5257
5258
5259 <!-- end of kind -->
5260 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5261 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5262
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5263 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5264 <tr>
5265 <th class="th_name">Property Name</th>
5266 <th class="th_type">Type</th>
5267 <th class="th_description">Description</th>
5268 <th class="th_units">Units</th>
5269 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5270 <th class="th_tags">Tags</th>
5271 </tr>
5272 </thead>
5273
5274 <tbody>
5275
5276
5277
5278
5279
5280
5281
5282
5283
5284
5285 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5286 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5287 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5288 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5289 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5290 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5291 <span class="entry_type_container">x</span>
5292
5293 <span class="entry_type_array">
5294 2 x n
5295 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5296 <span class="entry_type_visibility"> [public as size]</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>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5303 </td>
5304
5305 <td class="entry_units">
5306 </td>
5307
5308 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5309 <p>Must include at least one valid resolution,<wbr/> plus
5310(0,<wbr/>0) for no thumbnail generation,<wbr/> and each size must be distinct.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5311 </td>
5312
5313 <td class="entry_tags">
5314 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5315 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5316 </ul>
5317 </td>
5318
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5319 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5320 <tr class="entries_header">
5321 <th class="th_details" colspan="5">Details</th>
5322 </tr>
5323 <tr class="entry_cont">
5324 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5325 <p>Below condiditions must be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5326<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5327<li>The sizes must be sorted by increasing pixel area (width x height).<wbr/>
5328If several resolutions have the same area,<wbr/> they must be sorted by increasing width.<wbr/></li>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5329<li>The aspect ratio of the largest thumbnail size must be same as the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5330aspect 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]5331The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5332in a given size list.<wbr/></li>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5333<li>Each size in <a href="#static_android.scaler.availableJpegSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes</a> must have at least
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5334one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
5335and vice versa.<wbr/></li>
5336<li>All non (0,<wbr/> 0) sizes must have non-zero widths and heights.<wbr/></li>
5337</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5338 </td>
5339 </tr>
5340
5341
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5342 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5343 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5344
5345
5346 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5347 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5348 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5349 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5350 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5351 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5352
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5353 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5354
5355
5356 </td> <!-- entry_type -->
5357
5358 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5359 <p>Maximum size in bytes for the compressed
5360JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5361 </td>
5362
5363 <td class="entry_units">
5364 </td>
5365
5366 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5367 <p>Must be large enough to fit any JPEG produced by
5368the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5369 </td>
5370
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5371 <td class="entry_tags">
5372 </td>
5373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5374 </tr>
5375 <tr class="entries_header">
5376 <th class="th_details" colspan="5">Details</th>
5377 </tr>
5378 <tr class="entry_cont">
5379 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5380 <p>This is used for sizing the gralloc buffers for
5381JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5382 </td>
5383 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5384
5385
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5386 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5387 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5388
5389
5390
5391 <!-- end of kind -->
5392 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5393 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5394
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5395 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5396 <tr>
5397 <th class="th_name">Property Name</th>
5398 <th class="th_type">Type</th>
5399 <th class="th_description">Description</th>
5400 <th class="th_units">Units</th>
5401 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5402 <th class="th_tags">Tags</th>
5403 </tr>
5404 </thead>
5405
5406 <tbody>
5407
5408
5409
5410
5411
5412
5413
5414
5415
5416
5417 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5418 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5419 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5420 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5421 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5422 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5423 <span class="entry_type_container">x</span>
5424
5425 <span class="entry_type_array">
5426 3
5427 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5428 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5429 <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]5430
5431
5432 </td> <!-- entry_type -->
5433
5434 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5435 <p>GPS coordinates to include in output JPEG
5436EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5437 </td>
5438
5439 <td class="entry_units">
5440 </td>
5441
5442 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5443 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5444 </td>
5445
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5446 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5447 <ul class="entry_tags">
5448 <li><a href="#tag_BC">BC</a></li>
5449 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5450 </td>
5451
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5452 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5453
5454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5455 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5456 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5457
5458
5459 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5460 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5461 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5462 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5463 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5464 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5465
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5466 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5467
5468
5469 </td> <!-- entry_type -->
5470
5471 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5472 <p>32 characters describing GPS algorithm to
5473include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5474 </td>
5475
5476 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5477 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5478 </td>
5479
5480 <td class="entry_range">
5481 </td>
5482
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5483 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5484 <ul class="entry_tags">
5485 <li><a href="#tag_BC">BC</a></li>
5486 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5487 </td>
5488
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5489 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5490
5491
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5492 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5493 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5494
5495
5496 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5497 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5498 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5499 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5500 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5501 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5502
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5503 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5504
5505
5506 </td> <!-- entry_type -->
5507
5508 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5509 <p>Time GPS fix was made to include in
5510EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5511 </td>
5512
5513 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5514 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5515 </td>
5516
5517 <td class="entry_range">
5518 </td>
5519
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5520 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5521 <ul class="entry_tags">
5522 <li><a href="#tag_BC">BC</a></li>
5523 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5524 </td>
5525
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5526 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5527
5528
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5529 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5530 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5531
5532
5533 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5534 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5535 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5536 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5537 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5538 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5539
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5540 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5541
5542
5543 </td> <!-- entry_type -->
5544
5545 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5546 <p>Orientation of JPEG image to
5547write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5548 </td>
5549
5550 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5551 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5552 </td>
5553
5554 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5555 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5556 </td>
5557
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5558 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5559 <ul class="entry_tags">
5560 <li><a href="#tag_BC">BC</a></li>
5561 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5562 </td>
5563
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5564 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5565
5566
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5567 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5568 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5569
5570
5571 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5572 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5573 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5574 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5575 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5576 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5577
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5578 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5579
5580
5581 </td> <!-- entry_type -->
5582
5583 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5584 <p>Compression quality of the final JPEG
5585image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5586 </td>
5587
5588 <td class="entry_units">
5589 </td>
5590
5591 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5592 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5593 </td>
5594
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5595 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5596 <ul class="entry_tags">
5597 <li><a href="#tag_BC">BC</a></li>
5598 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5599 </td>
5600
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5601 </tr>
5602 <tr class="entries_header">
5603 <th class="th_details" colspan="5">Details</th>
5604 </tr>
5605 <tr class="entry_cont">
5606 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5607 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5608 </td>
5609 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5610
5611
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5612 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5613 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5614
5615
5616 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5617 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5618 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5619 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5620 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5621 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5622
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5623 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5624
5625
5626 </td> <!-- entry_type -->
5627
5628 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5629 <p>The size of the compressed JPEG image,<wbr/> in
5630bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5631 </td>
5632
5633 <td class="entry_units">
5634 </td>
5635
5636 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5637 <blockquote>
5638<p>= 0</p>
5639</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5640 </td>
5641
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5642 <td class="entry_tags">
5643 </td>
5644
5645 </tr>
5646 <tr class="entries_header">
5647 <th class="th_details" colspan="5">Details</th>
5648 </tr>
5649 <tr class="entry_cont">
5650 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5651 <p>If no JPEG output is produced for the request,<wbr/>
5652this must be 0.<wbr/></p>
5653<p>Otherwise,<wbr/> this describes the real size of the compressed
5654JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5655if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
5656has <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]5657the JPEG stream will be 1000000 bytes,<wbr/> of which the first
5658500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5659 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5660 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5661
5662
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5663 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5664 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5665
5666
5667 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5668 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5669 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5670 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5671 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5672 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5673
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5674 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5675
5676
5677 </td> <!-- entry_type -->
5678
5679 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5680 <p>Compression quality of JPEG
5681thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5682 </td>
5683
5684 <td class="entry_units">
5685 </td>
5686
5687 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5688 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5689 </td>
5690
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5691 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5692 <ul class="entry_tags">
5693 <li><a href="#tag_BC">BC</a></li>
5694 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5695 </td>
5696
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5697 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5698
5699
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5700 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5701 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5702
5703
5704 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5705 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5706 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5707 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5708 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5709 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5710 <span class="entry_type_container">x</span>
5711
5712 <span class="entry_type_array">
5713 2
5714 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5715 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5716
5717
5718 </td> <!-- entry_type -->
5719
5720 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5721 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5722 </td>
5723
5724 <td class="entry_units">
5725 </td>
5726
5727 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5728 <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]5729 </td>
5730
5731 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5732 <ul class="entry_tags">
5733 <li><a href="#tag_BC">BC</a></li>
5734 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5735 </td>
5736
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5737 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5738 <tr class="entries_header">
5739 <th class="th_details" colspan="5">Details</th>
5740 </tr>
5741 <tr class="entry_cont">
5742 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5743 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5744but the captured JPEG must still be a valid image.<wbr/></p>
5745<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5746the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5747 </td>
5748 </tr>
5749
5750
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5751 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5752 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5753
5754
5755
5756 <!-- end of kind -->
5757 </tbody>
5758
5759 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5760 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5761
5762
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5763 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5764
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5765 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5766 <tr>
5767 <th class="th_name">Property Name</th>
5768 <th class="th_type">Type</th>
5769 <th class="th_description">Description</th>
5770 <th class="th_units">Units</th>
5771 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5772 <th class="th_tags">Tags</th>
5773 </tr>
5774 </thead>
5775
5776 <tbody>
5777
5778
5779
5780
5781
5782
5783
5784
5785
5786
5787 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5788 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5789 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5790 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5791 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5792 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5793
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5794 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5795
5796
5797 </td> <!-- entry_type -->
5798
5799 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5800 <p>Size of the lens aperture</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5801 </td>
5802
5803 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5804 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5805 </td>
5806
5807 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5808 <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]5809 </td>
5810
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5811 <td class="entry_tags">
5812 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5813 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5814 </ul>
5815 </td>
5816
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5817 </tr>
5818 <tr class="entries_header">
5819 <th class="th_details" colspan="5">Details</th>
5820 </tr>
5821 <tr class="entry_cont">
5822 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5823 <p>Will not be supported on most devices.<wbr/> Can only
5824pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5825 </td>
5826 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5827
5828
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5829 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5830 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5831
5832
5833 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5834 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5835 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5836 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5837 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5838 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5839
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5840 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5841
5842
5843 </td> <!-- entry_type -->
5844
5845 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5846 <p>State of lens neutral density
5847filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5848 </td>
5849
5850 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5851 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5852 </td>
5853
5854 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5855 <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]5856 </td>
5857
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5858 <td class="entry_tags">
5859 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5860 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5861 </ul>
5862 </td>
5863
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5864 </tr>
5865 <tr class="entries_header">
5866 <th class="th_details" colspan="5">Details</th>
5867 </tr>
5868 <tr class="entry_cont">
5869 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5870 <p>Will not be supported on most devices.<wbr/> Can only
5871pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5872 </td>
5873 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5874
5875
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5876 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5877 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5878
5879
5880 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5881 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5882 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5883 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5884 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5885 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5886
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5887 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5888
5889
5890 </td> <!-- entry_type -->
5891
5892 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5893 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5894 </td>
5895
5896 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5897 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5898 </td>
5899
5900 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5901 <blockquote>
5902<p>0</p>
5903</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5904 </td>
5905
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5906 <td class="entry_tags">
5907 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5908 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5909 </ul>
5910 </td>
5911
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5912 </tr>
5913 <tr class="entries_header">
5914 <th class="th_details" colspan="5">Details</th>
5915 </tr>
5916 <tr class="entry_cont">
5917 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5918 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5919 </td>
5920 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5921
5922
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5923 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5924 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5925
5926
5927 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5928 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5929 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5930 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5931 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5932 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5933
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5934 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5935
5936
5937 </td> <!-- entry_type -->
5938
5939 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5940 <p>Distance to plane of sharpest focus,<wbr/>
5941measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5942 </td>
5943
5944 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5945 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5946 </td>
5947
5948 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]5949 <blockquote>
5950<p>= 0</p>
5951</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5952 </td>
5953
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5954 <td class="entry_tags">
5955 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5956 <li><a href="#tag_BC">BC</a></li>
5957 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5958 </ul>
5959 </td>
5960
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5961 </tr>
5962 <tr class="entries_header">
5963 <th class="th_details" colspan="5">Details</th>
5964 </tr>
5965 <tr class="entry_cont">
5966 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5967 <p>0 = infinity focus.<wbr/> Used value should be clamped
5968to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5969 </td>
5970 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5971
5972
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5973 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5974 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5975
5976
5977 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5978 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5979 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5980 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5981 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5982 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5983
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5984 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5985
5986 <ul class="entry_type_enum">
5987 <li>
5988 <span class="entry_type_enum_name">OFF</span>
5989 </li>
5990 <li>
5991 <span class="entry_type_enum_name">ON</span>
5992 <span class="entry_type_enum_optional">optional</span>
5993 </li>
5994 </ul>
5995
5996 </td> <!-- entry_type -->
5997
5998 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5999 <p>Whether optical image stabilization is
6000enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6001 </td>
6002
6003 <td class="entry_units">
6004 </td>
6005
6006 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6007 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6008 </td>
6009
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6010 <td class="entry_tags">
6011 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6012 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6013 </ul>
6014 </td>
6015
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6016 </tr>
6017 <tr class="entries_header">
6018 <th class="th_details" colspan="5">Details</th>
6019 </tr>
6020 <tr class="entry_cont">
6021 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6022 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6023 </td>
6024 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6025
6026
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6027 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6028 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6029
6030
6031
6032 <!-- end of kind -->
6033 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6034 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6035
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6036 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6037 <tr>
6038 <th class="th_name">Property Name</th>
6039 <th class="th_type">Type</th>
6040 <th class="th_description">Description</th>
6041 <th class="th_units">Units</th>
6042 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6043 <th class="th_tags">Tags</th>
6044 </tr>
6045 </thead>
6046
6047 <tbody>
6048
6049
6050
6051
6052
6053
6054
6055
6056
6057
6058
6059
6060 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6061 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6062 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6063 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6064 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6065 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6066 <span class="entry_type_container">x</span>
6067
6068 <span class="entry_type_array">
6069 n
6070 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6071 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6072
6073
6074 </td> <!-- entry_type -->
6075
6076 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6077 <p>List of supported aperture
6078values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6079 </td>
6080
6081 <td class="entry_units">
6082 </td>
6083
6084 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6085 <p>one entry required,<wbr/> &gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6086 </td>
6087
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6088 <td class="entry_tags">
6089 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6090 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6091 </ul>
6092 </td>
6093
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6094 </tr>
6095 <tr class="entries_header">
6096 <th class="th_details" colspan="5">Details</th>
6097 </tr>
6098 <tr class="entry_cont">
6099 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6100 <p>If variable aperture not available,<wbr/> only setting
6101should be for the fixed aperture</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6102 </td>
6103 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6104
6105
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6106 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6107 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6108
6109
6110 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6111 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6112 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6113 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6114 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6115 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6116 <span class="entry_type_container">x</span>
6117
6118 <span class="entry_type_array">
6119 n
6120 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6121 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6122
6123
6124 </td> <!-- entry_type -->
6125
6126 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6127 <p>List of supported ND filter
6128values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6129 </td>
6130
6131 <td class="entry_units">
6132 </td>
6133
6134 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6135 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6136 </td>
6137
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6138 <td class="entry_tags">
6139 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6140 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6141 </ul>
6142 </td>
6143
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6144 </tr>
6145 <tr class="entries_header">
6146 <th class="th_details" colspan="5">Details</th>
6147 </tr>
6148 <tr class="entry_cont">
6149 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6150 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6151lists the available exposure index values for dimming
6152(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6153light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6154 </td>
6155 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6156
6157
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6158 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6159 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6160
6161
6162 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6163 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6164 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6165 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6166 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6167 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6168 <span class="entry_type_container">x</span>
6169
6170 <span class="entry_type_array">
6171 n
6172 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6173 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6174 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6175
6176
6177 </td> <!-- entry_type -->
6178
6179 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6180 <p>If fitted with optical zoom,<wbr/> what focal
6181lengths are available.<wbr/> If not,<wbr/> the static focal
6182length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6183 </td>
6184
6185 <td class="entry_units">
6186 </td>
6187
6188 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6189 <blockquote>
6190<p>0</p>
6191</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6192 </td>
6193
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6194 <td class="entry_tags">
6195 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6196 <li><a href="#tag_BC">BC</a></li>
6197 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6198 </ul>
6199 </td>
6200
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6201 </tr>
6202 <tr class="entries_header">
6203 <th class="th_details" colspan="5">Details</th>
6204 </tr>
6205 <tr class="entry_cont">
6206 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6207 <p>If optical zoom not supported,<wbr/> only one value
6208should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6209 </td>
6210 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6211
6212
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6213 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6214 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6215
6216
6217 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6218 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6219 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6220 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6221 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6222 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6223 <span class="entry_type_container">x</span>
6224
6225 <span class="entry_type_array">
6226 n
6227 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6228 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6229 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6230
6231
6232 </td> <!-- entry_type -->
6233
6234 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6235 <p>List of supported optical image
6236stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6237 </td>
6238
6239 <td class="entry_units">
6240 </td>
6241
6242 <td class="entry_range">
6243 </td>
6244
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6245 <td class="entry_tags">
6246 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6247 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6248 </ul>
6249 </td>
6250
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6251 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6252
6253
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6254 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6255 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6256
6257
6258 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6259 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6260 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6261 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6262 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6263 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6264 <span class="entry_type_container">x</span>
6265
6266 <span class="entry_type_array">
6267 2 x 3 x n x m
6268 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6269 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6270 <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]6271
6272
6273 </td> <!-- entry_type -->
6274
6275 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6276 <p>A low-resolution map for correction of
6277geometric distortions and chromatic aberrations,<wbr/> per
6278color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6279 </td>
6280
6281 <td class="entry_units">
6282 </td>
6283
6284 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6285 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6286 </td>
6287
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6288 <td class="entry_tags">
6289 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6290 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6291 </ul>
6292 </td>
6293
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6294 </tr>
6295 <tr class="entries_header">
6296 <th class="th_details" colspan="5">Details</th>
6297 </tr>
6298 <tr class="entry_cont">
6299 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6300 <p>[DNG wants a function instead].<wbr/> What's easiest
6301for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
6302j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
6303j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
6304entry 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]6305 </td>
6306 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6307
6308
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6309 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6310 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6311
6312
6313 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6314 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6315 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6316 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6317 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6318 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6319 <span class="entry_type_container">x</span>
6320
6321 <span class="entry_type_array">
6322 2
6323 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6324 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6325 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6326
6327
6328 </td> <!-- entry_type -->
6329
6330 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6331 <p>Dimensions of geometric correction
6332map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6333 </td>
6334
6335 <td class="entry_units">
6336 </td>
6337
6338 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6339 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6340 </td>
6341
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6342 <td class="entry_tags">
6343 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6344 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6345 </ul>
6346 </td>
6347
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6348 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6349
6350
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6351 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6352 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6353
6354
6355 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6356 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6357 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6358 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6359 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6360 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6361
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6362 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6363
6364
6365 </td> <!-- entry_type -->
6366
6367 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6368 <p>Hyperfocal distance for this lens; set to
63690 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6370 </td>
6371
6372 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6373 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6374 </td>
6375
6376 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6377 <blockquote>
6378<p>= 0</p>
6379</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6380 </td>
6381
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6382 <td class="entry_tags">
6383 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6384 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6385 </ul>
6386 </td>
6387
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6388 </tr>
6389 <tr class="entries_header">
6390 <th class="th_details" colspan="5">Details</th>
6391 </tr>
6392 <tr class="entry_cont">
6393 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6394 <p>The hyperfocal distance is used for the old
6395API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6396 </td>
6397 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6398
6399
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6400 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6401 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6402
6403
6404 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6405 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6406 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6407 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6408 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6409 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6410
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6411 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6412
6413
6414 </td> <!-- entry_type -->
6415
6416 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6417 <p>Shortest distance from frontmost surface
6418of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6419 </td>
6420
6421 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6422 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6423 </td>
6424
6425 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6426 <blockquote>
6427<p>= 0</p>
6428</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6429 </td>
6430
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6431 <td class="entry_tags">
6432 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6433 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6434 </ul>
6435 </td>
6436
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6437 </tr>
6438 <tr class="entries_header">
6439 <th class="th_details" colspan="5">Details</th>
6440 </tr>
6441 <tr class="entry_cont">
6442 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6443 <p>If the lens is fixed-focus,<wbr/> this should be
64440</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6445 </td>
6446 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6447
6448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6449 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6450 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6451
6452
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6453 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6454 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6455 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6456 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6457 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6458 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6459 <span class="entry_type_container">x</span>
6460
6461 <span class="entry_type_array">
6462 2
6463 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6464 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6465 <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]6466
6467
6468 </td> <!-- entry_type -->
6469
6470 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6471 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6472 </td>
6473
6474 <td class="entry_units">
6475 </td>
6476
6477 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6478 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6479 </td>
6480
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6481 <td class="entry_tags">
6482 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6483 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6484 </ul>
6485 </td>
6486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6487 </tr>
6488 <tr class="entries_header">
6489 <th class="th_details" colspan="5">Details</th>
6490 </tr>
6491 <tr class="entry_cont">
6492 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6493 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
6494must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6495 </td>
6496 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6497
6498
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6499 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6500 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6501
6502
6503
6504
6505
6506 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6507 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6508 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6509 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6510 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6511 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6512
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6513 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6514
6515 <ul class="entry_type_enum">
6516 <li>
6517 <span class="entry_type_enum_name">FRONT</span>
6518 </li>
6519 <li>
6520 <span class="entry_type_enum_name">BACK</span>
6521 </li>
6522 </ul>
6523
6524 </td> <!-- entry_type -->
6525
6526 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6527 <p>Direction the camera faces relative to
6528device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6529 </td>
6530
6531 <td class="entry_units">
6532 </td>
6533
6534 <td class="entry_range">
6535 </td>
6536
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6537 <td class="entry_tags">
6538 </td>
6539
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6540 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6541
6542
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6543 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6544 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6545
6546
6547 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6548 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6549 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6550 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6551 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6552 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6553 <span class="entry_type_container">x</span>
6554
6555 <span class="entry_type_array">
6556 2
6557 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6558 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6559 <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]6560
6561
6562 </td> <!-- entry_type -->
6563
6564 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6565 <p>Relative angle of camera optical axis to the
6566perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6567 </td>
6568
6569 <td class="entry_units">
6570 </td>
6571
6572 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6573 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6574 </td>
6575
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6576 <td class="entry_tags">
6577 <ul class="entry_tags">
6578 <li><a href="#tag_ADV">ADV</a></li>
6579 </ul>
6580 </td>
6581
6582 </tr>
6583 <tr class="entries_header">
6584 <th class="th_details" colspan="5">Details</th>
6585 </tr>
6586 <tr class="entry_cont">
6587 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6588 <p>Examples:</p>
6589<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6590is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6591<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6592device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6593<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
6594the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6595<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6596direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6597 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6598 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6599
6600
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6601 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6602 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6603
6604
6605 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6606 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6607 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6608 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6609 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6610 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6611 <span class="entry_type_container">x</span>
6612
6613 <span class="entry_type_array">
6614 3, location in mm, in the sensor coordinate
6615 system
6616 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6617 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6618
6619
6620 </td> <!-- entry_type -->
6621
6622 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6623 <p>Coordinates of camera optical axis on
6624device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6625 </td>
6626
6627 <td class="entry_units">
6628 </td>
6629
6630 <td class="entry_range">
6631 </td>
6632
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6633 <td class="entry_tags">
6634 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6635 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6636 </ul>
6637 </td>
6638
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6639 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6640
6641
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6642 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6643 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6644
6645
6646
6647 <!-- end of kind -->
6648 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6649 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6650
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6651 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6652 <tr>
6653 <th class="th_name">Property Name</th>
6654 <th class="th_type">Type</th>
6655 <th class="th_description">Description</th>
6656 <th class="th_units">Units</th>
6657 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6658 <th class="th_tags">Tags</th>
6659 </tr>
6660 </thead>
6661
6662 <tbody>
6663
6664
6665
6666
6667
6668
6669
6670
6671
6672
6673 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6674 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6675 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6676 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6677 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6678 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6679
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6680 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6681
6682
6683 </td> <!-- entry_type -->
6684
6685 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6686 <p>Size of the lens aperture</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6687 </td>
6688
6689 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6690 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6691 </td>
6692
6693 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6694 <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]6695 </td>
6696
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6697 <td class="entry_tags">
6698 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6699 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6700 </ul>
6701 </td>
6702
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6703 </tr>
6704 <tr class="entries_header">
6705 <th class="th_details" colspan="5">Details</th>
6706 </tr>
6707 <tr class="entry_cont">
6708 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6709 <p>Will not be supported on most devices.<wbr/> Can only
6710pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6711 </td>
6712 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6713
6714
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6715 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6716 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6717
6718
6719 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6720 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6721 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6722 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6723 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6724 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6725
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6726 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6727
6728
6729 </td> <!-- entry_type -->
6730
6731 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6732 <p>State of lens neutral density
6733filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6734 </td>
6735
6736 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6737 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6738 </td>
6739
6740 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6741 <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]6742 </td>
6743
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6744 <td class="entry_tags">
6745 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6746 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6747 </ul>
6748 </td>
6749
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6750 </tr>
6751 <tr class="entries_header">
6752 <th class="th_details" colspan="5">Details</th>
6753 </tr>
6754 <tr class="entry_cont">
6755 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6756 <p>Will not be supported on most devices.<wbr/> Can only
6757pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6758 </td>
6759 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6760
6761
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6762 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6763 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6764
6765
6766 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6767 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6768 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6769 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6770 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6771 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6772
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6773 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6774
6775
6776 </td> <!-- entry_type -->
6777
6778 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6779 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6780 </td>
6781
6782 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6783 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6784 </td>
6785
6786 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6787 <blockquote>
6788<p>0</p>
6789</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6790 </td>
6791
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6792 <td class="entry_tags">
6793 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6794 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6795 </ul>
6796 </td>
6797
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6798 </tr>
6799 <tr class="entries_header">
6800 <th class="th_details" colspan="5">Details</th>
6801 </tr>
6802 <tr class="entry_cont">
6803 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6804 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6805 </td>
6806 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6807
6808
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6809 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6810 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6811
6812
6813 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6814 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6815 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6816 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6817 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6818 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6819
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6820 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6821
6822
6823 </td> <!-- entry_type -->
6824
6825 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6826 <p>Distance to plane of sharpest focus,<wbr/>
6827measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6828 </td>
6829
6830 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6831 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6832 </td>
6833
6834 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6835 <blockquote>
6836<p>= 0</p>
6837</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6838 </td>
6839
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6840 <td class="entry_tags">
6841 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6842 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6843 </ul>
6844 </td>
6845
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6846 </tr>
6847 <tr class="entries_header">
6848 <th class="th_details" colspan="5">Details</th>
6849 </tr>
6850 <tr class="entry_cont">
6851 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6852 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6853 </td>
6854 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6855
6856
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6857 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6858 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6859
6860
6861 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6862 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6863 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6864 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6865 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6866 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]6867 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6868
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]6869 <span class="entry_type_array">
6870 2
6871 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6872 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6873 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6874
6875
6876 </td> <!-- entry_type -->
6877
6878 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6879 <p>The range of scene distances that are in
6880sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6881 </td>
6882
6883 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6884 pair of focus distances in diopters: (near,<wbr/>
6885 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6886 </td>
6887
6888 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6889 <blockquote>
6890<p>=0</p>
6891</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6892 </td>
6893
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6894 <td class="entry_tags">
6895 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6896 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6897 </ul>
6898 </td>
6899
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6900 </tr>
6901 <tr class="entries_header">
6902 <th class="th_details" colspan="5">Details</th>
6903 </tr>
6904 <tr class="entry_cont">
6905 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6906 <p>If variable focus not supported,<wbr/> can still report
6907fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6908 </td>
6909 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6910
6911
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6912 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6913 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6914
6915
6916 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6917 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6918 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6919 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6920 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6921 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6922
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6923 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6924
6925 <ul class="entry_type_enum">
6926 <li>
6927 <span class="entry_type_enum_name">OFF</span>
6928 </li>
6929 <li>
6930 <span class="entry_type_enum_name">ON</span>
6931 <span class="entry_type_enum_optional">optional</span>
6932 </li>
6933 </ul>
6934
6935 </td> <!-- entry_type -->
6936
6937 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6938 <p>Whether optical image stabilization is
6939enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6940 </td>
6941
6942 <td class="entry_units">
6943 </td>
6944
6945 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]6946 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6947 </td>
6948
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6949 <td class="entry_tags">
6950 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6951 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6952 </ul>
6953 </td>
6954
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6955 </tr>
6956 <tr class="entries_header">
6957 <th class="th_details" colspan="5">Details</th>
6958 </tr>
6959 <tr class="entry_cont">
6960 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6961 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6962 </td>
6963 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6964
6965
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6966 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6967 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6968
6969
6970 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6971 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6972 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6973 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6974 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6975 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6976
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6977 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6978
6979 <ul class="entry_type_enum">
6980 <li>
6981 <span class="entry_type_enum_name">STATIONARY</span>
6982 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]6983 <li>
6984 <span class="entry_type_enum_name">MOVING</span>
6985 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6986 </ul>
6987
6988 </td> <!-- entry_type -->
6989
6990 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6991 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6992 </td>
6993
6994 <td class="entry_units">
6995 </td>
6996
6997 <td class="entry_range">
6998 </td>
6999
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7000 <td class="entry_tags">
7001 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7002 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7003 </ul>
7004 </td>
7005
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7006 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7007
7008
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7009 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7010 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7011
7012
7013
7014 <!-- end of kind -->
7015 </tbody>
7016
7017 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7018 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7019
7020
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7021 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7022
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7023 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7024 <tr>
7025 <th class="th_name">Property Name</th>
7026 <th class="th_type">Type</th>
7027 <th class="th_description">Description</th>
7028 <th class="th_units">Units</th>
7029 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7030 <th class="th_tags">Tags</th>
7031 </tr>
7032 </thead>
7033
7034 <tbody>
7035
7036
7037
7038
7039
7040
7041
7042
7043
7044
7045 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7046 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7047 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7048 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7049 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7050 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7051
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7052 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7053
7054 <ul class="entry_type_enum">
7055 <li>
7056 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7057 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7058 </li>
7059 <li>
7060 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7061 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7062 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7063 </li>
7064 <li>
7065 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7066 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7067 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7068 </li>
7069 </ul>
7070
7071 </td> <!-- entry_type -->
7072
7073 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7074 <p>Mode of operation for the noise reduction
7075algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7076 </td>
7077
7078 <td class="entry_units">
7079 </td>
7080
7081 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]7082 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7083 </td>
7084
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7085 <td class="entry_tags">
7086 <ul class="entry_tags">
7087 <li><a href="#tag_V1">V1</a></li>
7088 </ul>
7089 </td>
7090
7091 </tr>
7092 <tr class="entries_header">
7093 <th class="th_details" colspan="5">Details</th>
7094 </tr>
7095 <tr class="entry_cont">
7096 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7097 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7098will be applied by the HAL.<wbr/></p>
7099<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7100will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7101should use the highest-quality noise filtering algorithms,<wbr/>
7102even if it slows down capture rate.<wbr/> FAST means the HAL should not
7103slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7104 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7105 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7106
7107
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7108 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7109 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7110
7111
7112 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7113 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7114 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7115 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7116 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7117 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7118
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7119 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7120
7121
7122 </td> <!-- entry_type -->
7123
7124 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7125 <p>Control the amount of noise reduction
7126applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7127 </td>
7128
7129 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7130 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7131 </td>
7132
7133 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]7134 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7135 </td>
7136
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7137 <td class="entry_tags">
7138 </td>
7139
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7140 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7141
7142
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7143 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7144 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7145
7146
7147
7148 <!-- end of kind -->
7149 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7150 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7151
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7152 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7153 <tr>
7154 <th class="th_name">Property Name</th>
7155 <th class="th_type">Type</th>
7156 <th class="th_description">Description</th>
7157 <th class="th_units">Units</th>
7158 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7159 <th class="th_tags">Tags</th>
7160 </tr>
7161 </thead>
7162
7163 <tbody>
7164
7165
7166
7167
7168
7169
7170
7171
7172
7173
7174 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7175 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7176 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7177 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7178 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7179 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7180
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7181 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7182
7183 <ul class="entry_type_enum">
7184 <li>
7185 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7186 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7187 </li>
7188 <li>
7189 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7190 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7191 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7192 </li>
7193 <li>
7194 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7195 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7196 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7197 </li>
7198 </ul>
7199
7200 </td> <!-- entry_type -->
7201
7202 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7203 <p>Mode of operation for the noise reduction
7204algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7205 </td>
7206
7207 <td class="entry_units">
7208 </td>
7209
7210 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]7211 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7212 </td>
7213
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7214 <td class="entry_tags">
7215 <ul class="entry_tags">
7216 <li><a href="#tag_V1">V1</a></li>
7217 </ul>
7218 </td>
7219
7220 </tr>
7221 <tr class="entries_header">
7222 <th class="th_details" colspan="5">Details</th>
7223 </tr>
7224 <tr class="entry_cont">
7225 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7226 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7227will be applied by the HAL.<wbr/></p>
7228<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7229will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7230should use the highest-quality noise filtering algorithms,<wbr/>
7231even if it slows down capture rate.<wbr/> FAST means the HAL should not
7232slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7233 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7234 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7235
7236
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7237 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7238 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7239
7240
7241
7242 <!-- end of kind -->
7243 </tbody>
7244
7245 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7246 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7247
7248
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7249 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7250
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7251 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7252 <tr>
7253 <th class="th_name">Property Name</th>
7254 <th class="th_type">Type</th>
7255 <th class="th_description">Description</th>
7256 <th class="th_units">Units</th>
7257 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7258 <th class="th_tags">Tags</th>
7259 </tr>
7260 </thead>
7261
7262 <tbody>
7263
7264
7265
7266
7267
7268
7269
7270
7271
7272
7273 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7274 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7275 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7276 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7277 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7278 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7279
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7280 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7281
7282
7283 </td> <!-- entry_type -->
7284
7285 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7286 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7287scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7288region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
7289and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7290 </td>
7291
7292 <td class="entry_units">
7293 </td>
7294
7295 <td class="entry_range">
7296 </td>
7297
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7298 <td class="entry_tags">
7299 </td>
7300
7301 </tr>
7302 <tr class="entries_header">
7303 <th class="th_details" colspan="5">Details</th>
7304 </tr>
7305 <tr class="entry_cont">
7306 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7307 <p>Normalized coordinates refer to those in the
7308(-1000,<wbr/>1000) range mentioned in the
7309android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7310<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7311sensor array-relative coordinates for all region data.<wbr/> Does
7312not need to be listed in static metadata.<wbr/> Support will be
7313removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7314 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7315 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7316
7317
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7318 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7319 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7320
7321
7322 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7323 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7324 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7325 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7326 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7327 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7328
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7329 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7330
7331
7332 </td> <!-- entry_type -->
7333
7334 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7335 <p>If set to 1,<wbr/> then the camera service always
7336switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
7337trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7338 </td>
7339
7340 <td class="entry_units">
7341 </td>
7342
7343 <td class="entry_range">
7344 </td>
7345
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7346 <td class="entry_tags">
7347 </td>
7348
7349 </tr>
7350 <tr class="entries_header">
7351 <th class="th_details" colspan="5">Details</th>
7352 </tr>
7353 <tr class="entry_cont">
7354 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7355 <p>HAL implementations should implement AF trigger
7356modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
7357CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
7358not need to be listed in static metadata.<wbr/> Support will be
7359removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7360 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7361 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7362
7363
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7364 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7365 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7366
7367
7368 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7369 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7370 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7371 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7372 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7373 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7374
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7375 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7376
7377
7378 </td> <!-- entry_type -->
7379
7380 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7381 <p>If set to 1,<wbr/> the camera service uses
7382CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
7383HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
7384shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7385 </td>
7386
7387 <td class="entry_units">
7388 </td>
7389
7390 <td class="entry_range">
7391 </td>
7392
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7393 <td class="entry_tags">
7394 </td>
7395
7396 </tr>
7397 <tr class="entries_header">
7398 <th class="th_details" colspan="5">Details</th>
7399 </tr>
7400 <tr class="entry_cont">
7401 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7402 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7403to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7404zero-shutter-lag,<wbr/> instead of relying on an explicit
7405format setting.<wbr/> Does not need to be listed in static
7406metadata.<wbr/> Support will be removed in future versions of
7407camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7408 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7409 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7410
7411
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7412 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7413 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7414
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7415
7416 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7417 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7418 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7419 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7420 <td class="entry_type">
7421 <span class="entry_type_name">byte</span>
7422
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7423 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7424
7425
7426 </td> <!-- entry_type -->
7427
7428 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7429 <p>If set to 1,<wbr/> the HAL will always split result
7430metadata for a single capture into multiple buffers,<wbr/>
7431returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7432 </td>
7433
7434 <td class="entry_units">
7435 </td>
7436
7437 <td class="entry_range">
7438 </td>
7439
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7440 <td class="entry_tags">
7441 </td>
7442
7443 </tr>
7444 <tr class="entries_header">
7445 <th class="th_details" colspan="5">Details</th>
7446 </tr>
7447 <tr class="entry_cont">
7448 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7449 <p>Does not need to be listed in static
7450metadata.<wbr/> Support for partial results will be reworked in
7451future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7452working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7453consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7454 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7455 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7456
7457
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7458 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7459 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7460
7461
7462
7463 <!-- end of kind -->
7464 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7465 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7466
7467 <thead class="entries_header">
7468 <tr>
7469 <th class="th_name">Property Name</th>
7470 <th class="th_type">Type</th>
7471 <th class="th_description">Description</th>
7472 <th class="th_units">Units</th>
7473 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7474 <th class="th_tags">Tags</th>
7475 </tr>
7476 </thead>
7477
7478 <tbody>
7479
7480
7481
7482
7483
7484
7485
7486
7487
7488
7489 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7490 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7491 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7492 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7493 <td class="entry_type">
7494 <span class="entry_type_name entry_type_name_enum">byte</span>
7495
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7496 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7497
7498 <ul class="entry_type_enum">
7499 <li>
7500 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7501 <span class="entry_type_enum_notes">The last or only metadata result buffer
7502 for this capture.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7503 </li>
7504 <li>
7505 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7506 <span class="entry_type_enum_notes">A partial buffer of result metadata for this
7507 capture.<wbr/> More result buffers for this capture will be sent
7508 by the HAL,<wbr/> the last of which will be marked
7509 FINAL.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7510 </li>
7511 </ul>
7512
7513 </td> <!-- entry_type -->
7514
7515 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7516 <p>Whether a result given to the framework is the
7517final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7518subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7519values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7520 </td>
7521
7522 <td class="entry_units">
7523 </td>
7524
7525 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]7526 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7527 </td>
7528
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7529 <td class="entry_tags">
7530 </td>
7531
7532 </tr>
7533 <tr class="entries_header">
7534 <th class="th_details" colspan="5">Details</th>
7535 </tr>
7536 <tr class="entry_cont">
7537 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7538 <p>The entries in the result metadata buffers for a
7539single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7540FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7541requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
7542always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
7543before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
7544in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
7545capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
7546only 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]7547 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7548 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7549
7550
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7551 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7552 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7553
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7554
7555
7556 <!-- end of kind -->
7557 </tbody>
7558
7559 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7560 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7561
7562
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7563 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7564
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7565 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7566 <tr>
7567 <th class="th_name">Property Name</th>
7568 <th class="th_type">Type</th>
7569 <th class="th_description">Description</th>
7570 <th class="th_units">Units</th>
7571 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7572 <th class="th_tags">Tags</th>
7573 </tr>
7574 </thead>
7575
7576 <tbody>
7577
7578
7579
7580
7581
7582
7583
7584
7585
7586
7587 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7588 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7589 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7590 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7591 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7592 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7593
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7594 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7595
7596
7597 </td> <!-- entry_type -->
7598
7599 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7600 <p>A frame counter set by the framework.<wbr/> Must
7601be maintained unchanged in output frame.<wbr/> This value monotonically
7602increases with every new result (that is,<wbr/> each new result has a unique
7603frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7604 </td>
7605
7606 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7607 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7608 </td>
7609
7610 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]7611 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7612 </td>
7613
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7614 <td class="entry_tags">
7615 </td>
7616
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]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="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7625 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7626 android.<wbr/>request.<wbr/>id
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">int32</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"> [hidden]</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>An application-specified ID for the current
7638request.<wbr/> Must be maintained unchanged in output
7639frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7640 </td>
7641
7642 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7643 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7644 </td>
7645
7646 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]7647 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7648 </td>
7649
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7650 <td class="entry_tags">
7651 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7652 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7653 </ul>
7654 </td>
7655
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7656 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7657
7658
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7659 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7660 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7661
7662
7663 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7664 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7665 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7666 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7667 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7668 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7669 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7670
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7671 <span class="entry_type_array">
7672 n
7673 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7674 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7675
7676
7677 </td> <!-- entry_type -->
7678
7679 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7680 <p>List which camera reprocess stream is used
7681for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7682 </td>
7683
7684 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7685 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7686 </td>
7687
7688 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]7689 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
7690reprocess stream ID.<wbr/></p>
7691<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
7692reprocess streams may be included in a single request; they
7693must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7694 </td>
7695
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7696 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7697 <ul class="entry_tags">
7698 <li><a href="#tag_HAL2">HAL2</a></li>
7699 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7700 </td>
7701
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7702 </tr>
7703 <tr class="entries_header">
7704 <th class="th_details" colspan="5">Details</th>
7705 </tr>
7706 <tr class="entry_cont">
7707 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]7708 <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]7709REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7710 </td>
7711 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7712
7713
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7714 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7715 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7716
7717
7718 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7719 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7720 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7721 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7722 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7723 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7724
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7725 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7726
7727 <ul class="entry_type_enum">
7728 <li>
7729 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7730 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
7731 for application-bound buffer data.<wbr/> If no
7732 application-bound streams exist,<wbr/> no frame should be
7733 placed in the output frame queue.<wbr/> If such streams
7734 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7735 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7736 information.<wbr/> Timestamp information should still be
7737 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7738 </li>
7739 <li>
7740 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7741 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7742 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7743 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7744 </li>
7745 </ul>
7746
7747 </td> <!-- entry_type -->
7748
7749 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7750 <p>How much metadata to produce on
7751output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7752 </td>
7753
7754 <td class="entry_units">
7755 </td>
7756
7757 <td class="entry_range">
7758 </td>
7759
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7760 <td class="entry_tags">
7761 </td>
7762
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]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="controls_android.request.outputStreams">
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/>request.<wbr/>output<wbr/>Streams
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">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7775 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7776 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7777
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7778 <span class="entry_type_array">
7779 n
7780 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7781 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7782
7783
7784 </td> <!-- entry_type -->
7785
7786 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7787 <p>Lists which camera output streams image data
7788from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7789 </td>
7790
7791 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7792 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7793 </td>
7794
7795 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]7796 <p>List must only include streams that have been
7797created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7798 </td>
7799
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7800 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7801 <ul class="entry_tags">
7802 <li><a href="#tag_HAL2">HAL2</a></li>
7803 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7804 </td>
7805
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7806 </tr>
7807 <tr class="entries_header">
7808 <th class="th_details" colspan="5">Details</th>
7809 </tr>
7810 <tr class="entry_cont">
7811 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7812 <p>If no output streams are listed,<wbr/> then the image
7813data should simply be discarded.<wbr/> The image data must
7814still be captured for metadata and statistics production,<wbr/>
7815and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7816 </td>
7817 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7818
7819
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7820 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7821 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7822
7823
7824 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7825 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7826 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7827 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7828 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7829 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7830
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7831 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7832
7833 <ul class="entry_type_enum">
7834 <li>
7835 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7836 <span class="entry_type_enum_notes">Capture a new image from the imaging hardware,<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7837 and process it according to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7838 settings</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7839 </li>
7840 <li>
7841 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7842 <span class="entry_type_enum_notes">Process previously captured data; the
7843 android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
7844 source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
7845 needed for reprocessing with [RP]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7846 </li>
7847 </ul>
7848
7849 </td> <!-- entry_type -->
7850
7851 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7852 <p>The type of the request; either CAPTURE or
7853REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7854 </td>
7855
7856 <td class="entry_units">
7857 </td>
7858
7859 <td class="entry_range">
7860 </td>
7861
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7862 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7863 <ul class="entry_tags">
7864 <li><a href="#tag_HAL2">HAL2</a></li>
7865 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7866 </td>
7867
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7868 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7869
7870
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7871 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7872 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7873
7874
7875
7876 <!-- end of kind -->
7877 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7878 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7879
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7880 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7881 <tr>
7882 <th class="th_name">Property Name</th>
7883 <th class="th_type">Type</th>
7884 <th class="th_description">Description</th>
7885 <th class="th_units">Units</th>
7886 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7887 <th class="th_tags">Tags</th>
7888 </tr>
7889 </thead>
7890
7891 <tbody>
7892
7893
7894
7895
7896
7897
7898
7899
7900
7901
7902 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7903 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7904 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7905 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7906 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7907 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7908 <span class="entry_type_container">x</span>
7909
7910 <span class="entry_type_array">
7911 3
7912 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7913 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7914
7915
7916 </td> <!-- entry_type -->
7917
7918 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7919 <p>How many output streams can be allocated at
7920the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7921 </td>
7922
7923 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7924 The number of raw sensor streams; the number of
7925 processed,<wbr/> uncompressed streams; and the number of
7926 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7927 </td>
7928
7929 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]7930 <blockquote>
7931<p>=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
7932for processed,<wbr/> uncompressed streams</p>
7933</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7934 </td>
7935
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7936 <td class="entry_tags">
7937 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7938 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7939 </ul>
7940 </td>
7941
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7942 </tr>
7943 <tr class="entries_header">
7944 <th class="th_details" colspan="5">Details</th>
7945 </tr>
7946 <tr class="entry_cont">
7947 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7948 <p>Video snapshot with preview callbacks requires 3
7949processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
7950one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7951 </td>
7952 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7953
7954
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7955 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7956 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7957
7958
7959 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7960 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7961 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7962 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7963 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7964 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7965 <span class="entry_type_container">x</span>
7966
7967 <span class="entry_type_array">
7968 1
7969 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7970 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7971
7972
7973 </td> <!-- entry_type -->
7974
7975 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7976 <p>How many reprocessing streams of any type
7977can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7978 </td>
7979
7980 <td class="entry_units">
7981 </td>
7982
7983 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]7984 <blockquote>
7985<p>= 1</p>
7986</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7987 </td>
7988
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7989 <td class="entry_tags">
7990 </td>
7991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7992 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7993
7994
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7995 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7996 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7997
7998
7999
8000 <!-- end of kind -->
8001 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8002 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8003
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8004 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8005 <tr>
8006 <th class="th_name">Property Name</th>
8007 <th class="th_type">Type</th>
8008 <th class="th_description">Description</th>
8009 <th class="th_units">Units</th>
8010 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8011 <th class="th_tags">Tags</th>
8012 </tr>
8013 </thead>
8014
8015 <tbody>
8016
8017
8018
8019
8020
8021
8022
8023
8024
8025
8026 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8027 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8028 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8029 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8030 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8031 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8032
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8033 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8034
8035
8036 </td> <!-- entry_type -->
8037
8038 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8039 <p>A frame counter set by the framework.<wbr/> This value monotonically
8040increases with every new result (that is,<wbr/> each new result has a unique
8041frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8042 </td>
8043
8044 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8045 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8046 </td>
8047
8048 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]8049 <blockquote>
8050<p>0</p>
8051</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8052 </td>
8053
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8054 <td class="entry_tags">
8055 </td>
8056
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8057 </tr>
8058 <tr class="entries_header">
8059 <th class="th_details" colspan="5">Details</th>
8060 </tr>
8061 <tr class="entry_cont">
8062 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8063 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8064 </td>
8065 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8066
8067
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8068 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8069 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8070
8071
8072 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8073 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8074 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8075 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8076 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8077 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8078
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8079 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8080
8081
8082 </td> <!-- entry_type -->
8083
8084 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8085 <p>An application-specified ID for the current
8086request.<wbr/> Must be maintained unchanged in output
8087frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8088 </td>
8089
8090 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8091 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8092 </td>
8093
8094 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]8095 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8096 </td>
8097
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8098 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8099 <ul class="entry_tags">
8100 <li><a href="#tag_V1">V1</a></li>
8101 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8102 </td>
8103
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8104 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8105
8106
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8107 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8108 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8109
8110
8111 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8112 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8113 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8114 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8115 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8116 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8117
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8118 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8119
8120 <ul class="entry_type_enum">
8121 <li>
8122 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8123 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
8124 for application-bound buffer data.<wbr/> If no
8125 application-bound streams exist,<wbr/> no frame should be
8126 placed in the output frame queue.<wbr/> If such streams
8127 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8128 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8129 information.<wbr/> Timestamp information should still be
8130 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8131 </li>
8132 <li>
8133 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8134 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8135 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8136 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8137 </li>
8138 </ul>
8139
8140 </td> <!-- entry_type -->
8141
8142 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8143 <p>How much metadata to produce on
8144output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8145 </td>
8146
8147 <td class="entry_units">
8148 </td>
8149
8150 <td class="entry_range">
8151 </td>
8152
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8153 <td class="entry_tags">
8154 </td>
8155
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8156 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8157
8158
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8159 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8160 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8161
8162
8163 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8164 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8165 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8166 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8167 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8168 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8169 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8170
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8171 <span class="entry_type_array">
8172 n
8173 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8174 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8175
8176
8177 </td> <!-- entry_type -->
8178
8179 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8180 <p>Lists which camera output streams image data
8181from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8182 </td>
8183
8184 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8185 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8186 </td>
8187
8188 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]8189 <p>List must only include streams that have been
8190created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8191 </td>
8192
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8193 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8194 <ul class="entry_tags">
8195 <li><a href="#tag_HAL2">HAL2</a></li>
8196 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8197 </td>
8198
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8199 </tr>
8200 <tr class="entries_header">
8201 <th class="th_details" colspan="5">Details</th>
8202 </tr>
8203 <tr class="entry_cont">
8204 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8205 <p>If no output streams are listed,<wbr/> then the image
8206data should simply be discarded.<wbr/> The image data must
8207still be captured for metadata and statistics production,<wbr/>
8208and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8209 </td>
8210 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8211
8212
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8213 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8214 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8215
8216
8217
8218 <!-- end of kind -->
8219 </tbody>
8220
8221 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8222 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8223
8224
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8225 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8226
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8227 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8228 <tr>
8229 <th class="th_name">Property Name</th>
8230 <th class="th_type">Type</th>
8231 <th class="th_description">Description</th>
8232 <th class="th_units">Units</th>
8233 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8234 <th class="th_tags">Tags</th>
8235 </tr>
8236 </thead>
8237
8238 <tbody>
8239
8240
8241
8242
8243
8244
8245
8246
8247
8248
8249 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8250 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8251 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8252 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8253 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8254 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8255 <span class="entry_type_container">x</span>
8256
8257 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8258 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8259 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8260 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8261
8262
8263 </td> <!-- entry_type -->
8264
8265 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8266 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8267<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8268(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8269output.<wbr/> Each stream must use this rectangle to produce its
8270output,<wbr/> cropping to a smaller region if necessary to
8271maintain the stream's aspect ratio.<wbr/></p>
8272<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8273 </td>
8274
8275 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8276 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8277 in pixels; (0,<wbr/>0) is top-left corner of
8278 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8279 </td>
8280
8281 <td class="entry_range">
8282 </td>
8283
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8284 <td class="entry_tags">
8285 <ul class="entry_tags">
8286 <li><a href="#tag_BC">BC</a></li>
8287 </ul>
8288 </td>
8289
8290 </tr>
8291 <tr class="entries_header">
8292 <th class="th_details" colspan="5">Details</th>
8293 </tr>
8294 <tr class="entry_cont">
8295 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8296 <p>Any additional per-stream cropping must be done to
8297maximize the final pixel area of the stream.<wbr/></p>
8298<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8299ratio,<wbr/> then 4:3 streams should use the exact crop
8300region.<wbr/> 16:9 streams should further crop vertically
8301(letterbox).<wbr/></p>
8302<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8303outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8304streams should match exactly.<wbr/> These additional crops must
8305be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8306<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8307times,<wbr/> no matter what the relative aspect ratios of the
8308crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8309corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8310larger than active pixel array.<wbr/> Width and height may be
8311rounded to nearest larger supportable width,<wbr/> especially
8312for raw output,<wbr/> where only a few fixed scales may be
8313possible.<wbr/> The width and height of the crop region cannot
8314be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8315android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8316activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8317respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8318 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8319 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8320
8321
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8322 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8323 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8324
8325
8326
8327 <!-- end of kind -->
8328 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8329 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8330
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8331 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8332 <tr>
8333 <th class="th_name">Property Name</th>
8334 <th class="th_type">Type</th>
8335 <th class="th_description">Description</th>
8336 <th class="th_units">Units</th>
8337 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8338 <th class="th_tags">Tags</th>
8339 </tr>
8340 </thead>
8341
8342 <tbody>
8343
8344
8345
8346
8347
8348
8349
8350
8351
8352
8353 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8354 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8355 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8356 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8357 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8358 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8359 <span class="entry_type_container">x</span>
8360
8361 <span class="entry_type_array">
8362 n
8363 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]8364 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8365 <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]8366
8367 <ul class="entry_type_enum">
8368 <li>
8369 <span class="entry_type_enum_name">RAW_SENSOR</span>
8370 <span class="entry_type_enum_value">0x20</span>
8371 </li>
8372 <li>
8373 <span class="entry_type_enum_name">YV12</span>
8374 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8375 <span class="entry_type_enum_notes">YCrCb 4:2:0 Planar</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8376 </li>
8377 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8378 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8379 <span class="entry_type_enum_value">0x11</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8380 <span class="entry_type_enum_notes">NV21</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8381 </li>
8382 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8383 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
8384 <span class="entry_type_enum_value">0x22</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8385 <span class="entry_type_enum_notes">Hal Implementation Defined</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8386 </li>
8387 <li>
8388 <span class="entry_type_enum_name">YCbCr_420_888</span>
8389 <span class="entry_type_enum_value">0x23</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8390 <span class="entry_type_enum_notes">Flexible YUV420 Format</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8391 </li>
8392 <li>
8393 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8394 <span class="entry_type_enum_value">0x21</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8395 <span class="entry_type_enum_notes">JPEG</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8396 </li>
8397 </ul>
8398
8399 </td> <!-- entry_type -->
8400
8401 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8402 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8403 </td>
8404
8405 <td class="entry_units">
8406 </td>
8407
8408 <td class="entry_range">
8409 </td>
8410
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8411 <td class="entry_tags">
8412 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8413 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8414 </ul>
8415 </td>
8416
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8417 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8418
8419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8420 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8421 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8422
8423
8424 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8425 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8426 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8427 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8428 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8429 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8430 <span class="entry_type_container">x</span>
8431
8432 <span class="entry_type_array">
8433 n
8434 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8435 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8436
8437
8438 </td> <!-- entry_type -->
8439
8440 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8441 <p>The minimum frame duration that is supported
8442for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8443correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8444stream is active and captured in a burst,<wbr/> with all
8445processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8446 </td>
8447
8448 <td class="entry_units">
8449 </td>
8450
8451 <td class="entry_range">
8452 </td>
8453
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8454 <td class="entry_tags">
8455 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8456 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8457 </ul>
8458 </td>
8459
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8460 </tr>
8461 <tr class="entries_header">
8462 <th class="th_details" colspan="5">Details</th>
8463 </tr>
8464 <tr class="entry_cont">
8465 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8466 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8467frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8468durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8469 </td>
8470 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8471
8472
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8473 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8474 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8475
8476
8477 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8478 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8479 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8480 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8481 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8482 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8483 <span class="entry_type_container">x</span>
8484
8485 <span class="entry_type_array">
8486 n x 2
8487 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8488 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8489
8490
8491 </td> <!-- entry_type -->
8492
8493 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8494 <p>The resolutions available for output from
8495the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8496 </td>
8497
8498 <td class="entry_units">
8499 </td>
8500
8501 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]8502 <p>Must include: - sensor maximum resolution Should
8503include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8504 </td>
8505
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8506 <td class="entry_tags">
8507 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8508 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8509 </ul>
8510 </td>
8511
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8512 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8513
8514
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8515 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8516 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8517
8518
8519 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8520 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8521 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8522 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8523 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8524 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8525
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8526 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8527
8528
8529 </td> <!-- entry_type -->
8530
8531 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8532 <p>The maximum ratio between active area width
8533and crop region width,<wbr/> or between active area height and
8534crop region height,<wbr/> if the crop region height is larger
8535than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8536 </td>
8537
8538 <td class="entry_units">
8539 </td>
8540
8541 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]8542 <blockquote>
8543<p>=1</p>
8544</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8545 </td>
8546
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8547 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8548 <ul class="entry_tags">
8549 <li><a href="#tag_BC">BC</a></li>
8550 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8551 </td>
8552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8553 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8554
8555
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8556 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8557 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8558
8559
8560 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8561 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8562 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8563 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8564 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8565 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8566 <span class="entry_type_container">x</span>
8567
8568 <span class="entry_type_array">
8569 n
8570 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8571 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8572
8573
8574 </td> <!-- entry_type -->
8575
8576 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8577 <p>The minimum frame duration that is supported
8578for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8579correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8580stream is active,<wbr/> with all processing set to
8581FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8582 </td>
8583
8584 <td class="entry_units">
8585 </td>
8586
8587 <td class="entry_range">
8588 </td>
8589
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8590 <td class="entry_tags">
8591 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8592 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8593 </ul>
8594 </td>
8595
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8596 </tr>
8597 <tr class="entries_header">
8598 <th class="th_details" colspan="5">Details</th>
8599 </tr>
8600 <tr class="entry_cont">
8601 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8602 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8603frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8604durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8605 </td>
8606 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8607
8608
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8609 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8610 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8611
8612
8613 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8614 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8615 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8616 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8617 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8618 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8619 <span class="entry_type_container">x</span>
8620
8621 <span class="entry_type_array">
8622 n x 2
8623 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8624 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8625
8626
8627 </td> <!-- entry_type -->
8628
8629 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8630 <p>The resolutions available for use with
8631processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
8632platform opaque YUV/<wbr/>RGB streams to the GPU or video
8633encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8634 </td>
8635
8636 <td class="entry_units">
8637 </td>
8638
8639 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]8640 <p>Must include: - sensor maximum resolution -
8641standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
8642resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8643 </td>
8644
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8645 <td class="entry_tags">
8646 <ul class="entry_tags">
8647 <li><a href="#tag_BC">BC</a></li>
8648 </ul>
8649 </td>
8650
8651 </tr>
8652 <tr class="entries_header">
8653 <th class="th_details" colspan="5">Details</th>
8654 </tr>
8655 <tr class="entry_cont">
8656 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8657 <p>The actual supported resolution list may be limited by
8658consumer end points for different use cases.<wbr/> For example,<wbr/> for
8659recording use case,<wbr/> the largest supported resolution may be
8660limited by max supported size from encoder,<wbr/> for preview use
8661case,<wbr/> the largest supported resolution may be limited by max
8662resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8663 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8664 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8665
8666
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8667 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8668 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8669
8670
8671 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8672 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8673 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8674 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8675 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8676 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8677 <span class="entry_type_container">x</span>
8678
8679 <span class="entry_type_array">
8680 n
8681 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8682 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8683
8684
8685 </td> <!-- entry_type -->
8686
8687 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8688 <p>The minimum frame duration that is supported
8689for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8690correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8691is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8692 </td>
8693
8694 <td class="entry_units">
8695 </td>
8696
8697 <td class="entry_range">
8698 </td>
8699
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8700 <td class="entry_tags">
8701 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8702 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8703 </ul>
8704 </td>
8705
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8706 </tr>
8707 <tr class="entries_header">
8708 <th class="th_details" colspan="5">Details</th>
8709 </tr>
8710 <tr class="entry_cont">
8711 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8712 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8713frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8714durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8715 </td>
8716 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8717
8718
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8719 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8720 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8721
8722
8723 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8724 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8725 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8726 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8727 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8728 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8729 <span class="entry_type_container">x</span>
8730
8731 <span class="entry_type_array">
8732 n x 2
8733 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8734 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8735
8736
8737 </td> <!-- entry_type -->
8738
8739 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8740 <p>The resolutions available for use with raw
8741sensor output streams,<wbr/> listed as width,<wbr/>
8742height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8743 </td>
8744
8745 <td class="entry_units">
8746 </td>
8747
8748 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]8749 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8750 </td>
8751
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8752 <td class="entry_tags">
8753 </td>
8754
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8755 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8756
8757
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8758 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8759 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8760
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8761
8762
8763 <!-- end of kind -->
8764 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8765 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8766
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8767 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8768 <tr>
8769 <th class="th_name">Property Name</th>
8770 <th class="th_type">Type</th>
8771 <th class="th_description">Description</th>
8772 <th class="th_units">Units</th>
8773 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8774 <th class="th_tags">Tags</th>
8775 </tr>
8776 </thead>
8777
8778 <tbody>
8779
8780
8781
8782
8783
8784
8785
8786
8787
8788
8789 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8790 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8791 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8792 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8793 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8794 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8795 <span class="entry_type_container">x</span>
8796
8797 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8798 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8799 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8800 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8801
8802
8803 </td> <!-- entry_type -->
8804
8805 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8806 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8807<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8808(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8809output.<wbr/> Each stream must use this rectangle to produce its
8810output,<wbr/> cropping to a smaller region if necessary to
8811maintain the stream's aspect ratio.<wbr/></p>
8812<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8813 </td>
8814
8815 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8816 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8817 in pixels; (0,<wbr/>0) is top-left corner of
8818 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8819 </td>
8820
8821 <td class="entry_range">
8822 </td>
8823
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8824 <td class="entry_tags">
8825 <ul class="entry_tags">
8826 <li><a href="#tag_BC">BC</a></li>
8827 </ul>
8828 </td>
8829
8830 </tr>
8831 <tr class="entries_header">
8832 <th class="th_details" colspan="5">Details</th>
8833 </tr>
8834 <tr class="entry_cont">
8835 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8836 <p>Any additional per-stream cropping must be done to
8837maximize the final pixel area of the stream.<wbr/></p>
8838<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8839ratio,<wbr/> then 4:3 streams should use the exact crop
8840region.<wbr/> 16:9 streams should further crop vertically
8841(letterbox).<wbr/></p>
8842<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8843outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8844streams should match exactly.<wbr/> These additional crops must
8845be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8846<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8847times,<wbr/> no matter what the relative aspect ratios of the
8848crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8849corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8850larger than active pixel array.<wbr/> Width and height may be
8851rounded to nearest larger supportable width,<wbr/> especially
8852for raw output,<wbr/> where only a few fixed scales may be
8853possible.<wbr/> The width and height of the crop region cannot
8854be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8855android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8856activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8857respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8858 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8859 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8860
8861
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8862 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8863 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8864
8865
8866
8867 <!-- end of kind -->
8868 </tbody>
8869
8870 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8871 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8872
8873
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8874 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8875
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8876 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8877 <tr>
8878 <th class="th_name">Property Name</th>
8879 <th class="th_type">Type</th>
8880 <th class="th_description">Description</th>
8881 <th class="th_units">Units</th>
8882 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8883 <th class="th_tags">Tags</th>
8884 </tr>
8885 </thead>
8886
8887 <tbody>
8888
8889
8890
8891
8892
8893
8894
8895
8896
8897
8898 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8899 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8900 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8901 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8902 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8903 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8904
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8905 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8906
8907
8908 </td> <!-- entry_type -->
8909
8910 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8911 <p>Duration each pixel is exposed to
8912light.<wbr/></p>
8913<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
8914duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8915 </td>
8916
8917 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8918 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8919 </td>
8920
8921 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]8922 <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]8923 </td>
8924
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8925 <td class="entry_tags">
8926 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8927 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8928 </ul>
8929 </td>
8930
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8931 </tr>
8932 <tr class="entries_header">
8933 <th class="th_details" colspan="5">Details</th>
8934 </tr>
8935 <tr class="entry_cont">
8936 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8937 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8938 </td>
8939 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8940
8941
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8942 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8943 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8944
8945
8946 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8947 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8948 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8949 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8950 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8951 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8952
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8953 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8954
8955
8956 </td> <!-- entry_type -->
8957
8958 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8959 <p>Duration from start of frame exposure to
8960start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8961 </td>
8962
8963 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8964 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8965 </td>
8966
8967 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]8968 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
8969android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8970 </td>
8971
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8972 <td class="entry_tags">
8973 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8974 <li><a href="#tag_V1">V1</a></li>
8975 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8976 </ul>
8977 </td>
8978
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8979 </tr>
8980 <tr class="entries_header">
8981 <th class="th_details" colspan="5">Details</th>
8982 </tr>
8983 <tr class="entry_cont">
8984 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8985 <p>Exposure time has priority,<wbr/> so duration is set to
8986max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8987 </td>
8988 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8989
8990
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8991 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8992 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8993
8994
8995 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8996 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8997 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8998 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8999 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9000 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9001
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9002 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9003
9004
9005 </td> <!-- entry_type -->
9006
9007 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9008 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9009implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9010below 'maximum analog sensitivity'.<wbr/></p>
9011<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9012gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9013 </td>
9014
9015 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9016 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9017 </td>
9018
9019 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]9020 <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]9021 </td>
9022
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9023 <td class="entry_tags">
9024 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9025 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9026 </ul>
9027 </td>
9028
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9029 </tr>
9030 <tr class="entries_header">
9031 <th class="th_details" colspan="5">Details</th>
9032 </tr>
9033 <tr class="entry_cont">
9034 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9035 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9036 </td>
9037 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9038
9039
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9040 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9041 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9042
9043
9044
9045 <!-- end of kind -->
9046 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9047 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9048
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9049 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9050 <tr>
9051 <th class="th_name">Property Name</th>
9052 <th class="th_type">Type</th>
9053 <th class="th_description">Description</th>
9054 <th class="th_units">Units</th>
9055 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9056 <th class="th_tags">Tags</th>
9057 </tr>
9058 </thead>
9059
9060 <tbody>
9061
9062
9063
9064
9065
9066
9067
9068
9069
9070
9071
9072
9073 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9074 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9075 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9076 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9077 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9078 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9079 <span class="entry_type_container">x</span>
9080
9081 <span class="entry_type_array">
9082 4
9083 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9084 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9085 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9086
9087
9088 </td> <!-- entry_type -->
9089
9090 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9091 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9092active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9093pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9094 </td>
9095
9096 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9097 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9098 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9099 </td>
9100
9101 <td class="entry_range">
9102 </td>
9103
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9104 <td class="entry_tags">
9105 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9106 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9107 </ul>
9108 </td>
9109
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9110 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9111
9112
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9113 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9114 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9115
9116
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9117 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9118 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9119 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9120 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9121 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9122 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9123 <span class="entry_type_container">x</span>
9124
9125 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9126 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9127 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9128 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9129 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9130
9131
9132 </td> <!-- entry_type -->
9133
9134 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9135 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9136 </td>
9137
9138 <td class="entry_units">
9139 </td>
9140
9141 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]9142 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9143 </td>
9144
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9145 <td class="entry_tags">
9146 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9147 <li><a href="#tag_BC">BC</a></li>
9148 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9149 </ul>
9150 </td>
9151
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9152 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9153
9154
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9155 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9156 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9157
9158
9159 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9160 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9161 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9162 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9163 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9164 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9165
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9166 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9167
9168 <ul class="entry_type_enum">
9169 <li>
9170 <span class="entry_type_enum_name">RGGB</span>
9171 </li>
9172 <li>
9173 <span class="entry_type_enum_name">GRBG</span>
9174 </li>
9175 <li>
9176 <span class="entry_type_enum_name">GBRG</span>
9177 </li>
9178 <li>
9179 <span class="entry_type_enum_name">BGGR</span>
9180 </li>
9181 <li>
9182 <span class="entry_type_enum_name">RGB</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9183 <span class="entry_type_enum_notes">Sensor is not Bayer; output has 3 16-bit
9184 values for each pixel,<wbr/> instead of just 1 16-bit value
9185 per pixel.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9186 </li>
9187 </ul>
9188
9189 </td> <!-- entry_type -->
9190
9191 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9192 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9193represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9194the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9195 </td>
9196
9197 <td class="entry_units">
9198 </td>
9199
9200 <td class="entry_range">
9201 </td>
9202
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9203 <td class="entry_tags">
9204 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9205 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9206 </ul>
9207 </td>
9208
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9209 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9210
9211
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9212 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9213 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9214
9215
9216 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9217 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9218 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9219 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9220 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9221 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9222 <span class="entry_type_container">x</span>
9223
9224 <span class="entry_type_array">
9225 2
9226 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9227 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9228 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9229
9230
9231 </td> <!-- entry_type -->
9232
9233 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9234 <p>Range of valid exposure
9235times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9236 </td>
9237
9238 <td class="entry_units">
9239 </td>
9240
9241 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]9242 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
9243sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9244 </td>
9245
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9246 <td class="entry_tags">
9247 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9248 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9249 </ul>
9250 </td>
9251
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9252 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9253
9254
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9255 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9256 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9257
9258
9259 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9260 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9261 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9262 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9263 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9264 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9265
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9266 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9267
9268
9269 </td> <!-- entry_type -->
9270
9271 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9272 <p>Maximum possible frame duration (minimum frame
9273rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9274 </td>
9275
9276 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9277 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9278 </td>
9279
9280 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]9281 <blockquote>
9282<p>= 30e9</p>
9283</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9284 </td>
9285
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9286 <td class="entry_tags">
9287 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9288 <li><a href="#tag_BC">BC</a></li>
9289 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9290 </ul>
9291 </td>
9292
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9293 </tr>
9294 <tr class="entries_header">
9295 <th class="th_details" colspan="5">Details</th>
9296 </tr>
9297 <tr class="entry_cont">
9298 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9299 <p>Minimum duration is a function of resolution,<wbr/>
9300processing settings.<wbr/> See
9301android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
9302android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]9303<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]9304 </td>
9305 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9306
9307
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9308 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9309 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9310
9311
9312 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9313 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9314 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9315 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9316 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9317 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9318 <span class="entry_type_container">x</span>
9319
9320 <span class="entry_type_array">
9321 2
9322 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]9323 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9324 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9325
9326
9327 </td> <!-- entry_type -->
9328
9329 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9330 <p>The physical dimensions of the full pixel
9331array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9332 </td>
9333
9334 <td class="entry_units">
9335 </td>
9336
9337 <td class="entry_range">
9338 </td>
9339
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9340 <td class="entry_tags">
9341 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9342 <li><a href="#tag_V1">V1</a></li>
9343 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9344 </ul>
9345 </td>
9346
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9347 </tr>
9348 <tr class="entries_header">
9349 <th class="th_details" colspan="5">Details</th>
9350 </tr>
9351 <tr class="entry_cont">
9352 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9353 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9354 </td>
9355 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9356
9357
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9358 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9359 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9360
9361
9362 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9363 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9364 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9365 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9366 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9367 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9368 <span class="entry_type_container">x</span>
9369
9370 <span class="entry_type_array">
9371 2
9372 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9373 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9374
9375
9376 </td> <!-- entry_type -->
9377
9378 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9379 <p>Dimensions of full pixel array,<wbr/> possibly
9380including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9381 </td>
9382
9383 <td class="entry_units">
9384 </td>
9385
9386 <td class="entry_range">
9387 </td>
9388
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9389 <td class="entry_tags">
9390 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9391 <li><a href="#tag_DNG">DNG</a></li>
9392 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9393 </ul>
9394 </td>
9395
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9396 </tr>
9397 <tr class="entries_header">
9398 <th class="th_details" colspan="5">Details</th>
9399 </tr>
9400 <tr class="entry_cont">
9401 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9402 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9403match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9404android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9405 </td>
9406 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9407
9408
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9409 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9410 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9411
9412
9413 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9414 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9415 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9416 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9417 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9418 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9419
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9420 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9421
9422
9423 </td> <!-- entry_type -->
9424
9425 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9426 <p>Maximum raw value output by
9427sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9428 </td>
9429
9430 <td class="entry_units">
9431 </td>
9432
9433 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]9434 <blockquote>
9435<p>1024 (10-bit output)</p>
9436</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9437 </td>
9438
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9439 <td class="entry_tags">
9440 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9441 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9442 </ul>
9443 </td>
9444
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9445 </tr>
9446 <tr class="entries_header">
9447 <th class="th_details" colspan="5">Details</th>
9448 </tr>
9449 <tr class="entry_cont">
9450 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9451 <p>Defines sensor bit depth (10-14 bits is
9452expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9453 </td>
9454 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9455
9456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9457 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9458 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9459
9460
9461
9462
9463
9464 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9465 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9466 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9467 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9468 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9469 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9470
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9471 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9472
9473
9474 </td> <!-- entry_type -->
9475
9476 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9477 <p>Gain factor from electrons to raw units when
9478ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9479 </td>
9480
9481 <td class="entry_units">
9482 </td>
9483
9484 <td class="entry_range">
9485 </td>
9486
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9487 <td class="entry_tags">
9488 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9489 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9490 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9491 </ul>
9492 </td>
9493
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9494 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9495
9496
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9497 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9498 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9499
9500
9501 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9502 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9503 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9504 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9505 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9506 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9507 <span class="entry_type_container">x</span>
9508
9509 <span class="entry_type_array">
9510 4
9511 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9512 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9513 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9514
9515
9516 </td> <!-- entry_type -->
9517
9518 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9519 <p>A fixed black level offset for each of the
9520Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9521 </td>
9522
9523 <td class="entry_units">
9524 </td>
9525
9526 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]9527 <blockquote>
9528<p>= 0 each</p>
9529</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9530 </td>
9531
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9532 <td class="entry_tags">
9533 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9534 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9535 </ul>
9536 </td>
9537
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9538 </tr>
9539 <tr class="entries_header">
9540 <th class="th_details" colspan="5">Details</th>
9541 </tr>
9542 <tr class="entry_cont">
9543 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9544 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
9545tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9546 </td>
9547 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9548
9549
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9550 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9551 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9552
9553
9554 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9555 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9556 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9557 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9558 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9559 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9560 <span class="entry_type_container">x</span>
9561
9562 <span class="entry_type_array">
9563 9
9564 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9565 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9566 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9567
9568
9569 </td> <!-- entry_type -->
9570
9571 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9572 <p>Per-device calibration on top of color space
9573transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9574 </td>
9575
9576 <td class="entry_units">
9577 </td>
9578
9579 <td class="entry_range">
9580 </td>
9581
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9582 <td class="entry_tags">
9583 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9584 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9585 </ul>
9586 </td>
9587
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9588 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9589
9590
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9591 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9592 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9593
9594
9595 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9596 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9597 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9598 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9599 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9600 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9601 <span class="entry_type_container">x</span>
9602
9603 <span class="entry_type_array">
9604 9
9605 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9606 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9607 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9608
9609
9610 </td> <!-- entry_type -->
9611
9612 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9613 <p>Per-device calibration on top of color space
9614transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9615 </td>
9616
9617 <td class="entry_units">
9618 </td>
9619
9620 <td class="entry_range">
9621 </td>
9622
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9623 <td class="entry_tags">
9624 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9625 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9626 </ul>
9627 </td>
9628
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9629 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9630
9631
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9632 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9633 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9634
9635
9636 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9637 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9638 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9639 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9640 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9641 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9642 <span class="entry_type_container">x</span>
9643
9644 <span class="entry_type_array">
9645 9
9646 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9647 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9648 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9649
9650
9651 </td> <!-- entry_type -->
9652
9653 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9654 <p>Linear mapping from XYZ (D50) color space to
9655reference linear sensor color,<wbr/> for first reference
9656illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9657 </td>
9658
9659 <td class="entry_units">
9660 </td>
9661
9662 <td class="entry_range">
9663 </td>
9664
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9665 <td class="entry_tags">
9666 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9667 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9668 </ul>
9669 </td>
9670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9671 </tr>
9672 <tr class="entries_header">
9673 <th class="th_details" colspan="5">Details</th>
9674 </tr>
9675 <tr class="entry_cont">
9676 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9677 <p>Use as follows XYZ = inv(transform) * clip( (raw -
9678black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
9679At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9680 </td>
9681 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9682
9683
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9684 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9685 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9686
9687
9688 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9689 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9690 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
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">rational</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">
9697 9
9698 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9699 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9700 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9701
9702
9703 </td> <!-- entry_type -->
9704
9705 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9706 <p>Linear mapping from XYZ (D50) color space to
9707reference linear sensor color,<wbr/> for second reference
9708illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9709 </td>
9710
9711 <td class="entry_units">
9712 </td>
9713
9714 <td class="entry_range">
9715 </td>
9716
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9717 <td class="entry_tags">
9718 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9719 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9720 </ul>
9721 </td>
9722
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9723 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9724
9725
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9726 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9727 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9728
9729
9730 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9731 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9732 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9733 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9734 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9735 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9736 <span class="entry_type_container">x</span>
9737
9738 <span class="entry_type_array">
9739 9
9740 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9741 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9742 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9743
9744
9745 </td> <!-- entry_type -->
9746
9747 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9748 <p>Used by DNG for better WB
9749adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9750 </td>
9751
9752 <td class="entry_units">
9753 </td>
9754
9755 <td class="entry_range">
9756 </td>
9757
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9758 <td class="entry_tags">
9759 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9760 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9761 </ul>
9762 </td>
9763
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9764 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9765
9766
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9767 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9768 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9769
9770
9771 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9772 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9773 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9774 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9775 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9776 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9777 <span class="entry_type_container">x</span>
9778
9779 <span class="entry_type_array">
9780 9
9781 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9782 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9783 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9784
9785
9786 </td> <!-- entry_type -->
9787
9788 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9789 <p>Used by DNG for better WB
9790adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9791 </td>
9792
9793 <td class="entry_units">
9794 </td>
9795
9796 <td class="entry_range">
9797 </td>
9798
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9799 <td class="entry_tags">
9800 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9801 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9802 </ul>
9803 </td>
9804
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9805 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9806
9807
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9808 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9809 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9810
9811
9812 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9813 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9814 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9815 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9816 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9817 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9818
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9819 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9820
9821
9822 </td> <!-- entry_type -->
9823
9824 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9825 <p>Maximum sensitivity that is implemented
9826purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9827 </td>
9828
9829 <td class="entry_units">
9830 </td>
9831
9832 <td class="entry_range">
9833 </td>
9834
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9835 <td class="entry_tags">
9836 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9837 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9838 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9839 </ul>
9840 </td>
9841
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9842 </tr>
9843 <tr class="entries_header">
9844 <th class="th_details" colspan="5">Details</th>
9845 </tr>
9846 <tr class="entry_cont">
9847 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]9848 <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]9849equal to this,<wbr/> all applied gain must be analog.<wbr/> For
9850values above this,<wbr/> it can be a mix of analog and
9851digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9852 </td>
9853 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9854
9855
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9856 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9857 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9858
9859
9860 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9861 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9862 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9863 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9864 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9865 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9866 <span class="entry_type_container">x</span>
9867
9868 <span class="entry_type_array">
9869 2
9870 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9871 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9872 <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]9873
9874
9875 </td> <!-- entry_type -->
9876
9877 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9878 <p>Estimation of sensor noise
9879characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9880 </td>
9881
9882 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9883 var(raw pixel value) = electrons * (baseGainFactor
9884 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
9885 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9886 </td>
9887
9888 <td class="entry_range">
9889 </td>
9890
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9891 <td class="entry_tags">
9892 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9893 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9894 </ul>
9895 </td>
9896
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9897 </tr>
9898 <tr class="entries_header">
9899 <th class="th_details" colspan="5">Details</th>
9900 </tr>
9901 <tr class="entry_cont">
9902 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9903 <p>A represents sensor read noise before analog
9904amplification; B represents noise from A/<wbr/>D conversion and
9905other circuits after amplification.<wbr/> Both noise sources
9906are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
9907across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9908 </td>
9909 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9910
9911
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9912 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9913 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9914
9915
9916 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9917 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9918 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9919 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9920 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9921 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9922
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9923 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9924
9925
9926 </td> <!-- entry_type -->
9927
9928 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9929 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9930image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9931screen in its native orientation.<wbr/> Also defines the
9932direction of rolling shutter readout,<wbr/> which is from top
9933to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9934 </td>
9935
9936 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9937 degrees clockwise rotation,<wbr/> only multiples of
9938 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9939 </td>
9940
9941 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]9942 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9943 </td>
9944
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9945 <td class="entry_tags">
9946 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9947 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9948 </ul>
9949 </td>
9950
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9951 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9952
9953
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9954 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9955 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9956
9957
9958 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9959 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9960 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9961 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9962 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9963 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9964
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9965 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9966
9967 <ul class="entry_type_enum">
9968 <li>
9969 <span class="entry_type_enum_name">DAYLIGHT</span>
9970 <span class="entry_type_enum_value">1</span>
9971 </li>
9972 <li>
9973 <span class="entry_type_enum_name">FLUORESCENT</span>
9974 <span class="entry_type_enum_value">2</span>
9975 </li>
9976 <li>
9977 <span class="entry_type_enum_name">TUNGSTEN</span>
9978 <span class="entry_type_enum_value">3</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9979 <span class="entry_type_enum_notes">Incandescent light</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9980 </li>
9981 <li>
9982 <span class="entry_type_enum_name">FLASH</span>
9983 <span class="entry_type_enum_value">4</span>
9984 </li>
9985 <li>
9986 <span class="entry_type_enum_name">FINE_WEATHER</span>
9987 <span class="entry_type_enum_value">9</span>
9988 </li>
9989 <li>
9990 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
9991 <span class="entry_type_enum_value">10</span>
9992 </li>
9993 <li>
9994 <span class="entry_type_enum_name">SHADE</span>
9995 <span class="entry_type_enum_value">11</span>
9996 </li>
9997 <li>
9998 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
9999 <span class="entry_type_enum_value">12</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10000 <span class="entry_type_enum_notes">D 5700 - 7100K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10001 </li>
10002 <li>
10003 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10004 <span class="entry_type_enum_value">13</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10005 <span class="entry_type_enum_notes">N 4600 - 5400K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10006 </li>
10007 <li>
10008 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10009 <span class="entry_type_enum_value">14</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10010 <span class="entry_type_enum_notes">W 3900 - 4500K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10011 </li>
10012 <li>
10013 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10014 <span class="entry_type_enum_value">15</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10015 <span class="entry_type_enum_notes">WW 3200 - 3700K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10016 </li>
10017 <li>
10018 <span class="entry_type_enum_name">STANDARD_A</span>
10019 <span class="entry_type_enum_value">17</span>
10020 </li>
10021 <li>
10022 <span class="entry_type_enum_name">STANDARD_B</span>
10023 <span class="entry_type_enum_value">18</span>
10024 </li>
10025 <li>
10026 <span class="entry_type_enum_name">STANDARD_C</span>
10027 <span class="entry_type_enum_value">19</span>
10028 </li>
10029 <li>
10030 <span class="entry_type_enum_name">D55</span>
10031 <span class="entry_type_enum_value">20</span>
10032 </li>
10033 <li>
10034 <span class="entry_type_enum_name">D65</span>
10035 <span class="entry_type_enum_value">21</span>
10036 </li>
10037 <li>
10038 <span class="entry_type_enum_name">D75</span>
10039 <span class="entry_type_enum_value">22</span>
10040 </li>
10041 <li>
10042 <span class="entry_type_enum_name">D50</span>
10043 <span class="entry_type_enum_value">23</span>
10044 </li>
10045 <li>
10046 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10047 <span class="entry_type_enum_value">24</span>
10048 </li>
10049 </ul>
10050
10051 </td> <!-- entry_type -->
10052
10053 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10054 <p>Light source used to define transform
100551</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10056 </td>
10057
10058 <td class="entry_units">
10059 </td>
10060
10061 <td class="entry_range">
10062 </td>
10063
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10064 <td class="entry_tags">
10065 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10066 <li><a href="#tag_DNG">DNG</a></li>
10067 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10068 </ul>
10069 </td>
10070
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10071 </tr>
10072 <tr class="entries_header">
10073 <th class="th_details" colspan="5">Details</th>
10074 </tr>
10075 <tr class="entry_cont">
10076 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10077 <p>[EXIF LightSource tag] Must all these be
10078supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10079 </td>
10080 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10081
10082
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10083 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10084 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10085
10086
10087 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10088 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10089 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10090 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10091 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10092 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10093
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10094 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10095
10096
10097 </td> <!-- entry_type -->
10098
10099 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10100 <p>Light source used to define transform
101012</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10102 </td>
10103
10104 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10105 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10106 </td>
10107
10108 <td class="entry_range">
10109 </td>
10110
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10111 <td class="entry_tags">
10112 </td>
10113
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10114 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10115
10116
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10117 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10118 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10119
10120
10121
10122 <!-- end of kind -->
10123 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10124 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10125
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10126 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10127 <tr>
10128 <th class="th_name">Property Name</th>
10129 <th class="th_type">Type</th>
10130 <th class="th_description">Description</th>
10131 <th class="th_units">Units</th>
10132 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10133 <th class="th_tags">Tags</th>
10134 </tr>
10135 </thead>
10136
10137 <tbody>
10138
10139
10140
10141
10142
10143
10144
10145
10146
10147
10148 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10149 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10150 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10151 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10152 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10153 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10154
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10155 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10156
10157
10158 </td> <!-- entry_type -->
10159
10160 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10161 <p>Duration each pixel is exposed to
10162light.<wbr/></p>
10163<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
10164duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10165 </td>
10166
10167 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10168 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10169 </td>
10170
10171 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]10172 <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]10173 </td>
10174
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10175 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10176 <ul class="entry_tags">
10177 <li><a href="#tag_V1">V1</a></li>
10178 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10179 </td>
10180
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10181 </tr>
10182 <tr class="entries_header">
10183 <th class="th_details" colspan="5">Details</th>
10184 </tr>
10185 <tr class="entry_cont">
10186 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10187 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10188 </td>
10189 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10190
10191
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10192 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10193 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10194
10195
10196 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10197 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10198 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10199 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10200 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10201 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10202
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10203 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10204
10205
10206 </td> <!-- entry_type -->
10207
10208 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10209 <p>Duration from start of frame exposure to
10210start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10211 </td>
10212
10213 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10214 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10215 </td>
10216
10217 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]10218 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
10219android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10220 </td>
10221
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10222 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10223 <ul class="entry_tags">
10224 <li><a href="#tag_V1">V1</a></li>
10225 <li><a href="#tag_BC">BC</a></li>
10226 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10227 </td>
10228
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10229 </tr>
10230 <tr class="entries_header">
10231 <th class="th_details" colspan="5">Details</th>
10232 </tr>
10233 <tr class="entry_cont">
10234 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10235 <p>Exposure time has priority,<wbr/> so duration is set to
10236max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10237 </td>
10238 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10239
10240
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10241 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10242 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10243
10244
10245 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10246 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10247 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10248 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10249 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10250 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10251
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10252 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10253
10254
10255 </td> <!-- entry_type -->
10256
10257 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10258 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10259implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10260below 'maximum analog sensitivity'.<wbr/></p>
10261<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10262gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10263 </td>
10264
10265 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10266 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10267 </td>
10268
10269 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]10270 <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]10271 </td>
10272
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10273 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10274 <ul class="entry_tags">
10275 <li><a href="#tag_V1">V1</a></li>
10276 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10277 </td>
10278
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10279 </tr>
10280 <tr class="entries_header">
10281 <th class="th_details" colspan="5">Details</th>
10282 </tr>
10283 <tr class="entry_cont">
10284 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10285 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10286 </td>
10287 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10288
10289
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10290 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10291 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10292
10293
10294 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10295 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10296 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10297 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10298 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10299 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10300
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10301 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10302
10303
10304 </td> <!-- entry_type -->
10305
10306 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10307 <p>Time at start of exposure of first
10308row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10309 </td>
10310
10311 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10312 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10313 </td>
10314
10315 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]10316 <blockquote>
10317<p>0</p>
10318</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10319 </td>
10320
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10321 <td class="entry_tags">
10322 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10323 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10324 </ul>
10325 </td>
10326
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10327 </tr>
10328 <tr class="entries_header">
10329 <th class="th_details" colspan="5">Details</th>
10330 </tr>
10331 <tr class="entry_cont">
10332 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10333 <p>Monotonic,<wbr/> should be synced to other timestamps in
10334system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10335 </td>
10336 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10337
10338
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10339 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10340 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10341
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10342
10343 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10344 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10345 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10346 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10347 <td class="entry_type">
10348 <span class="entry_type_name">float</span>
10349
10350 <span class="entry_type_visibility"> [public]</span>
10351
10352
10353 </td> <!-- entry_type -->
10354
10355 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10356 <p>The temperature of the sensor,<wbr/> sampled at the time
10357exposure began for this frame.<wbr/></p>
10358<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
10359somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10360 </td>
10361
10362 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10363 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10364 </td>
10365
10366 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]10367 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10368 </td>
10369
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10370 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10371 <ul class="entry_tags">
10372 <li><a href="#tag_FULL">FULL</a></li>
10373 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10374 </td>
10375
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10376 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10377
10378
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10379 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10380 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10381
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10382
10383
10384 <!-- end of kind -->
10385 </tbody>
10386
10387 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10388 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10389
10390
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10391 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10392
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10393 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10394 <tr>
10395 <th class="th_name">Property Name</th>
10396 <th class="th_type">Type</th>
10397 <th class="th_description">Description</th>
10398 <th class="th_units">Units</th>
10399 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10400 <th class="th_tags">Tags</th>
10401 </tr>
10402 </thead>
10403
10404 <tbody>
10405
10406
10407
10408
10409
10410
10411
10412
10413
10414
10415 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10416 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10417 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10418 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10419 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10420 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10421
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10422 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10423
10424 <ul class="entry_type_enum">
10425 <li>
10426 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10427 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10428 </li>
10429 <li>
10430 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10431 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10432 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10433 </li>
10434 <li>
10435 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10436 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10437 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10438 </li>
10439 </ul>
10440
10441 </td> <!-- entry_type -->
10442
10443 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10444 <p>Quality of lens shading correction applied
10445to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10446 </td>
10447
10448 <td class="entry_units">
10449 </td>
10450
10451 <td class="entry_range">
10452 </td>
10453
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10454 <td class="entry_tags">
10455 </td>
10456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10457 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10458
10459
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10460 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10461 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10462
10463
10464 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10465 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10466 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10467 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10468 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10469 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10470
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10471 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10472
10473
10474 </td> <!-- entry_type -->
10475
10476 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10477 <p>Control the amount of shading correction
10478applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10479 </td>
10480
10481 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10482 unitless: 1-10; 10 is full shading
10483 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10484 </td>
10485
10486 <td class="entry_range">
10487 </td>
10488
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10489 <td class="entry_tags">
10490 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10491 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10492 </ul>
10493 </td>
10494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10495 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10496
10497
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10498 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10499 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10500
10501
10502
10503 <!-- end of kind -->
10504 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10505 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10506
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10507 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10508 <tr>
10509 <th class="th_name">Property Name</th>
10510 <th class="th_type">Type</th>
10511 <th class="th_description">Description</th>
10512 <th class="th_units">Units</th>
10513 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10514 <th class="th_tags">Tags</th>
10515 </tr>
10516 </thead>
10517
10518 <tbody>
10519
10520
10521
10522
10523
10524
10525
10526
10527
10528
10529 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10530 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10531 android.<wbr/>shading.<wbr/>mode
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 entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10535
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10536 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10537
10538 <ul class="entry_type_enum">
10539 <li>
10540 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10541 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10542 </li>
10543 <li>
10544 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10545 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10546 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10547 </li>
10548 <li>
10549 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10550 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10551 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10552 </li>
10553 </ul>
10554
10555 </td> <!-- entry_type -->
10556
10557 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10558 <p>Quality of lens shading correction applied
10559to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10560 </td>
10561
10562 <td class="entry_units">
10563 </td>
10564
10565 <td class="entry_range">
10566 </td>
10567
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10568 <td class="entry_tags">
10569 </td>
10570
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10571 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10572
10573
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10574 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10575 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10576
10577
10578
10579 <!-- end of kind -->
10580 </tbody>
10581
10582 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10583 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10584
10585
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10586 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10587
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10588 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10589 <tr>
10590 <th class="th_name">Property Name</th>
10591 <th class="th_type">Type</th>
10592 <th class="th_description">Description</th>
10593 <th class="th_units">Units</th>
10594 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10595 <th class="th_tags">Tags</th>
10596 </tr>
10597 </thead>
10598
10599 <tbody>
10600
10601
10602
10603
10604
10605
10606
10607
10608
10609
10610 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10611 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10612 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10613 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10614 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10615 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10616
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10617 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10618
10619 <ul class="entry_type_enum">
10620 <li>
10621 <span class="entry_type_enum_name">OFF</span>
10622 </li>
10623 <li>
10624 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10625 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
10626 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10627 </li>
10628 <li>
10629 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10630 <span class="entry_type_enum_notes">Optional Return all face
10631 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10632 </li>
10633 </ul>
10634
10635 </td> <!-- entry_type -->
10636
10637 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10638 <p>State of the face detector
10639unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10640 </td>
10641
10642 <td class="entry_units">
10643 </td>
10644
10645 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]10646 <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]10647 </td>
10648
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10649 <td class="entry_tags">
10650 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10651 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10652 </ul>
10653 </td>
10654
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10655 </tr>
10656 <tr class="entries_header">
10657 <th class="th_details" colspan="5">Details</th>
10658 </tr>
10659 <tr class="entry_cont">
10660 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10661 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10662should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10663fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]10664<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]10665 </td>
10666 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10667
10668
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10669 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10670 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10671
10672
10673 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10674 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10675 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10676 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10677 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10678 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10679
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10680 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10681
10682 <ul class="entry_type_enum">
10683 <li>
10684 <span class="entry_type_enum_name">OFF</span>
10685 </li>
10686 <li>
10687 <span class="entry_type_enum_name">ON</span>
10688 </li>
10689 </ul>
10690
10691 </td> <!-- entry_type -->
10692
10693 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10694 <p>Operating mode for histogram
10695generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10696 </td>
10697
10698 <td class="entry_units">
10699 </td>
10700
10701 <td class="entry_range">
10702 </td>
10703
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10704 <td class="entry_tags">
10705 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10706 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10707 </ul>
10708 </td>
10709
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10710 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10711
10712
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10713 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10714 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10715
10716
10717 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10718 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10719 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10720 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10721 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10722 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10723
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10724 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10725
10726 <ul class="entry_type_enum">
10727 <li>
10728 <span class="entry_type_enum_name">OFF</span>
10729 </li>
10730 <li>
10731 <span class="entry_type_enum_name">ON</span>
10732 </li>
10733 </ul>
10734
10735 </td> <!-- entry_type -->
10736
10737 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10738 <p>Operating mode for sharpness map
10739generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10740 </td>
10741
10742 <td class="entry_units">
10743 </td>
10744
10745 <td class="entry_range">
10746 </td>
10747
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10748 <td class="entry_tags">
10749 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10750 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10751 </ul>
10752 </td>
10753
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10754 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10755
10756
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10757 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10758 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10759
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10760
10761 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10762 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10763 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10764 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10765 <td class="entry_type">
10766 <span class="entry_type_name entry_type_name_enum">byte</span>
10767
10768 <span class="entry_type_visibility"> [public]</span>
10769
10770 <ul class="entry_type_enum">
10771 <li>
10772 <span class="entry_type_enum_name">OFF</span>
10773 </li>
10774 <li>
10775 <span class="entry_type_enum_name">ON</span>
10776 </li>
10777 </ul>
10778
10779 </td> <!-- entry_type -->
10780
10781 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10782 <p>Whether the HAL needs to output the lens
10783shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10784 </td>
10785
10786 <td class="entry_units">
10787 </td>
10788
10789 <td class="entry_range">
10790 </td>
10791
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10792 <td class="entry_tags">
10793 </td>
10794
10795 </tr>
10796 <tr class="entries_header">
10797 <th class="th_details" colspan="5">Details</th>
10798 </tr>
10799 <tr class="entry_cont">
10800 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10801 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]10802<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]10803the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10804 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10805 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10806
10807
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10808 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10809 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10810
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10811
10812
10813 <!-- end of kind -->
10814 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10815 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10816
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10817 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10818 <tr>
10819 <th class="th_name">Property Name</th>
10820 <th class="th_type">Type</th>
10821 <th class="th_description">Description</th>
10822 <th class="th_units">Units</th>
10823 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10824 <th class="th_tags">Tags</th>
10825 </tr>
10826 </thead>
10827
10828 <tbody>
10829
10830
10831
10832
10833
10834
10835
10836
10837
10838
10839
10840
10841 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10842 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10843 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10844 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10845 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10846 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10847 <span class="entry_type_container">x</span>
10848
10849 <span class="entry_type_array">
10850 n
10851 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10852 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10853 <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]10854
10855
10856 </td> <!-- entry_type -->
10857
10858 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10859 <p>Which face detection modes are available,<wbr/>
10860if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10861 </td>
10862
10863 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10864 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10865 OFF
10866 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10867 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10868 </td>
10869
10870 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10871 </td>
10872
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10873 <td class="entry_tags">
10874 </td>
10875
10876 </tr>
10877 <tr class="entries_header">
10878 <th class="th_details" colspan="5">Details</th>
10879 </tr>
10880 <tr class="entry_cont">
10881 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10882 <p>OFF means face detection is disabled,<wbr/> it must
10883be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10884<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]10885<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
10886<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]10887<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]10888<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
10889<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]10890 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10891 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10892
10893
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10894 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10895 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10896
10897
10898 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10899 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10900 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10901 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10902 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10903 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10904
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10905 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10906
10907
10908 </td> <!-- entry_type -->
10909
10910 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10911 <p>Number of histogram buckets
10912supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10913 </td>
10914
10915 <td class="entry_units">
10916 </td>
10917
10918 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]10919 <blockquote>
10920<p>= 64</p>
10921</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10922 </td>
10923
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10924 <td class="entry_tags">
10925 </td>
10926
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10927 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10928
10929
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10930 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10931 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10932
10933
10934 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10935 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10936 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10937 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10938 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10939 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10940
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10941 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10942
10943
10944 </td> <!-- entry_type -->
10945
10946 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10947 <p>Maximum number of simultaneously detectable
10948faces</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">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]10955 <blockquote>
10956<p>= 4 if availableFaceDetectionModes lists
10957modes besides OFF,<wbr/> otherwise 0</p>
10958</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10959 </td>
10960
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10961 <td class="entry_tags">
10962 </td>
10963
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10964 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10965
10966
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10967 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10968 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10969
10970
10971 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10972 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10973 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10974 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10975 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10976 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10977
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10978 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10979
10980
10981 </td> <!-- entry_type -->
10982
10983 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10984 <p>Maximum value possible for a histogram
10985bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10986 </td>
10987
10988 <td class="entry_units">
10989 </td>
10990
10991 <td class="entry_range">
10992 </td>
10993
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10994 <td class="entry_tags">
10995 </td>
10996
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10997 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10998
10999
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11000 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11001 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11002
11003
11004 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11005 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11006 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11007 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11008 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11009 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11010
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11011 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11012
11013
11014 </td> <!-- entry_type -->
11015
11016 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11017 <p>Maximum value possible for a sharpness map
11018region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11019 </td>
11020
11021 <td class="entry_units">
11022 </td>
11023
11024 <td class="entry_range">
11025 </td>
11026
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11027 <td class="entry_tags">
11028 </td>
11029
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11030 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11031
11032
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11033 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11034 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11035
11036
11037 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11038 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11039 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11040 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11041 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11042 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11043 <span class="entry_type_container">x</span>
11044
11045 <span class="entry_type_array">
11046 2
11047 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11048 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11049 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11050
11051
11052 </td> <!-- entry_type -->
11053
11054 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11055 <p>Dimensions of the sharpness
11056map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11057 </td>
11058
11059 <td class="entry_units">
11060 </td>
11061
11062 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11063 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11064 </td>
11065
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11066 <td class="entry_tags">
11067 </td>
11068
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11069 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11070
11071
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11072 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11073 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11074
11075
11076
11077
11078
11079
11080 <!-- end of kind -->
11081 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11082 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11083
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11084 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11085 <tr>
11086 <th class="th_name">Property Name</th>
11087 <th class="th_type">Type</th>
11088 <th class="th_description">Description</th>
11089 <th class="th_units">Units</th>
11090 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11091 <th class="th_tags">Tags</th>
11092 </tr>
11093 </thead>
11094
11095 <tbody>
11096
11097
11098
11099
11100
11101
11102
11103
11104
11105
11106 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11107 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11108 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11109 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11110 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11111 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11112
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11113 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11114
11115 <ul class="entry_type_enum">
11116 <li>
11117 <span class="entry_type_enum_name">OFF</span>
11118 </li>
11119 <li>
11120 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11121 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
11122 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11123 </li>
11124 <li>
11125 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11126 <span class="entry_type_enum_notes">Optional Return all face
11127 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11128 </li>
11129 </ul>
11130
11131 </td> <!-- entry_type -->
11132
11133 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11134 <p>State of the face detector
11135unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11136 </td>
11137
11138 <td class="entry_units">
11139 </td>
11140
11141 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11142 <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]11143 </td>
11144
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11145 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11146 <ul class="entry_tags">
11147 <li><a href="#tag_BC">BC</a></li>
11148 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11149 </td>
11150
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11151 </tr>
11152 <tr class="entries_header">
11153 <th class="th_details" colspan="5">Details</th>
11154 </tr>
11155 <tr class="entry_cont">
11156 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11157 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11158should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11159fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11160<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]11161 </td>
11162 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11163
11164
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11165 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11166 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11167
11168
11169 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11170 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11171 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11172 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11173 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11174 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11175 <span class="entry_type_container">x</span>
11176
11177 <span class="entry_type_array">
11178 n
11179 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11180 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11181
11182
11183 </td> <!-- entry_type -->
11184
11185 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11186 <p>List of unique IDs for detected
11187faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11188 </td>
11189
11190 <td class="entry_units">
11191 </td>
11192
11193 <td class="entry_range">
11194 </td>
11195
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11196 <td class="entry_tags">
11197 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11198 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11199 </ul>
11200 </td>
11201
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11202 </tr>
11203 <tr class="entries_header">
11204 <th class="th_details" colspan="5">Details</th>
11205 </tr>
11206 <tr class="entry_cont">
11207 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11208 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11209 </td>
11210 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11211
11212
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11213 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11214 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11215
11216
11217 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11218 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11219 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11220 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11221 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11222 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11223 <span class="entry_type_container">x</span>
11224
11225 <span class="entry_type_array">
11226 n x 6
11227 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11228 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11229 <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]11230
11231
11232 </td> <!-- entry_type -->
11233
11234 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11235 <p>List of landmarks for detected
11236faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11237 </td>
11238
11239 <td class="entry_units">
11240 </td>
11241
11242 <td class="entry_range">
11243 </td>
11244
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11245 <td class="entry_tags">
11246 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11247 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11248 </ul>
11249 </td>
11250
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11251 </tr>
11252 <tr class="entries_header">
11253 <th class="th_details" colspan="5">Details</th>
11254 </tr>
11255 <tr class="entry_cont">
11256 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11257 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11258 </td>
11259 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11260
11261
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11262 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11263 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11264
11265
11266 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11267 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11268 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11269 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11270 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11271 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11272 <span class="entry_type_container">x</span>
11273
11274 <span class="entry_type_array">
11275 n x 4
11276 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11277 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11278 <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]11279
11280
11281 </td> <!-- entry_type -->
11282
11283 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11284 <p>List of the bounding rectangles for detected
11285faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11286 </td>
11287
11288 <td class="entry_units">
11289 </td>
11290
11291 <td class="entry_range">
11292 </td>
11293
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11294 <td class="entry_tags">
11295 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11296 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11297 </ul>
11298 </td>
11299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11300 </tr>
11301 <tr class="entries_header">
11302 <th class="th_details" colspan="5">Details</th>
11303 </tr>
11304 <tr class="entry_cont">
11305 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11306 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11307 </td>
11308 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11309
11310
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11311 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11312 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11313
11314
11315 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11316 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11317 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11318 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11319 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11320 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11321 <span class="entry_type_container">x</span>
11322
11323 <span class="entry_type_array">
11324 n
11325 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11326 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11327
11328
11329 </td> <!-- entry_type -->
11330
11331 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11332 <p>List of the face confidence scores for
11333detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11334 </td>
11335
11336 <td class="entry_units">
11337 </td>
11338
11339 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11340 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11341 </td>
11342
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11343 <td class="entry_tags">
11344 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11345 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11346 </ul>
11347 </td>
11348
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11349 </tr>
11350 <tr class="entries_header">
11351 <th class="th_details" colspan="5">Details</th>
11352 </tr>
11353 <tr class="entry_cont">
11354 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11355 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
11356meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11357 </td>
11358 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11359
11360
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11361 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11362 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11363
11364
11365 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11366 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11367 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11368 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11369 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11370 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11371 <span class="entry_type_container">x</span>
11372
11373 <span class="entry_type_array">
11374 n x 3
11375 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11376 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11377 <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]11378
11379
11380 </td> <!-- entry_type -->
11381
11382 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11383 <p>A 3-channel histogram based on the raw
11384sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11385 </td>
11386
11387 <td class="entry_units">
11388 </td>
11389
11390 <td class="entry_range">
11391 </td>
11392
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11393 <td class="entry_tags">
11394 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11395 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11396 </ul>
11397 </td>
11398
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11399 </tr>
11400 <tr class="entries_header">
11401 <th class="th_details" colspan="5">Details</th>
11402 </tr>
11403 <tr class="entry_cont">
11404 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11405 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11406(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]11407(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
11408supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11409 </td>
11410 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11411
11412
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11413 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11414 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11415
11416
11417 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11418 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11419 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11420 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11421 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11422 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11423
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11424 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11425
11426 <ul class="entry_type_enum">
11427 <li>
11428 <span class="entry_type_enum_name">OFF</span>
11429 </li>
11430 <li>
11431 <span class="entry_type_enum_name">ON</span>
11432 </li>
11433 </ul>
11434
11435 </td> <!-- entry_type -->
11436
11437 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11438 <p>Operating mode for histogram
11439generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11440 </td>
11441
11442 <td class="entry_units">
11443 </td>
11444
11445 <td class="entry_range">
11446 </td>
11447
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11448 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11449 <ul class="entry_tags">
11450 <li><a href="#tag_V1">V1</a></li>
11451 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11452 </td>
11453
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11454 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11455
11456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11457 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11458 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11459
11460
11461 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11462 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11463 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11464 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11465 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11466 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11467 <span class="entry_type_container">x</span>
11468
11469 <span class="entry_type_array">
11470 n x m x 3
11471 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11472 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11473 <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]11474
11475
11476 </td> <!-- entry_type -->
11477
11478 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11479 <p>A 3-channel sharpness map,<wbr/> based on the raw
11480sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11481 </td>
11482
11483 <td class="entry_units">
11484 </td>
11485
11486 <td class="entry_range">
11487 </td>
11488
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11489 <td class="entry_tags">
11490 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11491 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11492 </ul>
11493 </td>
11494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11495 </tr>
11496 <tr class="entries_header">
11497 <th class="th_details" colspan="5">Details</th>
11498 </tr>
11499 <tr class="entry_cont">
11500 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11501 <p>If only a monochrome sharpness map is supported,<wbr/>
11502all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11503 </td>
11504 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11505
11506
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11507 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11508 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11509
11510
11511 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11512 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11513 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11514 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11515 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11516 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11517
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11518 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11519
11520 <ul class="entry_type_enum">
11521 <li>
11522 <span class="entry_type_enum_name">OFF</span>
11523 </li>
11524 <li>
11525 <span class="entry_type_enum_name">ON</span>
11526 </li>
11527 </ul>
11528
11529 </td> <!-- entry_type -->
11530
11531 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11532 <p>Operating mode for sharpness map
11533generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11534 </td>
11535
11536 <td class="entry_units">
11537 </td>
11538
11539 <td class="entry_range">
11540 </td>
11541
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11542 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11543 <ul class="entry_tags">
11544 <li><a href="#tag_V1">V1</a></li>
11545 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11546 </td>
11547
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11548 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11549
11550
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11551 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11552 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11553
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11554
11555 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11556 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11557 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11558 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11559 <td class="entry_type">
11560 <span class="entry_type_name">float</span>
11561 <span class="entry_type_container">x</span>
11562
11563 <span class="entry_type_array">
11564 4 x n x m
11565 </span>
11566 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11567 <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]11568
11569
11570 </td> <!-- entry_type -->
11571
11572 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11573 <p>The shading map is a low-resolution floating-point map
11574that lists the coefficients used to correct for vignetting,<wbr/> for each
11575Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11576 </td>
11577
11578 <td class="entry_units">
11579 </td>
11580
11581 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11582 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11583 </td>
11584
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11585 <td class="entry_tags">
11586 </td>
11587
11588 </tr>
11589 <tr class="entries_header">
11590 <th class="th_details" colspan="5">Details</th>
11591 </tr>
11592 <tr class="entry_cont">
11593 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11594 <p>The least shaded section of the image should have a gain factor
11595of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11596<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]11597must take into account the colorCorrection settings.<wbr/></p>
11598<p>The shading map is for the entire active pixel array,<wbr/> and is not
11599affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11600entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11601pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
11602map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
11603(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
11604pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
11605The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
11606<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
11607channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
11608The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11609is 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]11610<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
11611and must be smaller than 64x64.<wbr/></p>
11612<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11613<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
11614<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]11615[ 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/>
11616 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/>
11617 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/>
11618 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/>
11619 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/>
11620 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]11621</code></pre>
11622<p>The low-resolution scaling map images for each channel are
11623(displayed using nearest-neighbor interpolation):</p>
11624<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
11625<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
11626<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
11627<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]11628<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11629image 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]11630<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]11631 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11632 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11633
11634
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11635 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11636 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11637
11638
11639 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11640 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11641 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11642 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11643 <td class="entry_type">
11644 <span class="entry_type_name">float</span>
11645 <span class="entry_type_container">x</span>
11646
11647 <span class="entry_type_array">
11648 4
11649 </span>
11650 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11651 <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]11652
11653
11654 </td> <!-- entry_type -->
11655
11656 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11657 <p>The best-fit color channel gains calculated
11658by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11659 </td>
11660
11661 <td class="entry_units">
11662 </td>
11663
11664 <td class="entry_range">
11665 </td>
11666
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11667 <td class="entry_tags">
11668 </td>
11669
11670 </tr>
11671 <tr class="entries_header">
11672 <th class="th_details" colspan="5">Details</th>
11673 </tr>
11674 <tr class="entry_cont">
11675 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11676 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11677since statistics processing on data from a new frame
11678typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11679applied to that frame.<wbr/></p>
11680<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11681see <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]11682<p>This value should always be calculated by the AWB block,<wbr/>
11683regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11684 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11685 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11686
11687
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11688 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11689 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11690
11691
11692 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11693 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11694 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11695 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11696 <td class="entry_type">
11697 <span class="entry_type_name">rational</span>
11698 <span class="entry_type_container">x</span>
11699
11700 <span class="entry_type_array">
11701 3 x 3
11702 </span>
11703 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11704 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11705
11706
11707 </td> <!-- entry_type -->
11708
11709 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11710 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11711calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11712output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11713 </td>
11714
11715 <td class="entry_units">
11716 </td>
11717
11718 <td class="entry_range">
11719 </td>
11720
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11721 <td class="entry_tags">
11722 </td>
11723
11724 </tr>
11725 <tr class="entries_header">
11726 <th class="th_details" colspan="5">Details</th>
11727 </tr>
11728 <tr class="entry_cont">
11729 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11730 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11731statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11732for the next frame.<wbr/> These are the values the HAL believes
11733are the best fit for the current output frame.<wbr/> This may
11734be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11735statistics processing on data from a new frame typically
11736completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11737that frame.<wbr/></p>
11738<p>These estimates must be provided for all frames,<wbr/> even if
11739capture settings and color transforms are set by the application.<wbr/></p>
11740<p>This value should always be calculated by the AWB block,<wbr/>
11741regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11742 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11743 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11744
11745
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11746 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11747 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11748
11749
11750 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11751 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11752 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11753 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11754 <td class="entry_type">
11755 <span class="entry_type_name entry_type_name_enum">byte</span>
11756
11757 <span class="entry_type_visibility"> [public]</span>
11758
11759 <ul class="entry_type_enum">
11760 <li>
11761 <span class="entry_type_enum_name">NONE</span>
11762 </li>
11763 <li>
11764 <span class="entry_type_enum_name">50HZ</span>
11765 </li>
11766 <li>
11767 <span class="entry_type_enum_name">60HZ</span>
11768 </li>
11769 </ul>
11770
11771 </td> <!-- entry_type -->
11772
11773 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11774 <p>The HAL estimated scene illumination lighting
11775frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11776 </td>
11777
11778 <td class="entry_units">
11779 </td>
11780
11781 <td class="entry_range">
11782 </td>
11783
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11784 <td class="entry_tags">
11785 </td>
11786
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11787 </tr>
11788 <tr class="entries_header">
11789 <th class="th_details" colspan="5">Details</th>
11790 </tr>
11791 <tr class="entry_cont">
11792 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11793 <p>Report NONE if there doesn't appear to be flickering
11794illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11795 </td>
11796 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11797
11798
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11799 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11800 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11801
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11802
11803
11804 <!-- end of kind -->
11805 </tbody>
11806
11807 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11808 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11809
11810
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11811 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11812
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11813 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11814 <tr>
11815 <th class="th_name">Property Name</th>
11816 <th class="th_type">Type</th>
11817 <th class="th_description">Description</th>
11818 <th class="th_units">Units</th>
11819 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11820 <th class="th_tags">Tags</th>
11821 </tr>
11822 </thead>
11823
11824 <tbody>
11825
11826
11827
11828
11829
11830
11831
11832
11833
11834
11835 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11836 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11837 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11838 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11839 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]11840 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11841 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11842
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11843 <span class="entry_type_array">
11844 n x 2
11845 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11846 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11847 <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]11848
11849
11850 </td> <!-- entry_type -->
11851
11852 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11853 <p>Table mapping blue input values to output
11854values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11855 </td>
11856
11857 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11858 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11859 </td>
11860
11861 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11862 <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]11863 </td>
11864
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11865 <td class="entry_tags">
11866 </td>
11867
11868 </tr>
11869 <tr class="entries_header">
11870 <th class="th_details" colspan="5">Details</th>
11871 </tr>
11872 <tr class="entry_cont">
11873 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11874 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11875channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
11876<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]11877 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11878 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11879
11880
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11881 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11882 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11883
11884
11885 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11886 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11887 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11888 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11889 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]11890 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11891 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11892
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11893 <span class="entry_type_array">
11894 n x 2
11895 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11896 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11897 <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]11898
11899
11900 </td> <!-- entry_type -->
11901
11902 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11903 <p>Table mapping green input values to output
11904values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11905 </td>
11906
11907 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11908 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11909 </td>
11910
11911 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11912 <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]11913 </td>
11914
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11915 <td class="entry_tags">
11916 </td>
11917
11918 </tr>
11919 <tr class="entries_header">
11920 <th class="th_details" colspan="5">Details</th>
11921 </tr>
11922 <tr class="entry_cont">
11923 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11924 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11925channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
11926<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]11927 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11928 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11929
11930
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11931 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11932 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11933
11934
11935 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11936 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11937 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11938 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11939 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11940 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11941 <span class="entry_type_container">x</span>
11942
11943 <span class="entry_type_array">
11944 n x 2
11945 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11946 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11947 <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]11948
11949
11950 </td> <!-- entry_type -->
11951
11952 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11953 <p>Table mapping red input values to output
11954values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11955 </td>
11956
11957 <td class="entry_units">
11958 </td>
11959
11960 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11961 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11962 </td>
11963
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11964 <td class="entry_tags">
11965 <ul class="entry_tags">
11966 <li><a href="#tag_DNG">DNG</a></li>
11967 </ul>
11968 </td>
11969
11970 </tr>
11971 <tr class="entries_header">
11972 <th class="th_details" colspan="5">Details</th>
11973 </tr>
11974 <tr class="entry_cont">
11975 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11976 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]11977channel,<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]11978<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11979the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11980are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11981between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11982<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11983defined points.<wbr/> The points will be listed in increasing
11984order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
119850.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
11986for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
119870.<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]11988 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11989 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11990
11991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11992 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11993 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11994
11995
11996 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11997 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11998 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11999 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12000 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12001 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12002
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12003 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12004
12005 <ul class="entry_type_enum">
12006 <li>
12007 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12008 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12009 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12010 </li>
12011 <li>
12012 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12013 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12014 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12015 </li>
12016 <li>
12017 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12018 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12019 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12020 </li>
12021 </ul>
12022
12023 </td> <!-- entry_type -->
12024
12025 <td class="entry_description">
12026 </td>
12027
12028 <td class="entry_units">
12029 </td>
12030
12031 <td class="entry_range">
12032 </td>
12033
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12034 <td class="entry_tags">
12035 </td>
12036
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12037 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12038
12039
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12040 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12041 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12042
12043
12044
12045 <!-- end of kind -->
12046 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12047 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12048
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12049 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12050 <tr>
12051 <th class="th_name">Property Name</th>
12052 <th class="th_type">Type</th>
12053 <th class="th_description">Description</th>
12054 <th class="th_units">Units</th>
12055 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12056 <th class="th_tags">Tags</th>
12057 </tr>
12058 </thead>
12059
12060 <tbody>
12061
12062
12063
12064
12065
12066
12067
12068
12069
12070
12071 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12072 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12073 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12074 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12075 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12076 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12077
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12078 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12079
12080
12081 </td> <!-- entry_type -->
12082
12083 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12084 <p>Maximum number of supported points in the
12085tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12086 </td>
12087
12088 <td class="entry_units">
12089 </td>
12090
12091 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]12092 <blockquote>
12093<p>= 128</p>
12094</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12095 </td>
12096
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12097 <td class="entry_tags">
12098 </td>
12099
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12100 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12101
12102
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12103 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12104 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12105
12106
12107
12108 <!-- end of kind -->
12109 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12110 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12111
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12112 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12113 <tr>
12114 <th class="th_name">Property Name</th>
12115 <th class="th_type">Type</th>
12116 <th class="th_description">Description</th>
12117 <th class="th_units">Units</th>
12118 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12119 <th class="th_tags">Tags</th>
12120 </tr>
12121 </thead>
12122
12123 <tbody>
12124
12125
12126
12127
12128
12129
12130
12131
12132
12133
12134 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12135 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12136 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12137 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12138 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12139 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12140 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12141
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12142 <span class="entry_type_array">
12143 n x 2
12144 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12145 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12146 <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]12147
12148
12149 </td> <!-- entry_type -->
12150
12151 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12152 <p>Table mapping blue input values to output
12153values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12154 </td>
12155
12156 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12157 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12158 </td>
12159
12160 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]12161 <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]12162 </td>
12163
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12164 <td class="entry_tags">
12165 </td>
12166
12167 </tr>
12168 <tr class="entries_header">
12169 <th class="th_details" colspan="5">Details</th>
12170 </tr>
12171 <tr class="entry_cont">
12172 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12173 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]12174channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12175<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]12176 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12177 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12178
12179
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12180 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12181 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12182
12183
12184 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12185 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12186 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12187 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12188 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12189 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12190 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12191
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12192 <span class="entry_type_array">
12193 n x 2
12194 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12195 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12196 <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]12197
12198
12199 </td> <!-- entry_type -->
12200
12201 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12202 <p>Table mapping green input values to output
12203values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12204 </td>
12205
12206 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12207 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12208 </td>
12209
12210 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]12211 <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]12212 </td>
12213
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12214 <td class="entry_tags">
12215 </td>
12216
12217 </tr>
12218 <tr class="entries_header">
12219 <th class="th_details" colspan="5">Details</th>
12220 </tr>
12221 <tr class="entry_cont">
12222 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12223 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]12224channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12225<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]12226 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12227 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12228
12229
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12230 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12231 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12232
12233
12234 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12235 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12236 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12237 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12238 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12239 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12240 <span class="entry_type_container">x</span>
12241
12242 <span class="entry_type_array">
12243 n x 2
12244 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12245 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12246 <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]12247
12248
12249 </td> <!-- entry_type -->
12250
12251 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12252 <p>Table mapping red input values to output
12253values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12254 </td>
12255
12256 <td class="entry_units">
12257 </td>
12258
12259 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]12260 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12261 </td>
12262
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12263 <td class="entry_tags">
12264 <ul class="entry_tags">
12265 <li><a href="#tag_DNG">DNG</a></li>
12266 </ul>
12267 </td>
12268
12269 </tr>
12270 <tr class="entries_header">
12271 <th class="th_details" colspan="5">Details</th>
12272 </tr>
12273 <tr class="entry_cont">
12274 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12275 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]12276channel,<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]12277<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12278the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12279are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12280between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12281<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12282defined points.<wbr/> The points will be listed in increasing
12283order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
122840.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12285for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
122860.<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]12287 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12288 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12289
12290
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12291 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12292 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12293
12294
12295 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12296 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12297 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12298 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12299 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12300 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12301
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12302 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12303
12304 <ul class="entry_type_enum">
12305 <li>
12306 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12307 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12308 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12309 </li>
12310 <li>
12311 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12312 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12313 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12314 </li>
12315 <li>
12316 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12317 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12318 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12319 </li>
12320 </ul>
12321
12322 </td> <!-- entry_type -->
12323
12324 <td class="entry_description">
12325 </td>
12326
12327 <td class="entry_units">
12328 </td>
12329
12330 <td class="entry_range">
12331 </td>
12332
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12333 <td class="entry_tags">
12334 </td>
12335
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12336 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12337
12338
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12339 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12340 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12341
12342
12343
12344 <!-- end of kind -->
12345 </tbody>
12346
12347 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12348 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12349
12350
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12351 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12352
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12353 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12354 <tr>
12355 <th class="th_name">Property Name</th>
12356 <th class="th_type">Type</th>
12357 <th class="th_description">Description</th>
12358 <th class="th_units">Units</th>
12359 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12360 <th class="th_tags">Tags</th>
12361 </tr>
12362 </thead>
12363
12364 <tbody>
12365
12366
12367
12368
12369
12370
12371
12372
12373
12374
12375 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12376 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12377 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12378 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12379 <td class="entry_type">
12380 <span class="entry_type_name entry_type_name_enum">byte</span>
12381
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12382 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12383
12384 <ul class="entry_type_enum">
12385 <li>
12386 <span class="entry_type_enum_name">OFF</span>
12387 </li>
12388 <li>
12389 <span class="entry_type_enum_name">ON</span>
12390 </li>
12391 </ul>
12392
12393 </td> <!-- entry_type -->
12394
12395 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12396 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12397that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12398Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12399disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12400any untrusted applications.<wbr/></p>
12401<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12402transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12403data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12404<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]12405doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12406 </td>
12407
12408 <td class="entry_units">
12409 </td>
12410
12411 <td class="entry_range">
12412 </td>
12413
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12414 <td class="entry_tags">
12415 </td>
12416
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12417 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12418
12419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12420 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12421 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12422
12423
12424
12425 <!-- end of kind -->
12426 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12427 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12428
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12429 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12430 <tr>
12431 <th class="th_name">Property Name</th>
12432 <th class="th_type">Type</th>
12433 <th class="th_description">Description</th>
12434 <th class="th_units">Units</th>
12435 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12436 <th class="th_tags">Tags</th>
12437 </tr>
12438 </thead>
12439
12440 <tbody>
12441
12442
12443
12444
12445
12446
12447
12448
12449
12450
12451 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12452 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12453 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12454 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12455 <td class="entry_type">
12456 <span class="entry_type_name entry_type_name_enum">byte</span>
12457
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12458 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12459
12460 <ul class="entry_type_enum">
12461 <li>
12462 <span class="entry_type_enum_name">OFF</span>
12463 </li>
12464 <li>
12465 <span class="entry_type_enum_name">ON</span>
12466 </li>
12467 </ul>
12468
12469 </td> <!-- entry_type -->
12470
12471 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12472 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12473that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12474Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12475disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12476any untrusted applications.<wbr/></p>
12477<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12478transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12479data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12480<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]12481doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12482 </td>
12483
12484 <td class="entry_units">
12485 </td>
12486
12487 <td class="entry_range">
12488 </td>
12489
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12490 <td class="entry_tags">
12491 </td>
12492
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12493 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12494
12495
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12496 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12497 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12498
12499
12500
12501 <!-- end of kind -->
12502 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12503 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12504
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12505 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12506 <tr>
12507 <th class="th_name">Property Name</th>
12508 <th class="th_type">Type</th>
12509 <th class="th_description">Description</th>
12510 <th class="th_units">Units</th>
12511 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12512 <th class="th_tags">Tags</th>
12513 </tr>
12514 </thead>
12515
12516 <tbody>
12517
12518
12519
12520
12521
12522
12523
12524
12525
12526
12527 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12528 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12529 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12530 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12531 <td class="entry_type">
12532 <span class="entry_type_name entry_type_name_enum">byte</span>
12533 <span class="entry_type_container">x</span>
12534
12535 <span class="entry_type_array">
12536 n
12537 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12538 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12539
12540 <ul class="entry_type_enum">
12541 <li>
12542 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12543 <span class="entry_type_enum_notes">android.<wbr/>led.<wbr/>transmit control is used</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12544 </li>
12545 </ul>
12546
12547 </td> <!-- entry_type -->
12548
12549 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12550 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12551 </td>
12552
12553 <td class="entry_units">
12554 </td>
12555
12556 <td class="entry_range">
12557 </td>
12558
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12559 <td class="entry_tags">
12560 </td>
12561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12562 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12563
12564
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12565 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12566 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12567
12568
12569
12570 <!-- end of kind -->
12571 </tbody>
12572
12573 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12574 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12575
12576
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12577 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12578
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12579 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12580 <tr>
12581 <th class="th_name">Property Name</th>
12582 <th class="th_type">Type</th>
12583 <th class="th_description">Description</th>
12584 <th class="th_units">Units</th>
12585 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12586 <th class="th_tags">Tags</th>
12587 </tr>
12588 </thead>
12589
12590 <tbody>
12591
12592
12593
12594
12595
12596
12597
12598
12599
12600
12601 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12602 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12603 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12604 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12605 <td class="entry_type">
12606 <span class="entry_type_name entry_type_name_enum">byte</span>
12607
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12608 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12609
12610 <ul class="entry_type_enum">
12611 <li>
12612 <span class="entry_type_enum_name">LIMITED</span>
12613 </li>
12614 <li>
12615 <span class="entry_type_enum_name">FULL</span>
12616 </li>
12617 </ul>
12618
12619 </td> <!-- entry_type -->
12620
12621 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12622 <p>The camera 3 HAL device can implement one of two possible
12623operational modes; limited and full.<wbr/> Full support is
12624expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12625hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12626camera HAL device v1 implementation,<wbr/> and is expected from
12627older or inexpensive devices.<wbr/> Full is a strict superset of
12628limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
12629<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]12630 </td>
12631
12632 <td class="entry_units">
12633 </td>
12634
12635 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame^]12636 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12637 </td>
12638
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12639 <td class="entry_tags">
12640 </td>
12641
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12642 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12643
12644
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12645 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12646 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12647
12648
12649
12650 <!-- end of kind -->
12651 </tbody>
12652
12653 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12654 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12655
12656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12657 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12658
12659 <thead class="entries_header">
12660 <tr>
12661 <th class="th_name">Property Name</th>
12662 <th class="th_type">Type</th>
12663 <th class="th_description">Description</th>
12664 <th class="th_units">Units</th>
12665 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12666 <th class="th_tags">Tags</th>
12667 </tr>
12668 </thead>
12669
12670 <tbody>
12671
12672
12673
12674
12675
12676
12677
12678
12679
12680
12681 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12682 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12683 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12684 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12685 <td class="entry_type">
12686 <span class="entry_type_name entry_type_name_enum">byte</span>
12687
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12688 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12689
12690 <ul class="entry_type_enum">
12691 <li>
12692 <span class="entry_type_enum_name">OFF</span>
12693 </li>
12694 <li>
12695 <span class="entry_type_enum_name">ON</span>
12696 </li>
12697 </ul>
12698
12699 </td> <!-- entry_type -->
12700
12701 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12702 <p>Whether black-level compensation is locked
12703to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12704 </td>
12705
12706 <td class="entry_units">
12707 </td>
12708
12709 <td class="entry_range">
12710 </td>
12711
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12712 <td class="entry_tags">
12713 <ul class="entry_tags">
12714 <li><a href="#tag_HAL2">HAL2</a></li>
12715 </ul>
12716 </td>
12717
12718 </tr>
12719 <tr class="entries_header">
12720 <th class="th_details" colspan="5">Details</th>
12721 </tr>
12722 <tr class="entry_cont">
12723 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12724 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12725compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12726OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12727<p>Since changes to certain capture parameters (such as
12728exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12729compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12730the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12731metadata.<wbr/></p>
12732<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12733<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12734<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12735<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12736<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12737<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12738<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12739<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12740</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12741<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12742device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12743result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12744<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12745<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12746<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12747<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12748<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
12749<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12750<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12751</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12752<p>This indicates to the application that on frame 4,<wbr/> black
12753levels were reset due to exposure value changes,<wbr/> and pixel
12754values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12755<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12756possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12757other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12758or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12759 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12760 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12761
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12762 <tr class="entries_header">
12763 <th class="th_details" colspan="5">HAL Implementation Details</th>
12764 </tr>
12765 <tr class="entry_cont">
12766 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12767 <p>If for some reason black level locking is no longer possible
12768(for example,<wbr/> the analog gain has changed,<wbr/> which forces
12769black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12770override this request (and it must report 'OFF' when this
12771does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12772possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12773 </td>
12774 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12775
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12776 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12777 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12778
12779
12780
12781 <!-- end of kind -->
12782 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12783 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12784
12785 <thead class="entries_header">
12786 <tr>
12787 <th class="th_name">Property Name</th>
12788 <th class="th_type">Type</th>
12789 <th class="th_description">Description</th>
12790 <th class="th_units">Units</th>
12791 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12792 <th class="th_tags">Tags</th>
12793 </tr>
12794 </thead>
12795
12796 <tbody>
12797
12798
12799
12800
12801
12802
12803
12804
12805
12806
12807 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12808 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12809 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12810 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12811 <td class="entry_type">
12812 <span class="entry_type_name entry_type_name_enum">byte</span>
12813
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12814 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12815
12816 <ul class="entry_type_enum">
12817 <li>
12818 <span class="entry_type_enum_name">OFF</span>
12819 </li>
12820 <li>
12821 <span class="entry_type_enum_name">ON</span>
12822 </li>
12823 </ul>
12824
12825 </td> <!-- entry_type -->
12826
12827 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12828 <p>Whether black-level compensation is locked
12829to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12830 </td>
12831
12832 <td class="entry_units">
12833 </td>
12834
12835 <td class="entry_range">
12836 </td>
12837
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12838 <td class="entry_tags">
12839 <ul class="entry_tags">
12840 <li><a href="#tag_HAL2">HAL2</a></li>
12841 </ul>
12842 </td>
12843
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12844 </tr>
12845 <tr class="entries_header">
12846 <th class="th_details" colspan="5">Details</th>
12847 </tr>
12848 <tr class="entry_cont">
12849 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12850 <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^]12851ON 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]12852a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12853perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12854 </td>
12855 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12856
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12857 <tr class="entries_header">
12858 <th class="th_details" colspan="5">HAL Implementation Details</th>
12859 </tr>
12860 <tr class="entry_cont">
12861 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12862 <p>If for some reason black level locking is no longer possible
12863(for example,<wbr/> the analog gain has changed,<wbr/> which forces
12864black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12865override this request (and it must report 'OFF' when this
12866does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12867possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12868 </td>
12869 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12870
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12871 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12872 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12873
12874
12875
12876 <!-- end of kind -->
12877 </tbody>
12878
12879 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12880<!-- </namespace> -->
12881 </table>
12882
12883 <div class="tags" id="tag_index">
12884 <h2>Tags</h2>
12885 <ul>
12886 <li id="tag_AWB">AWB -
12887 Needed for auto white balance
12888
12889 <ul class="tags_entries">
12890 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
12891 </ul>
12892 </li> <!-- tag_AWB -->
12893 <li id="tag_BC">BC -
12894 Needed for backwards compatibility with old Java API
12895
12896 <ul class="tags_entries">
12897 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
12898 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
12899 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
12900 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
12901 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]12902 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12903 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
12904 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]12905 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12906 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
12907 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
12908 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
12909 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
12910 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
12911 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
12912 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
12913 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
12914 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
12915 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
12916 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
12917 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
12918 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
12919 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
12920 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
12921 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
12922 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
12923 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
12924 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
12925 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
12926 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
12927 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
12928 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
12929 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
12930 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
12931 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
12932 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
12933 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
12934 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
12935 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
12936 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
12937 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
12938 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
12939 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
12940 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
12941 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]12942 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12943 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
12944 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
12945 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12946 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12947 <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]12948 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
12949 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
12950 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
12951 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
12952 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
12953 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
12954 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
12955 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
12956 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
12957 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
12958 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
12959 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
12960 </ul>
12961 </li> <!-- tag_BC -->
12962 <li id="tag_V1">V1 -
12963 New features for first camera 2 release (API1)
12964
12965 <ul class="tags_entries">
12966 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
12967 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
12968 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
12969 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
12970 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
12971 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
12972 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
12973 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
12974 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
12975 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
12976 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
12977 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
12978 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
12979 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
12980 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
12981 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
12982 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
12983 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
12984 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
12985 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
12986 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
12987 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
12988 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
12989 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12990 <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]12991 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
12992 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
12993 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
12994 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
12995 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
12996 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
12997 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
12998 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
12999 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13000 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13001 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13002 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13003 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13004 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13005 </ul>
13006 </li> <!-- tag_V1 -->
13007 <li id="tag_ADV">ADV - None
13008 <ul class="tags_entries">
13009 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13010 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13011 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13012 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13013 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13014 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13015 </ul>
13016 </li> <!-- tag_ADV -->
13017 <li id="tag_DNG">DNG -
13018 Needed for DNG file support
13019
13020 <ul class="tags_entries">
13021 <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]13022 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13023 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13024 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13025 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13026 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13027 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13028 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13029 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13030 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13031 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13032 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13033 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13034 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13035 </ul>
13036 </li> <!-- tag_DNG -->
13037 <li id="tag_EXIF">EXIF - None
13038 <ul class="tags_entries">
13039 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13040 </ul>
13041 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13042 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13043 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13044
13045 <ul class="tags_entries">
13046 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13047 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13048 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13049 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13050 </ul>
13051 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13052 <li id="tag_FULL">FULL -
13053 Entry is required for full hardware level devices, and optional for other hardware levels
13054
13055 <ul class="tags_entries">
13056 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13057 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13058 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13059 </ul>
13060 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13061 </ul>
13062 </div>
13063
13064 [ <a href="#">top</a> ]
13065
13066</body>
13067</html>