Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / 0b080452cca90f215d10d636abfb47701d7518da / . / camera / docs / docs.html
blob: e61f5d42c727cbae9f9cb573c91458cb9ef72444 [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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]753 <p>When android.<wbr/>control.<wbr/>awb<wbr/>Mode is not OFF,<wbr/> TRANSFORM_<wbr/>MATRIX
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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]789 Output values are expected to be in the range
790 (0,<wbr/>1)
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
803android.<wbr/>color<wbr/>Correction.<wbr/>mode 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
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]805android.<wbr/>color<wbr/>Correction.<wbr/>mode is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
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
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]862android.<wbr/>color<wbr/>Correction.<wbr/>mode 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
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]864android.<wbr/>color<wbr/>Correction.<wbr/>mode 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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]928 Output values are expected to be in the range
929 (0,<wbr/>1)
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
942android.<wbr/>color<wbr/>Correction.<wbr/>mode 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
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]944android.<wbr/>color<wbr/>Correction.<wbr/>mode is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
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
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1001android.<wbr/>color<wbr/>Correction.<wbr/>mode 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
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1003android.<wbr/>color<wbr/>Correction.<wbr/>mode 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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1081
1082 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1083 </td>
1084
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1085 <td class="entry_tags">
1086 </td>
1087
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1088 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1089
1090
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1091 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1092 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1093
1094
1095 <tr class="entry" id="controls_android.control.aeExposureCompensation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1096 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1097 android.<wbr/>control.<wbr/>ae<wbr/>Exposure<wbr/>Compensation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1098 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1099 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1100 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1101
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1102 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1103
1104
1105 </td> <!-- entry_type -->
1106
1107 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1108 <p>Adjustment to AE target image
1109brightness</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1110 </td>
1111
1112 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1113 count of positive/<wbr/>negative EV steps
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1114 </td>
1115
1116 <td class="entry_range">
1117 </td>
1118
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1119 <td class="entry_tags">
1120 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1121 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1122 </ul>
1123 </td>
1124
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1125 </tr>
1126 <tr class="entries_header">
1127 <th class="th_details" colspan="5">Details</th>
1128 </tr>
1129 <tr class="entry_cont">
1130 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1131 <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]1132exposure compensation of +2 EV; -3 will mean an exposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1133compensation of -1</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1134 </td>
1135 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1136
1137
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1138 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1139 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1140
1141
1142 <tr class="entry" id="controls_android.control.aeLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1143 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1144 android.<wbr/>control.<wbr/>ae<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1145 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1146 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1147 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1148
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1149 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1150
1151 <ul class="entry_type_enum">
1152 <li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1153 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1154 <span class="entry_type_enum_notes">Autoexposure lock is disabled; the AE algorithm
1155 is free to update its parameters.<wbr/></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1156 </li>
1157 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1158 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1159 <span class="entry_type_enum_notes">Autoexposure lock is enabled; the AE algorithm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1160 must not update the exposure and sensitivity parameters
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1161 while the lock is active</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1162 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1163 </ul>
1164
1165 </td> <!-- entry_type -->
1166
1167 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1168 <p>Whether AE is currently locked to its latest
1169calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1170 </td>
1171
1172 <td class="entry_units">
1173 </td>
1174
1175 <td class="entry_range">
1176 </td>
1177
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1178 <td class="entry_tags">
1179 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1180 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1181 </ul>
1182 </td>
1183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1184 </tr>
1185 <tr class="entries_header">
1186 <th class="th_details" colspan="5">Details</th>
1187 </tr>
1188 <tr class="entry_cont">
1189 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1190 <p>Note that even when AE is locked,<wbr/> the flash may be
1191fired if the AE mode is ON_<wbr/>AUTO_<wbr/>FLASH /<wbr/> ON_<wbr/>ALWAYS_<wbr/>FLASH /<wbr/>
1192ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1193 </td>
1194 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1195
1196
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1197 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1198 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1199
1200
1201 <tr class="entry" id="controls_android.control.aeMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1202 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1203 android.<wbr/>control.<wbr/>ae<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1204 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1205 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1206 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1207
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1208 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1209
1210 <ul class="entry_type_enum">
1211 <li>
1212 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1213 <span class="entry_type_enum_notes">Autoexposure is disabled; sensor.<wbr/>exposureTime,<wbr/>
1214 sensor.<wbr/>sensitivity and sensor.<wbr/>frameDuration are used</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1215 </li>
1216 <li>
1217 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1218 <span class="entry_type_enum_notes">Autoexposure is active,<wbr/> no flash
1219 control</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1220 </li>
1221 <li>
1222 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1223 <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]1224 flash control; flash may be fired when precapture
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1225 trigger is activated,<wbr/> and for captures for which
1226 captureIntent = STILL_<wbr/>CAPTURE</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1227 </li>
1228 <li>
1229 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1230 <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]1231 flash control for precapture trigger and always flash
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1232 when captureIntent = STILL_<wbr/>CAPTURE</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1233 </li>
1234 <li>
1235 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1236 <span class="entry_type_enum_notes">Optional.<wbr/> Automatic red eye reduction with flash.<wbr/>
1237 If deemed necessary,<wbr/> red eye reduction sequence should
1238 fire when precapture trigger is activated,<wbr/> and final
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1239 flash should fire when captureIntent =
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1240 STILL_<wbr/>CAPTURE</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1241 </li>
1242 </ul>
1243
1244 </td> <!-- entry_type -->
1245
1246 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1247 <p>Whether AE is currently updating the sensor
1248exposure and sensitivity fields</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1249 </td>
1250
1251 <td class="entry_units">
1252 </td>
1253
1254 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1255 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1256 </td>
1257
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1258 <td class="entry_tags">
1259 <ul class="entry_tags">
1260 <li><a href="#tag_BC">BC</a></li>
1261 </ul>
1262 </td>
1263
1264 </tr>
1265 <tr class="entries_header">
1266 <th class="th_details" colspan="5">Details</th>
1267 </tr>
1268 <tr class="entry_cont">
1269 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1270 <p>Only effective if android.<wbr/>control.<wbr/>mode = AUTO.<wbr/></p>
1271<p>If auto-exposure is active,<wbr/> HAL auto-focus routine is enabled,<wbr/>
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1272then HAL auto-exposure routine overrides the control variables
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1273that relate to auto-exposure routine,<wbr/> and these override values
1274are then available in the result metadata for that capture.<wbr/></p>
1275<p>For example,<wbr/> if auto-exposure is enabled in a request,<wbr/> the HAL should
1276overwrite the exposure,<wbr/> gain,<wbr/> and frame duration fields (and potentially
1277the flash fields,<wbr/> depending on AE mode) of the request.<wbr/> The overridden
1278values are then provided back to the user in the corresponding result.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1279 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1280 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1281
1282
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1283 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1284 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1285
1286
1287 <tr class="entry" id="controls_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1288 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1289 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1290 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1291 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1292 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1293 <span class="entry_type_container">x</span>
1294
1295 <span class="entry_type_array">
1296 5 x area_count
1297 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1298 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1299
1300
1301 </td> <!-- entry_type -->
1302
1303 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1304 <p>List of areas to use for
1305metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1306 </td>
1307
1308 <td class="entry_units">
1309 </td>
1310
1311 <td class="entry_range">
1312 </td>
1313
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1314 <td class="entry_tags">
1315 <ul class="entry_tags">
1316 <li><a href="#tag_BC">BC</a></li>
1317 </ul>
1318 </td>
1319
1320 </tr>
1321 <tr class="entries_header">
1322 <th class="th_details" colspan="5">Details</th>
1323 </tr>
1324 <tr class="entry_cont">
1325 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1326 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1327xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1328specified coordinates.<wbr/></p>
1329<p>The coordinate system is based on the active pixel array,<wbr/>
1330with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
1331(android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size.<wbr/>width - 1,<wbr/>
1332android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size.<wbr/>height - 1) being the
1333bottom-right pixel in the active pixel array.<wbr/> The weight
1334should be nonnegative.<wbr/></p>
1335<p>If all regions have 0 weight,<wbr/> then no specific metering area
1336needs to be used by the HAL.<wbr/> If the metering region is
1337outside the current android.<wbr/>scaler.<wbr/>crop<wbr/>Region,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1338should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1339used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1340 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1341 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1342
1343
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1344 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1345 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1346
1347
1348 <tr class="entry" id="controls_android.control.aeTargetFpsRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1349 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1350 android.<wbr/>control.<wbr/>ae<wbr/>Target<wbr/>Fps<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1351 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1352 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1353 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1354 <span class="entry_type_container">x</span>
1355
1356 <span class="entry_type_array">
1357 2
1358 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1359 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1360
1361
1362 </td> <!-- entry_type -->
1363
1364 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1365 <p>Range over which fps can be adjusted to
1366maintain exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1367 </td>
1368
1369 <td class="entry_units">
1370 </td>
1371
1372 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1373 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1374 </td>
1375
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1376 <td class="entry_tags">
1377 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1378 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1379 </ul>
1380 </td>
1381
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1382 </tr>
1383 <tr class="entries_header">
1384 <th class="th_details" colspan="5">Details</th>
1385 </tr>
1386 <tr class="entry_cont">
1387 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1388 <p>Only constrains AE algorithm,<wbr/> not manual control
1389of android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1390 </td>
1391 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1392
1393
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1394 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1395 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1396
1397
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1398 <tr class="entry" id="controls_android.control.aePrecaptureTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1399 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1400 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1401 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1402 <td class="entry_type">
1403 <span class="entry_type_name entry_type_name_enum">byte</span>
1404
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1405 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1406
1407 <ul class="entry_type_enum">
1408 <li>
1409 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1410 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1411 </li>
1412 <li>
1413 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1414 <span class="entry_type_enum_notes">The precapture metering sequence
1415 must be started.<wbr/> The exact effect of the precapture
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1416 trigger depends on the current AE mode and
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1417 state.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1418 </li>
1419 </ul>
1420
1421 </td> <!-- entry_type -->
1422
1423 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1424 <p>Whether the HAL must trigger precapture
1425metering.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1426 </td>
1427
1428 <td class="entry_units">
1429 </td>
1430
1431 <td class="entry_range">
1432 </td>
1433
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1434 <td class="entry_tags">
1435 <ul class="entry_tags">
1436 <li><a href="#tag_BC">BC</a></li>
1437 </ul>
1438 </td>
1439
1440 </tr>
1441 <tr class="entries_header">
1442 <th class="th_details" colspan="5">Details</th>
1443 </tr>
1444 <tr class="entry_cont">
1445 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1446 <p>This entry is normally set to IDLE,<wbr/> or is not
1447included at all in the request settings.<wbr/> When included and
1448set to START,<wbr/> the HAL must trigger the autoexposure
1449precapture metering sequence.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1450<p>The effect of AE precapture trigger depends on the current
1451AE mode and state; see the camera HAL device v3 header for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1452details.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1453 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1454 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1455
1456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1457 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1458 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1459
1460
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1461 <tr class="entry" id="controls_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1462 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1463 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1464 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1465 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1466 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1467
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1468 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1469
1470 <ul class="entry_type_enum">
1471 <li>
1472 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1473 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
1474 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
1475 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1476 </li>
1477 <li>
1478 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1479 <span class="entry_type_enum_notes">
1480 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1481
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1482 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
1483 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
1484 the autofocus trigger action is called.<wbr/> When that trigger
1485 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
1486 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1487
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1488 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
1489 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1490 </li>
1491 <li>
1492 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1493 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
1494 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1495
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1496 When that trigger is activated,<wbr/> AF must transition to
1497 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
1498 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
1499 position to default,<wbr/> and sets the AF state to
1500 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1501 </li>
1502 <li>
1503 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1504 <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]1505 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1506 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1507
1508 The focusing behavior should be suitable for good quality
1509 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1510 movement and no overshoots.<wbr/> When the AF trigger is not
1511 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
1512 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
1513 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1514 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1515 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1516 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1517
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1518 Once cancel is received,<wbr/> the algorithm should transition
1519 back to INACTIVE and resume passive scan.<wbr/> Note that this
1520 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
1521 ongoing PASSIVE_<wbr/>SCAN must immediately be
1522 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1523 </li>
1524 <li>
1525 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1526 <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]1527 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1528 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1529
1530 The focusing behavior should be suitable for still image
1531 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1532 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
1533 algorithm should start in INACTIVE state,<wbr/> and then
1534 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
1535 appropriate as it attempts to maintain focus.<wbr/> When the AF
1536 trigger is activated,<wbr/> the algorithm should finish its
1537 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
1538 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1539 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1540
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1541 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1542 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1543 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1544 </li>
1545 <li>
1546 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1547 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
1548 trigger is ignored,<wbr/> AF state should always be
1549 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1550 </li>
1551 </ul>
1552
1553 </td> <!-- entry_type -->
1554
1555 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1556 <p>Whether AF is currently enabled,<wbr/> and what
1557mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1558 </td>
1559
1560 <td class="entry_units">
1561 </td>
1562
1563 <td class="entry_range">
1564 </td>
1565
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1566 <td class="entry_tags">
1567 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1568 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1569 </ul>
1570 </td>
1571
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1572 </tr>
1573 <tr class="entries_header">
1574 <th class="th_details" colspan="5">Details</th>
1575 </tr>
1576 <tr class="entry_cont">
1577 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1578 <p>Only effective if android.<wbr/>control.<wbr/>mode = AUTO.<wbr/></p>
1579<p>If lens is controlled by HAL auto-focus algorithm,<wbr/> the HAL should
1580report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State in
1581result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1582 </td>
1583 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1584
1585
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1586 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1587 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1588
1589
1590 <tr class="entry" id="controls_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1591 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1592 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1593 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1594 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1595 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1596 <span class="entry_type_container">x</span>
1597
1598 <span class="entry_type_array">
1599 5 x area_count
1600 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1601 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1602
1603
1604 </td> <!-- entry_type -->
1605
1606 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1607 <p>List of areas to use for focus
1608estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1609 </td>
1610
1611 <td class="entry_units">
1612 </td>
1613
1614 <td class="entry_range">
1615 </td>
1616
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1617 <td class="entry_tags">
1618 <ul class="entry_tags">
1619 <li><a href="#tag_BC">BC</a></li>
1620 </ul>
1621 </td>
1622
1623 </tr>
1624 <tr class="entries_header">
1625 <th class="th_details" colspan="5">Details</th>
1626 </tr>
1627 <tr class="entry_cont">
1628 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1629 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1630xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1631specified coordinates.<wbr/></p>
1632<p>The coordinate system is based on the active pixel array,<wbr/>
1633with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
1634(android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size.<wbr/>width - 1,<wbr/>
1635android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size.<wbr/>height - 1) being the
1636bottom-right pixel in the active pixel array.<wbr/> The weight
1637should be nonnegative.<wbr/></p>
1638<p>If all regions have 0 weight,<wbr/> then no specific focus area
1639needs to be used by the HAL.<wbr/> If the focusing region is
1640outside the current android.<wbr/>scaler.<wbr/>crop<wbr/>Region,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1641should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1642used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1643 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1644 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1645
1646
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1647 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1648 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1649
1650
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1651 <tr class="entry" id="controls_android.control.afTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1652 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1653 android.<wbr/>control.<wbr/>af<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1654 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1655 <td class="entry_type">
1656 <span class="entry_type_name entry_type_name_enum">byte</span>
1657
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1658 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1659
1660 <ul class="entry_type_enum">
1661 <li>
1662 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1663 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1664 </li>
1665 <li>
1666 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1667 <span class="entry_type_enum_notes">Autofocus must trigger now.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1668 </li>
1669 <li>
1670 <span class="entry_type_enum_name">CANCEL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1671 <span class="entry_type_enum_notes">Autofocus must return to initial
1672 state,<wbr/> and cancel any active trigger.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1673 </li>
1674 </ul>
1675
1676 </td> <!-- entry_type -->
1677
1678 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1679 <p>Whether the HAL must trigger autofocus.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1680 </td>
1681
1682 <td class="entry_units">
1683 </td>
1684
1685 <td class="entry_range">
1686 </td>
1687
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1688 <td class="entry_tags">
1689 <ul class="entry_tags">
1690 <li><a href="#tag_BC">BC</a></li>
1691 </ul>
1692 </td>
1693
1694 </tr>
1695 <tr class="entries_header">
1696 <th class="th_details" colspan="5">Details</th>
1697 </tr>
1698 <tr class="entry_cont">
1699 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1700 <p>This entry is normally set to IDLE,<wbr/> or is not
1701included at all in the request settings.<wbr/></p>
1702<p>When included and set to START,<wbr/> the HAL must trigger the
1703autofocus algorithm.<wbr/> The effect of AF trigger depends on the
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1704current AF mode and state; see the camera HAL device v3
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1705header for details.<wbr/> When set to CANCEL,<wbr/> the HAL must cancel
1706any active trigger,<wbr/> and return to initial AF state.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1707 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1708 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1709
1710
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1711 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1712 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1713
1714
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1715 <tr class="entry" id="controls_android.control.awbLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1716 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1717 android.<wbr/>control.<wbr/>awb<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1718 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1719 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1720 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1721
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1722 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1723
1724 <ul class="entry_type_enum">
1725 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1726 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1727 <span class="entry_type_enum_notes">Auto-whitebalance lock is disabled; the AWB
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1728 algorithm is free to update its parameters if in AUTO
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1729 mode.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1730 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1731 <li>
1732 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1733 <span class="entry_type_enum_notes">Auto-whitebalance lock is enabled; the AWB
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1734 algorithm must not update the exposure and sensitivity
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1735 parameters while the lock is active</span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1736 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1737 </ul>
1738
1739 </td> <!-- entry_type -->
1740
1741 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1742 <p>Whether AWB is currently locked to its
1743latest calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1744 </td>
1745
1746 <td class="entry_units">
1747 </td>
1748
1749 <td class="entry_range">
1750 </td>
1751
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1752 <td class="entry_tags">
1753 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1754 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1755 </ul>
1756 </td>
1757
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1758 </tr>
1759 <tr class="entries_header">
1760 <th class="th_details" colspan="5">Details</th>
1761 </tr>
1762 <tr class="entry_cont">
1763 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1764 <p>Note that AWB lock is only meaningful for AUTO
1765mode; in other modes,<wbr/> AWB is already fixed to a specific
1766setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1767 </td>
1768 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1769
1770
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1771 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1772 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1773
1774
1775 <tr class="entry" id="controls_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1776 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1777 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1778 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1779 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1780 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1781
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1782 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1783
1784 <ul class="entry_type_enum">
1785 <li>
1786 <span class="entry_type_enum_name">OFF</span>
1787 </li>
1788 <li>
1789 <span class="entry_type_enum_name">AUTO</span>
1790 </li>
1791 <li>
1792 <span class="entry_type_enum_name">INCANDESCENT</span>
1793 </li>
1794 <li>
1795 <span class="entry_type_enum_name">FLUORESCENT</span>
1796 </li>
1797 <li>
1798 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
1799 </li>
1800 <li>
1801 <span class="entry_type_enum_name">DAYLIGHT</span>
1802 </li>
1803 <li>
1804 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
1805 </li>
1806 <li>
1807 <span class="entry_type_enum_name">TWILIGHT</span>
1808 </li>
1809 <li>
1810 <span class="entry_type_enum_name">SHADE</span>
1811 </li>
1812 </ul>
1813
1814 </td> <!-- entry_type -->
1815
1816 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1817 <p>Whether AWB is currently setting the color
1818transform fields,<wbr/> and what its illumination target
1819is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1820 </td>
1821
1822 <td class="entry_units">
1823 </td>
1824
1825 <td class="entry_range">
1826 </td>
1827
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1828 <td class="entry_tags">
1829 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1830 <li><a href="#tag_BC">BC</a></li>
1831 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1832 </ul>
1833 </td>
1834
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1835 </tr>
1836 <tr class="entries_header">
1837 <th class="th_details" colspan="5">Details</th>
1838 </tr>
1839 <tr class="entry_cont">
1840 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1841 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
1842<p>Only effective if android.<wbr/>control.<wbr/>mode = AUTO.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1843 </td>
1844 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1845
1846
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1847 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1848 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1849
1850
1851 <tr class="entry" id="controls_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1852 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1853 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1854 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1855 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1856 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1857 <span class="entry_type_container">x</span>
1858
1859 <span class="entry_type_array">
1860 5 x area_count
1861 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1862 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1863
1864
1865 </td> <!-- entry_type -->
1866
1867 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1868 <p>List of areas to use for illuminant
1869estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1870 </td>
1871
1872 <td class="entry_units">
1873 </td>
1874
1875 <td class="entry_range">
1876 </td>
1877
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1878 <td class="entry_tags">
1879 <ul class="entry_tags">
1880 <li><a href="#tag_BC">BC</a></li>
1881 </ul>
1882 </td>
1883
1884 </tr>
1885 <tr class="entries_header">
1886 <th class="th_details" colspan="5">Details</th>
1887 </tr>
1888 <tr class="entry_cont">
1889 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1890 <p>Only used in AUTO mode.<wbr/></p>
1891<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1892xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1893specified coordinates.<wbr/></p>
1894<p>The coordinate system is based on the active pixel array,<wbr/>
1895with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
1896(android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size.<wbr/>width - 1,<wbr/>
1897android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size.<wbr/>height - 1) being the
1898bottom-right pixel in the active pixel array.<wbr/> The weight
1899should be nonnegative.<wbr/></p>
1900<p>If all regions have 0 weight,<wbr/> then no specific metering area
1901needs to be used by the HAL.<wbr/> If the metering region is
1902outside the current android.<wbr/>scaler.<wbr/>crop<wbr/>Region,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1903should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1904used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1905 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1906 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1907
1908
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1909 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1910 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1911
1912
1913 <tr class="entry" id="controls_android.control.captureIntent">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1914 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1915 android.<wbr/>control.<wbr/>capture<wbr/>Intent
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1916 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1917 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1918 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1919
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1920 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1921
1922 <ul class="entry_type_enum">
1923 <li>
1924 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1925 <span class="entry_type_enum_notes">This request doesn't fall into the other
1926 categories.<wbr/> Default to preview-like
1927 behavior.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1928 </li>
1929 <li>
1930 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1931 <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]1932 precapture trigger may be used to start off a metering
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1933 w/<wbr/>flash sequence</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1934 </li>
1935 <li>
1936 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1937 <span class="entry_type_enum_notes">This request is for a still capture-type
1938 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1939 </li>
1940 <li>
1941 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1942 <span class="entry_type_enum_notes">This request is for a video recording
1943 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1944 </li>
1945 <li>
1946 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1947 <span class="entry_type_enum_notes">This request is for a video snapshot (still
1948 image while recording video) usecase</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1949 </li>
1950 <li>
1951 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1952 <span class="entry_type_enum_notes">This request is for a ZSL usecase; the
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1953 application will stream full-resolution images and
1954 reprocess one or several later for a final
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1955 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1956 </li>
1957 </ul>
1958
1959 </td> <!-- entry_type -->
1960
1961 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1962 <p>Information to 3A routines about the purpose
1963of this capture,<wbr/> to help decide optimal 3A
1964strategy</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1965 </td>
1966
1967 <td class="entry_units">
1968 </td>
1969
1970 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1971 all must be supported
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1972 </td>
1973
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1974 <td class="entry_tags">
1975 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1976 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1977 </ul>
1978 </td>
1979
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1980 </tr>
1981 <tr class="entries_header">
1982 <th class="th_details" colspan="5">Details</th>
1983 </tr>
1984 <tr class="entry_cont">
1985 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1986 <p>Only used if android.<wbr/>control.<wbr/>mode != OFF.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1987 </td>
1988 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1989
1990
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1991 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1992 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1993
1994
1995 <tr class="entry" id="controls_android.control.effectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1996 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]1997 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1998 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1999 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2000 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2001
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2002 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2003
2004 <ul class="entry_type_enum">
2005 <li>
2006 <span class="entry_type_enum_name">OFF</span>
2007 </li>
2008 <li>
2009 <span class="entry_type_enum_name">MONO</span>
2010 <span class="entry_type_enum_optional">optional</span>
2011 </li>
2012 <li>
2013 <span class="entry_type_enum_name">NEGATIVE</span>
2014 <span class="entry_type_enum_optional">optional</span>
2015 </li>
2016 <li>
2017 <span class="entry_type_enum_name">SOLARIZE</span>
2018 <span class="entry_type_enum_optional">optional</span>
2019 </li>
2020 <li>
2021 <span class="entry_type_enum_name">SEPIA</span>
2022 <span class="entry_type_enum_optional">optional</span>
2023 </li>
2024 <li>
2025 <span class="entry_type_enum_name">POSTERIZE</span>
2026 <span class="entry_type_enum_optional">optional</span>
2027 </li>
2028 <li>
2029 <span class="entry_type_enum_name">WHITEBOARD</span>
2030 <span class="entry_type_enum_optional">optional</span>
2031 </li>
2032 <li>
2033 <span class="entry_type_enum_name">BLACKBOARD</span>
2034 <span class="entry_type_enum_optional">optional</span>
2035 </li>
2036 <li>
2037 <span class="entry_type_enum_name">AQUA</span>
2038 <span class="entry_type_enum_optional">optional</span>
2039 </li>
2040 </ul>
2041
2042 </td> <!-- entry_type -->
2043
2044 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2045 <p>Whether any special color effect is in use.<wbr/>
2046Only used if android.<wbr/>control.<wbr/>mode != OFF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2047 </td>
2048
2049 <td class="entry_units">
2050 </td>
2051
2052 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2053 android.<wbr/>control.<wbr/>available<wbr/>Effects
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2054 </td>
2055
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2056 <td class="entry_tags">
2057 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2058 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2059 </ul>
2060 </td>
2061
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2062 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2063
2064
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2065 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2066 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2067
2068
2069 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2070 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2071 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2072 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2073 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2074 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2075
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2076 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2077
2078 <ul class="entry_type_enum">
2079 <li>
2080 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2081 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
2082 routines are disabled,<wbr/> no other settings in
2083 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2084 </li>
2085 <li>
2086 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2087 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
2088 Manual control of capture parameters is disabled.<wbr/> All
2089 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2090 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2091 </li>
2092 <li>
2093 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2094 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
2095 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2096 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2097 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2098 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2099 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2100 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2101 </li>
2102 </ul>
2103
2104 </td> <!-- entry_type -->
2105
2106 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2107 <p>Overall mode of 3A control
2108routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2109 </td>
2110
2111 <td class="entry_units">
2112 </td>
2113
2114 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2115 all must be supported
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2116 </td>
2117
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2118 <td class="entry_tags">
2119 <ul class="entry_tags">
2120 <li><a href="#tag_BC">BC</a></li>
2121 </ul>
2122 </td>
2123
2124 </tr>
2125 <tr class="entries_header">
2126 <th class="th_details" colspan="5">Details</th>
2127 </tr>
2128 <tr class="entry_cont">
2129 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2130 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
2131by the HAL is disabled.<wbr/> The application must set the fields for
2132capture parameters itself.<wbr/></p>
2133<p>When set to AUTO,<wbr/> the individual algorithm controls in
2134android.<wbr/>control.<wbr/>* are in effect,<wbr/> such as android.<wbr/>control.<wbr/>af<wbr/>Mode.<wbr/></p>
2135<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
2136android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
2137one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
2138as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
2139android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2140 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2141 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2142
2143
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2144 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2145 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2146
2147
2148 <tr class="entry" id="controls_android.control.sceneMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2149 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2150 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2151 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2152 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2153 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2154
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2155 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2156
2157 <ul class="entry_type_enum">
2158 <li>
2159 <span class="entry_type_enum_name">UNSUPPORTED</span>
2160 <span class="entry_type_enum_value">0</span>
2161 </li>
2162 <li>
2163 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2164 <span class="entry_type_enum_notes">if face detection support exists Use face
2165 detection data to drive 3A routines.<wbr/> If face detection
2166 statistics are disabled,<wbr/> should still operate correctly
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2167 (but not return face detection statistics to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2168 framework).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2169
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2170 Unlike the other scene modes,<wbr/> aeMode,<wbr/> awbMode,<wbr/> and afMode
2171 remain active when FACE_<wbr/>PRIORITY is set.<wbr/> This is due to
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2172 compatibility concerns with the old camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2173 API</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2174 </li>
2175 <li>
2176 <span class="entry_type_enum_name">ACTION</span>
2177 <span class="entry_type_enum_optional">optional</span>
2178 </li>
2179 <li>
2180 <span class="entry_type_enum_name">PORTRAIT</span>
2181 <span class="entry_type_enum_optional">optional</span>
2182 </li>
2183 <li>
2184 <span class="entry_type_enum_name">LANDSCAPE</span>
2185 <span class="entry_type_enum_optional">optional</span>
2186 </li>
2187 <li>
2188 <span class="entry_type_enum_name">NIGHT</span>
2189 <span class="entry_type_enum_optional">optional</span>
2190 </li>
2191 <li>
2192 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2193 <span class="entry_type_enum_optional">optional</span>
2194 </li>
2195 <li>
2196 <span class="entry_type_enum_name">THEATRE</span>
2197 <span class="entry_type_enum_optional">optional</span>
2198 </li>
2199 <li>
2200 <span class="entry_type_enum_name">BEACH</span>
2201 <span class="entry_type_enum_optional">optional</span>
2202 </li>
2203 <li>
2204 <span class="entry_type_enum_name">SNOW</span>
2205 <span class="entry_type_enum_optional">optional</span>
2206 </li>
2207 <li>
2208 <span class="entry_type_enum_name">SUNSET</span>
2209 <span class="entry_type_enum_optional">optional</span>
2210 </li>
2211 <li>
2212 <span class="entry_type_enum_name">STEADYPHOTO</span>
2213 <span class="entry_type_enum_optional">optional</span>
2214 </li>
2215 <li>
2216 <span class="entry_type_enum_name">FIREWORKS</span>
2217 <span class="entry_type_enum_optional">optional</span>
2218 </li>
2219 <li>
2220 <span class="entry_type_enum_name">SPORTS</span>
2221 <span class="entry_type_enum_optional">optional</span>
2222 </li>
2223 <li>
2224 <span class="entry_type_enum_name">PARTY</span>
2225 <span class="entry_type_enum_optional">optional</span>
2226 </li>
2227 <li>
2228 <span class="entry_type_enum_name">CANDLELIGHT</span>
2229 <span class="entry_type_enum_optional">optional</span>
2230 </li>
2231 <li>
2232 <span class="entry_type_enum_name">BARCODE</span>
2233 <span class="entry_type_enum_optional">optional</span>
2234 </li>
2235 </ul>
2236
2237 </td> <!-- entry_type -->
2238
2239 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2240 <p>Which scene mode is active when
2241android.<wbr/>control.<wbr/>mode = SCENE_<wbr/>MODE</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2242 </td>
2243
2244 <td class="entry_units">
2245 </td>
2246
2247 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2248 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2249 </td>
2250
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2251 <td class="entry_tags">
2252 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2253 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2254 </ul>
2255 </td>
2256
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2257 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2258
2259
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2260 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2261 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2262
2263
2264 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2265 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2266 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2267 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2268 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2269 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2270
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2271 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2272
2273 <ul class="entry_type_enum">
2274 <li>
2275 <span class="entry_type_enum_name">OFF</span>
2276 </li>
2277 <li>
2278 <span class="entry_type_enum_name">ON</span>
2279 </li>
2280 </ul>
2281
2282 </td> <!-- entry_type -->
2283
2284 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2285 <p>Whether video stabilization is
2286active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2287 </td>
2288
2289 <td class="entry_units">
2290 </td>
2291
2292 <td class="entry_range">
2293 </td>
2294
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2295 <td class="entry_tags">
2296 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2297 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2298 </ul>
2299 </td>
2300
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2301 </tr>
2302 <tr class="entries_header">
2303 <th class="th_details" colspan="5">Details</th>
2304 </tr>
2305 <tr class="entry_cont">
2306 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2307 <p>If enabled,<wbr/> video stabilization can modify the
2308android.<wbr/>scaler.<wbr/>crop<wbr/>Region to keep the video stream
2309stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2310 </td>
2311 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2312
2313
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2314 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2315 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2316
2317
2318
2319 <!-- end of kind -->
2320 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2321 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2322
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2323 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2324 <tr>
2325 <th class="th_name">Property Name</th>
2326 <th class="th_type">Type</th>
2327 <th class="th_description">Description</th>
2328 <th class="th_units">Units</th>
2329 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2330 <th class="th_tags">Tags</th>
2331 </tr>
2332 </thead>
2333
2334 <tbody>
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2346 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2347 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2348 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2349 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2350 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2351 <span class="entry_type_container">x</span>
2352
2353 <span class="entry_type_array">
2354 n
2355 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2356 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2357 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2358
2359
2360 </td> <!-- entry_type -->
2361
2362 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2363 <p>Which set of antibanding modes are
2364supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2365 </td>
2366
2367 <td class="entry_units">
2368 </td>
2369
2370 <td class="entry_range">
2371 </td>
2372
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2373 <td class="entry_tags">
2374 </td>
2375
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2376 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2377
2378
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2379 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2380 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2381
2382
2383 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2384 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2385 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2386 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2387 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2388 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2389 <span class="entry_type_container">x</span>
2390
2391 <span class="entry_type_array">
2392 n
2393 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2394 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2395 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2396
2397
2398 </td> <!-- entry_type -->
2399
2400 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2401 <p>Which subset of AE modes is
2402supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2403 </td>
2404
2405 <td class="entry_units">
2406 </td>
2407
2408 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2409 OFF,<wbr/> ON must be supported.<wbr/>
2410 ON_<wbr/>AUTO_<wbr/>FLASH/<wbr/>ON_<wbr/>ALWAYS_<wbr/>FLASH must be supported if flash
2411 unit is available
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2412 </td>
2413
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2414 <td class="entry_tags">
2415 </td>
2416
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2417 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2418
2419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2420 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2421 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2422
2423
2424 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2425 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2426 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2427 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2428 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2429 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2430 <span class="entry_type_container">x</span>
2431
2432 <span class="entry_type_array">
2433 2 x n
2434 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2435 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2436 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2437
2438
2439 </td> <!-- entry_type -->
2440
2441 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2442 <p>List of frame rate ranges supported by the
2443AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2444 </td>
2445
2446 <td class="entry_units">
2447 </td>
2448
2449 <td class="entry_range">
2450 </td>
2451
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2452 <td class="entry_tags">
2453 </td>
2454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2455 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2456
2457
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2458 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2459 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2460
2461
2462 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2463 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2464 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2465 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2466 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2467 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2468 <span class="entry_type_container">x</span>
2469
2470 <span class="entry_type_array">
2471 2
2472 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2473 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2474
2475
2476 </td> <!-- entry_type -->
2477
2478 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2479 <p>Maximum and minimum exposure compensation
2480setting,<wbr/> in counts of
2481android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2482 </td>
2483
2484 <td class="entry_units">
2485 </td>
2486
2487 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2488 At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2489 size)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2490 </td>
2491
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2492 <td class="entry_tags">
2493 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2494 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2495 </ul>
2496 </td>
2497
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2498 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2499
2500
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2501 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2502 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2503
2504
2505 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2506 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2507 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2508 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2509 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2510 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2511
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2512 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2513
2514
2515 </td> <!-- entry_type -->
2516
2517 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2518 <p>Smallest step by which exposure compensation
2519can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2520 </td>
2521
2522 <td class="entry_units">
2523 </td>
2524
2525 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2526 &lt;= 1/<wbr/>2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2527 </td>
2528
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2529 <td class="entry_tags">
2530 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2531 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2532 </ul>
2533 </td>
2534
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2535 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2536
2537
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2538 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2539 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2540
2541
2542 <tr class="entry" id="static_android.control.afAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2543 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2544 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2545 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2546 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2547 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2548 <span class="entry_type_container">x</span>
2549
2550 <span class="entry_type_array">
2551 n
2552 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2553 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2554 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2555
2556
2557 </td> <!-- entry_type -->
2558
2559 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2560 <p>List of AF modes that can be
2561selected</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2562 </td>
2563
2564 <td class="entry_units">
2565 </td>
2566
2567 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2568 OFF must be included.<wbr/> AUTO must be supported if
2569 lens allows for changing focus
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2570 </td>
2571
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2572 <td class="entry_tags">
2573 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2574 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2575 </ul>
2576 </td>
2577
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2578 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2579
2580
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2581 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2582 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2583
2584
2585 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2586 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2587 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2588 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2589 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2590 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2591 <span class="entry_type_container">x</span>
2592
2593 <span class="entry_type_array">
2594 n
2595 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2596 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2597 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2598
2599
2600 </td> <!-- entry_type -->
2601
2602 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2603 <p>what subset of the full color effect enum
2604list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2605 </td>
2606
2607 <td class="entry_units">
2608 </td>
2609
2610 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2611 OFF must be listed
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2612 </td>
2613
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2614 <td class="entry_tags">
2615 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2616 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2617 </ul>
2618 </td>
2619
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2620 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2621
2622
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2623 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2624 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2625
2626
2627 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2628 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2629 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2630 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2631 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2632 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2633 <span class="entry_type_container">x</span>
2634
2635 <span class="entry_type_array">
2636 n
2637 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2638 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2639 <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]2640
2641
2642 </td> <!-- entry_type -->
2643
2644 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2645 <p>what subset of the scene mode enum list is
2646supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2647 </td>
2648
2649 <td class="entry_units">
2650 </td>
2651
2652 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2653 SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2654 detection is supported
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2655 </td>
2656
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2657 <td class="entry_tags">
2658 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2659 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2660 </ul>
2661 </td>
2662
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2663 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2664
2665
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2666 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2667 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2668
2669
2670 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2671 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2672 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2673 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2674 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2675 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2676 <span class="entry_type_container">x</span>
2677
2678 <span class="entry_type_array">
2679 n
2680 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2681 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2682 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2683
2684
2685 </td> <!-- entry_type -->
2686
2687 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2688 <p>List of video stabilization modes that can
2689be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2690 </td>
2691
2692 <td class="entry_units">
2693 </td>
2694
2695 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2696 OFF must be included
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2697 </td>
2698
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2699 <td class="entry_tags">
2700 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2701 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2702 </ul>
2703 </td>
2704
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2705 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2706
2707
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2708 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2709 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2710
2711
2712 <tr class="entry" id="static_android.control.awbAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2713 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2714 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2715 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2716 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2717 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2718 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2719
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2720 <span class="entry_type_array">
2721 n
2722 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2723 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2724 <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]2725
2726
2727 </td> <!-- entry_type -->
2728
2729 <td class="entry_description">
2730 </td>
2731
2732 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2733 </td>
2734
2735 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2736 OFF,<wbr/> AUTO must be included
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2737 </td>
2738
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2739 <td class="entry_tags">
2740 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2741 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2742 </ul>
2743 </td>
2744
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2745 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2746
2747
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2748 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2749 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2750
2751
2752 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2753 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2754 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2755 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2756 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2757 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2758
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2759 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2760
2761
2762 </td> <!-- entry_type -->
2763
2764 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2765 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
2766regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2767 </td>
2768
2769 <td class="entry_units">
2770 </td>
2771
2772 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2773 &gt;= 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2774 </td>
2775
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2776 <td class="entry_tags">
2777 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2778 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2779 </ul>
2780 </td>
2781
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2782 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2783
2784
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2785 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2786 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2787
2788
2789 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2790 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2791 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2792 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2793 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2794 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2795 <span class="entry_type_container">x</span>
2796
2797 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2798 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2799 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2800 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2801
2802
2803 </td> <!-- entry_type -->
2804
2805 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2806 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
2807each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2808 </td>
2809
2810 <td class="entry_units">
2811 </td>
2812
2813 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2814 For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
2815 awbMode,<wbr/> and afMode that the HAL wants to use for that
2816 scene mode.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2817
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]2818 For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
2819 order of increasing index
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
2843used instead,<wbr/> like they are when android.<wbr/>control.<wbr/>mode is
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
2974(android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size.<wbr/>width - 1,<wbr/>
2975android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size.<wbr/>height - 1) being the
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
2980outside the current android.<wbr/>scaler.<wbr/>crop<wbr/>Region,<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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]3187 <p>Only effective if android.<wbr/>control.<wbr/>mode = AUTO.<wbr/></p>
3188<p>If lens is controlled by HAL auto-focus algorithm,<wbr/> the HAL should
3189report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State in
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
3243(android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size.<wbr/>width - 1,<wbr/>
3244android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size.<wbr/>height - 1) being the
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
3249outside the current android.<wbr/>scaler.<wbr/>crop<wbr/>Region,<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>
3456<p>Only effective if android.<wbr/>control.<wbr/>mode = 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
3510(android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size.<wbr/>width - 1,<wbr/>
3511android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size.<wbr/>height - 1) being the
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
3516outside the current android.<wbr/>scaler.<wbr/>crop<wbr/>Region,<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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]3637 all must be supported
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
3656android.<wbr/>control.<wbr/>* are in effect,<wbr/> such as android.<wbr/>control.<wbr/>af<wbr/>Mode.<wbr/></p>
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
3661android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides.<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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4022 0 - 10
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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4070 0-(exposure time-flash duration)
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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4246 0-1e9
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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4296 0-1 for both
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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4334 &gt;= 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4335 </td>
4336
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4337 <td class="entry_tags">
4338 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4339 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4340 </ul>
4341 </td>
4342
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4343 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4344
4345
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4346 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4347 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4348
4349
4350
4351 <!-- end of kind -->
4352 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4353 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4354
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4355 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4356 <tr>
4357 <th class="th_name">Property Name</th>
4358 <th class="th_type">Type</th>
4359 <th class="th_description">Description</th>
4360 <th class="th_units">Units</th>
4361 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4362 <th class="th_tags">Tags</th>
4363 </tr>
4364 </thead>
4365
4366 <tbody>
4367
4368
4369
4370
4371
4372
4373
4374
4375
4376
4377 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4378 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4379 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4380 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4381 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4382 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4383
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4384 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4385
4386
4387 </td> <!-- entry_type -->
4388
4389 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4390 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4391 </td>
4392
4393 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4394 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4395 </td>
4396
4397 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4398 0 - 10
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4399 </td>
4400
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4401 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4402 <ul class="entry_tags">
4403 <li><a href="#tag_V1">V1</a></li>
4404 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4405 </td>
4406
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4407 </tr>
4408 <tr class="entries_header">
4409 <th class="th_details" colspan="5">Details</th>
4410 </tr>
4411 <tr class="entry_cont">
4412 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4413 <p>Power for snapshot may use a different scale than
4414for torch mode.<wbr/> Only one entry for torch mode will be
4415used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4416 </td>
4417 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4418
4419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4420 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4421 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4422
4423
4424 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4425 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4426 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4427 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4428 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4429 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4430
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4431 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4432
4433
4434 </td> <!-- entry_type -->
4435
4436 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4437 <p>Firing time of flash relative to start of
4438exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4439 </td>
4440
4441 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4442 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4443 </td>
4444
4445 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4446 0-(exposure time-flash duration)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4447 </td>
4448
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4449 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4450 <ul class="entry_tags">
4451 <li><a href="#tag_V1">V1</a></li>
4452 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4453 </td>
4454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4455 </tr>
4456 <tr class="entries_header">
4457 <th class="th_details" colspan="5">Details</th>
4458 </tr>
4459 <tr class="entry_cont">
4460 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4461 <p>Clamped to (0,<wbr/> exposure time - flash
4462duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4463 </td>
4464 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4465
4466
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4467 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4468 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4469
4470
4471 <tr class="entry" id="dynamic_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4472 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4473 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4474 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4475 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4476 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4477
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4478 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4479
4480 <ul class="entry_type_enum">
4481 <li>
4482 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4483 <span class="entry_type_enum_notes">Do not fire the flash for this
4484 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4485 </li>
4486 <li>
4487 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4488 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4489 for this capture based on firingPower,<wbr/>
4490 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4491 </li>
4492 <li>
4493 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4494 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4495 continuously on,<wbr/> power set by
4496 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4497 </li>
4498 </ul>
4499
4500 </td> <!-- entry_type -->
4501
4502 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4503 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4504 </td>
4505
4506 <td class="entry_units">
4507 </td>
4508
4509 <td class="entry_range">
4510 </td>
4511
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4512 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4513 <ul class="entry_tags">
4514 <li><a href="#tag_BC">BC</a></li>
4515 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4516 </td>
4517
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4518 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4519
4520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4521 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4522 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4523
4524
4525 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4526 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4527 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4528 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4529 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4530 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4531
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4532 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4533
4534 <ul class="entry_type_enum">
4535 <li>
4536 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4537 <span class="entry_type_enum_notes">No flash on camera</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4538 </li>
4539 <li>
4540 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4541 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4542 charging and cannot be fired</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4543 </li>
4544 <li>
4545 <span class="entry_type_enum_name">READY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4546 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4547 ready to fire</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4548 </li>
4549 <li>
4550 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4551 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash fired
4552 for this capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4553 </li>
4554 </ul>
4555
4556 </td> <!-- entry_type -->
4557
4558 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4559 <p>Current state of the flash
4560unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4561 </td>
4562
4563 <td class="entry_units">
4564 </td>
4565
4566 <td class="entry_range">
4567 </td>
4568
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4569 <td class="entry_tags">
4570 </td>
4571
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4572 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4573
4574
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4575 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4576 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4577
4578
4579
4580 <!-- end of kind -->
4581 </tbody>
4582
4583 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4584 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4585
4586
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4587 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4588
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4589 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4590 <tr>
4591 <th class="th_name">Property Name</th>
4592 <th class="th_type">Type</th>
4593 <th class="th_description">Description</th>
4594 <th class="th_units">Units</th>
4595 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4596 <th class="th_tags">Tags</th>
4597 </tr>
4598 </thead>
4599
4600 <tbody>
4601
4602
4603
4604
4605
4606
4607
4608
4609
4610
4611 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4612 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4613 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4614 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4615 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4616 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4617
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4618 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4619
4620 <ul class="entry_type_enum">
4621 <li>
4622 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4623 <span class="entry_type_enum_notes">No geometric correction is
4624 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4625 </li>
4626 <li>
4627 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4628 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
4629 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4630 </li>
4631 <li>
4632 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4633 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4634 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4635 </li>
4636 </ul>
4637
4638 </td> <!-- entry_type -->
4639
4640 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4641 <p>Operating mode of geometric
4642correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4643 </td>
4644
4645 <td class="entry_units">
4646 </td>
4647
4648 <td class="entry_range">
4649 </td>
4650
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4651 <td class="entry_tags">
4652 </td>
4653
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4654 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4655
4656
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4657 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4658 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4659
4660
4661 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4662 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4663 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4664 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4665 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4666 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4667
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4668 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4669
4670
4671 </td> <!-- entry_type -->
4672
4673 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4674 <p>Control the amount of shading correction
4675applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4676 </td>
4677
4678 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4679 unitless: 1-10; 10 is full shading
4680 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4681 </td>
4682
4683 <td class="entry_range">
4684 </td>
4685
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4686 <td class="entry_tags">
4687 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4688 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4689 </ul>
4690 </td>
4691
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4692 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4693
4694
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4695 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4696 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4697
4698
4699
4700 <!-- end of kind -->
4701 </tbody>
4702
4703 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4704 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4705
4706
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4707 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4708
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4709 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4710 <tr>
4711 <th class="th_name">Property Name</th>
4712 <th class="th_type">Type</th>
4713 <th class="th_description">Description</th>
4714 <th class="th_units">Units</th>
4715 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4716 <th class="th_tags">Tags</th>
4717 </tr>
4718 </thead>
4719
4720 <tbody>
4721
4722
4723
4724
4725
4726
4727
4728
4729
4730
4731 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4732 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4733 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4734 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4735 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4736 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4737
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4738 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4739
4740 <ul class="entry_type_enum">
4741 <li>
4742 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4743 <span class="entry_type_enum_notes">No hot pixel correction can be
4744 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4745 </li>
4746 <li>
4747 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4748 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
4749 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4750 </li>
4751 <li>
4752 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4753 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4754 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4755 </li>
4756 </ul>
4757
4758 </td> <!-- entry_type -->
4759
4760 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4761 <p>Set operational mode for hot pixel
4762correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4763 </td>
4764
4765 <td class="entry_units">
4766 </td>
4767
4768 <td class="entry_range">
4769 </td>
4770
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4771 <td class="entry_tags">
4772 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4773 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4774 </ul>
4775 </td>
4776
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4777 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4778
4779
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4780 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4781 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4782
4783
4784
4785 <!-- end of kind -->
4786 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4787 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4788
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4789 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4790 <tr>
4791 <th class="th_name">Property Name</th>
4792 <th class="th_type">Type</th>
4793 <th class="th_description">Description</th>
4794 <th class="th_units">Units</th>
4795 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4796 <th class="th_tags">Tags</th>
4797 </tr>
4798 </thead>
4799
4800 <tbody>
4801
4802
4803
4804
4805
4806
4807
4808
4809
4810
4811
4812
4813 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4814 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4815 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4816 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4817 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4818 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4819 <span class="entry_type_container">x</span>
4820
4821 <span class="entry_type_array">
4822 2 x n
4823 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4824 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4825 <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]4826
4827
4828 </td> <!-- entry_type -->
4829
4830 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4831 <p>Location of hot/<wbr/>defective pixels on
4832sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4833 </td>
4834
4835 <td class="entry_units">
4836 </td>
4837
4838 <td class="entry_range">
4839 </td>
4840
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4841 <td class="entry_tags">
4842 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4843 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4844 </ul>
4845 </td>
4846
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4847 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4848
4849
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4850 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4851 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4852
4853
4854
4855
4856
4857
4858 <!-- end of kind -->
4859 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4860 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4861
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4862 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4863 <tr>
4864 <th class="th_name">Property Name</th>
4865 <th class="th_type">Type</th>
4866 <th class="th_description">Description</th>
4867 <th class="th_units">Units</th>
4868 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4869 <th class="th_tags">Tags</th>
4870 </tr>
4871 </thead>
4872
4873 <tbody>
4874
4875
4876
4877
4878
4879
4880
4881
4882
4883
4884 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4885 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4886 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4887 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4888 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4889 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4890
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4891 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4892
4893 <ul class="entry_type_enum">
4894 <li>
4895 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4896 <span class="entry_type_enum_notes">No hot pixel correction can be
4897 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4898 </li>
4899 <li>
4900 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4901 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
4902 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4903 </li>
4904 <li>
4905 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4906 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4907 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4908 </li>
4909 </ul>
4910
4911 </td> <!-- entry_type -->
4912
4913 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4914 <p>Set operational mode for hot pixel
4915correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4916 </td>
4917
4918 <td class="entry_units">
4919 </td>
4920
4921 <td class="entry_range">
4922 </td>
4923
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4924 <td class="entry_tags">
4925 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4926 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4927 </ul>
4928 </td>
4929
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4930 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4931
4932
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4933 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4934 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4935
4936
4937
4938 <!-- end of kind -->
4939 </tbody>
4940
4941 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4942 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4943
4944
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4945 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4946
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4947 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4948 <tr>
4949 <th class="th_name">Property Name</th>
4950 <th class="th_type">Type</th>
4951 <th class="th_description">Description</th>
4952 <th class="th_units">Units</th>
4953 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4954 <th class="th_tags">Tags</th>
4955 </tr>
4956 </thead>
4957
4958 <tbody>
4959
4960
4961
4962
4963
4964
4965
4966
4967
4968
4969 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4970 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4971 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4972 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4973 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4974 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4975 <span class="entry_type_container">x</span>
4976
4977 <span class="entry_type_array">
4978 3
4979 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4980 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4981 <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]4982
4983
4984 </td> <!-- entry_type -->
4985
4986 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4987 <p>GPS coordinates to include in output JPEG
4988EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4989 </td>
4990
4991 <td class="entry_units">
4992 </td>
4993
4994 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]4995 (-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4996 </td>
4997
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4998 <td class="entry_tags">
4999 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5000 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5001 </ul>
5002 </td>
5003
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5004 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5005
5006
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5007 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5008 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5009
5010
5011 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5012 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5013 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5014 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5015 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5016 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5017
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5018 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5019
5020
5021 </td> <!-- entry_type -->
5022
5023 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5024 <p>32 characters describing GPS algorithm to
5025include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5026 </td>
5027
5028 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5029 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5030 </td>
5031
5032 <td class="entry_range">
5033 </td>
5034
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5035 <td class="entry_tags">
5036 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5037 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5038 </ul>
5039 </td>
5040
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5041 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5042
5043
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5044 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5045 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5046
5047
5048 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5049 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5050 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5051 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5052 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5053 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5054
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5055 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5056
5057
5058 </td> <!-- entry_type -->
5059
5060 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5061 <p>Time GPS fix was made to include in
5062EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5063 </td>
5064
5065 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5066 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5067 </td>
5068
5069 <td class="entry_range">
5070 </td>
5071
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5072 <td class="entry_tags">
5073 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5074 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5075 </ul>
5076 </td>
5077
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5078 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5079
5080
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5081 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5082 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5083
5084
5085 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5086 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5087 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5088 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5089 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5090 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5091
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5092 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5093
5094
5095 </td> <!-- entry_type -->
5096
5097 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5098 <p>Orientation of JPEG image to
5099write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5100 </td>
5101
5102 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5103 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5104 </td>
5105
5106 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5107 0,<wbr/> 90,<wbr/> 180,<wbr/> 270
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5108 </td>
5109
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5110 <td class="entry_tags">
5111 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5112 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5113 </ul>
5114 </td>
5115
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5116 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5117
5118
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5119 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5120 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5121
5122
5123 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5124 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5125 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5126 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5127 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5128 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5129
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5130 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5131
5132
5133 </td> <!-- entry_type -->
5134
5135 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5136 <p>Compression quality of the final JPEG
5137image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5138 </td>
5139
5140 <td class="entry_units">
5141 </td>
5142
5143 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5144 1-100; larger is higher quality
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5145 </td>
5146
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5147 <td class="entry_tags">
5148 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5149 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5150 </ul>
5151 </td>
5152
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5153 </tr>
5154 <tr class="entries_header">
5155 <th class="th_details" colspan="5">Details</th>
5156 </tr>
5157 <tr class="entry_cont">
5158 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5159 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5160 </td>
5161 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5162
5163
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5164 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5165 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5166
5167
5168 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5169 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5170 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5171 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5172 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5173 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5174
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5175 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5176
5177
5178 </td> <!-- entry_type -->
5179
5180 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5181 <p>Compression quality of JPEG
5182thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5183 </td>
5184
5185 <td class="entry_units">
5186 </td>
5187
5188 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5189 1-100; larger is higher quality
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5190 </td>
5191
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5192 <td class="entry_tags">
5193 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5194 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5195 </ul>
5196 </td>
5197
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5198 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5199
5200
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5201 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5202 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5203
5204
5205 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5206 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5207 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5208 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5209 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5210 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5211 <span class="entry_type_container">x</span>
5212
5213 <span class="entry_type_array">
5214 2
5215 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5216 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5217
5218
5219 </td> <!-- entry_type -->
5220
5221 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5222 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5223 </td>
5224
5225 <td class="entry_units">
5226 </td>
5227
5228 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5229 Size must be one of the size from android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5230 </td>
5231
5232 <td class="entry_tags">
5233 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5234 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5235 </ul>
5236 </td>
5237
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5238 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5239 <tr class="entries_header">
5240 <th class="th_details" colspan="5">Details</th>
5241 </tr>
5242 <tr class="entry_cont">
5243 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5244 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5245but the captured JPEG must still be a valid image.<wbr/></p>
5246<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5247the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5248 </td>
5249 </tr>
5250
5251
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5252 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5253 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5254
5255
5256
5257 <!-- end of kind -->
5258 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5259 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5260
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5261 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5262 <tr>
5263 <th class="th_name">Property Name</th>
5264 <th class="th_type">Type</th>
5265 <th class="th_description">Description</th>
5266 <th class="th_units">Units</th>
5267 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5268 <th class="th_tags">Tags</th>
5269 </tr>
5270 </thead>
5271
5272 <tbody>
5273
5274
5275
5276
5277
5278
5279
5280
5281
5282
5283 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5284 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5285 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5286 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5287 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5288 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5289 <span class="entry_type_container">x</span>
5290
5291 <span class="entry_type_array">
5292 2 x n
5293 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5294 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5295
5296
5297 </td> <!-- entry_type -->
5298
5299 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5300 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5301 </td>
5302
5303 <td class="entry_units">
5304 </td>
5305
5306 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5307 Must include at least one valid resolution,<wbr/> plus
5308 (0,<wbr/>0) for no thumbnail generation,<wbr/> and each size must be distinct.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5309 </td>
5310
5311 <td class="entry_tags">
5312 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5313 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5314 </ul>
5315 </td>
5316
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5317 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5318 <tr class="entries_header">
5319 <th class="th_details" colspan="5">Details</th>
5320 </tr>
5321 <tr class="entry_cont">
5322 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5323 <p>Below condiditions must be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5324<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5325<li>The sizes must be sorted by increasing pixel area (width x height).<wbr/>
5326If 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]5327<li>The aspect ratio of the largest thumbnail size must be same as the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5328aspect ratio of largest size in android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes.<wbr/>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5329The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5330in a given size list.<wbr/></li>
5331<li>Each size in android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes must have at least
5332one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
5333and vice versa.<wbr/></li>
5334<li>All non (0,<wbr/> 0) sizes must have non-zero widths and heights.<wbr/></li>
5335</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5336 </td>
5337 </tr>
5338
5339
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5340 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5341 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5342
5343
5344 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5345 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5346 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5347 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5348 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5349 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5350
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5351 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5352
5353
5354 </td> <!-- entry_type -->
5355
5356 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5357 <p>Maximum size in bytes for the compressed
5358JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5359 </td>
5360
5361 <td class="entry_units">
5362 </td>
5363
5364 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5365 Must be large enough to fit any JPEG produced by
5366 the camera
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5367 </td>
5368
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5369 <td class="entry_tags">
5370 </td>
5371
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5372 </tr>
5373 <tr class="entries_header">
5374 <th class="th_details" colspan="5">Details</th>
5375 </tr>
5376 <tr class="entry_cont">
5377 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5378 <p>This is used for sizing the gralloc buffers for
5379JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5380 </td>
5381 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5382
5383
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5384 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5385 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5386
5387
5388
5389 <!-- end of kind -->
5390 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5391 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5392
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5393 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5394 <tr>
5395 <th class="th_name">Property Name</th>
5396 <th class="th_type">Type</th>
5397 <th class="th_description">Description</th>
5398 <th class="th_units">Units</th>
5399 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5400 <th class="th_tags">Tags</th>
5401 </tr>
5402 </thead>
5403
5404 <tbody>
5405
5406
5407
5408
5409
5410
5411
5412
5413
5414
5415 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5416 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5417 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5418 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5419 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5420 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5421 <span class="entry_type_container">x</span>
5422
5423 <span class="entry_type_array">
5424 3
5425 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5426 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5427 <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]5428
5429
5430 </td> <!-- entry_type -->
5431
5432 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5433 <p>GPS coordinates to include in output JPEG
5434EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5435 </td>
5436
5437 <td class="entry_units">
5438 </td>
5439
5440 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5441 (-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5442 </td>
5443
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5444 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5445 <ul class="entry_tags">
5446 <li><a href="#tag_BC">BC</a></li>
5447 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5448 </td>
5449
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5450 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5451
5452
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5453 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5454 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5455
5456
5457 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5458 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5459 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5460 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5461 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5462 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5463
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5464 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5465
5466
5467 </td> <!-- entry_type -->
5468
5469 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5470 <p>32 characters describing GPS algorithm to
5471include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5472 </td>
5473
5474 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5475 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5476 </td>
5477
5478 <td class="entry_range">
5479 </td>
5480
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5481 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5482 <ul class="entry_tags">
5483 <li><a href="#tag_BC">BC</a></li>
5484 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5485 </td>
5486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5487 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5488
5489
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5490 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5491 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5492
5493
5494 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5495 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5496 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5497 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5498 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5499 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5500
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5501 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5502
5503
5504 </td> <!-- entry_type -->
5505
5506 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5507 <p>Time GPS fix was made to include in
5508EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5509 </td>
5510
5511 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5512 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5513 </td>
5514
5515 <td class="entry_range">
5516 </td>
5517
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5518 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5519 <ul class="entry_tags">
5520 <li><a href="#tag_BC">BC</a></li>
5521 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5522 </td>
5523
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5524 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5525
5526
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5527 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5528 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5529
5530
5531 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5532 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5533 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5534 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5535 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5536 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5537
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5538 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5539
5540
5541 </td> <!-- entry_type -->
5542
5543 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5544 <p>Orientation of JPEG image to
5545write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5546 </td>
5547
5548 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5549 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5550 </td>
5551
5552 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5553 0,<wbr/> 90,<wbr/> 180,<wbr/> 270
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5554 </td>
5555
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5556 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5557 <ul class="entry_tags">
5558 <li><a href="#tag_BC">BC</a></li>
5559 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5560 </td>
5561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5562 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5563
5564
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5565 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5566 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5567
5568
5569 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5570 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5571 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5572 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5573 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5574 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5575
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5576 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5577
5578
5579 </td> <!-- entry_type -->
5580
5581 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5582 <p>Compression quality of the final JPEG
5583image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5584 </td>
5585
5586 <td class="entry_units">
5587 </td>
5588
5589 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5590 1-100; larger is higher quality
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5591 </td>
5592
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5593 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5594 <ul class="entry_tags">
5595 <li><a href="#tag_BC">BC</a></li>
5596 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5597 </td>
5598
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5599 </tr>
5600 <tr class="entries_header">
5601 <th class="th_details" colspan="5">Details</th>
5602 </tr>
5603 <tr class="entry_cont">
5604 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5605 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5606 </td>
5607 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5608
5609
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5610 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5611 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5612
5613
5614 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5615 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5616 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5617 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5618 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5619 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5620
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5621 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5622
5623
5624 </td> <!-- entry_type -->
5625
5626 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5627 <p>The size of the compressed JPEG image,<wbr/> in
5628bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5629 </td>
5630
5631 <td class="entry_units">
5632 </td>
5633
5634 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5635 &gt;= 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5636 </td>
5637
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5638 <td class="entry_tags">
5639 </td>
5640
5641 </tr>
5642 <tr class="entries_header">
5643 <th class="th_details" colspan="5">Details</th>
5644 </tr>
5645 <tr class="entry_cont">
5646 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5647 <p>If no JPEG output is produced for the request,<wbr/>
5648this must be 0.<wbr/></p>
5649<p>Otherwise,<wbr/> this describes the real size of the compressed
5650JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
5651if android.<wbr/>jpeg.<wbr/>max<wbr/>Size = 1000000,<wbr/> and a specific capture
5652has android.<wbr/>jpeg.<wbr/>size = 500000,<wbr/> then the output buffer from
5653the JPEG stream will be 1000000 bytes,<wbr/> of which the first
5654500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5655 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5656 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5657
5658
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5659 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5660 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5661
5662
5663 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5664 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5665 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5666 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5667 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5668 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5669
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5670 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5671
5672
5673 </td> <!-- entry_type -->
5674
5675 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5676 <p>Compression quality of JPEG
5677thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5678 </td>
5679
5680 <td class="entry_units">
5681 </td>
5682
5683 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5684 1-100; larger is higher quality
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5685 </td>
5686
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5687 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5688 <ul class="entry_tags">
5689 <li><a href="#tag_BC">BC</a></li>
5690 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5691 </td>
5692
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5693 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5694
5695
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5696 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5697 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5698
5699
5700 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5701 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5702 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5703 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5704 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5705 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5706 <span class="entry_type_container">x</span>
5707
5708 <span class="entry_type_array">
5709 2
5710 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5711 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5712
5713
5714 </td> <!-- entry_type -->
5715
5716 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5717 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5718 </td>
5719
5720 <td class="entry_units">
5721 </td>
5722
5723 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5724 Size must be one of the size from android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5725 </td>
5726
5727 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5728 <ul class="entry_tags">
5729 <li><a href="#tag_BC">BC</a></li>
5730 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5731 </td>
5732
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5733 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5734 <tr class="entries_header">
5735 <th class="th_details" colspan="5">Details</th>
5736 </tr>
5737 <tr class="entry_cont">
5738 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5739 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5740but the captured JPEG must still be a valid image.<wbr/></p>
5741<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5742the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5743 </td>
5744 </tr>
5745
5746
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5747 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5748 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5749
5750
5751
5752 <!-- end of kind -->
5753 </tbody>
5754
5755 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5756 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5757
5758
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5759 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5760
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5761 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5762 <tr>
5763 <th class="th_name">Property Name</th>
5764 <th class="th_type">Type</th>
5765 <th class="th_description">Description</th>
5766 <th class="th_units">Units</th>
5767 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5768 <th class="th_tags">Tags</th>
5769 </tr>
5770 </thead>
5771
5772 <tbody>
5773
5774
5775
5776
5777
5778
5779
5780
5781
5782
5783 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5784 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5785 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5786 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5787 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5788 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5789
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5790 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5791
5792
5793 </td> <!-- entry_type -->
5794
5795 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5796 <p>Size of the lens aperture</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5797 </td>
5798
5799 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5800 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5801 </td>
5802
5803 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5804 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5805 </td>
5806
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5807 <td class="entry_tags">
5808 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5809 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5810 </ul>
5811 </td>
5812
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5813 </tr>
5814 <tr class="entries_header">
5815 <th class="th_details" colspan="5">Details</th>
5816 </tr>
5817 <tr class="entry_cont">
5818 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5819 <p>Will not be supported on most devices.<wbr/> Can only
5820pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5821 </td>
5822 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5823
5824
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5825 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5826 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5827
5828
5829 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5830 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5831 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5832 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5833 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5834 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5835
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5836 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5837
5838
5839 </td> <!-- entry_type -->
5840
5841 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5842 <p>State of lens neutral density
5843filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5844 </td>
5845
5846 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5847 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5848 </td>
5849
5850 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5851 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5852 </td>
5853
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5854 <td class="entry_tags">
5855 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5856 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5857 </ul>
5858 </td>
5859
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5860 </tr>
5861 <tr class="entries_header">
5862 <th class="th_details" colspan="5">Details</th>
5863 </tr>
5864 <tr class="entry_cont">
5865 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5866 <p>Will not be supported on most devices.<wbr/> Can only
5867pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5868 </td>
5869 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5870
5871
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5872 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5873 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5874
5875
5876 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5877 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5878 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5879 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5880 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5881 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5882
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5883 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5884
5885
5886 </td> <!-- entry_type -->
5887
5888 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5889 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5890 </td>
5891
5892 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5893 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5894 </td>
5895
5896 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5897 &gt; 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5898 </td>
5899
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5900 <td class="entry_tags">
5901 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5902 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5903 </ul>
5904 </td>
5905
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5906 </tr>
5907 <tr class="entries_header">
5908 <th class="th_details" colspan="5">Details</th>
5909 </tr>
5910 <tr class="entry_cont">
5911 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5912 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5913 </td>
5914 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5915
5916
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5917 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5918 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5919
5920
5921 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5922 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5923 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5924 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5925 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5926 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5927
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5928 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5929
5930
5931 </td> <!-- entry_type -->
5932
5933 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5934 <p>Distance to plane of sharpest focus,<wbr/>
5935measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5936 </td>
5937
5938 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5939 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5940 </td>
5941
5942 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5943 &gt;= 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5944 </td>
5945
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5946 <td class="entry_tags">
5947 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5948 <li><a href="#tag_BC">BC</a></li>
5949 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5950 </ul>
5951 </td>
5952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5953 </tr>
5954 <tr class="entries_header">
5955 <th class="th_details" colspan="5">Details</th>
5956 </tr>
5957 <tr class="entry_cont">
5958 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5959 <p>0 = infinity focus.<wbr/> Used value should be clamped
5960to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5961 </td>
5962 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5963
5964
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5965 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5966 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5967
5968
5969 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5970 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5971 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5972 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5973 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5974 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5975
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5976 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5977
5978 <ul class="entry_type_enum">
5979 <li>
5980 <span class="entry_type_enum_name">OFF</span>
5981 </li>
5982 <li>
5983 <span class="entry_type_enum_name">ON</span>
5984 <span class="entry_type_enum_optional">optional</span>
5985 </li>
5986 </ul>
5987
5988 </td> <!-- entry_type -->
5989
5990 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5991 <p>Whether optical image stabilization is
5992enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5993 </td>
5994
5995 <td class="entry_units">
5996 </td>
5997
5998 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]5999 android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6000 </td>
6001
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6002 <td class="entry_tags">
6003 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6004 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6005 </ul>
6006 </td>
6007
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6008 </tr>
6009 <tr class="entries_header">
6010 <th class="th_details" colspan="5">Details</th>
6011 </tr>
6012 <tr class="entry_cont">
6013 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6014 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6015 </td>
6016 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6017
6018
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6019 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6020 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6021
6022
6023
6024 <!-- end of kind -->
6025 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6026 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6027
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6028 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6029 <tr>
6030 <th class="th_name">Property Name</th>
6031 <th class="th_type">Type</th>
6032 <th class="th_description">Description</th>
6033 <th class="th_units">Units</th>
6034 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6035 <th class="th_tags">Tags</th>
6036 </tr>
6037 </thead>
6038
6039 <tbody>
6040
6041
6042
6043
6044
6045
6046
6047
6048
6049
6050
6051
6052 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6053 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6054 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6055 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6056 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6057 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6058 <span class="entry_type_container">x</span>
6059
6060 <span class="entry_type_array">
6061 n
6062 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6063 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6064
6065
6066 </td> <!-- entry_type -->
6067
6068 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6069 <p>List of supported aperture
6070values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6071 </td>
6072
6073 <td class="entry_units">
6074 </td>
6075
6076 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6077 one entry required,<wbr/> &gt; 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6078 </td>
6079
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6080 <td class="entry_tags">
6081 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6082 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6083 </ul>
6084 </td>
6085
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6086 </tr>
6087 <tr class="entries_header">
6088 <th class="th_details" colspan="5">Details</th>
6089 </tr>
6090 <tr class="entry_cont">
6091 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6092 <p>If variable aperture not available,<wbr/> only setting
6093should be for the fixed aperture</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6094 </td>
6095 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6096
6097
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6098 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6099 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6100
6101
6102 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6103 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6104 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6105 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6106 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6107 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6108 <span class="entry_type_container">x</span>
6109
6110 <span class="entry_type_array">
6111 n
6112 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6113 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6114
6115
6116 </td> <!-- entry_type -->
6117
6118 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6119 <p>List of supported ND filter
6120values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6121 </td>
6122
6123 <td class="entry_units">
6124 </td>
6125
6126 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6127 one entry required,<wbr/> &gt;= 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6128 </td>
6129
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6130 <td class="entry_tags">
6131 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6132 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6133 </ul>
6134 </td>
6135
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6136 </tr>
6137 <tr class="entries_header">
6138 <th class="th_details" colspan="5">Details</th>
6139 </tr>
6140 <tr class="entry_cont">
6141 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6142 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6143lists the available exposure index values for dimming
6144(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6145light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6146 </td>
6147 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6148
6149
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6150 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6151 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6152
6153
6154 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6155 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6156 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6157 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6158 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6159 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6160 <span class="entry_type_container">x</span>
6161
6162 <span class="entry_type_array">
6163 n
6164 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6165 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6166 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6167
6168
6169 </td> <!-- entry_type -->
6170
6171 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6172 <p>If fitted with optical zoom,<wbr/> what focal
6173lengths are available.<wbr/> If not,<wbr/> the static focal
6174length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6175 </td>
6176
6177 <td class="entry_units">
6178 </td>
6179
6180 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6181 &gt; 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6182 </td>
6183
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6184 <td class="entry_tags">
6185 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6186 <li><a href="#tag_BC">BC</a></li>
6187 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6188 </ul>
6189 </td>
6190
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6191 </tr>
6192 <tr class="entries_header">
6193 <th class="th_details" colspan="5">Details</th>
6194 </tr>
6195 <tr class="entry_cont">
6196 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6197 <p>If optical zoom not supported,<wbr/> only one value
6198should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6199 </td>
6200 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6201
6202
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6203 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6204 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6205
6206
6207 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6208 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6209 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6210 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6211 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6212 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6213 <span class="entry_type_container">x</span>
6214
6215 <span class="entry_type_array">
6216 n
6217 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6218 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6219 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6220
6221
6222 </td> <!-- entry_type -->
6223
6224 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6225 <p>List of supported optical image
6226stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6227 </td>
6228
6229 <td class="entry_units">
6230 </td>
6231
6232 <td class="entry_range">
6233 </td>
6234
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6235 <td class="entry_tags">
6236 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6237 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6238 </ul>
6239 </td>
6240
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6241 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6242
6243
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6244 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6245 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6246
6247
6248 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6249 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6250 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6251 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6252 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6253 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6254 <span class="entry_type_container">x</span>
6255
6256 <span class="entry_type_array">
6257 2 x 3 x n x m
6258 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6259 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6260 <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]6261
6262
6263 </td> <!-- entry_type -->
6264
6265 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6266 <p>A low-resolution map for correction of
6267geometric distortions and chromatic aberrations,<wbr/> per
6268color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6269 </td>
6270
6271 <td class="entry_units">
6272 </td>
6273
6274 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6275 N,<wbr/> M &gt;= 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6276 </td>
6277
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6278 <td class="entry_tags">
6279 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6280 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6281 </ul>
6282 </td>
6283
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6284 </tr>
6285 <tr class="entries_header">
6286 <th class="th_details" colspan="5">Details</th>
6287 </tr>
6288 <tr class="entry_cont">
6289 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6290 <p>[DNG wants a function instead].<wbr/> What's easiest
6291for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
6292j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
6293j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
6294entry 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]6295 </td>
6296 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6297
6298
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6299 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6300 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6301
6302
6303 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6304 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6305 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6306 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6307 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6308 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6309 <span class="entry_type_container">x</span>
6310
6311 <span class="entry_type_array">
6312 2
6313 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6314 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6315 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6316
6317
6318 </td> <!-- entry_type -->
6319
6320 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6321 <p>Dimensions of geometric correction
6322map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6323 </td>
6324
6325 <td class="entry_units">
6326 </td>
6327
6328 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6329 Both values &gt;= 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6330 </td>
6331
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6332 <td class="entry_tags">
6333 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6334 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6335 </ul>
6336 </td>
6337
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6338 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6339
6340
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6341 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6342 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6343
6344
6345 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6346 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6347 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6348 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6349 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6350 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6351
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6352 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6353
6354
6355 </td> <!-- entry_type -->
6356
6357 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6358 <p>Hyperfocal distance for this lens; set to
63590 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6360 </td>
6361
6362 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6363 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6364 </td>
6365
6366 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6367 &gt;= 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6368 </td>
6369
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6370 <td class="entry_tags">
6371 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6372 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6373 </ul>
6374 </td>
6375
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6376 </tr>
6377 <tr class="entries_header">
6378 <th class="th_details" colspan="5">Details</th>
6379 </tr>
6380 <tr class="entry_cont">
6381 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6382 <p>The hyperfocal distance is used for the old
6383API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6384 </td>
6385 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6386
6387
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6388 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6389 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6390
6391
6392 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6393 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6394 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6395 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6396 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6397 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6398
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6399 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6400
6401
6402 </td> <!-- entry_type -->
6403
6404 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6405 <p>Shortest distance from frontmost surface
6406of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6407 </td>
6408
6409 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6410 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6411 </td>
6412
6413 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6414 &gt;= 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6415 </td>
6416
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6417 <td class="entry_tags">
6418 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6419 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6420 </ul>
6421 </td>
6422
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6423 </tr>
6424 <tr class="entries_header">
6425 <th class="th_details" colspan="5">Details</th>
6426 </tr>
6427 <tr class="entry_cont">
6428 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6429 <p>If the lens is fixed-focus,<wbr/> this should be
64300</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6431 </td>
6432 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6433
6434
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6435 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6436 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6437
6438
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6439 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6440 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6441 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6442 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6443 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6444 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6445 <span class="entry_type_container">x</span>
6446
6447 <span class="entry_type_array">
6448 2
6449 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6450 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6451 <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]6452
6453
6454 </td> <!-- entry_type -->
6455
6456 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6457 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6458 </td>
6459
6460 <td class="entry_units">
6461 </td>
6462
6463 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6464 Both values &gt;= 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6465 </td>
6466
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6467 <td class="entry_tags">
6468 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6469 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6470 </ul>
6471 </td>
6472
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6473 </tr>
6474 <tr class="entries_header">
6475 <th class="th_details" colspan="5">Details</th>
6476 </tr>
6477 <tr class="entry_cont">
6478 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6479 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
6480must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6481 </td>
6482 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6483
6484
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6485 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6486 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6487
6488
6489
6490
6491
6492 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6493 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6494 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6495 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6496 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6497 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6498
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6499 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6500
6501 <ul class="entry_type_enum">
6502 <li>
6503 <span class="entry_type_enum_name">FRONT</span>
6504 </li>
6505 <li>
6506 <span class="entry_type_enum_name">BACK</span>
6507 </li>
6508 </ul>
6509
6510 </td> <!-- entry_type -->
6511
6512 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6513 <p>Direction the camera faces relative to
6514device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6515 </td>
6516
6517 <td class="entry_units">
6518 </td>
6519
6520 <td class="entry_range">
6521 </td>
6522
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6523 <td class="entry_tags">
6524 </td>
6525
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6526 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6527
6528
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6529 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6530 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6531
6532
6533 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6534 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6535 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6536 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6537 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6538 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6539 <span class="entry_type_container">x</span>
6540
6541 <span class="entry_type_array">
6542 2
6543 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6544 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6545 <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]6546
6547
6548 </td> <!-- entry_type -->
6549
6550 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6551 <p>Relative angle of camera optical axis to the
6552perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6553 </td>
6554
6555 <td class="entry_units">
6556 </td>
6557
6558 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6559 [0-90) for first angle,<wbr/> [0-360) for second
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6560 </td>
6561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6562 <td class="entry_tags">
6563 <ul class="entry_tags">
6564 <li><a href="#tag_ADV">ADV</a></li>
6565 </ul>
6566 </td>
6567
6568 </tr>
6569 <tr class="entries_header">
6570 <th class="th_details" colspan="5">Details</th>
6571 </tr>
6572 <tr class="entry_cont">
6573 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6574 <p>Examples:</p>
6575<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6576is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6577<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6578device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6579<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
6580the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6581<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6582direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6583 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6584 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6585
6586
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6587 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6588 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6589
6590
6591 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6592 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6593 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6594 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6595 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6596 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6597 <span class="entry_type_container">x</span>
6598
6599 <span class="entry_type_array">
6600 3, location in mm, in the sensor coordinate
6601 system
6602 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6603 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6604
6605
6606 </td> <!-- entry_type -->
6607
6608 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6609 <p>Coordinates of camera optical axis on
6610device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6611 </td>
6612
6613 <td class="entry_units">
6614 </td>
6615
6616 <td class="entry_range">
6617 </td>
6618
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6619 <td class="entry_tags">
6620 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6621 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6622 </ul>
6623 </td>
6624
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6625 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6626
6627
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6628 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6629 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6630
6631
6632
6633 <!-- end of kind -->
6634 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6635 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6636
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6637 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6638 <tr>
6639 <th class="th_name">Property Name</th>
6640 <th class="th_type">Type</th>
6641 <th class="th_description">Description</th>
6642 <th class="th_units">Units</th>
6643 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6644 <th class="th_tags">Tags</th>
6645 </tr>
6646 </thead>
6647
6648 <tbody>
6649
6650
6651
6652
6653
6654
6655
6656
6657
6658
6659 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6660 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6661 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6662 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6663 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6664 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6665
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6666 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6667
6668
6669 </td> <!-- entry_type -->
6670
6671 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6672 <p>Size of the lens aperture</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6673 </td>
6674
6675 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6676 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6677 </td>
6678
6679 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6680 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6681 </td>
6682
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6683 <td class="entry_tags">
6684 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6685 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6686 </ul>
6687 </td>
6688
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6689 </tr>
6690 <tr class="entries_header">
6691 <th class="th_details" colspan="5">Details</th>
6692 </tr>
6693 <tr class="entry_cont">
6694 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6695 <p>Will not be supported on most devices.<wbr/> Can only
6696pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6697 </td>
6698 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6699
6700
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6701 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6702 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6703
6704
6705 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6706 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6707 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6708 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6709 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6710 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6711
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6712 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6713
6714
6715 </td> <!-- entry_type -->
6716
6717 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6718 <p>State of lens neutral density
6719filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6720 </td>
6721
6722 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6723 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6724 </td>
6725
6726 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6727 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6728 </td>
6729
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6730 <td class="entry_tags">
6731 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6732 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6733 </ul>
6734 </td>
6735
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6736 </tr>
6737 <tr class="entries_header">
6738 <th class="th_details" colspan="5">Details</th>
6739 </tr>
6740 <tr class="entry_cont">
6741 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6742 <p>Will not be supported on most devices.<wbr/> Can only
6743pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6744 </td>
6745 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6746
6747
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6748 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6749 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6750
6751
6752 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6753 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6754 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6755 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6756 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6757 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6758
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6759 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6760
6761
6762 </td> <!-- entry_type -->
6763
6764 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6765 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6766 </td>
6767
6768 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6769 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6770 </td>
6771
6772 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6773 &gt; 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6774 </td>
6775
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6776 <td class="entry_tags">
6777 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6778 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6779 </ul>
6780 </td>
6781
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6782 </tr>
6783 <tr class="entries_header">
6784 <th class="th_details" colspan="5">Details</th>
6785 </tr>
6786 <tr class="entry_cont">
6787 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6788 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6789 </td>
6790 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6791
6792
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6793 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6794 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6795
6796
6797 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6798 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6799 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6800 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6801 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6802 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6803
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6804 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6805
6806
6807 </td> <!-- entry_type -->
6808
6809 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6810 <p>Distance to plane of sharpest focus,<wbr/>
6811measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6812 </td>
6813
6814 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6815 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6816 </td>
6817
6818 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6819 &gt;= 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6820 </td>
6821
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6822 <td class="entry_tags">
6823 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6824 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6825 </ul>
6826 </td>
6827
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6828 </tr>
6829 <tr class="entries_header">
6830 <th class="th_details" colspan="5">Details</th>
6831 </tr>
6832 <tr class="entry_cont">
6833 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6834 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6835 </td>
6836 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6837
6838
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6839 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6840 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6841
6842
6843 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6844 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6845 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6846 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6847 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6848 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]6849 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6850
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]6851 <span class="entry_type_array">
6852 2
6853 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6854 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6855 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6856
6857
6858 </td> <!-- entry_type -->
6859
6860 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6861 <p>The range of scene distances that are in
6862sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6863 </td>
6864
6865 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6866 pair of focus distances in diopters: (near,<wbr/>
6867 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6868 </td>
6869
6870 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6871 &gt;=0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6872 </td>
6873
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6874 <td class="entry_tags">
6875 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6876 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6877 </ul>
6878 </td>
6879
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6880 </tr>
6881 <tr class="entries_header">
6882 <th class="th_details" colspan="5">Details</th>
6883 </tr>
6884 <tr class="entry_cont">
6885 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6886 <p>If variable focus not supported,<wbr/> can still report
6887fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6888 </td>
6889 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6890
6891
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6892 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6893 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6894
6895
6896 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6897 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6898 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6899 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6900 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6901 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6902
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6903 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6904
6905 <ul class="entry_type_enum">
6906 <li>
6907 <span class="entry_type_enum_name">OFF</span>
6908 </li>
6909 <li>
6910 <span class="entry_type_enum_name">ON</span>
6911 <span class="entry_type_enum_optional">optional</span>
6912 </li>
6913 </ul>
6914
6915 </td> <!-- entry_type -->
6916
6917 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6918 <p>Whether optical image stabilization is
6919enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6920 </td>
6921
6922 <td class="entry_units">
6923 </td>
6924
6925 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6926 android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6927 </td>
6928
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6929 <td class="entry_tags">
6930 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6931 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6932 </ul>
6933 </td>
6934
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6935 </tr>
6936 <tr class="entries_header">
6937 <th class="th_details" colspan="5">Details</th>
6938 </tr>
6939 <tr class="entry_cont">
6940 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6941 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6942 </td>
6943 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6944
6945
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6946 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6947 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6948
6949
6950 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6951 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6952 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6953 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6954 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6955 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6956
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6957 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6958
6959 <ul class="entry_type_enum">
6960 <li>
6961 <span class="entry_type_enum_name">STATIONARY</span>
6962 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]6963 <li>
6964 <span class="entry_type_enum_name">MOVING</span>
6965 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6966 </ul>
6967
6968 </td> <!-- entry_type -->
6969
6970 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]6971 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6972 </td>
6973
6974 <td class="entry_units">
6975 </td>
6976
6977 <td class="entry_range">
6978 </td>
6979
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6980 <td class="entry_tags">
6981 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6982 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6983 </ul>
6984 </td>
6985
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6986 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6987
6988
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6989 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6990 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6991
6992
6993
6994 <!-- end of kind -->
6995 </tbody>
6996
6997 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6998 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6999
7000
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7001 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7002
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7003 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7004 <tr>
7005 <th class="th_name">Property Name</th>
7006 <th class="th_type">Type</th>
7007 <th class="th_description">Description</th>
7008 <th class="th_units">Units</th>
7009 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7010 <th class="th_tags">Tags</th>
7011 </tr>
7012 </thead>
7013
7014 <tbody>
7015
7016
7017
7018
7019
7020
7021
7022
7023
7024
7025 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7026 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7027 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7028 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7029 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7030 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7031
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7032 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7033
7034 <ul class="entry_type_enum">
7035 <li>
7036 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7037 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7038 </li>
7039 <li>
7040 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7041 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7042 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7043 </li>
7044 <li>
7045 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7046 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7047 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7048 </li>
7049 </ul>
7050
7051 </td> <!-- entry_type -->
7052
7053 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7054 <p>Mode of operation for the noise reduction
7055algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7056 </td>
7057
7058 <td class="entry_units">
7059 </td>
7060
7061 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7062 android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7063 </td>
7064
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7065 <td class="entry_tags">
7066 <ul class="entry_tags">
7067 <li><a href="#tag_V1">V1</a></li>
7068 </ul>
7069 </td>
7070
7071 </tr>
7072 <tr class="entries_header">
7073 <th class="th_details" colspan="5">Details</th>
7074 </tr>
7075 <tr class="entry_cont">
7076 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7077 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7078will be applied by the HAL.<wbr/></p>
7079<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7080will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7081should use the highest-quality noise filtering algorithms,<wbr/>
7082even if it slows down capture rate.<wbr/> FAST means the HAL should not
7083slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7084 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7085 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7086
7087
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7088 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7089 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7090
7091
7092 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7093 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7094 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7095 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7096 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7097 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7098
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7099 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7100
7101
7102 </td> <!-- entry_type -->
7103
7104 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7105 <p>Control the amount of noise reduction
7106applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7107 </td>
7108
7109 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7110 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7111 </td>
7112
7113 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7114 1 - 10
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7115 </td>
7116
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7117 <td class="entry_tags">
7118 </td>
7119
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7120 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7121
7122
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7123 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7124 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7125
7126
7127
7128 <!-- end of kind -->
7129 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7130 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7131
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7132 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7133 <tr>
7134 <th class="th_name">Property Name</th>
7135 <th class="th_type">Type</th>
7136 <th class="th_description">Description</th>
7137 <th class="th_units">Units</th>
7138 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7139 <th class="th_tags">Tags</th>
7140 </tr>
7141 </thead>
7142
7143 <tbody>
7144
7145
7146
7147
7148
7149
7150
7151
7152
7153
7154 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7155 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7156 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7157 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7158 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7159 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7160
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7161 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7162
7163 <ul class="entry_type_enum">
7164 <li>
7165 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7166 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7167 </li>
7168 <li>
7169 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7170 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7171 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7172 </li>
7173 <li>
7174 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7175 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7176 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7177 </li>
7178 </ul>
7179
7180 </td> <!-- entry_type -->
7181
7182 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7183 <p>Mode of operation for the noise reduction
7184algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7185 </td>
7186
7187 <td class="entry_units">
7188 </td>
7189
7190 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7191 android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7192 </td>
7193
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7194 <td class="entry_tags">
7195 <ul class="entry_tags">
7196 <li><a href="#tag_V1">V1</a></li>
7197 </ul>
7198 </td>
7199
7200 </tr>
7201 <tr class="entries_header">
7202 <th class="th_details" colspan="5">Details</th>
7203 </tr>
7204 <tr class="entry_cont">
7205 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7206 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7207will be applied by the HAL.<wbr/></p>
7208<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7209will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7210should use the highest-quality noise filtering algorithms,<wbr/>
7211even if it slows down capture rate.<wbr/> FAST means the HAL should not
7212slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7213 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7214 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7215
7216
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7217 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7218 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7219
7220
7221
7222 <!-- end of kind -->
7223 </tbody>
7224
7225 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7226 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7227
7228
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7229 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7230
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7231 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7232 <tr>
7233 <th class="th_name">Property Name</th>
7234 <th class="th_type">Type</th>
7235 <th class="th_description">Description</th>
7236 <th class="th_units">Units</th>
7237 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7238 <th class="th_tags">Tags</th>
7239 </tr>
7240 </thead>
7241
7242 <tbody>
7243
7244
7245
7246
7247
7248
7249
7250
7251
7252
7253 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7254 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7255 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7256 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7257 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7258 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7259
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7260 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7261
7262
7263 </td> <!-- entry_type -->
7264
7265 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7266 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7267scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7268region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
7269and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7270 </td>
7271
7272 <td class="entry_units">
7273 </td>
7274
7275 <td class="entry_range">
7276 </td>
7277
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7278 <td class="entry_tags">
7279 </td>
7280
7281 </tr>
7282 <tr class="entries_header">
7283 <th class="th_details" colspan="5">Details</th>
7284 </tr>
7285 <tr class="entry_cont">
7286 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7287 <p>Normalized coordinates refer to those in the
7288(-1000,<wbr/>1000) range mentioned in the
7289android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7290<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7291sensor array-relative coordinates for all region data.<wbr/> Does
7292not need to be listed in static metadata.<wbr/> Support will be
7293removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7294 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7295 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7296
7297
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7298 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7299 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7300
7301
7302 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7303 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7304 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7305 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7306 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7307 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7308
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7309 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7310
7311
7312 </td> <!-- entry_type -->
7313
7314 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7315 <p>If set to 1,<wbr/> then the camera service always
7316switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
7317trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7318 </td>
7319
7320 <td class="entry_units">
7321 </td>
7322
7323 <td class="entry_range">
7324 </td>
7325
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7326 <td class="entry_tags">
7327 </td>
7328
7329 </tr>
7330 <tr class="entries_header">
7331 <th class="th_details" colspan="5">Details</th>
7332 </tr>
7333 <tr class="entry_cont">
7334 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7335 <p>HAL implementations should implement AF trigger
7336modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
7337CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
7338not need to be listed in static metadata.<wbr/> Support will be
7339removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7340 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7341 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7342
7343
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7344 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7345 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7346
7347
7348 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7349 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7350 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7351 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7352 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7353 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7354
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7355 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7356
7357
7358 </td> <!-- entry_type -->
7359
7360 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7361 <p>If set to 1,<wbr/> the camera service uses
7362CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
7363HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
7364shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7365 </td>
7366
7367 <td class="entry_units">
7368 </td>
7369
7370 <td class="entry_range">
7371 </td>
7372
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7373 <td class="entry_tags">
7374 </td>
7375
7376 </tr>
7377 <tr class="entries_header">
7378 <th class="th_details" colspan="5">Details</th>
7379 </tr>
7380 <tr class="entry_cont">
7381 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7382 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7383to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7384zero-shutter-lag,<wbr/> instead of relying on an explicit
7385format setting.<wbr/> Does not need to be listed in static
7386metadata.<wbr/> Support will be removed in future versions of
7387camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7388 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7389 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7390
7391
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7392 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7393 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7394
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7395
7396 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7397 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7398 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7399 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7400 <td class="entry_type">
7401 <span class="entry_type_name">byte</span>
7402
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7403 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7404
7405
7406 </td> <!-- entry_type -->
7407
7408 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7409 <p>If set to 1,<wbr/> the HAL will always split result
7410metadata for a single capture into multiple buffers,<wbr/>
7411returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7412 </td>
7413
7414 <td class="entry_units">
7415 </td>
7416
7417 <td class="entry_range">
7418 </td>
7419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7420 <td class="entry_tags">
7421 </td>
7422
7423 </tr>
7424 <tr class="entries_header">
7425 <th class="th_details" colspan="5">Details</th>
7426 </tr>
7427 <tr class="entry_cont">
7428 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7429 <p>Does not need to be listed in static
7430metadata.<wbr/> Support for partial results will be reworked in
7431future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7432working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7433consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7434 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7435 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7436
7437
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7438 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7439 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7440
7441
7442
7443 <!-- end of kind -->
7444 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7445 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7446
7447 <thead class="entries_header">
7448 <tr>
7449 <th class="th_name">Property Name</th>
7450 <th class="th_type">Type</th>
7451 <th class="th_description">Description</th>
7452 <th class="th_units">Units</th>
7453 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7454 <th class="th_tags">Tags</th>
7455 </tr>
7456 </thead>
7457
7458 <tbody>
7459
7460
7461
7462
7463
7464
7465
7466
7467
7468
7469 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7470 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7471 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7472 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7473 <td class="entry_type">
7474 <span class="entry_type_name entry_type_name_enum">byte</span>
7475
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7476 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7477
7478 <ul class="entry_type_enum">
7479 <li>
7480 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7481 <span class="entry_type_enum_notes">The last or only metadata result buffer
7482 for this capture.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7483 </li>
7484 <li>
7485 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7486 <span class="entry_type_enum_notes">A partial buffer of result metadata for this
7487 capture.<wbr/> More result buffers for this capture will be sent
7488 by the HAL,<wbr/> the last of which will be marked
7489 FINAL.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7490 </li>
7491 </ul>
7492
7493 </td> <!-- entry_type -->
7494
7495 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7496 <p>Whether a result given to the framework is the
7497final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7498subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7499values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7500 </td>
7501
7502 <td class="entry_units">
7503 </td>
7504
7505 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7506 Optional.<wbr/> Default value is FINAL.<wbr/>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7507 </td>
7508
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7509 <td class="entry_tags">
7510 </td>
7511
7512 </tr>
7513 <tr class="entries_header">
7514 <th class="th_details" colspan="5">Details</th>
7515 </tr>
7516 <tr class="entry_cont">
7517 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7518 <p>The entries in the result metadata buffers for a
7519single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7520FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7521requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
7522always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
7523before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
7524in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
7525capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
7526only 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]7527 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7528 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7529
7530
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7531 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7532 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7533
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7534
7535
7536 <!-- end of kind -->
7537 </tbody>
7538
7539 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7540 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7541
7542
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7543 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7544
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7545 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7546 <tr>
7547 <th class="th_name">Property Name</th>
7548 <th class="th_type">Type</th>
7549 <th class="th_description">Description</th>
7550 <th class="th_units">Units</th>
7551 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7552 <th class="th_tags">Tags</th>
7553 </tr>
7554 </thead>
7555
7556 <tbody>
7557
7558
7559
7560
7561
7562
7563
7564
7565
7566
7567 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7568 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7569 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7570 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7571 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7572 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7573
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7574 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7575
7576
7577 </td> <!-- entry_type -->
7578
7579 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7580 <p>A frame counter set by the framework.<wbr/> Must
7581be maintained unchanged in output frame.<wbr/> This value monotonically
7582increases with every new result (that is,<wbr/> each new result has a unique
7583frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7584 </td>
7585
7586 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7587 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7588 </td>
7589
7590 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7591 Any int
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7592 </td>
7593
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7594 <td class="entry_tags">
7595 </td>
7596
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7597 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7598
7599
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7600 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7601 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7602
7603
7604 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7605 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7606 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7607 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7608 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7609 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7610
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7611 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7612
7613
7614 </td> <!-- entry_type -->
7615
7616 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7617 <p>An application-specified ID for the current
7618request.<wbr/> Must be maintained unchanged in output
7619frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7620 </td>
7621
7622 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7623 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7624 </td>
7625
7626 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7627 Any int
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7628 </td>
7629
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7630 <td class="entry_tags">
7631 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7632 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7633 </ul>
7634 </td>
7635
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7636 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7637
7638
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7639 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7640 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7641
7642
7643 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7644 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7645 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7646 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7647 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7648 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7649 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7650
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7651 <span class="entry_type_array">
7652 n
7653 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7654 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7655
7656
7657 </td> <!-- entry_type -->
7658
7659 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7660 <p>List which camera reprocess stream is used
7661for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7662 </td>
7663
7664 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7665 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7666 </td>
7667
7668 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7669 Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
7670 reprocess stream ID.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7671
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7672 If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7673 reprocess streams may be included in a single request; they
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7674 must be different scaled versions of the same image.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7675 </td>
7676
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7677 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7678 <ul class="entry_tags">
7679 <li><a href="#tag_HAL2">HAL2</a></li>
7680 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7681 </td>
7682
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7683 </tr>
7684 <tr class="entries_header">
7685 <th class="th_details" colspan="5">Details</th>
7686 </tr>
7687 <tr class="entry_cont">
7688 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7689 <p>Only meaningful when android.<wbr/>request.<wbr/>type ==
7690REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7691 </td>
7692 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7693
7694
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7695 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7696 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7697
7698
7699 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7700 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7701 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7702 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7703 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7704 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7705
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7706 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7707
7708 <ul class="entry_type_enum">
7709 <li>
7710 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7711 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
7712 for application-bound buffer data.<wbr/> If no
7713 application-bound streams exist,<wbr/> no frame should be
7714 placed in the output frame queue.<wbr/> If such streams
7715 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7716 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7717 information.<wbr/> Timestamp information should still be
7718 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7719 </li>
7720 <li>
7721 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7722 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7723 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7724 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7725 </li>
7726 </ul>
7727
7728 </td> <!-- entry_type -->
7729
7730 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7731 <p>How much metadata to produce on
7732output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7733 </td>
7734
7735 <td class="entry_units">
7736 </td>
7737
7738 <td class="entry_range">
7739 </td>
7740
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7741 <td class="entry_tags">
7742 </td>
7743
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7744 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7745
7746
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7747 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7748 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7749
7750
7751 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7752 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7753 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7754 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7755 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7756 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7757 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7758
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7759 <span class="entry_type_array">
7760 n
7761 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7762 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7763
7764
7765 </td> <!-- entry_type -->
7766
7767 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7768 <p>Lists which camera output streams image data
7769from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7770 </td>
7771
7772 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7773 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7774 </td>
7775
7776 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7777 List must only include streams that have been
7778 created
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7779 </td>
7780
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7781 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7782 <ul class="entry_tags">
7783 <li><a href="#tag_HAL2">HAL2</a></li>
7784 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7785 </td>
7786
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7787 </tr>
7788 <tr class="entries_header">
7789 <th class="th_details" colspan="5">Details</th>
7790 </tr>
7791 <tr class="entry_cont">
7792 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7793 <p>If no output streams are listed,<wbr/> then the image
7794data should simply be discarded.<wbr/> The image data must
7795still be captured for metadata and statistics production,<wbr/>
7796and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7797 </td>
7798 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7799
7800
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7801 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7802 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7803
7804
7805 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7806 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7807 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7808 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7809 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7810 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7811
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7812 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7813
7814 <ul class="entry_type_enum">
7815 <li>
7816 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7817 <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]7818 and process it according to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7819 settings</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7820 </li>
7821 <li>
7822 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7823 <span class="entry_type_enum_notes">Process previously captured data; the
7824 android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
7825 source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
7826 needed for reprocessing with [RP]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7827 </li>
7828 </ul>
7829
7830 </td> <!-- entry_type -->
7831
7832 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7833 <p>The type of the request; either CAPTURE or
7834REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7835 </td>
7836
7837 <td class="entry_units">
7838 </td>
7839
7840 <td class="entry_range">
7841 </td>
7842
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7843 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7844 <ul class="entry_tags">
7845 <li><a href="#tag_HAL2">HAL2</a></li>
7846 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7847 </td>
7848
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7849 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7850
7851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7852 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7853 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7854
7855
7856
7857 <!-- end of kind -->
7858 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7859 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7860
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7861 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7862 <tr>
7863 <th class="th_name">Property Name</th>
7864 <th class="th_type">Type</th>
7865 <th class="th_description">Description</th>
7866 <th class="th_units">Units</th>
7867 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7868 <th class="th_tags">Tags</th>
7869 </tr>
7870 </thead>
7871
7872 <tbody>
7873
7874
7875
7876
7877
7878
7879
7880
7881
7882
7883 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7884 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7885 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7886 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7887 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7888 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7889 <span class="entry_type_container">x</span>
7890
7891 <span class="entry_type_array">
7892 3
7893 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7894 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7895
7896
7897 </td> <!-- entry_type -->
7898
7899 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7900 <p>How many output streams can be allocated at
7901the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7902 </td>
7903
7904 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7905 The number of raw sensor streams; the number of
7906 processed,<wbr/> uncompressed streams; and the number of
7907 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7908 </td>
7909
7910 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7911 &gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
7912 for processed,<wbr/> uncompressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7913 </td>
7914
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7915 <td class="entry_tags">
7916 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7917 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7918 </ul>
7919 </td>
7920
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7921 </tr>
7922 <tr class="entries_header">
7923 <th class="th_details" colspan="5">Details</th>
7924 </tr>
7925 <tr class="entry_cont">
7926 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7927 <p>Video snapshot with preview callbacks requires 3
7928processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
7929one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7930 </td>
7931 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7932
7933
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7934 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7935 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7936
7937
7938 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7939 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7940 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7941 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7942 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7943 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7944 <span class="entry_type_container">x</span>
7945
7946 <span class="entry_type_array">
7947 1
7948 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7949 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7950
7951
7952 </td> <!-- entry_type -->
7953
7954 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7955 <p>How many reprocessing streams of any type
7956can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7957 </td>
7958
7959 <td class="entry_units">
7960 </td>
7961
7962 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]7963 &gt;= 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7964 </td>
7965
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7966 <td class="entry_tags">
7967 </td>
7968
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7969 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7970
7971
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7972 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7973 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7974
7975
7976
7977 <!-- end of kind -->
7978 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7979 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7980
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7981 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7982 <tr>
7983 <th class="th_name">Property Name</th>
7984 <th class="th_type">Type</th>
7985 <th class="th_description">Description</th>
7986 <th class="th_units">Units</th>
7987 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7988 <th class="th_tags">Tags</th>
7989 </tr>
7990 </thead>
7991
7992 <tbody>
7993
7994
7995
7996
7997
7998
7999
8000
8001
8002
8003 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8004 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8005 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8006 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8007 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8008 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8009
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8010 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8011
8012
8013 </td> <!-- entry_type -->
8014
8015 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8016 <p>A frame counter set by the framework.<wbr/> This value monotonically
8017increases with every new result (that is,<wbr/> each new result has a unique
8018frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8019 </td>
8020
8021 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8022 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8023 </td>
8024
8025 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8026 &gt; 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8027 </td>
8028
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8029 <td class="entry_tags">
8030 </td>
8031
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8032 </tr>
8033 <tr class="entries_header">
8034 <th class="th_details" colspan="5">Details</th>
8035 </tr>
8036 <tr class="entry_cont">
8037 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8038 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8039 </td>
8040 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8041
8042
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8043 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8044 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8045
8046
8047 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8048 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8049 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8050 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8051 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8052 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8053
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8054 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8055
8056
8057 </td> <!-- entry_type -->
8058
8059 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8060 <p>An application-specified ID for the current
8061request.<wbr/> Must be maintained unchanged in output
8062frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8063 </td>
8064
8065 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8066 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8067 </td>
8068
8069 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8070 Any int
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8071 </td>
8072
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8073 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8074 <ul class="entry_tags">
8075 <li><a href="#tag_V1">V1</a></li>
8076 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8077 </td>
8078
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8079 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8080
8081
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8082 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8083 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8084
8085
8086 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8087 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8088 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8089 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8090 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8091 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8092
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8093 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8094
8095 <ul class="entry_type_enum">
8096 <li>
8097 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8098 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
8099 for application-bound buffer data.<wbr/> If no
8100 application-bound streams exist,<wbr/> no frame should be
8101 placed in the output frame queue.<wbr/> If such streams
8102 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8103 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8104 information.<wbr/> Timestamp information should still be
8105 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8106 </li>
8107 <li>
8108 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8109 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8110 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8111 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8112 </li>
8113 </ul>
8114
8115 </td> <!-- entry_type -->
8116
8117 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8118 <p>How much metadata to produce on
8119output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8120 </td>
8121
8122 <td class="entry_units">
8123 </td>
8124
8125 <td class="entry_range">
8126 </td>
8127
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8128 <td class="entry_tags">
8129 </td>
8130
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8131 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8132
8133
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8134 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8135 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8136
8137
8138 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8139 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8140 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8141 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8142 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8143 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8144 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8145
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8146 <span class="entry_type_array">
8147 n
8148 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8149 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8150
8151
8152 </td> <!-- entry_type -->
8153
8154 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8155 <p>Lists which camera output streams image data
8156from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8157 </td>
8158
8159 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8160 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8161 </td>
8162
8163 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8164 List must only include streams that have been
8165 created
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8166 </td>
8167
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8168 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8169 <ul class="entry_tags">
8170 <li><a href="#tag_HAL2">HAL2</a></li>
8171 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8172 </td>
8173
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8174 </tr>
8175 <tr class="entries_header">
8176 <th class="th_details" colspan="5">Details</th>
8177 </tr>
8178 <tr class="entry_cont">
8179 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8180 <p>If no output streams are listed,<wbr/> then the image
8181data should simply be discarded.<wbr/> The image data must
8182still be captured for metadata and statistics production,<wbr/>
8183and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8184 </td>
8185 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8186
8187
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8188 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8189 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8190
8191
8192
8193 <!-- end of kind -->
8194 </tbody>
8195
8196 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8197 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8198
8199
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8200 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8201
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8202 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8203 <tr>
8204 <th class="th_name">Property Name</th>
8205 <th class="th_type">Type</th>
8206 <th class="th_description">Description</th>
8207 <th class="th_units">Units</th>
8208 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8209 <th class="th_tags">Tags</th>
8210 </tr>
8211 </thead>
8212
8213 <tbody>
8214
8215
8216
8217
8218
8219
8220
8221
8222
8223
8224 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8225 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8226 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8227 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8228 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8229 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8230 <span class="entry_type_container">x</span>
8231
8232 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8233 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8234 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8235 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8236
8237
8238 </td> <!-- entry_type -->
8239
8240 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8241 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8242<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8243(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8244output.<wbr/> Each stream must use this rectangle to produce its
8245output,<wbr/> cropping to a smaller region if necessary to
8246maintain the stream's aspect ratio.<wbr/></p>
8247<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8248 </td>
8249
8250 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8251 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8252 in pixels; (0,<wbr/>0) is top-left corner of
8253 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8254 </td>
8255
8256 <td class="entry_range">
8257 </td>
8258
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8259 <td class="entry_tags">
8260 <ul class="entry_tags">
8261 <li><a href="#tag_BC">BC</a></li>
8262 </ul>
8263 </td>
8264
8265 </tr>
8266 <tr class="entries_header">
8267 <th class="th_details" colspan="5">Details</th>
8268 </tr>
8269 <tr class="entry_cont">
8270 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8271 <p>Any additional per-stream cropping must be done to
8272maximize the final pixel area of the stream.<wbr/></p>
8273<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8274ratio,<wbr/> then 4:3 streams should use the exact crop
8275region.<wbr/> 16:9 streams should further crop vertically
8276(letterbox).<wbr/></p>
8277<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8278outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8279streams should match exactly.<wbr/> These additional crops must
8280be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8281<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8282times,<wbr/> no matter what the relative aspect ratios of the
8283crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8284corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8285larger than active pixel array.<wbr/> Width and height may be
8286rounded to nearest larger supportable width,<wbr/> especially
8287for raw output,<wbr/> where only a few fixed scales may be
8288possible.<wbr/> The width and height of the crop region cannot
8289be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8290android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8291activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8292respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8293 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8294 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8295
8296
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8297 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8298 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8299
8300
8301
8302 <!-- end of kind -->
8303 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8304 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8305
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8306 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8307 <tr>
8308 <th class="th_name">Property Name</th>
8309 <th class="th_type">Type</th>
8310 <th class="th_description">Description</th>
8311 <th class="th_units">Units</th>
8312 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8313 <th class="th_tags">Tags</th>
8314 </tr>
8315 </thead>
8316
8317 <tbody>
8318
8319
8320
8321
8322
8323
8324
8325
8326
8327
8328 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8329 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8330 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8331 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8332 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8333 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8334 <span class="entry_type_container">x</span>
8335
8336 <span class="entry_type_array">
8337 n
8338 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]8339 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8340 <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]8341
8342 <ul class="entry_type_enum">
8343 <li>
8344 <span class="entry_type_enum_name">RAW_SENSOR</span>
8345 <span class="entry_type_enum_value">0x20</span>
8346 </li>
8347 <li>
8348 <span class="entry_type_enum_name">YV12</span>
8349 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8350 <span class="entry_type_enum_notes">YCrCb 4:2:0 Planar</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8351 </li>
8352 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8353 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8354 <span class="entry_type_enum_value">0x11</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8355 <span class="entry_type_enum_notes">NV21</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8356 </li>
8357 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8358 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
8359 <span class="entry_type_enum_value">0x22</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8360 <span class="entry_type_enum_notes">Hal Implementation Defined</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8361 </li>
8362 <li>
8363 <span class="entry_type_enum_name">YCbCr_420_888</span>
8364 <span class="entry_type_enum_value">0x23</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8365 <span class="entry_type_enum_notes">Flexible YUV420 Format</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8366 </li>
8367 <li>
8368 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8369 <span class="entry_type_enum_value">0x21</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8370 <span class="entry_type_enum_notes">JPEG</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8371 </li>
8372 </ul>
8373
8374 </td> <!-- entry_type -->
8375
8376 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8377 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8378 </td>
8379
8380 <td class="entry_units">
8381 </td>
8382
8383 <td class="entry_range">
8384 </td>
8385
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8386 <td class="entry_tags">
8387 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8388 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8389 </ul>
8390 </td>
8391
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8392 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8393
8394
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8395 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8396 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8397
8398
8399 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8400 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8401 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8402 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8403 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8404 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8405 <span class="entry_type_container">x</span>
8406
8407 <span class="entry_type_array">
8408 n
8409 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8410 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8411
8412
8413 </td> <!-- entry_type -->
8414
8415 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8416 <p>The minimum frame duration that is supported
8417for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8418correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8419stream is active and captured in a burst,<wbr/> with all
8420processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8421 </td>
8422
8423 <td class="entry_units">
8424 </td>
8425
8426 <td class="entry_range">
8427 </td>
8428
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8429 <td class="entry_tags">
8430 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8431 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8432 </ul>
8433 </td>
8434
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8435 </tr>
8436 <tr class="entries_header">
8437 <th class="th_details" colspan="5">Details</th>
8438 </tr>
8439 <tr class="entry_cont">
8440 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8441 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8442frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8443durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8444 </td>
8445 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8446
8447
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8448 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8449 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8450
8451
8452 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8453 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8454 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8455 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8456 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8457 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8458 <span class="entry_type_container">x</span>
8459
8460 <span class="entry_type_array">
8461 n x 2
8462 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8463 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8464
8465
8466 </td> <!-- entry_type -->
8467
8468 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8469 <p>The resolutions available for output from
8470the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8471 </td>
8472
8473 <td class="entry_units">
8474 </td>
8475
8476 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8477 Must include: - sensor maximum resolution Should
8478 include: - half/<wbr/>quarter max resolution
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8479 </td>
8480
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8481 <td class="entry_tags">
8482 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8483 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8484 </ul>
8485 </td>
8486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8487 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8488
8489
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8490 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8491 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8492
8493
8494 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8495 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8496 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8497 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8498 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8499 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8500
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8501 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8502
8503
8504 </td> <!-- entry_type -->
8505
8506 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8507 <p>The maximum ratio between active area width
8508and crop region width,<wbr/> or between active area height and
8509crop region height,<wbr/> if the crop region height is larger
8510than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8511 </td>
8512
8513 <td class="entry_units">
8514 </td>
8515
8516 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8517 &gt;=1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8518 </td>
8519
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8520 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8521 <ul class="entry_tags">
8522 <li><a href="#tag_BC">BC</a></li>
8523 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8524 </td>
8525
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8526 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8527
8528
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8529 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8530 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8531
8532
8533 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8534 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8535 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8536 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8537 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8538 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8539 <span class="entry_type_container">x</span>
8540
8541 <span class="entry_type_array">
8542 n
8543 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8544 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8545
8546
8547 </td> <!-- entry_type -->
8548
8549 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8550 <p>The minimum frame duration that is supported
8551for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8552correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8553stream is active,<wbr/> with all processing set to
8554FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8555 </td>
8556
8557 <td class="entry_units">
8558 </td>
8559
8560 <td class="entry_range">
8561 </td>
8562
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8563 <td class="entry_tags">
8564 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8565 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8566 </ul>
8567 </td>
8568
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8569 </tr>
8570 <tr class="entries_header">
8571 <th class="th_details" colspan="5">Details</th>
8572 </tr>
8573 <tr class="entry_cont">
8574 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8575 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8576frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8577durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8578 </td>
8579 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8580
8581
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8582 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8583 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8584
8585
8586 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8587 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8588 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8589 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8590 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8591 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8592 <span class="entry_type_container">x</span>
8593
8594 <span class="entry_type_array">
8595 n x 2
8596 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8597 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8598
8599
8600 </td> <!-- entry_type -->
8601
8602 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8603 <p>The resolutions available for use with
8604processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
8605platform opaque YUV/<wbr/>RGB streams to the GPU or video
8606encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8607 </td>
8608
8609 <td class="entry_units">
8610 </td>
8611
8612 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8613 Must include: - sensor maximum resolution -
8614 standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
8615 resolutions
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8616 </td>
8617
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8618 <td class="entry_tags">
8619 <ul class="entry_tags">
8620 <li><a href="#tag_BC">BC</a></li>
8621 </ul>
8622 </td>
8623
8624 </tr>
8625 <tr class="entries_header">
8626 <th class="th_details" colspan="5">Details</th>
8627 </tr>
8628 <tr class="entry_cont">
8629 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8630 <p>The actual supported resolution list may be limited by
8631consumer end points for different use cases.<wbr/> For example,<wbr/> for
8632recording use case,<wbr/> the largest supported resolution may be
8633limited by max supported size from encoder,<wbr/> for preview use
8634case,<wbr/> the largest supported resolution may be limited by max
8635resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8636 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8637 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8638
8639
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8640 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8641 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8642
8643
8644 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8645 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8646 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8647 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8648 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8649 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8650 <span class="entry_type_container">x</span>
8651
8652 <span class="entry_type_array">
8653 n
8654 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8655 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8656
8657
8658 </td> <!-- entry_type -->
8659
8660 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8661 <p>The minimum frame duration that is supported
8662for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8663correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8664is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8665 </td>
8666
8667 <td class="entry_units">
8668 </td>
8669
8670 <td class="entry_range">
8671 </td>
8672
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8673 <td class="entry_tags">
8674 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8675 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8676 </ul>
8677 </td>
8678
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8679 </tr>
8680 <tr class="entries_header">
8681 <th class="th_details" colspan="5">Details</th>
8682 </tr>
8683 <tr class="entry_cont">
8684 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8685 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8686frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8687durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8688 </td>
8689 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8690
8691
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8692 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8693 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8694
8695
8696 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8697 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8698 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8699 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8700 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8701 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8702 <span class="entry_type_container">x</span>
8703
8704 <span class="entry_type_array">
8705 n x 2
8706 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8707 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8708
8709
8710 </td> <!-- entry_type -->
8711
8712 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8713 <p>The resolutions available for use with raw
8714sensor output streams,<wbr/> listed as width,<wbr/>
8715height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8716 </td>
8717
8718 <td class="entry_units">
8719 </td>
8720
8721 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8722 Must include: - sensor maximum resolution
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8723 </td>
8724
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8725 <td class="entry_tags">
8726 </td>
8727
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8728 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8729
8730
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8731 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8732 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8733
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8734
8735
8736 <!-- end of kind -->
8737 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8738 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8739
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8740 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8741 <tr>
8742 <th class="th_name">Property Name</th>
8743 <th class="th_type">Type</th>
8744 <th class="th_description">Description</th>
8745 <th class="th_units">Units</th>
8746 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8747 <th class="th_tags">Tags</th>
8748 </tr>
8749 </thead>
8750
8751 <tbody>
8752
8753
8754
8755
8756
8757
8758
8759
8760
8761
8762 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8763 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8764 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8765 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8766 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8767 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8768 <span class="entry_type_container">x</span>
8769
8770 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8771 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8772 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8773 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8774
8775
8776 </td> <!-- entry_type -->
8777
8778 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8779 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8780<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8781(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8782output.<wbr/> Each stream must use this rectangle to produce its
8783output,<wbr/> cropping to a smaller region if necessary to
8784maintain the stream's aspect ratio.<wbr/></p>
8785<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8786 </td>
8787
8788 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8789 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8790 in pixels; (0,<wbr/>0) is top-left corner of
8791 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8792 </td>
8793
8794 <td class="entry_range">
8795 </td>
8796
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8797 <td class="entry_tags">
8798 <ul class="entry_tags">
8799 <li><a href="#tag_BC">BC</a></li>
8800 </ul>
8801 </td>
8802
8803 </tr>
8804 <tr class="entries_header">
8805 <th class="th_details" colspan="5">Details</th>
8806 </tr>
8807 <tr class="entry_cont">
8808 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8809 <p>Any additional per-stream cropping must be done to
8810maximize the final pixel area of the stream.<wbr/></p>
8811<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8812ratio,<wbr/> then 4:3 streams should use the exact crop
8813region.<wbr/> 16:9 streams should further crop vertically
8814(letterbox).<wbr/></p>
8815<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8816outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8817streams should match exactly.<wbr/> These additional crops must
8818be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8819<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8820times,<wbr/> no matter what the relative aspect ratios of the
8821crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8822corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8823larger than active pixel array.<wbr/> Width and height may be
8824rounded to nearest larger supportable width,<wbr/> especially
8825for raw output,<wbr/> where only a few fixed scales may be
8826possible.<wbr/> The width and height of the crop region cannot
8827be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8828android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8829activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8830respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8831 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8832 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8833
8834
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8835 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8836 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8837
8838
8839
8840 <!-- end of kind -->
8841 </tbody>
8842
8843 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8844 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8845
8846
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8847 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8848
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8849 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8850 <tr>
8851 <th class="th_name">Property Name</th>
8852 <th class="th_type">Type</th>
8853 <th class="th_description">Description</th>
8854 <th class="th_units">Units</th>
8855 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8856 <th class="th_tags">Tags</th>
8857 </tr>
8858 </thead>
8859
8860 <tbody>
8861
8862
8863
8864
8865
8866
8867
8868
8869
8870
8871 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8872 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8873 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8874 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8875 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8876 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8877
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8878 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8879
8880
8881 </td> <!-- entry_type -->
8882
8883 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8884 <p>Duration each pixel is exposed to
8885light.<wbr/></p>
8886<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
8887duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8888 </td>
8889
8890 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8891 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8892 </td>
8893
8894 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8895 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8896 </td>
8897
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8898 <td class="entry_tags">
8899 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8900 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8901 </ul>
8902 </td>
8903
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8904 </tr>
8905 <tr class="entries_header">
8906 <th class="th_details" colspan="5">Details</th>
8907 </tr>
8908 <tr class="entry_cont">
8909 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8910 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8911 </td>
8912 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8913
8914
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8915 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8916 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8917
8918
8919 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8920 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8921 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8922 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8923 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8924 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8925
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8926 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8927
8928
8929 </td> <!-- entry_type -->
8930
8931 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8932 <p>Duration from start of frame exposure to
8933start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8934 </td>
8935
8936 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8937 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8938 </td>
8939
8940 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8941 see android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration,<wbr/>
8942 android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8943 </td>
8944
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8945 <td class="entry_tags">
8946 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8947 <li><a href="#tag_V1">V1</a></li>
8948 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8949 </ul>
8950 </td>
8951
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8952 </tr>
8953 <tr class="entries_header">
8954 <th class="th_details" colspan="5">Details</th>
8955 </tr>
8956 <tr class="entry_cont">
8957 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8958 <p>Exposure time has priority,<wbr/> so duration is set to
8959max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8960 </td>
8961 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8962
8963
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8964 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8965 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8966
8967
8968 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8969 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8970 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8971 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8972 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8973 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8974
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8975 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8976
8977
8978 </td> <!-- entry_type -->
8979
8980 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8981 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8982implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8983below 'maximum analog sensitivity'.<wbr/></p>
8984<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
8985gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8986 </td>
8987
8988 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8989 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8990 </td>
8991
8992 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]8993 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8994 </td>
8995
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8996 <td class="entry_tags">
8997 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8998 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8999 </ul>
9000 </td>
9001
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9002 </tr>
9003 <tr class="entries_header">
9004 <th class="th_details" colspan="5">Details</th>
9005 </tr>
9006 <tr class="entry_cont">
9007 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9008 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9009 </td>
9010 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9011
9012
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9013 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9014 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9015
9016
9017
9018 <!-- end of kind -->
9019 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9020 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9021
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9022 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9023 <tr>
9024 <th class="th_name">Property Name</th>
9025 <th class="th_type">Type</th>
9026 <th class="th_description">Description</th>
9027 <th class="th_units">Units</th>
9028 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9029 <th class="th_tags">Tags</th>
9030 </tr>
9031 </thead>
9032
9033 <tbody>
9034
9035
9036
9037
9038
9039
9040
9041
9042
9043
9044
9045
9046 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9047 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9048 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9049 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9050 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9051 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9052 <span class="entry_type_container">x</span>
9053
9054 <span class="entry_type_array">
9055 4
9056 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9057 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9058 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9059
9060
9061 </td> <!-- entry_type -->
9062
9063 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9064 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9065active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9066pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9067 </td>
9068
9069 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9070 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9071 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9072 </td>
9073
9074 <td class="entry_range">
9075 </td>
9076
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9077 <td class="entry_tags">
9078 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9079 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9080 </ul>
9081 </td>
9082
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9083 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9084
9085
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9086 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9087 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9088
9089
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9090 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9091 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9092 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9093 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9094 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9095 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9096 <span class="entry_type_container">x</span>
9097
9098 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9099 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9100 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9101 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9102 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9103
9104
9105 </td> <!-- entry_type -->
9106
9107 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9108 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9109 </td>
9110
9111 <td class="entry_units">
9112 </td>
9113
9114 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9115 Min &lt;= 100,<wbr/> Max &gt;= 1600
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9116 </td>
9117
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9118 <td class="entry_tags">
9119 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9120 <li><a href="#tag_BC">BC</a></li>
9121 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9122 </ul>
9123 </td>
9124
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9125 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9126
9127
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9128 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9129 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9130
9131
9132 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9133 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9134 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9135 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9136 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9137 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9138
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9139 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9140
9141 <ul class="entry_type_enum">
9142 <li>
9143 <span class="entry_type_enum_name">RGGB</span>
9144 </li>
9145 <li>
9146 <span class="entry_type_enum_name">GRBG</span>
9147 </li>
9148 <li>
9149 <span class="entry_type_enum_name">GBRG</span>
9150 </li>
9151 <li>
9152 <span class="entry_type_enum_name">BGGR</span>
9153 </li>
9154 <li>
9155 <span class="entry_type_enum_name">RGB</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9156 <span class="entry_type_enum_notes">Sensor is not Bayer; output has 3 16-bit
9157 values for each pixel,<wbr/> instead of just 1 16-bit value
9158 per pixel.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9159 </li>
9160 </ul>
9161
9162 </td> <!-- entry_type -->
9163
9164 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9165 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9166represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9167the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9168 </td>
9169
9170 <td class="entry_units">
9171 </td>
9172
9173 <td class="entry_range">
9174 </td>
9175
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9176 <td class="entry_tags">
9177 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9178 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9179 </ul>
9180 </td>
9181
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9182 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9183
9184
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9185 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9186 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9187
9188
9189 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9190 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9191 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9192 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9193 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9194 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9195 <span class="entry_type_container">x</span>
9196
9197 <span class="entry_type_array">
9198 2
9199 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9200 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9201 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9202
9203
9204 </td> <!-- entry_type -->
9205
9206 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9207 <p>Range of valid exposure
9208times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9209 </td>
9210
9211 <td class="entry_units">
9212 </td>
9213
9214 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9215 Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
9216 sec)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9217 </td>
9218
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9219 <td class="entry_tags">
9220 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9221 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9222 </ul>
9223 </td>
9224
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9225 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9226
9227
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9228 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9229 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9230
9231
9232 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9233 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9234 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9235 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9236 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9237 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9238
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9239 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9240
9241
9242 </td> <!-- entry_type -->
9243
9244 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9245 <p>Maximum possible frame duration (minimum frame
9246rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9247 </td>
9248
9249 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9250 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9251 </td>
9252
9253 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9254 &gt;= 30e9
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9255 </td>
9256
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9257 <td class="entry_tags">
9258 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9259 <li><a href="#tag_BC">BC</a></li>
9260 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9261 </ul>
9262 </td>
9263
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9264 </tr>
9265 <tr class="entries_header">
9266 <th class="th_details" colspan="5">Details</th>
9267 </tr>
9268 <tr class="entry_cont">
9269 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9270 <p>Minimum duration is a function of resolution,<wbr/>
9271processing settings.<wbr/> See
9272android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
9273android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
9274android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9275 </td>
9276 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9277
9278
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9279 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9280 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9281
9282
9283 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9284 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9285 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9286 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9287 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9288 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9289 <span class="entry_type_container">x</span>
9290
9291 <span class="entry_type_array">
9292 2
9293 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]9294 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9295 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9296
9297
9298 </td> <!-- entry_type -->
9299
9300 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9301 <p>The physical dimensions of the full pixel
9302array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9303 </td>
9304
9305 <td class="entry_units">
9306 </td>
9307
9308 <td class="entry_range">
9309 </td>
9310
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9311 <td class="entry_tags">
9312 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9313 <li><a href="#tag_V1">V1</a></li>
9314 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9315 </ul>
9316 </td>
9317
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9318 </tr>
9319 <tr class="entries_header">
9320 <th class="th_details" colspan="5">Details</th>
9321 </tr>
9322 <tr class="entry_cont">
9323 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9324 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9325 </td>
9326 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9327
9328
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9329 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9330 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9331
9332
9333 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9334 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9335 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9336 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9337 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9338 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9339 <span class="entry_type_container">x</span>
9340
9341 <span class="entry_type_array">
9342 2
9343 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9344 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9345
9346
9347 </td> <!-- entry_type -->
9348
9349 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9350 <p>Dimensions of full pixel array,<wbr/> possibly
9351including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9352 </td>
9353
9354 <td class="entry_units">
9355 </td>
9356
9357 <td class="entry_range">
9358 </td>
9359
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9360 <td class="entry_tags">
9361 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9362 <li><a href="#tag_DNG">DNG</a></li>
9363 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9364 </ul>
9365 </td>
9366
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9367 </tr>
9368 <tr class="entries_header">
9369 <th class="th_details" colspan="5">Details</th>
9370 </tr>
9371 <tr class="entry_cont">
9372 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9373 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9374match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9375android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9376 </td>
9377 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9378
9379
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9380 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9381 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9382
9383
9384 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9385 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9386 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9387 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9388 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9389 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9390
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9391 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9392
9393
9394 </td> <!-- entry_type -->
9395
9396 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9397 <p>Maximum raw value output by
9398sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9399 </td>
9400
9401 <td class="entry_units">
9402 </td>
9403
9404 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9405 &gt; 1024 (10-bit output)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9406 </td>
9407
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9408 <td class="entry_tags">
9409 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9410 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9411 </ul>
9412 </td>
9413
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9414 </tr>
9415 <tr class="entries_header">
9416 <th class="th_details" colspan="5">Details</th>
9417 </tr>
9418 <tr class="entry_cont">
9419 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9420 <p>Defines sensor bit depth (10-14 bits is
9421expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9422 </td>
9423 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9424
9425
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9426 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9427 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9428
9429
9430
9431
9432
9433 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9434 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9435 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9436 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9437 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9438 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9439
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9440 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9441
9442
9443 </td> <!-- entry_type -->
9444
9445 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9446 <p>Gain factor from electrons to raw units when
9447ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9448 </td>
9449
9450 <td class="entry_units">
9451 </td>
9452
9453 <td class="entry_range">
9454 </td>
9455
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9456 <td class="entry_tags">
9457 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9458 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9459 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9460 </ul>
9461 </td>
9462
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9463 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9464
9465
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9466 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9467 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9468
9469
9470 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9471 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9472 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9473 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9474 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9475 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9476 <span class="entry_type_container">x</span>
9477
9478 <span class="entry_type_array">
9479 4
9480 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9481 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9482 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9483
9484
9485 </td> <!-- entry_type -->
9486
9487 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9488 <p>A fixed black level offset for each of the
9489Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9490 </td>
9491
9492 <td class="entry_units">
9493 </td>
9494
9495 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9496 &gt;= 0 each
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9497 </td>
9498
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9499 <td class="entry_tags">
9500 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9501 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9502 </ul>
9503 </td>
9504
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9505 </tr>
9506 <tr class="entries_header">
9507 <th class="th_details" colspan="5">Details</th>
9508 </tr>
9509 <tr class="entry_cont">
9510 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9511 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
9512tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9513 </td>
9514 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9515
9516
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9517 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9518 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9519
9520
9521 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9522 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9523 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9524 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9525 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9526 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9527 <span class="entry_type_container">x</span>
9528
9529 <span class="entry_type_array">
9530 9
9531 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9532 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9533 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9534
9535
9536 </td> <!-- entry_type -->
9537
9538 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9539 <p>Per-device calibration on top of color space
9540transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9541 </td>
9542
9543 <td class="entry_units">
9544 </td>
9545
9546 <td class="entry_range">
9547 </td>
9548
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9549 <td class="entry_tags">
9550 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9551 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9552 </ul>
9553 </td>
9554
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9555 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9556
9557
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9558 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9559 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9560
9561
9562 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9563 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9564 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9565 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9566 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9567 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9568 <span class="entry_type_container">x</span>
9569
9570 <span class="entry_type_array">
9571 9
9572 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9573 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9574 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9575
9576
9577 </td> <!-- entry_type -->
9578
9579 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9580 <p>Per-device calibration on top of color space
9581transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9582 </td>
9583
9584 <td class="entry_units">
9585 </td>
9586
9587 <td class="entry_range">
9588 </td>
9589
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9590 <td class="entry_tags">
9591 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9592 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9593 </ul>
9594 </td>
9595
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9596 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9597
9598
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9599 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9600 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9601
9602
9603 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9604 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9605 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9606 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9607 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9608 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9609 <span class="entry_type_container">x</span>
9610
9611 <span class="entry_type_array">
9612 9
9613 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9614 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9615 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9616
9617
9618 </td> <!-- entry_type -->
9619
9620 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9621 <p>Linear mapping from XYZ (D50) color space to
9622reference linear sensor color,<wbr/> for first reference
9623illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9624 </td>
9625
9626 <td class="entry_units">
9627 </td>
9628
9629 <td class="entry_range">
9630 </td>
9631
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9632 <td class="entry_tags">
9633 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9634 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9635 </ul>
9636 </td>
9637
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9638 </tr>
9639 <tr class="entries_header">
9640 <th class="th_details" colspan="5">Details</th>
9641 </tr>
9642 <tr class="entry_cont">
9643 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9644 <p>Use as follows XYZ = inv(transform) * clip( (raw -
9645black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
9646At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9647 </td>
9648 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9649
9650
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9651 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9652 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9653
9654
9655 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9656 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9657 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9658 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9659 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9660 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9661 <span class="entry_type_container">x</span>
9662
9663 <span class="entry_type_array">
9664 9
9665 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9666 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9667 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9668
9669
9670 </td> <!-- entry_type -->
9671
9672 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9673 <p>Linear mapping from XYZ (D50) color space to
9674reference linear sensor color,<wbr/> for second reference
9675illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9676 </td>
9677
9678 <td class="entry_units">
9679 </td>
9680
9681 <td class="entry_range">
9682 </td>
9683
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9684 <td class="entry_tags">
9685 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9686 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9687 </ul>
9688 </td>
9689
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9690 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9691
9692
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9693 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9694 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9695
9696
9697 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9698 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9699 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9700 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9701 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9702 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9703 <span class="entry_type_container">x</span>
9704
9705 <span class="entry_type_array">
9706 9
9707 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9708 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9709 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9710
9711
9712 </td> <!-- entry_type -->
9713
9714 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9715 <p>Used by DNG for better WB
9716adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9717 </td>
9718
9719 <td class="entry_units">
9720 </td>
9721
9722 <td class="entry_range">
9723 </td>
9724
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9725 <td class="entry_tags">
9726 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9727 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9728 </ul>
9729 </td>
9730
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9731 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9732
9733
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9734 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9735 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9736
9737
9738 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9739 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9740 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9741 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9742 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9743 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9744 <span class="entry_type_container">x</span>
9745
9746 <span class="entry_type_array">
9747 9
9748 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9749 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9750 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9751
9752
9753 </td> <!-- entry_type -->
9754
9755 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9756 <p>Used by DNG for better WB
9757adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9758 </td>
9759
9760 <td class="entry_units">
9761 </td>
9762
9763 <td class="entry_range">
9764 </td>
9765
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9766 <td class="entry_tags">
9767 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9768 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9769 </ul>
9770 </td>
9771
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9772 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9773
9774
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9775 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9776 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9777
9778
9779 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9780 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9781 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9782 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9783 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9784 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9785
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9786 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9787
9788
9789 </td> <!-- entry_type -->
9790
9791 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9792 <p>Maximum sensitivity that is implemented
9793purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9794 </td>
9795
9796 <td class="entry_units">
9797 </td>
9798
9799 <td class="entry_range">
9800 </td>
9801
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9802 <td class="entry_tags">
9803 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9804 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9805 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9806 </ul>
9807 </td>
9808
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9809 </tr>
9810 <tr class="entries_header">
9811 <th class="th_details" colspan="5">Details</th>
9812 </tr>
9813 <tr class="entry_cont">
9814 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9815 <p>For android.<wbr/>sensor.<wbr/>sensitivity values less than or
9816equal to this,<wbr/> all applied gain must be analog.<wbr/> For
9817values above this,<wbr/> it can be a mix of analog and
9818digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9819 </td>
9820 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9821
9822
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9823 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9824 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9825
9826
9827 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9828 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9829 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9830 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9831 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9832 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9833 <span class="entry_type_container">x</span>
9834
9835 <span class="entry_type_array">
9836 2
9837 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9838 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9839 <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]9840
9841
9842 </td> <!-- entry_type -->
9843
9844 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9845 <p>Estimation of sensor noise
9846characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9847 </td>
9848
9849 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9850 var(raw pixel value) = electrons * (baseGainFactor
9851 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
9852 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9853 </td>
9854
9855 <td class="entry_range">
9856 </td>
9857
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9858 <td class="entry_tags">
9859 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9860 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9861 </ul>
9862 </td>
9863
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9864 </tr>
9865 <tr class="entries_header">
9866 <th class="th_details" colspan="5">Details</th>
9867 </tr>
9868 <tr class="entry_cont">
9869 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9870 <p>A represents sensor read noise before analog
9871amplification; B represents noise from A/<wbr/>D conversion and
9872other circuits after amplification.<wbr/> Both noise sources
9873are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
9874across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9875 </td>
9876 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9877
9878
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9879 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9880 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9881
9882
9883 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9884 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9885 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9886 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9887 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9888 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9889
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9890 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9891
9892
9893 </td> <!-- entry_type -->
9894
9895 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9896 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9897image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9898screen in its native orientation.<wbr/> Also defines the
9899direction of rolling shutter readout,<wbr/> which is from top
9900to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9901 </td>
9902
9903 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9904 degrees clockwise rotation,<wbr/> only multiples of
9905 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9906 </td>
9907
9908 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9909 0,<wbr/>90,<wbr/>180,<wbr/>270
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9910 </td>
9911
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9912 <td class="entry_tags">
9913 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9914 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9915 </ul>
9916 </td>
9917
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9918 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9919
9920
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9921 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9922 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9923
9924
9925 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9926 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9927 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9928 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9929 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9930 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9931
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9932 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9933
9934 <ul class="entry_type_enum">
9935 <li>
9936 <span class="entry_type_enum_name">DAYLIGHT</span>
9937 <span class="entry_type_enum_value">1</span>
9938 </li>
9939 <li>
9940 <span class="entry_type_enum_name">FLUORESCENT</span>
9941 <span class="entry_type_enum_value">2</span>
9942 </li>
9943 <li>
9944 <span class="entry_type_enum_name">TUNGSTEN</span>
9945 <span class="entry_type_enum_value">3</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9946 <span class="entry_type_enum_notes">Incandescent light</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9947 </li>
9948 <li>
9949 <span class="entry_type_enum_name">FLASH</span>
9950 <span class="entry_type_enum_value">4</span>
9951 </li>
9952 <li>
9953 <span class="entry_type_enum_name">FINE_WEATHER</span>
9954 <span class="entry_type_enum_value">9</span>
9955 </li>
9956 <li>
9957 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
9958 <span class="entry_type_enum_value">10</span>
9959 </li>
9960 <li>
9961 <span class="entry_type_enum_name">SHADE</span>
9962 <span class="entry_type_enum_value">11</span>
9963 </li>
9964 <li>
9965 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
9966 <span class="entry_type_enum_value">12</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9967 <span class="entry_type_enum_notes">D 5700 - 7100K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9968 </li>
9969 <li>
9970 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
9971 <span class="entry_type_enum_value">13</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9972 <span class="entry_type_enum_notes">N 4600 - 5400K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9973 </li>
9974 <li>
9975 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
9976 <span class="entry_type_enum_value">14</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9977 <span class="entry_type_enum_notes">W 3900 - 4500K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9978 </li>
9979 <li>
9980 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
9981 <span class="entry_type_enum_value">15</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]9982 <span class="entry_type_enum_notes">WW 3200 - 3700K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9983 </li>
9984 <li>
9985 <span class="entry_type_enum_name">STANDARD_A</span>
9986 <span class="entry_type_enum_value">17</span>
9987 </li>
9988 <li>
9989 <span class="entry_type_enum_name">STANDARD_B</span>
9990 <span class="entry_type_enum_value">18</span>
9991 </li>
9992 <li>
9993 <span class="entry_type_enum_name">STANDARD_C</span>
9994 <span class="entry_type_enum_value">19</span>
9995 </li>
9996 <li>
9997 <span class="entry_type_enum_name">D55</span>
9998 <span class="entry_type_enum_value">20</span>
9999 </li>
10000 <li>
10001 <span class="entry_type_enum_name">D65</span>
10002 <span class="entry_type_enum_value">21</span>
10003 </li>
10004 <li>
10005 <span class="entry_type_enum_name">D75</span>
10006 <span class="entry_type_enum_value">22</span>
10007 </li>
10008 <li>
10009 <span class="entry_type_enum_name">D50</span>
10010 <span class="entry_type_enum_value">23</span>
10011 </li>
10012 <li>
10013 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10014 <span class="entry_type_enum_value">24</span>
10015 </li>
10016 </ul>
10017
10018 </td> <!-- entry_type -->
10019
10020 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10021 <p>Light source used to define transform
100221</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10023 </td>
10024
10025 <td class="entry_units">
10026 </td>
10027
10028 <td class="entry_range">
10029 </td>
10030
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10031 <td class="entry_tags">
10032 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10033 <li><a href="#tag_DNG">DNG</a></li>
10034 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10035 </ul>
10036 </td>
10037
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10038 </tr>
10039 <tr class="entries_header">
10040 <th class="th_details" colspan="5">Details</th>
10041 </tr>
10042 <tr class="entry_cont">
10043 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10044 <p>[EXIF LightSource tag] Must all these be
10045supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10046 </td>
10047 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10048
10049
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10050 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10051 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10052
10053
10054 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10055 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10056 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10057 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10058 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10059 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10060
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10061 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10062
10063
10064 </td> <!-- entry_type -->
10065
10066 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10067 <p>Light source used to define transform
100682</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10069 </td>
10070
10071 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10072 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10073 </td>
10074
10075 <td class="entry_range">
10076 </td>
10077
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10078 <td class="entry_tags">
10079 </td>
10080
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10081 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10082
10083
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10084 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10085 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10086
10087
10088
10089 <!-- end of kind -->
10090 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10091 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10092
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10093 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10094 <tr>
10095 <th class="th_name">Property Name</th>
10096 <th class="th_type">Type</th>
10097 <th class="th_description">Description</th>
10098 <th class="th_units">Units</th>
10099 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10100 <th class="th_tags">Tags</th>
10101 </tr>
10102 </thead>
10103
10104 <tbody>
10105
10106
10107
10108
10109
10110
10111
10112
10113
10114
10115 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10116 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10117 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10118 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10119 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10120 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10121
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10122 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10123
10124
10125 </td> <!-- entry_type -->
10126
10127 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10128 <p>Duration each pixel is exposed to
10129light.<wbr/></p>
10130<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
10131duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10132 </td>
10133
10134 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10135 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10136 </td>
10137
10138 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10139 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10140 </td>
10141
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10142 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10143 <ul class="entry_tags">
10144 <li><a href="#tag_V1">V1</a></li>
10145 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10146 </td>
10147
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10148 </tr>
10149 <tr class="entries_header">
10150 <th class="th_details" colspan="5">Details</th>
10151 </tr>
10152 <tr class="entry_cont">
10153 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10154 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10155 </td>
10156 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10157
10158
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10159 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10160 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10161
10162
10163 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10164 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10165 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10166 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10167 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10168 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10169
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10170 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10171
10172
10173 </td> <!-- entry_type -->
10174
10175 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10176 <p>Duration from start of frame exposure to
10177start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10178 </td>
10179
10180 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10181 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10182 </td>
10183
10184 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10185 see android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration,<wbr/>
10186 android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10187 </td>
10188
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10189 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10190 <ul class="entry_tags">
10191 <li><a href="#tag_V1">V1</a></li>
10192 <li><a href="#tag_BC">BC</a></li>
10193 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10194 </td>
10195
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10196 </tr>
10197 <tr class="entries_header">
10198 <th class="th_details" colspan="5">Details</th>
10199 </tr>
10200 <tr class="entry_cont">
10201 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10202 <p>Exposure time has priority,<wbr/> so duration is set to
10203max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10204 </td>
10205 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10206
10207
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10208 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10209 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10210
10211
10212 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10213 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10214 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10215 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10216 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10217 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10218
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10219 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10220
10221
10222 </td> <!-- entry_type -->
10223
10224 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10225 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10226implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10227below 'maximum analog sensitivity'.<wbr/></p>
10228<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10229gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10230 </td>
10231
10232 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10233 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10234 </td>
10235
10236 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10237 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10238 </td>
10239
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10240 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10241 <ul class="entry_tags">
10242 <li><a href="#tag_V1">V1</a></li>
10243 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10244 </td>
10245
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10246 </tr>
10247 <tr class="entries_header">
10248 <th class="th_details" colspan="5">Details</th>
10249 </tr>
10250 <tr class="entry_cont">
10251 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10252 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10253 </td>
10254 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10255
10256
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10257 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10258 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10259
10260
10261 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10262 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10263 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10264 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10265 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10266 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10267
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10268 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10269
10270
10271 </td> <!-- entry_type -->
10272
10273 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10274 <p>Time at start of exposure of first
10275row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10276 </td>
10277
10278 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10279 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10280 </td>
10281
10282 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10283 &gt; 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10284 </td>
10285
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10286 <td class="entry_tags">
10287 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10288 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10289 </ul>
10290 </td>
10291
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10292 </tr>
10293 <tr class="entries_header">
10294 <th class="th_details" colspan="5">Details</th>
10295 </tr>
10296 <tr class="entry_cont">
10297 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10298 <p>Monotonic,<wbr/> should be synced to other timestamps in
10299system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10300 </td>
10301 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10302
10303
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10304 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10305 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10306
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10307
10308 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10309 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10310 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10311 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10312 <td class="entry_type">
10313 <span class="entry_type_name">float</span>
10314
10315 <span class="entry_type_visibility"> [public]</span>
10316
10317
10318 </td> <!-- entry_type -->
10319
10320 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10321 <p>The temperature of the sensor,<wbr/> sampled at the time
10322exposure began for this frame.<wbr/></p>
10323<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
10324somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10325 </td>
10326
10327 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10328 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10329 </td>
10330
10331 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10332 Optional.<wbr/> This value is missing if no temperature is available.<wbr/>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10333 </td>
10334
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10335 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10336 <ul class="entry_tags">
10337 <li><a href="#tag_FULL">FULL</a></li>
10338 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10339 </td>
10340
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10341 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10342
10343
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10344 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10345 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10346
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10347
10348
10349 <!-- end of kind -->
10350 </tbody>
10351
10352 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10353 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10354
10355
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10356 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10357
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10358 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10359 <tr>
10360 <th class="th_name">Property Name</th>
10361 <th class="th_type">Type</th>
10362 <th class="th_description">Description</th>
10363 <th class="th_units">Units</th>
10364 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10365 <th class="th_tags">Tags</th>
10366 </tr>
10367 </thead>
10368
10369 <tbody>
10370
10371
10372
10373
10374
10375
10376
10377
10378
10379
10380 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10381 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10382 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10383 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10384 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10385 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10386
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10387 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10388
10389 <ul class="entry_type_enum">
10390 <li>
10391 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10392 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10393 </li>
10394 <li>
10395 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10396 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10397 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10398 </li>
10399 <li>
10400 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10401 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10402 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10403 </li>
10404 </ul>
10405
10406 </td> <!-- entry_type -->
10407
10408 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10409 <p>Quality of lens shading correction applied
10410to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10411 </td>
10412
10413 <td class="entry_units">
10414 </td>
10415
10416 <td class="entry_range">
10417 </td>
10418
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10419 <td class="entry_tags">
10420 </td>
10421
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10422 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10423
10424
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10425 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10426 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10427
10428
10429 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10430 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10431 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10432 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10433 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10434 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10435
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10436 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10437
10438
10439 </td> <!-- entry_type -->
10440
10441 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10442 <p>Control the amount of shading correction
10443applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10444 </td>
10445
10446 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10447 unitless: 1-10; 10 is full shading
10448 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]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 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10456 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10457 </ul>
10458 </td>
10459
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10460 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10461
10462
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10463 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10464 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10465
10466
10467
10468 <!-- end of kind -->
10469 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10470 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10471
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10472 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10473 <tr>
10474 <th class="th_name">Property Name</th>
10475 <th class="th_type">Type</th>
10476 <th class="th_description">Description</th>
10477 <th class="th_units">Units</th>
10478 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10479 <th class="th_tags">Tags</th>
10480 </tr>
10481 </thead>
10482
10483 <tbody>
10484
10485
10486
10487
10488
10489
10490
10491
10492
10493
10494 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10495 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10496 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10497 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10498 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10499 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10500
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10501 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10502
10503 <ul class="entry_type_enum">
10504 <li>
10505 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10506 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10507 </li>
10508 <li>
10509 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10510 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10511 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10512 </li>
10513 <li>
10514 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10515 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10516 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10517 </li>
10518 </ul>
10519
10520 </td> <!-- entry_type -->
10521
10522 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10523 <p>Quality of lens shading correction applied
10524to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10525 </td>
10526
10527 <td class="entry_units">
10528 </td>
10529
10530 <td class="entry_range">
10531 </td>
10532
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10533 <td class="entry_tags">
10534 </td>
10535
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10536 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10537
10538
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10539 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10540 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10541
10542
10543
10544 <!-- end of kind -->
10545 </tbody>
10546
10547 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10548 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10549
10550
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10551 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10552
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10553 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10554 <tr>
10555 <th class="th_name">Property Name</th>
10556 <th class="th_type">Type</th>
10557 <th class="th_description">Description</th>
10558 <th class="th_units">Units</th>
10559 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10560 <th class="th_tags">Tags</th>
10561 </tr>
10562 </thead>
10563
10564 <tbody>
10565
10566
10567
10568
10569
10570
10571
10572
10573
10574
10575 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10576 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10577 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10578 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10579 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10580 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10581
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10582 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10583
10584 <ul class="entry_type_enum">
10585 <li>
10586 <span class="entry_type_enum_name">OFF</span>
10587 </li>
10588 <li>
10589 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10590 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
10591 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10592 </li>
10593 <li>
10594 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10595 <span class="entry_type_enum_notes">Optional Return all face
10596 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10597 </li>
10598 </ul>
10599
10600 </td> <!-- entry_type -->
10601
10602 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10603 <p>State of the face detector
10604unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10605 </td>
10606
10607 <td class="entry_units">
10608 </td>
10609
10610 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10611
10612 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10613 </td>
10614
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10615 <td class="entry_tags">
10616 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10617 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10618 </ul>
10619 </td>
10620
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10621 </tr>
10622 <tr class="entries_header">
10623 <th class="th_details" colspan="5">Details</th>
10624 </tr>
10625 <tr class="entry_cont">
10626 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10627 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10628should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10629fields.<wbr/> Value must be one of the
10630android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10631 </td>
10632 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10633
10634
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10635 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10636 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10637
10638
10639 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10640 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10641 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10642 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10643 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10644 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10645
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10646 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10647
10648 <ul class="entry_type_enum">
10649 <li>
10650 <span class="entry_type_enum_name">OFF</span>
10651 </li>
10652 <li>
10653 <span class="entry_type_enum_name">ON</span>
10654 </li>
10655 </ul>
10656
10657 </td> <!-- entry_type -->
10658
10659 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10660 <p>Operating mode for histogram
10661generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10662 </td>
10663
10664 <td class="entry_units">
10665 </td>
10666
10667 <td class="entry_range">
10668 </td>
10669
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10670 <td class="entry_tags">
10671 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10672 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10673 </ul>
10674 </td>
10675
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10676 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10677
10678
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10679 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10680 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10681
10682
10683 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10684 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10685 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10686 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10687 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10688 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10689
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10690 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10691
10692 <ul class="entry_type_enum">
10693 <li>
10694 <span class="entry_type_enum_name">OFF</span>
10695 </li>
10696 <li>
10697 <span class="entry_type_enum_name">ON</span>
10698 </li>
10699 </ul>
10700
10701 </td> <!-- entry_type -->
10702
10703 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10704 <p>Operating mode for sharpness map
10705generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10706 </td>
10707
10708 <td class="entry_units">
10709 </td>
10710
10711 <td class="entry_range">
10712 </td>
10713
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10714 <td class="entry_tags">
10715 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10716 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10717 </ul>
10718 </td>
10719
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10720 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10721
10722
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10723 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10724 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10725
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10726
10727 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10728 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10729 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10730 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10731 <td class="entry_type">
10732 <span class="entry_type_name entry_type_name_enum">byte</span>
10733
10734 <span class="entry_type_visibility"> [public]</span>
10735
10736 <ul class="entry_type_enum">
10737 <li>
10738 <span class="entry_type_enum_name">OFF</span>
10739 </li>
10740 <li>
10741 <span class="entry_type_enum_name">ON</span>
10742 </li>
10743 </ul>
10744
10745 </td> <!-- entry_type -->
10746
10747 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10748 <p>Whether the HAL needs to output the lens
10749shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10750 </td>
10751
10752 <td class="entry_units">
10753 </td>
10754
10755 <td class="entry_range">
10756 </td>
10757
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10758 <td class="entry_tags">
10759 </td>
10760
10761 </tr>
10762 <tr class="entries_header">
10763 <th class="th_details" colspan="5">Details</th>
10764 </tr>
10765 <tr class="entry_cont">
10766 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10767 <p>When set to ON,<wbr/>
10768android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map must be provided in
10769the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10770 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10771 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10772
10773
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10774 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10775 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10776
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10777
10778
10779 <!-- end of kind -->
10780 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10781 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10782
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10783 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10784 <tr>
10785 <th class="th_name">Property Name</th>
10786 <th class="th_type">Type</th>
10787 <th class="th_description">Description</th>
10788 <th class="th_units">Units</th>
10789 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10790 <th class="th_tags">Tags</th>
10791 </tr>
10792 </thead>
10793
10794 <tbody>
10795
10796
10797
10798
10799
10800
10801
10802
10803
10804
10805
10806
10807 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10808 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10809 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10810 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10811 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10812 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10813 <span class="entry_type_container">x</span>
10814
10815 <span class="entry_type_array">
10816 n
10817 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10818 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10819 <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]10820
10821
10822 </td> <!-- entry_type -->
10823
10824 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10825 <p>Which face detection modes are available,<wbr/>
10826if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10827 </td>
10828
10829 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10830 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10831 OFF
10832 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10833 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10834 </td>
10835
10836 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10837 </td>
10838
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10839 <td class="entry_tags">
10840 </td>
10841
10842 </tr>
10843 <tr class="entries_header">
10844 <th class="th_details" colspan="5">Details</th>
10845 </tr>
10846 <tr class="entry_cont">
10847 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10848 <p>OFF means face detection is disabled,<wbr/> it must
10849be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10850<p>SIMPLE means the device supports the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10851android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles and
10852android.<wbr/>statistics.<wbr/>face<wbr/>Scores outputs.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10853<p>FULL means the device additionally supports the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10854android.<wbr/>statistics.<wbr/>face<wbr/>Ids and
10855android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks outputs.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10856 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10857 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10858
10859
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10860 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10861 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10862
10863
10864 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10865 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10866 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10867 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10868 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10869 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10870
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10871 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10872
10873
10874 </td> <!-- entry_type -->
10875
10876 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10877 <p>Number of histogram buckets
10878supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10879 </td>
10880
10881 <td class="entry_units">
10882 </td>
10883
10884 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10885 &gt;= 64
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10886 </td>
10887
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10888 <td class="entry_tags">
10889 </td>
10890
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.maxFaceCount">
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/>max<wbr/>Face<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"> [public]</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>Maximum number of simultaneously detectable
10912faces</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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10919 &gt;= 4 if availableFaceDetectionModes lists
10920 modes besides OFF,<wbr/> otherwise 0
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10921 </td>
10922
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10923 <td class="entry_tags">
10924 </td>
10925
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10926 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10927
10928
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10929 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10930 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10931
10932
10933 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10934 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10935 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10936 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10937 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10938 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10939
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10940 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10941
10942
10943 </td> <!-- entry_type -->
10944
10945 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10946 <p>Maximum value possible for a histogram
10947bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10948 </td>
10949
10950 <td class="entry_units">
10951 </td>
10952
10953 <td class="entry_range">
10954 </td>
10955
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10956 <td class="entry_tags">
10957 </td>
10958
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10959 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10960
10961
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10962 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10963 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10964
10965
10966 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10967 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10968 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10969 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10970 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10971 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10972
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10973 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10974
10975
10976 </td> <!-- entry_type -->
10977
10978 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]10979 <p>Maximum value possible for a sharpness map
10980region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10981 </td>
10982
10983 <td class="entry_units">
10984 </td>
10985
10986 <td class="entry_range">
10987 </td>
10988
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10989 <td class="entry_tags">
10990 </td>
10991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10992 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10993
10994
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10995 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10996 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10997
10998
10999 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11000 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11001 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11002 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11003 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11004 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11005 <span class="entry_type_container">x</span>
11006
11007 <span class="entry_type_array">
11008 2
11009 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11010 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11011 <div class="entry_type_notes">width x height</div>
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>Dimensions of the sharpness
11018map</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">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11025 Must be at least 32 x 32
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11026 </td>
11027
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11028 <td class="entry_tags">
11029 </td>
11030
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11031 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11032
11033
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11034 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11035 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11036
11037
11038
11039
11040
11041
11042 <!-- end of kind -->
11043 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11044 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11045
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11046 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11047 <tr>
11048 <th class="th_name">Property Name</th>
11049 <th class="th_type">Type</th>
11050 <th class="th_description">Description</th>
11051 <th class="th_units">Units</th>
11052 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11053 <th class="th_tags">Tags</th>
11054 </tr>
11055 </thead>
11056
11057 <tbody>
11058
11059
11060
11061
11062
11063
11064
11065
11066
11067
11068 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11069 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11070 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11071 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11072 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11073 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11074
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11075 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11076
11077 <ul class="entry_type_enum">
11078 <li>
11079 <span class="entry_type_enum_name">OFF</span>
11080 </li>
11081 <li>
11082 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11083 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
11084 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11085 </li>
11086 <li>
11087 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11088 <span class="entry_type_enum_notes">Optional Return all face
11089 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11090 </li>
11091 </ul>
11092
11093 </td> <!-- entry_type -->
11094
11095 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11096 <p>State of the face detector
11097unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11098 </td>
11099
11100 <td class="entry_units">
11101 </td>
11102
11103 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11104
11105 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11106 </td>
11107
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11108 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11109 <ul class="entry_tags">
11110 <li><a href="#tag_BC">BC</a></li>
11111 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11112 </td>
11113
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11114 </tr>
11115 <tr class="entries_header">
11116 <th class="th_details" colspan="5">Details</th>
11117 </tr>
11118 <tr class="entry_cont">
11119 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11120 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11121should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11122fields.<wbr/> Value must be one of the
11123android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11124 </td>
11125 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11126
11127
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11128 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11129 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11130
11131
11132 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11133 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11134 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11135 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11136 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11137 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11138 <span class="entry_type_container">x</span>
11139
11140 <span class="entry_type_array">
11141 n
11142 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11143 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11144
11145
11146 </td> <!-- entry_type -->
11147
11148 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11149 <p>List of unique IDs for detected
11150faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11151 </td>
11152
11153 <td class="entry_units">
11154 </td>
11155
11156 <td class="entry_range">
11157 </td>
11158
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11159 <td class="entry_tags">
11160 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11161 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11162 </ul>
11163 </td>
11164
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11165 </tr>
11166 <tr class="entries_header">
11167 <th class="th_details" colspan="5">Details</th>
11168 </tr>
11169 <tr class="entry_cont">
11170 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11171 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11172 </td>
11173 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11174
11175
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11176 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11177 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11178
11179
11180 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11181 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11182 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11183 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11184 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11185 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11186 <span class="entry_type_container">x</span>
11187
11188 <span class="entry_type_array">
11189 n x 6
11190 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11191 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11192 <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]11193
11194
11195 </td> <!-- entry_type -->
11196
11197 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11198 <p>List of landmarks for detected
11199faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11200 </td>
11201
11202 <td class="entry_units">
11203 </td>
11204
11205 <td class="entry_range">
11206 </td>
11207
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11208 <td class="entry_tags">
11209 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11210 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11211 </ul>
11212 </td>
11213
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11214 </tr>
11215 <tr class="entries_header">
11216 <th class="th_details" colspan="5">Details</th>
11217 </tr>
11218 <tr class="entry_cont">
11219 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11220 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11221 </td>
11222 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11223
11224
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11225 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11226 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11227
11228
11229 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11230 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11231 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11232 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11233 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11234 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11235 <span class="entry_type_container">x</span>
11236
11237 <span class="entry_type_array">
11238 n x 4
11239 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11240 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11241 <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]11242
11243
11244 </td> <!-- entry_type -->
11245
11246 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11247 <p>List of the bounding rectangles for detected
11248faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11249 </td>
11250
11251 <td class="entry_units">
11252 </td>
11253
11254 <td class="entry_range">
11255 </td>
11256
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11257 <td class="entry_tags">
11258 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11259 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11260 </ul>
11261 </td>
11262
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11263 </tr>
11264 <tr class="entries_header">
11265 <th class="th_details" colspan="5">Details</th>
11266 </tr>
11267 <tr class="entry_cont">
11268 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11269 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11270 </td>
11271 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11272
11273
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11274 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11275 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11276
11277
11278 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11279 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11280 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11281 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11282 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11283 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11284 <span class="entry_type_container">x</span>
11285
11286 <span class="entry_type_array">
11287 n
11288 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11289 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11290
11291
11292 </td> <!-- entry_type -->
11293
11294 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11295 <p>List of the face confidence scores for
11296detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11297 </td>
11298
11299 <td class="entry_units">
11300 </td>
11301
11302 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11303 1-100
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11304 </td>
11305
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11306 <td class="entry_tags">
11307 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11308 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11309 </ul>
11310 </td>
11311
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11312 </tr>
11313 <tr class="entries_header">
11314 <th class="th_details" colspan="5">Details</th>
11315 </tr>
11316 <tr class="entry_cont">
11317 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11318 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
11319meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11320 </td>
11321 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11322
11323
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11324 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11325 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11326
11327
11328 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11329 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11330 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11331 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11332 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11333 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11334 <span class="entry_type_container">x</span>
11335
11336 <span class="entry_type_array">
11337 n x 3
11338 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11339 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11340 <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]11341
11342
11343 </td> <!-- entry_type -->
11344
11345 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11346 <p>A 3-channel histogram based on the raw
11347sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11348 </td>
11349
11350 <td class="entry_units">
11351 </td>
11352
11353 <td class="entry_range">
11354 </td>
11355
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11356 <td class="entry_tags">
11357 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11358 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11359 </ul>
11360 </td>
11361
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11362 </tr>
11363 <tr class="entries_header">
11364 <th class="th_details" colspan="5">Details</th>
11365 </tr>
11366 <tr class="entry_cont">
11367 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11368 <p>The k'th bucket (0-based) covers the input range
11369(with w = android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level) of [ k * w/<wbr/>N,<wbr/>
11370(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
11371supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11372 </td>
11373 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11374
11375
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11376 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11377 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11378
11379
11380 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11381 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11382 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11383 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11384 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11385 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11386
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11387 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11388
11389 <ul class="entry_type_enum">
11390 <li>
11391 <span class="entry_type_enum_name">OFF</span>
11392 </li>
11393 <li>
11394 <span class="entry_type_enum_name">ON</span>
11395 </li>
11396 </ul>
11397
11398 </td> <!-- entry_type -->
11399
11400 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11401 <p>Operating mode for histogram
11402generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11403 </td>
11404
11405 <td class="entry_units">
11406 </td>
11407
11408 <td class="entry_range">
11409 </td>
11410
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11411 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11412 <ul class="entry_tags">
11413 <li><a href="#tag_V1">V1</a></li>
11414 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11415 </td>
11416
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11417 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11418
11419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11420 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11421 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11422
11423
11424 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11425 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11426 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11427 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11428 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11429 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11430 <span class="entry_type_container">x</span>
11431
11432 <span class="entry_type_array">
11433 n x m x 3
11434 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11435 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11436 <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]11437
11438
11439 </td> <!-- entry_type -->
11440
11441 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11442 <p>A 3-channel sharpness map,<wbr/> based on the raw
11443sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11444 </td>
11445
11446 <td class="entry_units">
11447 </td>
11448
11449 <td class="entry_range">
11450 </td>
11451
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11452 <td class="entry_tags">
11453 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11454 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11455 </ul>
11456 </td>
11457
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11458 </tr>
11459 <tr class="entries_header">
11460 <th class="th_details" colspan="5">Details</th>
11461 </tr>
11462 <tr class="entry_cont">
11463 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11464 <p>If only a monochrome sharpness map is supported,<wbr/>
11465all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11466 </td>
11467 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11468
11469
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11470 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11471 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11472
11473
11474 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11475 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11476 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11477 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11478 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11479 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11480
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11481 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11482
11483 <ul class="entry_type_enum">
11484 <li>
11485 <span class="entry_type_enum_name">OFF</span>
11486 </li>
11487 <li>
11488 <span class="entry_type_enum_name">ON</span>
11489 </li>
11490 </ul>
11491
11492 </td> <!-- entry_type -->
11493
11494 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11495 <p>Operating mode for sharpness map
11496generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11497 </td>
11498
11499 <td class="entry_units">
11500 </td>
11501
11502 <td class="entry_range">
11503 </td>
11504
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11505 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11506 <ul class="entry_tags">
11507 <li><a href="#tag_V1">V1</a></li>
11508 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11509 </td>
11510
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11511 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11512
11513
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11514 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11515 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11516
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11517
11518 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11519 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11520 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11521 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11522 <td class="entry_type">
11523 <span class="entry_type_name">float</span>
11524 <span class="entry_type_container">x</span>
11525
11526 <span class="entry_type_array">
11527 4 x n x m
11528 </span>
11529 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11530 <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]11531
11532
11533 </td> <!-- entry_type -->
11534
11535 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11536 <p>The shading map is a low-resolution floating-point map
11537that lists the coefficients used to correct for vignetting,<wbr/> for each
11538Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11539 </td>
11540
11541 <td class="entry_units">
11542 </td>
11543
11544 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11545 Each gain factor is &gt;= 1
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11546 </td>
11547
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11548 <td class="entry_tags">
11549 </td>
11550
11551 </tr>
11552 <tr class="entries_header">
11553 <th class="th_details" colspan="5">Details</th>
11554 </tr>
11555 <tr class="entry_cont">
11556 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11557 <p>The least shaded section of the image should have a gain factor
11558of 1; all other sections should have gains above 1.<wbr/></p>
11559<p>When android.<wbr/>color<wbr/>Correction.<wbr/>mode = TRANSFORM_<wbr/>MATRIX,<wbr/> the map
11560must take into account the colorCorrection settings.<wbr/></p>
11561<p>The shading map is for the entire active pixel array,<wbr/> and is not
11562affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11563entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11564pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
11565map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
11566(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
11567pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
11568The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
11569<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
11570channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
11571The shading map is stored in a fully interleaved format,<wbr/> and its size
11572is provided in the camera static metadata by android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size.<wbr/></p>
11573<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
11574and must be smaller than 64x64.<wbr/></p>
11575<p>As an example,<wbr/> given a very small map defined as:</p>
11576<pre><code>android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size = [ 4,<wbr/> 3 ]
11577android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map =
11578[ 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/>
11579 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/>
11580 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/>
11581 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/>
11582 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/>
11583 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]11584</code></pre>
11585<p>The low-resolution scaling map images for each channel are
11586(displayed using nearest-neighbor interpolation):</p>
11587<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
11588<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
11589<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
11590<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^]11591<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11592image 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^]11593<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]11594 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11595 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11596
11597
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11598 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11599 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11600
11601
11602 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11603 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11604 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11605 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11606 <td class="entry_type">
11607 <span class="entry_type_name">float</span>
11608 <span class="entry_type_container">x</span>
11609
11610 <span class="entry_type_array">
11611 4
11612 </span>
11613 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11614 <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]11615
11616
11617 </td> <!-- entry_type -->
11618
11619 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11620 <p>The best-fit color channel gains calculated
11621by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11622 </td>
11623
11624 <td class="entry_units">
11625 </td>
11626
11627 <td class="entry_range">
11628 </td>
11629
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11630 <td class="entry_tags">
11631 </td>
11632
11633 </tr>
11634 <tr class="entries_header">
11635 <th class="th_details" colspan="5">Details</th>
11636 </tr>
11637 <tr class="entry_cont">
11638 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11639 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11640since statistics processing on data from a new frame
11641typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11642applied to that frame.<wbr/></p>
11643<p>The 4 channel gains are defined in Bayer domain,<wbr/>
11644see android.<wbr/>color<wbr/>Correction.<wbr/>gains for details.<wbr/></p>
11645<p>This value should always be calculated by the AWB block,<wbr/>
11646regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11647 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11648 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11649
11650
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11651 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11652 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11653
11654
11655 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11656 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11657 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11658 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11659 <td class="entry_type">
11660 <span class="entry_type_name">rational</span>
11661 <span class="entry_type_container">x</span>
11662
11663 <span class="entry_type_array">
11664 3 x 3
11665 </span>
11666 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11667 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11668
11669
11670 </td> <!-- entry_type -->
11671
11672 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11673 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11674calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11675output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11676 </td>
11677
11678 <td class="entry_units">
11679 </td>
11680
11681 <td class="entry_range">
11682 </td>
11683
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11684 <td class="entry_tags">
11685 </td>
11686
11687 </tr>
11688 <tr class="entries_header">
11689 <th class="th_details" colspan="5">Details</th>
11690 </tr>
11691 <tr class="entry_cont">
11692 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11693 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11694statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11695for the next frame.<wbr/> These are the values the HAL believes
11696are the best fit for the current output frame.<wbr/> This may
11697be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11698statistics processing on data from a new frame typically
11699completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11700that frame.<wbr/></p>
11701<p>These estimates must be provided for all frames,<wbr/> even if
11702capture settings and color transforms are set by the application.<wbr/></p>
11703<p>This value should always be calculated by the AWB block,<wbr/>
11704regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11705 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11706 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11707
11708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11709 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11710 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11711
11712
11713 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11714 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11715 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11716 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11717 <td class="entry_type">
11718 <span class="entry_type_name entry_type_name_enum">byte</span>
11719
11720 <span class="entry_type_visibility"> [public]</span>
11721
11722 <ul class="entry_type_enum">
11723 <li>
11724 <span class="entry_type_enum_name">NONE</span>
11725 </li>
11726 <li>
11727 <span class="entry_type_enum_name">50HZ</span>
11728 </li>
11729 <li>
11730 <span class="entry_type_enum_name">60HZ</span>
11731 </li>
11732 </ul>
11733
11734 </td> <!-- entry_type -->
11735
11736 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11737 <p>The HAL estimated scene illumination lighting
11738frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11739 </td>
11740
11741 <td class="entry_units">
11742 </td>
11743
11744 <td class="entry_range">
11745 </td>
11746
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11747 <td class="entry_tags">
11748 </td>
11749
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11750 </tr>
11751 <tr class="entries_header">
11752 <th class="th_details" colspan="5">Details</th>
11753 </tr>
11754 <tr class="entry_cont">
11755 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11756 <p>Report NONE if there doesn't appear to be flickering
11757illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11758 </td>
11759 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11760
11761
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11762 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11763 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11764
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11765
11766
11767 <!-- end of kind -->
11768 </tbody>
11769
11770 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11771 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11772
11773
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11774 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11775
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11776 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11777 <tr>
11778 <th class="th_name">Property Name</th>
11779 <th class="th_type">Type</th>
11780 <th class="th_description">Description</th>
11781 <th class="th_units">Units</th>
11782 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11783 <th class="th_tags">Tags</th>
11784 </tr>
11785 </thead>
11786
11787 <tbody>
11788
11789
11790
11791
11792
11793
11794
11795
11796
11797
11798 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11799 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11800 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11801 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11802 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]11803 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11804 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11805
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11806 <span class="entry_type_array">
11807 n x 2
11808 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11809 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11810 <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]11811
11812
11813 </td> <!-- entry_type -->
11814
11815 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11816 <p>Table mapping blue input values to output
11817values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11818 </td>
11819
11820 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11821 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11822 </td>
11823
11824 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11825 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11826 </td>
11827
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11828 <td class="entry_tags">
11829 </td>
11830
11831 </tr>
11832 <tr class="entries_header">
11833 <th class="th_details" colspan="5">Details</th>
11834 </tr>
11835 <tr class="entry_cont">
11836 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11837 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
11838channel,<wbr/> to use when android.<wbr/>tonemap.<wbr/>mode is CONTRAST_<wbr/>CURVE.<wbr/></p>
11839<p>See android.<wbr/>tonemap.<wbr/>curve<wbr/>Red for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11840 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11841 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11842
11843
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11844 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11845 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11846
11847
11848 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11849 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11850 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11851 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11852 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]11853 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11854 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11855
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]11856 <span class="entry_type_array">
11857 n x 2
11858 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11859 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11860 <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]11861
11862
11863 </td> <!-- entry_type -->
11864
11865 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11866 <p>Table mapping green input values to output
11867values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11868 </td>
11869
11870 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11871 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11872 </td>
11873
11874 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11875 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11876 </td>
11877
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11878 <td class="entry_tags">
11879 </td>
11880
11881 </tr>
11882 <tr class="entries_header">
11883 <th class="th_details" colspan="5">Details</th>
11884 </tr>
11885 <tr class="entry_cont">
11886 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11887 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
11888channel,<wbr/> to use when android.<wbr/>tonemap.<wbr/>mode is CONTRAST_<wbr/>CURVE.<wbr/></p>
11889<p>See android.<wbr/>tonemap.<wbr/>curve<wbr/>Red for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11890 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11891 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11892
11893
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11894 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11895 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11896
11897
11898 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11899 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11900 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11901 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11902 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11903 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11904 <span class="entry_type_container">x</span>
11905
11906 <span class="entry_type_array">
11907 n x 2
11908 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11909 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11910 <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]11911
11912
11913 </td> <!-- entry_type -->
11914
11915 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11916 <p>Table mapping red input values to output
11917values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11918 </td>
11919
11920 <td class="entry_units">
11921 </td>
11922
11923 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11924 0-1 on input and output coordinates.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11925 </td>
11926
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11927 <td class="entry_tags">
11928 <ul class="entry_tags">
11929 <li><a href="#tag_DNG">DNG</a></li>
11930 </ul>
11931 </td>
11932
11933 </tr>
11934 <tr class="entries_header">
11935 <th class="th_details" colspan="5">Details</th>
11936 </tr>
11937 <tr class="entry_cont">
11938 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11939 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
11940channel,<wbr/> to use when android.<wbr/>tonemap.<wbr/>mode is CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11941<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11942the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11943are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11944between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11945<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11946defined points.<wbr/> The points will be listed in increasing
11947order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
119480.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
11949for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
119500.<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]11951 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11952 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11953
11954
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11955 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11956 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11957
11958
11959 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11960 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11961 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11962 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11963 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11964 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11965
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11966 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11967
11968 <ul class="entry_type_enum">
11969 <li>
11970 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11971 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
11972 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11973 </li>
11974 <li>
11975 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11976 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
11977 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11978 </li>
11979 <li>
11980 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]11981 <span class="entry_type_enum_notes">Frame rate may be reduced by high
11982 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11983 </li>
11984 </ul>
11985
11986 </td> <!-- entry_type -->
11987
11988 <td class="entry_description">
11989 </td>
11990
11991 <td class="entry_units">
11992 </td>
11993
11994 <td class="entry_range">
11995 </td>
11996
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11997 <td class="entry_tags">
11998 </td>
11999
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12000 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12001
12002
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12003 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12004 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12005
12006
12007
12008 <!-- end of kind -->
12009 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12010 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12011
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12012 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12013 <tr>
12014 <th class="th_name">Property Name</th>
12015 <th class="th_type">Type</th>
12016 <th class="th_description">Description</th>
12017 <th class="th_units">Units</th>
12018 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12019 <th class="th_tags">Tags</th>
12020 </tr>
12021 </thead>
12022
12023 <tbody>
12024
12025
12026
12027
12028
12029
12030
12031
12032
12033
12034 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12035 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12036 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12037 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12038 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12039 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12040
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12041 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12042
12043
12044 </td> <!-- entry_type -->
12045
12046 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12047 <p>Maximum number of supported points in the
12048tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12049 </td>
12050
12051 <td class="entry_units">
12052 </td>
12053
12054 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12055 &gt;= 128
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12056 </td>
12057
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12058 <td class="entry_tags">
12059 </td>
12060
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12061 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12062
12063
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12064 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12065 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12066
12067
12068
12069 <!-- end of kind -->
12070 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12071 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12072
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12073 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12074 <tr>
12075 <th class="th_name">Property Name</th>
12076 <th class="th_type">Type</th>
12077 <th class="th_description">Description</th>
12078 <th class="th_units">Units</th>
12079 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12080 <th class="th_tags">Tags</th>
12081 </tr>
12082 </thead>
12083
12084 <tbody>
12085
12086
12087
12088
12089
12090
12091
12092
12093
12094
12095 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12096 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12097 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12098 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12099 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12100 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12101 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12102
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12103 <span class="entry_type_array">
12104 n x 2
12105 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12106 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12107 <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]12108
12109
12110 </td> <!-- entry_type -->
12111
12112 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12113 <p>Table mapping blue input values to output
12114values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12115 </td>
12116
12117 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12118 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12119 </td>
12120
12121 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12122 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12123 </td>
12124
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12125 <td class="entry_tags">
12126 </td>
12127
12128 </tr>
12129 <tr class="entries_header">
12130 <th class="th_details" colspan="5">Details</th>
12131 </tr>
12132 <tr class="entry_cont">
12133 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12134 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
12135channel,<wbr/> to use when android.<wbr/>tonemap.<wbr/>mode is CONTRAST_<wbr/>CURVE.<wbr/></p>
12136<p>See android.<wbr/>tonemap.<wbr/>curve<wbr/>Red for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12137 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12138 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12139
12140
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12141 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12142 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12143
12144
12145 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12146 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12147 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12148 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12149 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12150 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12151 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12152
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12153 <span class="entry_type_array">
12154 n x 2
12155 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12156 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12157 <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]12158
12159
12160 </td> <!-- entry_type -->
12161
12162 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12163 <p>Table mapping green input values to output
12164values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12165 </td>
12166
12167 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12168 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12169 </td>
12170
12171 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12172 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12173 </td>
12174
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12175 <td class="entry_tags">
12176 </td>
12177
12178 </tr>
12179 <tr class="entries_header">
12180 <th class="th_details" colspan="5">Details</th>
12181 </tr>
12182 <tr class="entry_cont">
12183 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12184 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
12185channel,<wbr/> to use when android.<wbr/>tonemap.<wbr/>mode is CONTRAST_<wbr/>CURVE.<wbr/></p>
12186<p>See android.<wbr/>tonemap.<wbr/>curve<wbr/>Red for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12187 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12188 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12189
12190
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12191 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12192 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12193
12194
12195 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12196 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12197 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12198 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12199 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12200 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12201 <span class="entry_type_container">x</span>
12202
12203 <span class="entry_type_array">
12204 n x 2
12205 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12206 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12207 <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]12208
12209
12210 </td> <!-- entry_type -->
12211
12212 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12213 <p>Table mapping red input values to output
12214values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12215 </td>
12216
12217 <td class="entry_units">
12218 </td>
12219
12220 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12221 0-1 on input and output coordinates.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12222 </td>
12223
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12224 <td class="entry_tags">
12225 <ul class="entry_tags">
12226 <li><a href="#tag_DNG">DNG</a></li>
12227 </ul>
12228 </td>
12229
12230 </tr>
12231 <tr class="entries_header">
12232 <th class="th_details" colspan="5">Details</th>
12233 </tr>
12234 <tr class="entry_cont">
12235 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12236 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
12237channel,<wbr/> to use when android.<wbr/>tonemap.<wbr/>mode is CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12238<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12239the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12240are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12241between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12242<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12243defined points.<wbr/> The points will be listed in increasing
12244order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
122450.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12246for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
122470.<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]12248 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12249 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12250
12251
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12252 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12253 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12254
12255
12256 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12257 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12258 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12259 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12260 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12261 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12262
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12263 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12264
12265 <ul class="entry_type_enum">
12266 <li>
12267 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12268 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12269 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12270 </li>
12271 <li>
12272 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12273 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12274 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12275 </li>
12276 <li>
12277 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12278 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12279 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12280 </li>
12281 </ul>
12282
12283 </td> <!-- entry_type -->
12284
12285 <td class="entry_description">
12286 </td>
12287
12288 <td class="entry_units">
12289 </td>
12290
12291 <td class="entry_range">
12292 </td>
12293
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12294 <td class="entry_tags">
12295 </td>
12296
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12297 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12298
12299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12300 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12301 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12302
12303
12304
12305 <!-- end of kind -->
12306 </tbody>
12307
12308 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12309 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12310
12311
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12312 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12313
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12314 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12315 <tr>
12316 <th class="th_name">Property Name</th>
12317 <th class="th_type">Type</th>
12318 <th class="th_description">Description</th>
12319 <th class="th_units">Units</th>
12320 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12321 <th class="th_tags">Tags</th>
12322 </tr>
12323 </thead>
12324
12325 <tbody>
12326
12327
12328
12329
12330
12331
12332
12333
12334
12335
12336 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12337 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12338 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12339 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12340 <td class="entry_type">
12341 <span class="entry_type_name entry_type_name_enum">byte</span>
12342
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12343 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12344
12345 <ul class="entry_type_enum">
12346 <li>
12347 <span class="entry_type_enum_name">OFF</span>
12348 </li>
12349 <li>
12350 <span class="entry_type_enum_name">ON</span>
12351 </li>
12352 </ul>
12353
12354 </td> <!-- entry_type -->
12355
12356 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12357 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12358that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12359Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12360disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12361any untrusted applications.<wbr/></p>
12362<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12363transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12364data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12365<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^]12366doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12367 </td>
12368
12369 <td class="entry_units">
12370 </td>
12371
12372 <td class="entry_range">
12373 </td>
12374
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12375 <td class="entry_tags">
12376 </td>
12377
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12378 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12379
12380
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12381 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12382 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12383
12384
12385
12386 <!-- end of kind -->
12387 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12388 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12389
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12390 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12391 <tr>
12392 <th class="th_name">Property Name</th>
12393 <th class="th_type">Type</th>
12394 <th class="th_description">Description</th>
12395 <th class="th_units">Units</th>
12396 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12397 <th class="th_tags">Tags</th>
12398 </tr>
12399 </thead>
12400
12401 <tbody>
12402
12403
12404
12405
12406
12407
12408
12409
12410
12411
12412 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12413 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12414 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12415 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12416 <td class="entry_type">
12417 <span class="entry_type_name entry_type_name_enum">byte</span>
12418
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12419 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12420
12421 <ul class="entry_type_enum">
12422 <li>
12423 <span class="entry_type_enum_name">OFF</span>
12424 </li>
12425 <li>
12426 <span class="entry_type_enum_name">ON</span>
12427 </li>
12428 </ul>
12429
12430 </td> <!-- entry_type -->
12431
12432 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12433 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12434that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12435Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12436disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12437any untrusted applications.<wbr/></p>
12438<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12439transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12440data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12441<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^]12442doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12443 </td>
12444
12445 <td class="entry_units">
12446 </td>
12447
12448 <td class="entry_range">
12449 </td>
12450
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12451 <td class="entry_tags">
12452 </td>
12453
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12454 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12455
12456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12457 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12458 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12459
12460
12461
12462 <!-- end of kind -->
12463 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12464 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12465
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12466 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12467 <tr>
12468 <th class="th_name">Property Name</th>
12469 <th class="th_type">Type</th>
12470 <th class="th_description">Description</th>
12471 <th class="th_units">Units</th>
12472 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12473 <th class="th_tags">Tags</th>
12474 </tr>
12475 </thead>
12476
12477 <tbody>
12478
12479
12480
12481
12482
12483
12484
12485
12486
12487
12488 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12489 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12490 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12491 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12492 <td class="entry_type">
12493 <span class="entry_type_name entry_type_name_enum">byte</span>
12494 <span class="entry_type_container">x</span>
12495
12496 <span class="entry_type_array">
12497 n
12498 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12499 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12500
12501 <ul class="entry_type_enum">
12502 <li>
12503 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12504 <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]12505 </li>
12506 </ul>
12507
12508 </td> <!-- entry_type -->
12509
12510 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12511 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12512 </td>
12513
12514 <td class="entry_units">
12515 </td>
12516
12517 <td class="entry_range">
12518 </td>
12519
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12520 <td class="entry_tags">
12521 </td>
12522
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12523 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12524
12525
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12526 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12527 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12528
12529
12530
12531 <!-- end of kind -->
12532 </tbody>
12533
12534 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12535 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12536
12537
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12538 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12539
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12540 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12541 <tr>
12542 <th class="th_name">Property Name</th>
12543 <th class="th_type">Type</th>
12544 <th class="th_description">Description</th>
12545 <th class="th_units">Units</th>
12546 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12547 <th class="th_tags">Tags</th>
12548 </tr>
12549 </thead>
12550
12551 <tbody>
12552
12553
12554
12555
12556
12557
12558
12559
12560
12561
12562 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12563 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12564 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12565 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12566 <td class="entry_type">
12567 <span class="entry_type_name entry_type_name_enum">byte</span>
12568
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12569 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12570
12571 <ul class="entry_type_enum">
12572 <li>
12573 <span class="entry_type_enum_name">LIMITED</span>
12574 </li>
12575 <li>
12576 <span class="entry_type_enum_name">FULL</span>
12577 </li>
12578 </ul>
12579
12580 </td> <!-- entry_type -->
12581
12582 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12583 <p>The camera 3 HAL device can implement one of two possible
12584operational modes; limited and full.<wbr/> Full support is
12585expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12586hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12587camera HAL device v1 implementation,<wbr/> and is expected from
12588older or inexpensive devices.<wbr/> Full is a strict superset of
12589limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
12590<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]12591 </td>
12592
12593 <td class="entry_units">
12594 </td>
12595
12596 <td class="entry_range">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12597 Optional.<wbr/> Default value is LIMITED.<wbr/>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12598 </td>
12599
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12600 <td class="entry_tags">
12601 </td>
12602
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12603 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12604
12605
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12606 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12607 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12608
12609
12610
12611 <!-- end of kind -->
12612 </tbody>
12613
12614 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12615 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12616
12617
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12618 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12619
12620 <thead class="entries_header">
12621 <tr>
12622 <th class="th_name">Property Name</th>
12623 <th class="th_type">Type</th>
12624 <th class="th_description">Description</th>
12625 <th class="th_units">Units</th>
12626 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12627 <th class="th_tags">Tags</th>
12628 </tr>
12629 </thead>
12630
12631 <tbody>
12632
12633
12634
12635
12636
12637
12638
12639
12640
12641
12642 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12643 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12644 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12645 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12646 <td class="entry_type">
12647 <span class="entry_type_name entry_type_name_enum">byte</span>
12648
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12649 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12650
12651 <ul class="entry_type_enum">
12652 <li>
12653 <span class="entry_type_enum_name">OFF</span>
12654 </li>
12655 <li>
12656 <span class="entry_type_enum_name">ON</span>
12657 </li>
12658 </ul>
12659
12660 </td> <!-- entry_type -->
12661
12662 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12663 <p>Whether black-level compensation is locked
12664to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12665 </td>
12666
12667 <td class="entry_units">
12668 </td>
12669
12670 <td class="entry_range">
12671 </td>
12672
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12673 <td class="entry_tags">
12674 <ul class="entry_tags">
12675 <li><a href="#tag_HAL2">HAL2</a></li>
12676 </ul>
12677 </td>
12678
12679 </tr>
12680 <tr class="entries_header">
12681 <th class="th_details" colspan="5">Details</th>
12682 </tr>
12683 <tr class="entry_cont">
12684 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12685 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12686compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12687OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12688<p>Since changes to certain capture parameters (such as
12689exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12690compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12691the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12692metadata.<wbr/></p>
12693<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12694<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12695<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12696<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12697<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12698<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12699<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12700<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12701</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12702<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12703device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12704result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12705<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12706<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12707<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12708<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12709<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
12710<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12711<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12712</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12713<p>This indicates to the application that on frame 4,<wbr/> black
12714levels were reset due to exposure value changes,<wbr/> and pixel
12715values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12716<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12717possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12718other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12719or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12720 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12721 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12722
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12723 <tr class="entries_header">
12724 <th class="th_details" colspan="5">HAL Implementation Details</th>
12725 </tr>
12726 <tr class="entry_cont">
12727 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12728 <p>If for some reason black level locking is no longer possible
12729(for example,<wbr/> the analog gain has changed,<wbr/> which forces
12730black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12731override this request (and it must report 'OFF' when this
12732does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12733possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12734 </td>
12735 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12736
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12737 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12738 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12739
12740
12741
12742 <!-- end of kind -->
12743 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12744 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12745
12746 <thead class="entries_header">
12747 <tr>
12748 <th class="th_name">Property Name</th>
12749 <th class="th_type">Type</th>
12750 <th class="th_description">Description</th>
12751 <th class="th_units">Units</th>
12752 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12753 <th class="th_tags">Tags</th>
12754 </tr>
12755 </thead>
12756
12757 <tbody>
12758
12759
12760
12761
12762
12763
12764
12765
12766
12767
12768 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12769 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12770 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12771 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12772 <td class="entry_type">
12773 <span class="entry_type_name entry_type_name_enum">byte</span>
12774
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12775 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12776
12777 <ul class="entry_type_enum">
12778 <li>
12779 <span class="entry_type_enum_name">OFF</span>
12780 </li>
12781 <li>
12782 <span class="entry_type_enum_name">ON</span>
12783 </li>
12784 </ul>
12785
12786 </td> <!-- entry_type -->
12787
12788 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12789 <p>Whether black-level compensation is locked
12790to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12791 </td>
12792
12793 <td class="entry_units">
12794 </td>
12795
12796 <td class="entry_range">
12797 </td>
12798
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12799 <td class="entry_tags">
12800 <ul class="entry_tags">
12801 <li><a href="#tag_HAL2">HAL2</a></li>
12802 </ul>
12803 </td>
12804
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12805 </tr>
12806 <tr class="entries_header">
12807 <th class="th_details" colspan="5">Details</th>
12808 </tr>
12809 <tr class="entry_cont">
12810 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12811 <p>Whether the black level offset was locked for this frame.<wbr/> Should be
12812ON if android.<wbr/>black<wbr/>Level.<wbr/>lock was ON in the capture request,<wbr/> unless
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12813a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12814perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12815 </td>
12816 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12817
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12818 <tr class="entries_header">
12819 <th class="th_details" colspan="5">HAL Implementation Details</th>
12820 </tr>
12821 <tr class="entry_cont">
12822 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12823 <p>If for some reason black level locking is no longer possible
12824(for example,<wbr/> the analog gain has changed,<wbr/> which forces
12825black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12826override this request (and it must report 'OFF' when this
12827does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame^]12828possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12829 </td>
12830 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12831
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12832 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12833 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12834
12835
12836
12837 <!-- end of kind -->
12838 </tbody>
12839
12840 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12841<!-- </namespace> -->
12842 </table>
12843
12844 <div class="tags" id="tag_index">
12845 <h2>Tags</h2>
12846 <ul>
12847 <li id="tag_AWB">AWB -
12848 Needed for auto white balance
12849
12850 <ul class="tags_entries">
12851 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
12852 </ul>
12853 </li> <!-- tag_AWB -->
12854 <li id="tag_BC">BC -
12855 Needed for backwards compatibility with old Java API
12856
12857 <ul class="tags_entries">
12858 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
12859 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
12860 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
12861 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
12862 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]12863 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12864 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
12865 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]12866 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12867 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
12868 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
12869 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
12870 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
12871 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
12872 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
12873 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
12874 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
12875 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
12876 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
12877 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
12878 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
12879 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
12880 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
12881 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
12882 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
12883 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
12884 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
12885 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
12886 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
12887 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
12888 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
12889 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
12890 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
12891 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
12892 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
12893 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
12894 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
12895 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
12896 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
12897 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
12898 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
12899 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
12900 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
12901 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
12902 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]12903 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12904 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
12905 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
12906 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12907 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12908 <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]12909 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
12910 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
12911 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
12912 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
12913 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
12914 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
12915 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
12916 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
12917 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
12918 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
12919 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
12920 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
12921 </ul>
12922 </li> <!-- tag_BC -->
12923 <li id="tag_V1">V1 -
12924 New features for first camera 2 release (API1)
12925
12926 <ul class="tags_entries">
12927 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
12928 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
12929 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
12930 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
12931 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
12932 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
12933 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
12934 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
12935 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
12936 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
12937 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
12938 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
12939 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
12940 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
12941 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
12942 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
12943 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
12944 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
12945 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
12946 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
12947 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
12948 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
12949 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
12950 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12951 <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]12952 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
12953 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
12954 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
12955 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
12956 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
12957 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
12958 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
12959 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
12960 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
12961 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
12962 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
12963 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
12964 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
12965 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
12966 </ul>
12967 </li> <!-- tag_V1 -->
12968 <li id="tag_ADV">ADV - None
12969 <ul class="tags_entries">
12970 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
12971 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
12972 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
12973 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
12974 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
12975 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
12976 </ul>
12977 </li> <!-- tag_ADV -->
12978 <li id="tag_DNG">DNG -
12979 Needed for DNG file support
12980
12981 <ul class="tags_entries">
12982 <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]12983 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
12984 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
12985 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
12986 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
12987 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
12988 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
12989 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
12990 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
12991 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
12992 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
12993 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
12994 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
12995 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
12996 </ul>
12997 </li> <!-- tag_DNG -->
12998 <li id="tag_EXIF">EXIF - None
12999 <ul class="tags_entries">
13000 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13001 </ul>
13002 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13003 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13004 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13005
13006 <ul class="tags_entries">
13007 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13008 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13009 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13010 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13011 </ul>
13012 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13013 <li id="tag_FULL">FULL -
13014 Entry is required for full hardware level devices, and optional for other hardware levels
13015
13016 <ul class="tags_entries">
13017 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13018 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13019 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13020 </ul>
13021 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13022 </ul>
13023 </div>
13024
13025 [ <a href="#">top</a> ]
13026
13027</body>
13028</html>