Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / f163fa91a5ca5b6a8efceb67c60d515145187101 / . / camera / docs / docs.html
blob: 93d2f9508bab3ce502bd8b10ae011c3825d6d333 [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>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]171 <li><a href="#dynamic_android.control.aeMode">android.control.aeMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]172 <li><a href="#dynamic_android.control.aeRegions">android.control.aeRegions</a></li>
173 <li><a href="#dynamic_android.control.aeState">android.control.aeState</a></li>
174 <li><a href="#dynamic_android.control.afMode">android.control.afMode</a></li>
175 <li><a href="#dynamic_android.control.afRegions">android.control.afRegions</a></li>
176 <li><a href="#dynamic_android.control.afState">android.control.afState</a></li>
177 <li><a href="#dynamic_android.control.afTriggerId">android.control.afTriggerId</a></li>
178 <li><a href="#dynamic_android.control.awbMode">android.control.awbMode</a></li>
179 <li><a href="#dynamic_android.control.awbRegions">android.control.awbRegions</a></li>
180 <li><a href="#dynamic_android.control.awbState">android.control.awbState</a></li>
181 <li><a href="#dynamic_android.control.mode">android.control.mode</a></li>
182 </ul>
183 </li>
184 </ul> <!-- toc_section -->
185 </li>
186 <li>
187 <span class="toc_section_header"><a href="#section_demosaic">demosaic</a></span>
188 <ul class="toc_section">
189 <li>
190 <span class="toc_kind_header">controls</span>
191 <ul class="toc_section">
192 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a></li>
193 </ul>
194 </li>
195 </ul> <!-- toc_section -->
196 </li>
197 <li>
198 <span class="toc_section_header"><a href="#section_edge">edge</a></span>
199 <ul class="toc_section">
200 <li>
201 <span class="toc_kind_header">controls</span>
202 <ul class="toc_section">
203 <li><a href="#controls_android.edge.mode">android.edge.mode</a></li>
204 <li><a href="#controls_android.edge.strength">android.edge.strength</a></li>
205 </ul>
206 </li>
207 <li>
208 <span class="toc_kind_header">dynamic</span>
209 <ul class="toc_section">
210 <li><a href="#dynamic_android.edge.mode">android.edge.mode</a></li>
211 </ul>
212 </li>
213 </ul> <!-- toc_section -->
214 </li>
215 <li>
216 <span class="toc_section_header"><a href="#section_flash">flash</a></span>
217 <ul class="toc_section">
218 <li>
219 <span class="toc_kind_header">controls</span>
220 <ul class="toc_section">
221 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a></li>
222 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a></li>
223 <li><a href="#controls_android.flash.mode">android.flash.mode</a></li>
224 </ul>
225 </li>
226 <li>
227 <span class="toc_kind_header">static</span>
228 <ul class="toc_section">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]229
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]230 <li><a href="#static_android.flash.info.available">android.flash.info.available</a></li>
231 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]232
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]233 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a></li>
234 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a></li>
235 </ul>
236 </li>
237 <li>
238 <span class="toc_kind_header">dynamic</span>
239 <ul class="toc_section">
240 <li><a href="#dynamic_android.flash.firingPower">android.flash.firingPower</a></li>
241 <li><a href="#dynamic_android.flash.firingTime">android.flash.firingTime</a></li>
242 <li><a href="#dynamic_android.flash.mode">android.flash.mode</a></li>
243 <li><a href="#dynamic_android.flash.state">android.flash.state</a></li>
244 </ul>
245 </li>
246 </ul> <!-- toc_section -->
247 </li>
248 <li>
249 <span class="toc_section_header"><a href="#section_geometric">geometric</a></span>
250 <ul class="toc_section">
251 <li>
252 <span class="toc_kind_header">controls</span>
253 <ul class="toc_section">
254 <li><a href="#controls_android.geometric.mode">android.geometric.mode</a></li>
255 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a></li>
256 </ul>
257 </li>
258 </ul> <!-- toc_section -->
259 </li>
260 <li>
261 <span class="toc_section_header"><a href="#section_hotPixel">hotPixel</a></span>
262 <ul class="toc_section">
263 <li>
264 <span class="toc_kind_header">controls</span>
265 <ul class="toc_section">
266 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a></li>
267 </ul>
268 </li>
269 <li>
270 <span class="toc_kind_header">static</span>
271 <ul class="toc_section">
272
273 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a></li>
274
275 </ul>
276 </li>
277 <li>
278 <span class="toc_kind_header">dynamic</span>
279 <ul class="toc_section">
280 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a></li>
281 </ul>
282 </li>
283 </ul> <!-- toc_section -->
284 </li>
285 <li>
286 <span class="toc_section_header"><a href="#section_jpeg">jpeg</a></span>
287 <ul class="toc_section">
288 <li>
289 <span class="toc_kind_header">controls</span>
290 <ul class="toc_section">
291 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
292 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
293 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
294 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a></li>
295 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a></li>
296 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
297 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
298 </ul>
299 </li>
300 <li>
301 <span class="toc_kind_header">static</span>
302 <ul class="toc_section">
303 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a></li>
304 <li><a href="#static_android.jpeg.maxSize">android.jpeg.maxSize</a></li>
305 </ul>
306 </li>
307 <li>
308 <span class="toc_kind_header">dynamic</span>
309 <ul class="toc_section">
310 <li><a href="#dynamic_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
311 <li><a href="#dynamic_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
312 <li><a href="#dynamic_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
313 <li><a href="#dynamic_android.jpeg.orientation">android.jpeg.orientation</a></li>
314 <li><a href="#dynamic_android.jpeg.quality">android.jpeg.quality</a></li>
315 <li><a href="#dynamic_android.jpeg.size">android.jpeg.size</a></li>
316 <li><a href="#dynamic_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
317 <li><a href="#dynamic_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
318 </ul>
319 </li>
320 </ul> <!-- toc_section -->
321 </li>
322 <li>
323 <span class="toc_section_header"><a href="#section_lens">lens</a></span>
324 <ul class="toc_section">
325 <li>
326 <span class="toc_kind_header">controls</span>
327 <ul class="toc_section">
328 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a></li>
329 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a></li>
330 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a></li>
331 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a></li>
332 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
333 </ul>
334 </li>
335 <li>
336 <span class="toc_kind_header">static</span>
337 <ul class="toc_section">
338
339 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a></li>
340 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a></li>
341 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a></li>
342 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a></li>
343 <li><a href="#static_android.lens.info.geometricCorrectionMap">android.lens.info.geometricCorrectionMap</a></li>
344 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a></li>
345 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a></li>
346 <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]347 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a></li>
348
349 <li><a href="#static_android.lens.facing">android.lens.facing</a></li>
350 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a></li>
351 <li><a href="#static_android.lens.position">android.lens.position</a></li>
352 </ul>
353 </li>
354 <li>
355 <span class="toc_kind_header">dynamic</span>
356 <ul class="toc_section">
357 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a></li>
358 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a></li>
359 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a></li>
360 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a></li>
361 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a></li>
362 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
363 <li><a href="#dynamic_android.lens.state">android.lens.state</a></li>
364 </ul>
365 </li>
366 </ul> <!-- toc_section -->
367 </li>
368 <li>
369 <span class="toc_section_header"><a href="#section_noiseReduction">noiseReduction</a></span>
370 <ul class="toc_section">
371 <li>
372 <span class="toc_kind_header">controls</span>
373 <ul class="toc_section">
374 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
375 <li><a href="#controls_android.noiseReduction.strength">android.noiseReduction.strength</a></li>
376 </ul>
377 </li>
378 <li>
379 <span class="toc_kind_header">dynamic</span>
380 <ul class="toc_section">
381 <li><a href="#dynamic_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
382 </ul>
383 </li>
384 </ul> <!-- toc_section -->
385 </li>
386 <li>
387 <span class="toc_section_header"><a href="#section_quirks">quirks</a></span>
388 <ul class="toc_section">
389 <li>
390 <span class="toc_kind_header">static</span>
391 <ul class="toc_section">
392 <li><a href="#static_android.quirks.meteringCropRegion">android.quirks.meteringCropRegion</a></li>
393 <li><a href="#static_android.quirks.triggerAfWithAuto">android.quirks.triggerAfWithAuto</a></li>
394 <li><a href="#static_android.quirks.useZslFormat">android.quirks.useZslFormat</a></li>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]395 <li><a href="#static_android.quirks.usePartialResult">android.quirks.usePartialResult</a></li>
396 </ul>
397 </li>
398 <li>
399 <span class="toc_kind_header">dynamic</span>
400 <ul class="toc_section">
401 <li><a href="#dynamic_android.quirks.partialResult">android.quirks.partialResult</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]402 </ul>
403 </li>
404 </ul> <!-- toc_section -->
405 </li>
406 <li>
407 <span class="toc_section_header"><a href="#section_request">request</a></span>
408 <ul class="toc_section">
409 <li>
410 <span class="toc_kind_header">controls</span>
411 <ul class="toc_section">
412 <li><a href="#controls_android.request.frameCount">android.request.frameCount</a></li>
413 <li><a href="#controls_android.request.id">android.request.id</a></li>
414 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a></li>
415 <li><a href="#controls_android.request.metadataMode">android.request.metadataMode</a></li>
416 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a></li>
417 <li><a href="#controls_android.request.type">android.request.type</a></li>
418 </ul>
419 </li>
420 <li>
421 <span class="toc_kind_header">static</span>
422 <ul class="toc_section">
423 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a></li>
424 <li><a href="#static_android.request.maxNumReprocessStreams">android.request.maxNumReprocessStreams</a></li>
425 </ul>
426 </li>
427 <li>
428 <span class="toc_kind_header">dynamic</span>
429 <ul class="toc_section">
430 <li><a href="#dynamic_android.request.frameCount">android.request.frameCount</a></li>
431 <li><a href="#dynamic_android.request.id">android.request.id</a></li>
432 <li><a href="#dynamic_android.request.metadataMode">android.request.metadataMode</a></li>
433 <li><a href="#dynamic_android.request.outputStreams">android.request.outputStreams</a></li>
434 </ul>
435 </li>
436 </ul> <!-- toc_section -->
437 </li>
438 <li>
439 <span class="toc_section_header"><a href="#section_scaler">scaler</a></span>
440 <ul class="toc_section">
441 <li>
442 <span class="toc_kind_header">controls</span>
443 <ul class="toc_section">
444 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
445 </ul>
446 </li>
447 <li>
448 <span class="toc_kind_header">static</span>
449 <ul class="toc_section">
450 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a></li>
451 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a></li>
452 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a></li>
453 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a></li>
454 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a></li>
455 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a></li>
456 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a></li>
457 <li><a href="#static_android.scaler.availableRawSizes">android.scaler.availableRawSizes</a></li>
458 </ul>
459 </li>
460 <li>
461 <span class="toc_kind_header">dynamic</span>
462 <ul class="toc_section">
463 <li><a href="#dynamic_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
464 </ul>
465 </li>
466 </ul> <!-- toc_section -->
467 </li>
468 <li>
469 <span class="toc_section_header"><a href="#section_sensor">sensor</a></span>
470 <ul class="toc_section">
471 <li>
472 <span class="toc_kind_header">controls</span>
473 <ul class="toc_section">
474 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
475 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
476 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
477 </ul>
478 </li>
479 <li>
480 <span class="toc_kind_header">static</span>
481 <ul class="toc_section">
482
483 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]484 <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]485 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a></li>
486 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a></li>
487 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a></li>
488 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a></li>
489 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a></li>
490 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a></li>
491
492 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a></li>
493 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a></li>
494 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a></li>
495 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a></li>
496 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a></li>
497 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a></li>
498 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a></li>
499 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a></li>
500 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a></li>
501 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a></li>
502 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a></li>
503 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a></li>
504 <li><a href="#static_android.sensor.referenceIlluminant2">android.sensor.referenceIlluminant2</a></li>
505 </ul>
506 </li>
507 <li>
508 <span class="toc_kind_header">dynamic</span>
509 <ul class="toc_section">
510 <li><a href="#dynamic_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
511 <li><a href="#dynamic_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
512 <li><a href="#dynamic_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
513 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a></li>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]514 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]515 </ul>
516 </li>
517 </ul> <!-- toc_section -->
518 </li>
519 <li>
520 <span class="toc_section_header"><a href="#section_shading">shading</a></span>
521 <ul class="toc_section">
522 <li>
523 <span class="toc_kind_header">controls</span>
524 <ul class="toc_section">
525 <li><a href="#controls_android.shading.mode">android.shading.mode</a></li>
526 <li><a href="#controls_android.shading.strength">android.shading.strength</a></li>
527 </ul>
528 </li>
529 <li>
530 <span class="toc_kind_header">dynamic</span>
531 <ul class="toc_section">
532 <li><a href="#dynamic_android.shading.mode">android.shading.mode</a></li>
533 </ul>
534 </li>
535 </ul> <!-- toc_section -->
536 </li>
537 <li>
538 <span class="toc_section_header"><a href="#section_statistics">statistics</a></span>
539 <ul class="toc_section">
540 <li>
541 <span class="toc_kind_header">controls</span>
542 <ul class="toc_section">
543 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
544 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
545 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]546 <li><a href="#controls_android.statistics.lensShadingMapMode">android.statistics.lensShadingMapMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]547 </ul>
548 </li>
549 <li>
550 <span class="toc_kind_header">static</span>
551 <ul class="toc_section">
552
553 <li><a href="#static_android.statistics.info.availableFaceDetectModes">android.statistics.info.availableFaceDetectModes</a></li>
554 <li><a href="#static_android.statistics.info.histogramBucketCount">android.statistics.info.histogramBucketCount</a></li>
555 <li><a href="#static_android.statistics.info.maxFaceCount">android.statistics.info.maxFaceCount</a></li>
556 <li><a href="#static_android.statistics.info.maxHistogramCount">android.statistics.info.maxHistogramCount</a></li>
557 <li><a href="#static_android.statistics.info.maxSharpnessMapValue">android.statistics.info.maxSharpnessMapValue</a></li>
558 <li><a href="#static_android.statistics.info.sharpnessMapSize">android.statistics.info.sharpnessMapSize</a></li>
559
560 </ul>
561 </li>
562 <li>
563 <span class="toc_kind_header">dynamic</span>
564 <ul class="toc_section">
565 <li><a href="#dynamic_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
566 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a></li>
567 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a></li>
568 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a></li>
569 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a></li>
570 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a></li>
571 <li><a href="#dynamic_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
572 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a></li>
573 <li><a href="#dynamic_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]574 <li><a href="#dynamic_android.statistics.lensShadingMap">android.statistics.lensShadingMap</a></li>
575 <li><a href="#dynamic_android.statistics.predictedColorGains">android.statistics.predictedColorGains</a></li>
576 <li><a href="#dynamic_android.statistics.predictedColorTransform">android.statistics.predictedColorTransform</a></li>
577 <li><a href="#dynamic_android.statistics.sceneFlicker">android.statistics.sceneFlicker</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]578 </ul>
579 </li>
580 </ul> <!-- toc_section -->
581 </li>
582 <li>
583 <span class="toc_section_header"><a href="#section_tonemap">tonemap</a></span>
584 <ul class="toc_section">
585 <li>
586 <span class="toc_kind_header">controls</span>
587 <ul class="toc_section">
588 <li><a href="#controls_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
589 <li><a href="#controls_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
590 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
591 <li><a href="#controls_android.tonemap.mode">android.tonemap.mode</a></li>
592 </ul>
593 </li>
594 <li>
595 <span class="toc_kind_header">static</span>
596 <ul class="toc_section">
597 <li><a href="#static_android.tonemap.maxCurvePoints">android.tonemap.maxCurvePoints</a></li>
598 </ul>
599 </li>
600 <li>
601 <span class="toc_kind_header">dynamic</span>
602 <ul class="toc_section">
603 <li><a href="#dynamic_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
604 <li><a href="#dynamic_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
605 <li><a href="#dynamic_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
606 <li><a href="#dynamic_android.tonemap.mode">android.tonemap.mode</a></li>
607 </ul>
608 </li>
609 </ul> <!-- toc_section -->
610 </li>
611 <li>
612 <span class="toc_section_header"><a href="#section_led">led</a></span>
613 <ul class="toc_section">
614 <li>
615 <span class="toc_kind_header">controls</span>
616 <ul class="toc_section">
617 <li><a href="#controls_android.led.transmit">android.led.transmit</a></li>
618 </ul>
619 </li>
620 <li>
621 <span class="toc_kind_header">dynamic</span>
622 <ul class="toc_section">
623 <li><a href="#dynamic_android.led.transmit">android.led.transmit</a></li>
624 </ul>
625 </li>
626 <li>
627 <span class="toc_kind_header">static</span>
628 <ul class="toc_section">
629 <li><a href="#static_android.led.availableLeds">android.led.availableLeds</a></li>
630 </ul>
631 </li>
632 </ul> <!-- toc_section -->
633 </li>
634 <li>
635 <span class="toc_section_header"><a href="#section_info">info</a></span>
636 <ul class="toc_section">
637 <li>
638 <span class="toc_kind_header">static</span>
639 <ul class="toc_section">
640 <li><a href="#static_android.info.supportedHardwareLevel">android.info.supportedHardwareLevel</a></li>
641 </ul>
642 </li>
643 </ul> <!-- toc_section -->
644 </li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]645 <li>
646 <span class="toc_section_header"><a href="#section_blackLevel">blackLevel</a></span>
647 <ul class="toc_section">
648 <li>
649 <span class="toc_kind_header">controls</span>
650 <ul class="toc_section">
651 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a></li>
652 </ul>
653 </li>
654 <li>
655 <span class="toc_kind_header">dynamic</span>
656 <ul class="toc_section">
657 <li><a href="#dynamic_android.blackLevel.lock">android.blackLevel.lock</a></li>
658 </ul>
659 </li>
660 </ul> <!-- toc_section -->
661 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]662 </ul>
663
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]664
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]665 <h1>Properties</h1>
666 <table class="properties">
667
668 <thead class="thead_dummy">
669 <tr>
670 <th class="th_name">Property Name</th>
671 <th class="th_type">Type</th>
672 <th class="th_description">Description</th>
673 <th class="th_units">Units</th>
674 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]675 <th class="th_tags">Tags</th>
676 </tr>
677 </thead> <!-- so that the first occurrence of thead is not
678 above the first occurrence of tr -->
679<!-- <namespace name="android"> -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]680 <tr><td colspan="6" id="section_colorCorrection" class="section">colorCorrection</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]681
682
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]683 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]684
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]685 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]686 <tr>
687 <th class="th_name">Property Name</th>
688 <th class="th_type">Type</th>
689 <th class="th_description">Description</th>
690 <th class="th_units">Units</th>
691 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]692 <th class="th_tags">Tags</th>
693 </tr>
694 </thead>
695
696 <tbody>
697
698
699
700
701
702
703
704
705
706
707 <tr class="entry" id="controls_android.colorCorrection.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]708 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]709 android.<wbr/>color<wbr/>Correction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]710 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]711 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]712 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]713
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]714 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]715
716 <ul class="entry_type_enum">
717 <li>
718 <span class="entry_type_enum_name">TRANSFORM_MATRIX</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]719 <span class="entry_type_enum_notes">Use the android.<wbr/>color<wbr/>Correction.<wbr/>transform matrix
720 and android.<wbr/>color<wbr/>Correction.<wbr/>gains to do color conversion</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]721 </li>
722 <li>
723 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]724 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
725 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]726 </li>
727 <li>
728 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]729 <span class="entry_type_enum_notes">Frame rate may be reduced by high
730 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]731 </li>
732 </ul>
733
734 </td> <!-- entry_type -->
735
736 <td class="entry_description">
737 </td>
738
739 <td class="entry_units">
740 </td>
741
742 <td class="entry_range">
743 </td>
744
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]745 <td class="entry_tags">
746 </td>
747
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]748 </tr>
749 <tr class="entries_header">
750 <th class="th_details" colspan="5">Details</th>
751 </tr>
752 <tr class="entry_cont">
753 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]754 <p>When <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> is not OFF,<wbr/> TRANSFORM_<wbr/>MATRIX
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]755should be ignored.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]756 </td>
757 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]758
759
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]760 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
761 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]762
763
764 <tr class="entry" id="controls_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]765 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]766 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]767 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]768 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]769 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]770 <span class="entry_type_container">x</span>
771
772 <span class="entry_type_array">
773 3 x 3
774 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]775 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]776 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]777
778
779 </td> <!-- entry_type -->
780
781 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]782 <p>A color transform matrix to use to transform
783from sensor RGB color space to output linear sRGB color space</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]784 </td>
785
786 <td class="entry_units">
787 </td>
788
789 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]790 <p>Output values are expected to be in the range
791(0,<wbr/>1)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]792 </td>
793
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]794 <td class="entry_tags">
795 </td>
796
797 </tr>
798 <tr class="entries_header">
799 <th class="th_details" colspan="5">Details</th>
800 </tr>
801 <tr class="entry_cont">
802 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]803 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]804<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]805directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]806<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]807<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]808for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]809reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]810 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]811 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]812
813
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]814 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
815 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]816
817
818 <tr class="entry" id="controls_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]819 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]820 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]821 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]822 <td class="entry_type">
823 <span class="entry_type_name">float</span>
824 <span class="entry_type_container">x</span>
825
826 <span class="entry_type_array">
827 4
828 </span>
829 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]830 <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]831
832
833 </td> <!-- entry_type -->
834
835 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]836 <p>Gains applying to Bayer color channels for
837white-balance</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]838 </td>
839
840 <td class="entry_units">
841 </td>
842
843 <td class="entry_range">
844 </td>
845
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]846 <td class="entry_tags">
847 </td>
848
849 </tr>
850 <tr class="entries_header">
851 <th class="th_details" colspan="5">Details</th>
852 </tr>
853 <tr class="entry_cont">
854 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]855 <p>The 4-channel white-balance gains are defined in
856the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
857for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
858is the gain for greenpixels on the odd rows.<wbr/> if a HAL
859does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
860it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
861G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]862<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]863<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]864directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]865<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]866<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]867the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]868 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]869 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]870
871
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]872 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
873 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]874
875
876
877 <!-- end of kind -->
878 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]879 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]880
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]881 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]882 <tr>
883 <th class="th_name">Property Name</th>
884 <th class="th_type">Type</th>
885 <th class="th_description">Description</th>
886 <th class="th_units">Units</th>
887 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]888 <th class="th_tags">Tags</th>
889 </tr>
890 </thead>
891
892 <tbody>
893
894
895
896
897
898
899
900
901
902
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]903 <tr class="entry" id="dynamic_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]904 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]905 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]906 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]907 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]908 <span class="entry_type_name">rational</span>
909 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]910
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]911 <span class="entry_type_array">
912 3 x 3
913 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]914 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]915 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]916
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]917
918 </td> <!-- entry_type -->
919
920 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]921 <p>A color transform matrix to use to transform
922from sensor RGB color space to output linear sRGB color space</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]923 </td>
924
925 <td class="entry_units">
926 </td>
927
928 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]929 <p>Output values are expected to be in the range
930(0,<wbr/>1)</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]931 </td>
932
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]933 <td class="entry_tags">
934 </td>
935
936 </tr>
937 <tr class="entries_header">
938 <th class="th_details" colspan="5">Details</th>
939 </tr>
940 <tr class="entry_cont">
941 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]942 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]943<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]944directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]945<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]946<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]947for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]948reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]949 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]950 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]951
952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]953 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
954 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]955
956
957 <tr class="entry" id="dynamic_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]958 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]959 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]960 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]961 <td class="entry_type">
962 <span class="entry_type_name">float</span>
963 <span class="entry_type_container">x</span>
964
965 <span class="entry_type_array">
966 4
967 </span>
968 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]969 <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]970
971
972 </td> <!-- entry_type -->
973
974 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]975 <p>Gains applying to Bayer color channels for
976white-balance</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]977 </td>
978
979 <td class="entry_units">
980 </td>
981
982 <td class="entry_range">
983 </td>
984
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]985 <td class="entry_tags">
986 </td>
987
988 </tr>
989 <tr class="entries_header">
990 <th class="th_details" colspan="5">Details</th>
991 </tr>
992 <tr class="entry_cont">
993 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]994 <p>The 4-channel white-balance gains are defined in
995the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
996for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
997is the gain for greenpixels on the odd rows.<wbr/> if a HAL
998does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
999it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
1000G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1001<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1002<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1003directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1004<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1005<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1006the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1007 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1008 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1009
1010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1011 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1012 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1013
1014
1015
1016 <!-- end of kind -->
1017 </tbody>
1018
1019 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1020 <tr><td colspan="6" id="section_control" class="section">control</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1021
1022
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1023 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1024
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1025 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1026 <tr>
1027 <th class="th_name">Property Name</th>
1028 <th class="th_type">Type</th>
1029 <th class="th_description">Description</th>
1030 <th class="th_units">Units</th>
1031 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1032 <th class="th_tags">Tags</th>
1033 </tr>
1034 </thead>
1035
1036 <tbody>
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047 <tr class="entry" id="controls_android.control.aeAntibandingMode">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1048 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1049 android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1050 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1051 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1052 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1053
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1054 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1055
1056 <ul class="entry_type_enum">
1057 <li>
1058 <span class="entry_type_enum_name">OFF</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1059 <span class="entry_type_enum_notes">
1060 The camera device will not adjust exposure duration to
1061 avoid banding problems.<wbr/>
1062 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1063 </li>
1064 <li>
1065 <span class="entry_type_enum_name">50HZ</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1066 <span class="entry_type_enum_notes">
1067 The camera device will adjust exposure duration to
1068 avoid banding problems with 50Hz illumination sources.<wbr/>
1069 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1070 </li>
1071 <li>
1072 <span class="entry_type_enum_name">60HZ</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1073 <span class="entry_type_enum_notes">
1074 The camera device will adjust exposure duration to
1075 avoid banding problems with 60Hz illumination
1076 sources.<wbr/>
1077 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1078 </li>
1079 <li>
1080 <span class="entry_type_enum_name">AUTO</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1081 <span class="entry_type_enum_notes">
1082 The camera device will automatically adapt its
1083 antibanding routine to the current illumination
1084 conditions.<wbr/> This is the default.<wbr/>
1085 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1086 </li>
1087 </ul>
1088
1089 </td> <!-- entry_type -->
1090
1091 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1092 <p>The desired setting for the camera device's auto-exposure
1093algorithm's antibanding compensation.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1094 </td>
1095
1096 <td class="entry_units">
1097 </td>
1098
1099 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1100 <p><a href="#static_android.control.aeAvailableAntibandingModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1101 </td>
1102
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1103 <td class="entry_tags">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1104 <ul class="entry_tags">
1105 <li><a href="#tag_BC">BC</a></li>
1106 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1107 </td>
1108
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1109 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1110 <tr class="entries_header">
1111 <th class="th_details" colspan="5">Details</th>
1112 </tr>
1113 <tr class="entry_cont">
1114 <td class="entry_details" colspan="5">
1115 <p>Some kinds of lighting fixtures,<wbr/> such as some fluorescent
1116lights,<wbr/> flicker at the rate of the power supply frequency
1117(60Hz or 50Hz,<wbr/> depending on country).<wbr/> While this is
1118typically not noticeable to a person,<wbr/> it can be visible to
1119a camera device.<wbr/> If a camera sets its exposure time to the
1120wrong value,<wbr/> the flicker may become visible in the
1121viewfinder as flicker or in a final captured image,<wbr/> as a
1122set of variable-brightness bands across the image.<wbr/></p>
1123<p>Therefore,<wbr/> the auto-exposure routines of camera devices
1124include antibanding routines that ensure that the chosen
1125exposure value will not cause such banding.<wbr/> The choice of
1126exposure time depends on the rate of flicker,<wbr/> which the
1127camera device can detect automatically,<wbr/> or the expected
1128rate can be selected by the application using this
1129control.<wbr/></p>
1130<p>A given camera device may not support all of the possible
1131options for the antibanding mode.<wbr/> The
1132<a href="#static_android.control.aeAvailableAntibandingModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes</a> key contains
1133the available modes for a given camera device.<wbr/></p>
1134<p>The default mode is AUTO,<wbr/> which must be supported by all
1135camera devices.<wbr/></p>
1136<p>If manual exposure control is enabled (by setting
1137<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> or <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> to OFF),<wbr/>
1138then this setting has no effect,<wbr/> and the application must
1139ensure it selects exposure times that do not cause banding
1140issues.<wbr/> The <a href="#dynamic_android.statistics.sceneFlicker">android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker</a> key can assist
1141the application in this.<wbr/></p>
1142 </td>
1143 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1144
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1145 <tr class="entries_header">
1146 <th class="th_details" colspan="5">HAL Implementation Details</th>
1147 </tr>
1148 <tr class="entry_cont">
1149 <td class="entry_details" colspan="5">
1150 <p>For all capture request templates,<wbr/> this field must be set
1151to AUTO.<wbr/> AUTO is the only mode that must supported;
1152OFF,<wbr/> 50HZ,<wbr/> 60HZ are all optional.<wbr/></p>
1153<p>If manual exposure control is enabled (by setting
1154<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> or <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> to OFF),<wbr/>
1155then the exposure values provided by the application must not be
1156adjusted for antibanding.<wbr/></p>
1157 </td>
1158 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1160 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1161 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1162
1163
1164 <tr class="entry" id="controls_android.control.aeExposureCompensation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1165 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1166 android.<wbr/>control.<wbr/>ae<wbr/>Exposure<wbr/>Compensation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1167 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1168 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1169 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1170
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1171 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1172
1173
1174 </td> <!-- entry_type -->
1175
1176 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1177 <p>Adjustment to AE target image
1178brightness</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1179 </td>
1180
1181 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1182 count of positive/<wbr/>negative EV steps
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1183 </td>
1184
1185 <td class="entry_range">
1186 </td>
1187
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1188 <td class="entry_tags">
1189 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1190 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1191 </ul>
1192 </td>
1193
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1194 </tr>
1195 <tr class="entries_header">
1196 <th class="th_details" colspan="5">Details</th>
1197 </tr>
1198 <tr class="entry_cont">
1199 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1200 <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]1201exposure compensation of +2 EV; -3 will mean an exposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1202compensation of -1</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1203 </td>
1204 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1205
1206
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1207 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1208 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1209
1210
1211 <tr class="entry" id="controls_android.control.aeLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1212 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1213 android.<wbr/>control.<wbr/>ae<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1214 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1215 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1216 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1217
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1218 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1219
1220 <ul class="entry_type_enum">
1221 <li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1222 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1223 <span class="entry_type_enum_notes">Autoexposure lock is disabled; the AE algorithm
1224 is free to update its parameters.<wbr/></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1225 </li>
1226 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1227 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1228 <span class="entry_type_enum_notes">Autoexposure lock is enabled; the AE algorithm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1229 must not update the exposure and sensitivity parameters
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1230 while the lock is active</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1231 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1232 </ul>
1233
1234 </td> <!-- entry_type -->
1235
1236 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1237 <p>Whether AE is currently locked to its latest
1238calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1239 </td>
1240
1241 <td class="entry_units">
1242 </td>
1243
1244 <td class="entry_range">
1245 </td>
1246
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1247 <td class="entry_tags">
1248 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1249 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1250 </ul>
1251 </td>
1252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1253 </tr>
1254 <tr class="entries_header">
1255 <th class="th_details" colspan="5">Details</th>
1256 </tr>
1257 <tr class="entry_cont">
1258 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1259 <p>Note that even when AE is locked,<wbr/> the flash may be
1260fired if the AE mode is ON_<wbr/>AUTO_<wbr/>FLASH /<wbr/> ON_<wbr/>ALWAYS_<wbr/>FLASH /<wbr/>
1261ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1262 </td>
1263 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1264
1265
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1266 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1267 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1268
1269
1270 <tr class="entry" id="controls_android.control.aeMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1271 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1272 android.<wbr/>control.<wbr/>ae<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1273 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1274 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1275 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1276
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1277 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1278
1279 <ul class="entry_type_enum">
1280 <li>
1281 <span class="entry_type_enum_name">OFF</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1282 <span class="entry_type_enum_notes">
1283 The camera device's autoexposure routine is disabled;
1284 the application-selected android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
1285 android.<wbr/>sensor.<wbr/>sensitivity and
1286 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are used by the camera
1287 device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
1288 a flash unit for this camera device.<wbr/>
1289 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1290 </li>
1291 <li>
1292 <span class="entry_type_enum_name">ON</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1293 <span class="entry_type_enum_notes">
1294 The camera device's autoexposure routine is active,<wbr/>
1295 with no flash control.<wbr/> The application's values for
1296 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
1297 android.<wbr/>sensor.<wbr/>sensitivity,<wbr/> and
1298 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are ignored.<wbr/> The
1299 application has control over the various
1300 android.<wbr/>flash.<wbr/>* fields.<wbr/>
1301 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1302 </li>
1303 <li>
1304 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1305 <span class="entry_type_enum_notes">
1306 Like ON,<wbr/> except that the camera device also controls
1307 the camera's flash unit,<wbr/> firing it in low-light
1308 conditions.<wbr/> The flash may be fired during a
1309 precapture sequence (triggered by
1310 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and may be fired
1311 for captures for which the
1312 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
1313 STILL_<wbr/>CAPTURE
1314 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1315 </li>
1316 <li>
1317 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1318 <span class="entry_type_enum_notes">
1319 Like ON,<wbr/> except that the camera device also controls
1320 the camera's flash unit,<wbr/> always firing it for still
1321 captures.<wbr/> The flash may be fired during a precapture
1322 sequence (triggered by
1323 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and will always
1324 be fired for captures for which the
1325 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
1326 STILL_<wbr/>CAPTURE
1327 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1328 </li>
1329 <li>
1330 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1331 <span class="entry_type_enum_notes">
1332 Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
1333 reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
1334 a red eye reduction flash will fire during the
1335 precapture sequence.<wbr/>
1336 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1337 </li>
1338 </ul>
1339
1340 </td> <!-- entry_type -->
1341
1342 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1343 <p>The desired mode for the camera device's
1344auto-exposure routine.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1345 </td>
1346
1347 <td class="entry_units">
1348 </td>
1349
1350 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1351 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1352 </td>
1353
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1354 <td class="entry_tags">
1355 <ul class="entry_tags">
1356 <li><a href="#tag_BC">BC</a></li>
1357 </ul>
1358 </td>
1359
1360 </tr>
1361 <tr class="entries_header">
1362 <th class="th_details" colspan="5">Details</th>
1363 </tr>
1364 <tr class="entry_cont">
1365 <td class="entry_details" colspan="5">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1366 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
1367AUTO.<wbr/></p>
1368<p>When set to any of the ON modes,<wbr/> the camera device's
1369auto-exposure routine is enabled,<wbr/> overriding the
1370application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
1371and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1372<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
1373<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
1374is selected,<wbr/> the camera device's flash unit controls are
1375also overridden.<wbr/></p>
1376<p>The FLASH modes are only available if the camera device
1377has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
1378<p>If flash TORCH mode is desired,<wbr/> this field must be set to
1379ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
1380<p>When set to any of the ON modes,<wbr/> the values chosen by the
1381camera device auto-exposure routine for the overridden
1382fields for a given capture will be available in its
1383CaptureResult.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1384 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1385 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1386
1387
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1388 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1389 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1390
1391
1392 <tr class="entry" id="controls_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1393 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1394 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1395 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1396 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1397 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1398 <span class="entry_type_container">x</span>
1399
1400 <span class="entry_type_array">
1401 5 x area_count
1402 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1403 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1404
1405
1406 </td> <!-- entry_type -->
1407
1408 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1409 <p>List of areas to use for
1410metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1411 </td>
1412
1413 <td class="entry_units">
1414 </td>
1415
1416 <td class="entry_range">
1417 </td>
1418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1419 <td class="entry_tags">
1420 <ul class="entry_tags">
1421 <li><a href="#tag_BC">BC</a></li>
1422 </ul>
1423 </td>
1424
1425 </tr>
1426 <tr class="entries_header">
1427 <th class="th_details" colspan="5">Details</th>
1428 </tr>
1429 <tr class="entry_cont">
1430 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1431 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1432xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1433specified coordinates.<wbr/></p>
1434<p>The coordinate system is based on the active pixel array,<wbr/>
1435with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1436(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1437<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1438bottom-right pixel in the active pixel array.<wbr/> The weight
1439should be nonnegative.<wbr/></p>
1440<p>If all regions have 0 weight,<wbr/> then no specific metering area
1441needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1442outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1443should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1444used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1445 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1446 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1447
1448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1449 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1450 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1451
1452
1453 <tr class="entry" id="controls_android.control.aeTargetFpsRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1454 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1455 android.<wbr/>control.<wbr/>ae<wbr/>Target<wbr/>Fps<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1456 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1457 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1458 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1459 <span class="entry_type_container">x</span>
1460
1461 <span class="entry_type_array">
1462 2
1463 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1464 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1465
1466
1467 </td> <!-- entry_type -->
1468
1469 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1470 <p>Range over which fps can be adjusted to
1471maintain exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1472 </td>
1473
1474 <td class="entry_units">
1475 </td>
1476
1477 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1478 <p><a href="#static_android.control.aeAvailableTargetFpsRanges">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1479 </td>
1480
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1481 <td class="entry_tags">
1482 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1483 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1484 </ul>
1485 </td>
1486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1487 </tr>
1488 <tr class="entries_header">
1489 <th class="th_details" colspan="5">Details</th>
1490 </tr>
1491 <tr class="entry_cont">
1492 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1493 <p>Only constrains AE algorithm,<wbr/> not manual control
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1494of <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1495 </td>
1496 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1497
1498
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1499 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1500 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1501
1502
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1503 <tr class="entry" id="controls_android.control.aePrecaptureTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1504 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1505 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1506 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1507 <td class="entry_type">
1508 <span class="entry_type_name entry_type_name_enum">byte</span>
1509
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1510 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1511
1512 <ul class="entry_type_enum">
1513 <li>
1514 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1515 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1516 </li>
1517 <li>
1518 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1519 <span class="entry_type_enum_notes">The precapture metering sequence
1520 must be started.<wbr/> The exact effect of the precapture
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1521 trigger depends on the current AE mode and
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1522 state.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1523 </li>
1524 </ul>
1525
1526 </td> <!-- entry_type -->
1527
1528 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1529 <p>Whether the HAL must trigger precapture
1530metering.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1531 </td>
1532
1533 <td class="entry_units">
1534 </td>
1535
1536 <td class="entry_range">
1537 </td>
1538
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1539 <td class="entry_tags">
1540 <ul class="entry_tags">
1541 <li><a href="#tag_BC">BC</a></li>
1542 </ul>
1543 </td>
1544
1545 </tr>
1546 <tr class="entries_header">
1547 <th class="th_details" colspan="5">Details</th>
1548 </tr>
1549 <tr class="entry_cont">
1550 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1551 <p>This entry is normally set to IDLE,<wbr/> or is not
1552included at all in the request settings.<wbr/> When included and
1553set to START,<wbr/> the HAL must trigger the autoexposure
1554precapture metering sequence.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1555<p>The effect of AE precapture trigger depends on the current
1556AE mode and state; see the camera HAL device v3 header for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1557details.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1558 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1559 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1560
1561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1562 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1563 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1564
1565
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1566 <tr class="entry" id="controls_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1567 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1568 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1569 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1570 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1571 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1572
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1573 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1574
1575 <ul class="entry_type_enum">
1576 <li>
1577 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1578 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
1579 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
1580 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1581 </li>
1582 <li>
1583 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1584 <span class="entry_type_enum_notes">
1585 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1586
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1587 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
1588 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
1589 the autofocus trigger action is called.<wbr/> When that trigger
1590 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
1591 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1592
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1593 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
1594 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1595 </li>
1596 <li>
1597 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1598 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
1599 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1600
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1601 When that trigger is activated,<wbr/> AF must transition to
1602 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
1603 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
1604 position to default,<wbr/> and sets the AF state to
1605 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1606 </li>
1607 <li>
1608 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1609 <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]1610 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1611 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1612
1613 The focusing behavior should be suitable for good quality
1614 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1615 movement and no overshoots.<wbr/> When the AF trigger is not
1616 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
1617 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
1618 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1619 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1620 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1621 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1622
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1623 Once cancel is received,<wbr/> the algorithm should transition
1624 back to INACTIVE and resume passive scan.<wbr/> Note that this
1625 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
1626 ongoing PASSIVE_<wbr/>SCAN must immediately be
1627 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1628 </li>
1629 <li>
1630 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1631 <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]1632 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1633 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1634
1635 The focusing behavior should be suitable for still image
1636 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1637 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
1638 algorithm should start in INACTIVE state,<wbr/> and then
1639 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
1640 appropriate as it attempts to maintain focus.<wbr/> When the AF
1641 trigger is activated,<wbr/> the algorithm should finish its
1642 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
1643 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1644 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1645
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1646 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1647 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1648 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1649 </li>
1650 <li>
1651 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1652 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
1653 trigger is ignored,<wbr/> AF state should always be
1654 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1655 </li>
1656 </ul>
1657
1658 </td> <!-- entry_type -->
1659
1660 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1661 <p>Whether AF is currently enabled,<wbr/> and what
1662mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1663 </td>
1664
1665 <td class="entry_units">
1666 </td>
1667
1668 <td class="entry_range">
1669 </td>
1670
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1671 <td class="entry_tags">
1672 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1673 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1674 </ul>
1675 </td>
1676
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1677 </tr>
1678 <tr class="entries_header">
1679 <th class="th_details" colspan="5">Details</th>
1680 </tr>
1681 <tr class="entry_cont">
1682 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1683 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame^]1684<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
1685the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
1686in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1687 </td>
1688 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1689
1690
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1691 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1692 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1693
1694
1695 <tr class="entry" id="controls_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1696 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1697 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1698 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1699 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1700 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1701 <span class="entry_type_container">x</span>
1702
1703 <span class="entry_type_array">
1704 5 x area_count
1705 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1706 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1707
1708
1709 </td> <!-- entry_type -->
1710
1711 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1712 <p>List of areas to use for focus
1713estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1714 </td>
1715
1716 <td class="entry_units">
1717 </td>
1718
1719 <td class="entry_range">
1720 </td>
1721
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1722 <td class="entry_tags">
1723 <ul class="entry_tags">
1724 <li><a href="#tag_BC">BC</a></li>
1725 </ul>
1726 </td>
1727
1728 </tr>
1729 <tr class="entries_header">
1730 <th class="th_details" colspan="5">Details</th>
1731 </tr>
1732 <tr class="entry_cont">
1733 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1734 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1735xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1736specified coordinates.<wbr/></p>
1737<p>The coordinate system is based on the active pixel array,<wbr/>
1738with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1739(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1740<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1741bottom-right pixel in the active pixel array.<wbr/> The weight
1742should be nonnegative.<wbr/></p>
1743<p>If all regions have 0 weight,<wbr/> then no specific focus area
1744needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1745outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1746should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1747used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1748 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1749 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1750
1751
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1752 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1753 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1754
1755
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1756 <tr class="entry" id="controls_android.control.afTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1757 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1758 android.<wbr/>control.<wbr/>af<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1759 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1760 <td class="entry_type">
1761 <span class="entry_type_name entry_type_name_enum">byte</span>
1762
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1763 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1764
1765 <ul class="entry_type_enum">
1766 <li>
1767 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1768 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1769 </li>
1770 <li>
1771 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1772 <span class="entry_type_enum_notes">Autofocus must trigger now.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1773 </li>
1774 <li>
1775 <span class="entry_type_enum_name">CANCEL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1776 <span class="entry_type_enum_notes">Autofocus must return to initial
1777 state,<wbr/> and cancel any active trigger.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1778 </li>
1779 </ul>
1780
1781 </td> <!-- entry_type -->
1782
1783 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1784 <p>Whether the HAL must trigger autofocus.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1785 </td>
1786
1787 <td class="entry_units">
1788 </td>
1789
1790 <td class="entry_range">
1791 </td>
1792
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1793 <td class="entry_tags">
1794 <ul class="entry_tags">
1795 <li><a href="#tag_BC">BC</a></li>
1796 </ul>
1797 </td>
1798
1799 </tr>
1800 <tr class="entries_header">
1801 <th class="th_details" colspan="5">Details</th>
1802 </tr>
1803 <tr class="entry_cont">
1804 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1805 <p>This entry is normally set to IDLE,<wbr/> or is not
1806included at all in the request settings.<wbr/></p>
1807<p>When included and set to START,<wbr/> the HAL must trigger the
1808autofocus algorithm.<wbr/> The effect of AF trigger depends on the
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1809current AF mode and state; see the camera HAL device v3
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1810header for details.<wbr/> When set to CANCEL,<wbr/> the HAL must cancel
1811any active trigger,<wbr/> and return to initial AF state.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1812 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1813 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1814
1815
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1816 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1817 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1818
1819
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1820 <tr class="entry" id="controls_android.control.awbLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1821 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1822 android.<wbr/>control.<wbr/>awb<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1823 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1824 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1825 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1826
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1827 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1828
1829 <ul class="entry_type_enum">
1830 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1831 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1832 <span class="entry_type_enum_notes">Auto-whitebalance lock is disabled; the AWB
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1833 algorithm is free to update its parameters if in AUTO
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1834 mode.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1835 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1836 <li>
1837 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1838 <span class="entry_type_enum_notes">Auto-whitebalance lock is enabled; the AWB
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1839 algorithm must not update the exposure and sensitivity
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1840 parameters while the lock is active</span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1841 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1842 </ul>
1843
1844 </td> <!-- entry_type -->
1845
1846 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1847 <p>Whether AWB is currently locked to its
1848latest calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1849 </td>
1850
1851 <td class="entry_units">
1852 </td>
1853
1854 <td class="entry_range">
1855 </td>
1856
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1857 <td class="entry_tags">
1858 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1859 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1860 </ul>
1861 </td>
1862
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1863 </tr>
1864 <tr class="entries_header">
1865 <th class="th_details" colspan="5">Details</th>
1866 </tr>
1867 <tr class="entry_cont">
1868 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1869 <p>Note that AWB lock is only meaningful for AUTO
1870mode; in other modes,<wbr/> AWB is already fixed to a specific
1871setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1872 </td>
1873 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1874
1875
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1876 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1877 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1878
1879
1880 <tr class="entry" id="controls_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1881 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1882 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1883 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1884 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1885 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1886
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1887 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1888
1889 <ul class="entry_type_enum">
1890 <li>
1891 <span class="entry_type_enum_name">OFF</span>
1892 </li>
1893 <li>
1894 <span class="entry_type_enum_name">AUTO</span>
1895 </li>
1896 <li>
1897 <span class="entry_type_enum_name">INCANDESCENT</span>
1898 </li>
1899 <li>
1900 <span class="entry_type_enum_name">FLUORESCENT</span>
1901 </li>
1902 <li>
1903 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
1904 </li>
1905 <li>
1906 <span class="entry_type_enum_name">DAYLIGHT</span>
1907 </li>
1908 <li>
1909 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
1910 </li>
1911 <li>
1912 <span class="entry_type_enum_name">TWILIGHT</span>
1913 </li>
1914 <li>
1915 <span class="entry_type_enum_name">SHADE</span>
1916 </li>
1917 </ul>
1918
1919 </td> <!-- entry_type -->
1920
1921 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1922 <p>Whether AWB is currently setting the color
1923transform fields,<wbr/> and what its illumination target
1924is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1925 </td>
1926
1927 <td class="entry_units">
1928 </td>
1929
1930 <td class="entry_range">
1931 </td>
1932
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1933 <td class="entry_tags">
1934 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1935 <li><a href="#tag_BC">BC</a></li>
1936 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1937 </ul>
1938 </td>
1939
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1940 </tr>
1941 <tr class="entries_header">
1942 <th class="th_details" colspan="5">Details</th>
1943 </tr>
1944 <tr class="entry_cont">
1945 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1946 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1947<p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1948 </td>
1949 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1950
1951
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1952 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1953 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1954
1955
1956 <tr class="entry" id="controls_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1957 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1958 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1959 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1960 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1961 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1962 <span class="entry_type_container">x</span>
1963
1964 <span class="entry_type_array">
1965 5 x area_count
1966 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1967 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1968
1969
1970 </td> <!-- entry_type -->
1971
1972 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1973 <p>List of areas to use for illuminant
1974estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1975 </td>
1976
1977 <td class="entry_units">
1978 </td>
1979
1980 <td class="entry_range">
1981 </td>
1982
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1983 <td class="entry_tags">
1984 <ul class="entry_tags">
1985 <li><a href="#tag_BC">BC</a></li>
1986 </ul>
1987 </td>
1988
1989 </tr>
1990 <tr class="entries_header">
1991 <th class="th_details" colspan="5">Details</th>
1992 </tr>
1993 <tr class="entry_cont">
1994 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1995 <p>Only used in AUTO mode.<wbr/></p>
1996<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1997xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1998specified coordinates.<wbr/></p>
1999<p>The coordinate system is based on the active pixel array,<wbr/>
2000with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2001(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
2002<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2003bottom-right pixel in the active pixel array.<wbr/> The weight
2004should be nonnegative.<wbr/></p>
2005<p>If all regions have 0 weight,<wbr/> then no specific metering area
2006needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2007outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]2008should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2009used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2010 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2011 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2012
2013
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2014 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2015 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2016
2017
2018 <tr class="entry" id="controls_android.control.captureIntent">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2019 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2020 android.<wbr/>control.<wbr/>capture<wbr/>Intent
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2021 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2022 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2023 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2024
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2025 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2026
2027 <ul class="entry_type_enum">
2028 <li>
2029 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2030 <span class="entry_type_enum_notes">This request doesn't fall into the other
2031 categories.<wbr/> Default to preview-like
2032 behavior.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2033 </li>
2034 <li>
2035 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2036 <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]2037 precapture trigger may be used to start off a metering
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2038 w/<wbr/>flash sequence</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2039 </li>
2040 <li>
2041 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2042 <span class="entry_type_enum_notes">This request is for a still capture-type
2043 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2044 </li>
2045 <li>
2046 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2047 <span class="entry_type_enum_notes">This request is for a video recording
2048 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2049 </li>
2050 <li>
2051 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2052 <span class="entry_type_enum_notes">This request is for a video snapshot (still
2053 image while recording video) usecase</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2054 </li>
2055 <li>
2056 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2057 <span class="entry_type_enum_notes">This request is for a ZSL usecase; the
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2058 application will stream full-resolution images and
2059 reprocess one or several later for a final
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2060 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2061 </li>
2062 </ul>
2063
2064 </td> <!-- entry_type -->
2065
2066 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2067 <p>Information to 3A routines about the purpose
2068of this capture,<wbr/> to help decide optimal 3A
2069strategy</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2070 </td>
2071
2072 <td class="entry_units">
2073 </td>
2074
2075 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2076 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2077 </td>
2078
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2079 <td class="entry_tags">
2080 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2081 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2082 </ul>
2083 </td>
2084
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2085 </tr>
2086 <tr class="entries_header">
2087 <th class="th_details" colspan="5">Details</th>
2088 </tr>
2089 <tr class="entry_cont">
2090 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2091 <p>Only used if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2092 </td>
2093 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2094
2095
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2096 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2097 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2098
2099
2100 <tr class="entry" id="controls_android.control.effectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2101 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2102 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2103 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2104 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2105 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2106
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2107 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2108
2109 <ul class="entry_type_enum">
2110 <li>
2111 <span class="entry_type_enum_name">OFF</span>
2112 </li>
2113 <li>
2114 <span class="entry_type_enum_name">MONO</span>
2115 <span class="entry_type_enum_optional">optional</span>
2116 </li>
2117 <li>
2118 <span class="entry_type_enum_name">NEGATIVE</span>
2119 <span class="entry_type_enum_optional">optional</span>
2120 </li>
2121 <li>
2122 <span class="entry_type_enum_name">SOLARIZE</span>
2123 <span class="entry_type_enum_optional">optional</span>
2124 </li>
2125 <li>
2126 <span class="entry_type_enum_name">SEPIA</span>
2127 <span class="entry_type_enum_optional">optional</span>
2128 </li>
2129 <li>
2130 <span class="entry_type_enum_name">POSTERIZE</span>
2131 <span class="entry_type_enum_optional">optional</span>
2132 </li>
2133 <li>
2134 <span class="entry_type_enum_name">WHITEBOARD</span>
2135 <span class="entry_type_enum_optional">optional</span>
2136 </li>
2137 <li>
2138 <span class="entry_type_enum_name">BLACKBOARD</span>
2139 <span class="entry_type_enum_optional">optional</span>
2140 </li>
2141 <li>
2142 <span class="entry_type_enum_name">AQUA</span>
2143 <span class="entry_type_enum_optional">optional</span>
2144 </li>
2145 </ul>
2146
2147 </td> <!-- entry_type -->
2148
2149 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2150 <p>Whether any special color effect is in use.<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2151Only used if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2152 </td>
2153
2154 <td class="entry_units">
2155 </td>
2156
2157 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2158 <p><a href="#static_android.control.availableEffects">android.<wbr/>control.<wbr/>available<wbr/>Effects</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2159 </td>
2160
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2161 <td class="entry_tags">
2162 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2163 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2164 </ul>
2165 </td>
2166
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2167 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2168
2169
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2170 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2171 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2172
2173
2174 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2175 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2176 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2177 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2178 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2179 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2180
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2181 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2182
2183 <ul class="entry_type_enum">
2184 <li>
2185 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2186 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
2187 routines are disabled,<wbr/> no other settings in
2188 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2189 </li>
2190 <li>
2191 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2192 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
2193 Manual control of capture parameters is disabled.<wbr/> All
2194 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2195 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2196 </li>
2197 <li>
2198 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2199 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
2200 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2201 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2202 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2203 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2204 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2205 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2206 </li>
2207 </ul>
2208
2209 </td> <!-- entry_type -->
2210
2211 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2212 <p>Overall mode of 3A control
2213routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2214 </td>
2215
2216 <td class="entry_units">
2217 </td>
2218
2219 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2220 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2221 </td>
2222
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2223 <td class="entry_tags">
2224 <ul class="entry_tags">
2225 <li><a href="#tag_BC">BC</a></li>
2226 </ul>
2227 </td>
2228
2229 </tr>
2230 <tr class="entries_header">
2231 <th class="th_details" colspan="5">Details</th>
2232 </tr>
2233 <tr class="entry_cont">
2234 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2235 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
2236by the HAL is disabled.<wbr/> The application must set the fields for
2237capture parameters itself.<wbr/></p>
2238<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2239android.<wbr/>control.<wbr/>* are in effect,<wbr/> such as <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2240<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
2241android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
2242one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
2243as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2244<a href="#static_android.control.sceneModeOverrides">android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2245 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2246 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2247
2248
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2249 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2250 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2251
2252
2253 <tr class="entry" id="controls_android.control.sceneMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2254 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2255 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2256 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2257 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2258 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2259
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2260 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2261
2262 <ul class="entry_type_enum">
2263 <li>
2264 <span class="entry_type_enum_name">UNSUPPORTED</span>
2265 <span class="entry_type_enum_value">0</span>
2266 </li>
2267 <li>
2268 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2269 <span class="entry_type_enum_notes">if face detection support exists Use face
2270 detection data to drive 3A routines.<wbr/> If face detection
2271 statistics are disabled,<wbr/> should still operate correctly
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2272 (but not return face detection statistics to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2273 framework).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2274
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2275 Unlike the other scene modes,<wbr/> aeMode,<wbr/> awbMode,<wbr/> and afMode
2276 remain active when FACE_<wbr/>PRIORITY is set.<wbr/> This is due to
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2277 compatibility concerns with the old camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2278 API</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2279 </li>
2280 <li>
2281 <span class="entry_type_enum_name">ACTION</span>
2282 <span class="entry_type_enum_optional">optional</span>
2283 </li>
2284 <li>
2285 <span class="entry_type_enum_name">PORTRAIT</span>
2286 <span class="entry_type_enum_optional">optional</span>
2287 </li>
2288 <li>
2289 <span class="entry_type_enum_name">LANDSCAPE</span>
2290 <span class="entry_type_enum_optional">optional</span>
2291 </li>
2292 <li>
2293 <span class="entry_type_enum_name">NIGHT</span>
2294 <span class="entry_type_enum_optional">optional</span>
2295 </li>
2296 <li>
2297 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2298 <span class="entry_type_enum_optional">optional</span>
2299 </li>
2300 <li>
2301 <span class="entry_type_enum_name">THEATRE</span>
2302 <span class="entry_type_enum_optional">optional</span>
2303 </li>
2304 <li>
2305 <span class="entry_type_enum_name">BEACH</span>
2306 <span class="entry_type_enum_optional">optional</span>
2307 </li>
2308 <li>
2309 <span class="entry_type_enum_name">SNOW</span>
2310 <span class="entry_type_enum_optional">optional</span>
2311 </li>
2312 <li>
2313 <span class="entry_type_enum_name">SUNSET</span>
2314 <span class="entry_type_enum_optional">optional</span>
2315 </li>
2316 <li>
2317 <span class="entry_type_enum_name">STEADYPHOTO</span>
2318 <span class="entry_type_enum_optional">optional</span>
2319 </li>
2320 <li>
2321 <span class="entry_type_enum_name">FIREWORKS</span>
2322 <span class="entry_type_enum_optional">optional</span>
2323 </li>
2324 <li>
2325 <span class="entry_type_enum_name">SPORTS</span>
2326 <span class="entry_type_enum_optional">optional</span>
2327 </li>
2328 <li>
2329 <span class="entry_type_enum_name">PARTY</span>
2330 <span class="entry_type_enum_optional">optional</span>
2331 </li>
2332 <li>
2333 <span class="entry_type_enum_name">CANDLELIGHT</span>
2334 <span class="entry_type_enum_optional">optional</span>
2335 </li>
2336 <li>
2337 <span class="entry_type_enum_name">BARCODE</span>
2338 <span class="entry_type_enum_optional">optional</span>
2339 </li>
2340 </ul>
2341
2342 </td> <!-- entry_type -->
2343
2344 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2345 <p>Which scene mode is active when
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2346<a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = SCENE_<wbr/>MODE</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2347 </td>
2348
2349 <td class="entry_units">
2350 </td>
2351
2352 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2353 <p><a href="#static_android.control.availableSceneModes">android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2354 </td>
2355
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2356 <td class="entry_tags">
2357 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2358 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2359 </ul>
2360 </td>
2361
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2362 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2363
2364
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2365 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2366 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2367
2368
2369 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2370 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2371 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2372 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2373 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2374 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2375
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2376 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2377
2378 <ul class="entry_type_enum">
2379 <li>
2380 <span class="entry_type_enum_name">OFF</span>
2381 </li>
2382 <li>
2383 <span class="entry_type_enum_name">ON</span>
2384 </li>
2385 </ul>
2386
2387 </td> <!-- entry_type -->
2388
2389 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2390 <p>Whether video stabilization is
2391active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2392 </td>
2393
2394 <td class="entry_units">
2395 </td>
2396
2397 <td class="entry_range">
2398 </td>
2399
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2400 <td class="entry_tags">
2401 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2402 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2403 </ul>
2404 </td>
2405
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2406 </tr>
2407 <tr class="entries_header">
2408 <th class="th_details" colspan="5">Details</th>
2409 </tr>
2410 <tr class="entry_cont">
2411 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2412 <p>If enabled,<wbr/> video stabilization can modify the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2413<a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a> to keep the video stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2414stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2415 </td>
2416 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2417
2418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2419 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2420 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2421
2422
2423
2424 <!-- end of kind -->
2425 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2426 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2427
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2428 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2429 <tr>
2430 <th class="th_name">Property Name</th>
2431 <th class="th_type">Type</th>
2432 <th class="th_description">Description</th>
2433 <th class="th_units">Units</th>
2434 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2435 <th class="th_tags">Tags</th>
2436 </tr>
2437 </thead>
2438
2439 <tbody>
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2451 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2452 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2453 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2454 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2455 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2456 <span class="entry_type_container">x</span>
2457
2458 <span class="entry_type_array">
2459 n
2460 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2461 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2462 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2463
2464
2465 </td> <!-- entry_type -->
2466
2467 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2468 <p>The set of auto-exposure antibanding modes that are
2469supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2470 </td>
2471
2472 <td class="entry_units">
2473 </td>
2474
2475 <td class="entry_range">
2476 </td>
2477
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2478 <td class="entry_tags">
2479 </td>
2480
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2481 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2482 <tr class="entries_header">
2483 <th class="th_details" colspan="5">Details</th>
2484 </tr>
2485 <tr class="entry_cont">
2486 <td class="entry_details" colspan="5">
2487 <p>Not all of the auto-exposure anti-banding modes may be
2488supported by a given camera device.<wbr/> This field lists the
2489valid anti-banding modes that the application may request
2490for this camera device; they must include AUTO.<wbr/></p>
2491 </td>
2492 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2493
2494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2495 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2496 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2497
2498
2499 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2500 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2501 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2502 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2503 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2504 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2505 <span class="entry_type_container">x</span>
2506
2507 <span class="entry_type_array">
2508 n
2509 </span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2510 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2511 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2512
2513
2514 </td> <!-- entry_type -->
2515
2516 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2517 <p>The set of auto-exposure modes that are supported by this
2518camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2519 </td>
2520
2521 <td class="entry_units">
2522 </td>
2523
2524 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2525 </td>
2526
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2527 <td class="entry_tags">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2528 <ul class="entry_tags">
2529 <li><a href="#tag_BC">BC</a></li>
2530 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2531 </td>
2532
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2533 </tr>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2534 <tr class="entries_header">
2535 <th class="th_details" colspan="5">Details</th>
2536 </tr>
2537 <tr class="entry_cont">
2538 <td class="entry_details" colspan="5">
2539 <p>Not all the auto-exposure modes may be supported by a
2540given camera device,<wbr/> especially if no flash unit is
2541available.<wbr/> This entry lists the valid modes for
2542<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> for this camera device.<wbr/></p>
2543<p>All camera devices support ON,<wbr/> and all camera devices with
2544flash units support ON_<wbr/>AUTO_<wbr/>FLASH and
2545ON_<wbr/>ALWAYS_<wbr/>FLASH.<wbr/></p>
2546<p>Full-capability camera devices always support OFF mode,<wbr/>
2547which enables application control of camera exposure time,<wbr/>
2548sensitivity,<wbr/> and frame duration.<wbr/></p>
2549 </td>
2550 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2551
2552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2553 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2554 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2555
2556
2557 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2558 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2559 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2560 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2561 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2562 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2563 <span class="entry_type_container">x</span>
2564
2565 <span class="entry_type_array">
2566 2 x n
2567 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2568 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2569 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2570
2571
2572 </td> <!-- entry_type -->
2573
2574 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2575 <p>List of frame rate ranges supported by the
2576AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2577 </td>
2578
2579 <td class="entry_units">
2580 </td>
2581
2582 <td class="entry_range">
2583 </td>
2584
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2585 <td class="entry_tags">
2586 </td>
2587
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2588 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2589
2590
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2591 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2592 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2593
2594
2595 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2596 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2597 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2598 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2599 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2600 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2601 <span class="entry_type_container">x</span>
2602
2603 <span class="entry_type_array">
2604 2
2605 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2606 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2607
2608
2609 </td> <!-- entry_type -->
2610
2611 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2612 <p>Maximum and minimum exposure compensation
2613setting,<wbr/> in counts of
2614android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2615 </td>
2616
2617 <td class="entry_units">
2618 </td>
2619
2620 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2621 <p>At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2622size)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2623 </td>
2624
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2625 <td class="entry_tags">
2626 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2627 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2628 </ul>
2629 </td>
2630
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2631 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2632
2633
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2634 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2635 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2636
2637
2638 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2639 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2640 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2641 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2642 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2643 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2644
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2645 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2646
2647
2648 </td> <!-- entry_type -->
2649
2650 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2651 <p>Smallest step by which exposure compensation
2652can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2653 </td>
2654
2655 <td class="entry_units">
2656 </td>
2657
2658 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2659 <p>&lt;= 1/<wbr/>2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2660 </td>
2661
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2662 <td class="entry_tags">
2663 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2664 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2665 </ul>
2666 </td>
2667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2668 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2669
2670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2671 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2672 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2673
2674
2675 <tr class="entry" id="static_android.control.afAvailableModes">
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame^]2676 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2677 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2678 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2679 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2680 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2681 <span class="entry_type_container">x</span>
2682
2683 <span class="entry_type_array">
2684 n
2685 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2686 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2687 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2688
2689
2690 </td> <!-- entry_type -->
2691
2692 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2693 <p>List of AF modes that can be
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame^]2694selected with <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2695 </td>
2696
2697 <td class="entry_units">
2698 </td>
2699
2700 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2701 </td>
2702
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2703 <td class="entry_tags">
2704 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2705 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2706 </ul>
2707 </td>
2708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2709 </tr>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame^]2710 <tr class="entries_header">
2711 <th class="th_details" colspan="5">Details</th>
2712 </tr>
2713 <tr class="entry_cont">
2714 <td class="entry_details" colspan="5">
2715 <p>Not all the auto-focus modes may be supported by a
2716given camera device.<wbr/> This entry lists the valid modes for
2717<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> for this camera device.<wbr/></p>
2718<p>All camera devices will support OFF mode,<wbr/> and all camera devices with
2719adjustable focuser units (<code><a href="#static_android.lens.info.minimumFocusDistance">android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance</a> &gt; 0</code>)
2720will support AUTO mode.<wbr/></p>
2721 </td>
2722 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2723
2724
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2725 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2726 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2727
2728
2729 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2730 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2731 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2732 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2733 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2734 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2735 <span class="entry_type_container">x</span>
2736
2737 <span class="entry_type_array">
2738 n
2739 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2740 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2741 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2742
2743
2744 </td> <!-- entry_type -->
2745
2746 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2747 <p>what subset of the full color effect enum
2748list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2749 </td>
2750
2751 <td class="entry_units">
2752 </td>
2753
2754 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2755 <p>OFF must be listed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2756 </td>
2757
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2758 <td class="entry_tags">
2759 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2760 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2761 </ul>
2762 </td>
2763
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2764 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2765
2766
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2767 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2768 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2769
2770
2771 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2772 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2773 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2774 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2775 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2776 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2777 <span class="entry_type_container">x</span>
2778
2779 <span class="entry_type_array">
2780 n
2781 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2782 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2783 <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]2784
2785
2786 </td> <!-- entry_type -->
2787
2788 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2789 <p>what subset of the scene mode enum list is
2790supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2791 </td>
2792
2793 <td class="entry_units">
2794 </td>
2795
2796 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2797 <p>SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2798detection is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2799 </td>
2800
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2801 <td class="entry_tags">
2802 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2803 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2804 </ul>
2805 </td>
2806
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2807 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2808
2809
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2810 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2811 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2812
2813
2814 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2815 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2816 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2817 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2818 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2819 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2820 <span class="entry_type_container">x</span>
2821
2822 <span class="entry_type_array">
2823 n
2824 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2825 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2826 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2827
2828
2829 </td> <!-- entry_type -->
2830
2831 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2832 <p>List of video stabilization modes that can
2833be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2834 </td>
2835
2836 <td class="entry_units">
2837 </td>
2838
2839 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2840 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2841 </td>
2842
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2843 <td class="entry_tags">
2844 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2845 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2846 </ul>
2847 </td>
2848
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2849 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2850
2851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2852 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2853 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2854
2855
2856 <tr class="entry" id="static_android.control.awbAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2857 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2858 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2859 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2860 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2861 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2862 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2863
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2864 <span class="entry_type_array">
2865 n
2866 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2867 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2868 <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]2869
2870
2871 </td> <!-- entry_type -->
2872
2873 <td class="entry_description">
2874 </td>
2875
2876 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2877 </td>
2878
2879 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2880 <p>OFF,<wbr/> AUTO must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2881 </td>
2882
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2883 <td class="entry_tags">
2884 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2885 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2886 </ul>
2887 </td>
2888
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2889 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2890
2891
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2892 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2893 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2894
2895
2896 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2897 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2898 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2899 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2900 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2901 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2902
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2903 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2904
2905
2906 </td> <!-- entry_type -->
2907
2908 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2909 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
2910regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2911 </td>
2912
2913 <td class="entry_units">
2914 </td>
2915
2916 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]2917 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2918 </td>
2919
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2920 <td class="entry_tags">
2921 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2922 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2923 </ul>
2924 </td>
2925
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2926 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2927
2928
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2929 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2930 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2931
2932
2933 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2934 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2935 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2936 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2937 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2938 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2939 <span class="entry_type_container">x</span>
2940
2941 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2942 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2943 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2944 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2945
2946
2947 </td> <!-- entry_type -->
2948
2949 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2950 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
2951each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2952 </td>
2953
2954 <td class="entry_units">
2955 </td>
2956
2957 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2958 <p>For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
2959awbMode,<wbr/> and afMode that the HAL wants to use for that
2960scene mode.<wbr/></p>
2961<p>For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
2962order of increasing index</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2963 </td>
2964
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2965 <td class="entry_tags">
2966 <ul class="entry_tags">
2967 <li><a href="#tag_BC">BC</a></li>
2968 </ul>
2969 </td>
2970
2971 </tr>
2972 <tr class="entries_header">
2973 <th class="th_details" colspan="5">Details</th>
2974 </tr>
2975 <tr class="entry_cont">
2976 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2977 <p>When a scene mode is enabled,<wbr/> the HAL is expected
2978to override aeMode,<wbr/> awbMode,<wbr/> and afMode with its
2979preferred settings for that scene mode.<wbr/></p>
2980<p>To simplify communication with old camera API applications,<wbr/>
2981the service wants this override list in the static metadata.<wbr/>
2982The order of this list matches that of availableSceneModes,<wbr/>
2983with 3 entires for each scene mode.<wbr/> The overrides listed
2984for SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
2985mode,<wbr/> the application-set aeMode,<wbr/> awbMode,<wbr/> and afMode are
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2986used instead,<wbr/> like they are when <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2987AUTO.<wbr/></p>
2988<p>It is recommended that for FACE_<wbr/>PRIORITY,<wbr/> the overrides
2989should be set to 0.<wbr/> As an example,<wbr/> if availableSceneModes is
2990{ FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT },<wbr/> then the service expects
2991this field to have 9 entries; for example { 0 ,<wbr/> 0,<wbr/> 0,<wbr/>
2992ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
2993INCANDESCENT,<wbr/> AUTO }</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2994 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2995 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2996
2997
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2998 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2999 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3000
3001
3002
3003 <!-- end of kind -->
3004 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3005 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3006
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3007 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3008 <tr>
3009 <th class="th_name">Property Name</th>
3010 <th class="th_type">Type</th>
3011 <th class="th_description">Description</th>
3012 <th class="th_units">Units</th>
3013 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3014 <th class="th_tags">Tags</th>
3015 </tr>
3016 </thead>
3017
3018 <tbody>
3019
3020
3021
3022
3023
3024
3025
3026
3027
3028
3029 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3030 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3031 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3032 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3033 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3034 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3035
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3036 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3037
3038
3039 </td> <!-- entry_type -->
3040
3041 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3042 <p>The ID sent with the latest
3043CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3044 </td>
3045
3046 <td class="entry_units">
3047 </td>
3048
3049 <td class="entry_range">
3050 </td>
3051
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3052 <td class="entry_tags">
3053 </td>
3054
3055 </tr>
3056 <tr class="entries_header">
3057 <th class="th_details" colspan="5">Details</th>
3058 </tr>
3059 <tr class="entry_cont">
3060 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3061 <p>Must be 0 if no
3062CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
3063by HAL.<wbr/> Always updated even if AE algorithm ignores the
3064trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3065 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3066 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3067
3068
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3069 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3070 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3071
3072
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3073 <tr class="entry" id="dynamic_android.control.aeMode">
3074 <td class="entry_name" rowspan="3">
3075 android.<wbr/>control.<wbr/>ae<wbr/>Mode
3076 </td>
3077 <td class="entry_type">
3078 <span class="entry_type_name entry_type_name_enum">byte</span>
3079
3080 <span class="entry_type_visibility"> [public]</span>
3081
3082 <ul class="entry_type_enum">
3083 <li>
3084 <span class="entry_type_enum_name">OFF</span>
3085 <span class="entry_type_enum_notes">
3086 The camera device's autoexposure routine is disabled;
3087 the application-selected android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
3088 android.<wbr/>sensor.<wbr/>sensitivity and
3089 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are used by the camera
3090 device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
3091 a flash unit for this camera device.<wbr/>
3092 </span>
3093 </li>
3094 <li>
3095 <span class="entry_type_enum_name">ON</span>
3096 <span class="entry_type_enum_notes">
3097 The camera device's autoexposure routine is active,<wbr/>
3098 with no flash control.<wbr/> The application's values for
3099 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
3100 android.<wbr/>sensor.<wbr/>sensitivity,<wbr/> and
3101 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are ignored.<wbr/> The
3102 application has control over the various
3103 android.<wbr/>flash.<wbr/>* fields.<wbr/>
3104 </span>
3105 </li>
3106 <li>
3107 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
3108 <span class="entry_type_enum_notes">
3109 Like ON,<wbr/> except that the camera device also controls
3110 the camera's flash unit,<wbr/> firing it in low-light
3111 conditions.<wbr/> The flash may be fired during a
3112 precapture sequence (triggered by
3113 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and may be fired
3114 for captures for which the
3115 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
3116 STILL_<wbr/>CAPTURE
3117 </span>
3118 </li>
3119 <li>
3120 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
3121 <span class="entry_type_enum_notes">
3122 Like ON,<wbr/> except that the camera device also controls
3123 the camera's flash unit,<wbr/> always firing it for still
3124 captures.<wbr/> The flash may be fired during a precapture
3125 sequence (triggered by
3126 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and will always
3127 be fired for captures for which the
3128 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
3129 STILL_<wbr/>CAPTURE
3130 </span>
3131 </li>
3132 <li>
3133 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
3134 <span class="entry_type_enum_notes">
3135 Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
3136 reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
3137 a red eye reduction flash will fire during the
3138 precapture sequence.<wbr/>
3139 </span>
3140 </li>
3141 </ul>
3142
3143 </td> <!-- entry_type -->
3144
3145 <td class="entry_description">
3146 <p>The desired mode for the camera device's
3147auto-exposure routine.<wbr/></p>
3148 </td>
3149
3150 <td class="entry_units">
3151 </td>
3152
3153 <td class="entry_range">
3154 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
3155 </td>
3156
3157 <td class="entry_tags">
3158 <ul class="entry_tags">
3159 <li><a href="#tag_BC">BC</a></li>
3160 </ul>
3161 </td>
3162
3163 </tr>
3164 <tr class="entries_header">
3165 <th class="th_details" colspan="5">Details</th>
3166 </tr>
3167 <tr class="entry_cont">
3168 <td class="entry_details" colspan="5">
3169 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
3170AUTO.<wbr/></p>
3171<p>When set to any of the ON modes,<wbr/> the camera device's
3172auto-exposure routine is enabled,<wbr/> overriding the
3173application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
3174and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3175<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3176<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
3177is selected,<wbr/> the camera device's flash unit controls are
3178also overridden.<wbr/></p>
3179<p>The FLASH modes are only available if the camera device
3180has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
3181<p>If flash TORCH mode is desired,<wbr/> this field must be set to
3182ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
3183<p>When set to any of the ON modes,<wbr/> the values chosen by the
3184camera device auto-exposure routine for the overridden
3185fields for a given capture will be available in its
3186CaptureResult.<wbr/></p>
3187 </td>
3188 </tr>
3189
3190
3191 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3192 <!-- end of entry -->
3193
3194
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3195 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3196 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3197 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3198 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3199 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3200 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3201 <span class="entry_type_container">x</span>
3202
3203 <span class="entry_type_array">
3204 5 x area_count
3205 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3206 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3207
3208
3209 </td> <!-- entry_type -->
3210
3211 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3212 <p>List of areas to use for
3213metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3214 </td>
3215
3216 <td class="entry_units">
3217 </td>
3218
3219 <td class="entry_range">
3220 </td>
3221
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3222 <td class="entry_tags">
3223 <ul class="entry_tags">
3224 <li><a href="#tag_BC">BC</a></li>
3225 </ul>
3226 </td>
3227
3228 </tr>
3229 <tr class="entries_header">
3230 <th class="th_details" colspan="5">Details</th>
3231 </tr>
3232 <tr class="entry_cont">
3233 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3234 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3235xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3236specified coordinates.<wbr/></p>
3237<p>The coordinate system is based on the active pixel array,<wbr/>
3238with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3239(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3240<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3241bottom-right pixel in the active pixel array.<wbr/> The weight
3242should be nonnegative.<wbr/></p>
3243<p>If all regions have 0 weight,<wbr/> then no specific metering area
3244needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3245outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]3246should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3247used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3248 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3249 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3250
3251
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3252 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3253 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3254
3255
3256 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3257 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3258 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3259 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3260 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3261 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3262
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3263 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3264
3265 <ul class="entry_type_enum">
3266 <li>
3267 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3268 <span class="entry_type_enum_notes">AE is off.<wbr/> When a camera device is opened,<wbr/> it starts in
3269 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3270 </li>
3271 <li>
3272 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3273 <span class="entry_type_enum_notes">AE doesn't yet have a good set of control values
3274 for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3275 </li>
3276 <li>
3277 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3278 <span class="entry_type_enum_notes">AE has a good set of control values for the
3279 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3280 </li>
3281 <li>
3282 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3283 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3284 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3285 </li>
3286 <li>
3287 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3288 <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]3289 needs to be fired for good quality still
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3290 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3291 </li>
3292 <li>
3293 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3294 <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]3295 (through the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3296 trigger_<wbr/>action(CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING)
3297 call),<wbr/> and is currently executing it.<wbr/> Once PRECAPTURE
3298 completes,<wbr/> AE will transition to CONVERGED or
3299 FLASH_<wbr/>REQUIRED as appropriate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3300 </li>
3301 </ul>
3302
3303 </td> <!-- entry_type -->
3304
3305 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3306 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3307 </td>
3308
3309 <td class="entry_units">
3310 </td>
3311
3312 <td class="entry_range">
3313 </td>
3314
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3315 <td class="entry_tags">
3316 </td>
3317
3318 </tr>
3319 <tr class="entries_header">
3320 <th class="th_details" colspan="5">Details</th>
3321 </tr>
3322 <tr class="entry_cont">
3323 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3324 <p>Whenever the AE algorithm state changes,<wbr/> a
3325MSG_<wbr/>AUTOEXPOSURE notification must be send if a
3326notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3327 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3328 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3329
3330
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3331 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3332 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3333
3334
3335 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3336 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3337 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3338 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3339 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3340 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3341
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3342 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3343
3344 <ul class="entry_type_enum">
3345 <li>
3346 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3347 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
3348 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
3349 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3350 </li>
3351 <li>
3352 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3353 <span class="entry_type_enum_notes">
3354 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3355
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3356 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
3357 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3358 the autofocus trigger action is called.<wbr/> When that trigger
3359 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3360 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3361
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3362 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3363 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3364 </li>
3365 <li>
3366 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3367 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
3368 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3369
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3370 When that trigger is activated,<wbr/> AF must transition to
3371 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3372 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3373 position to default,<wbr/> and sets the AF state to
3374 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3375 </li>
3376 <li>
3377 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3378 <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]3379 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3380 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3381
3382 The focusing behavior should be suitable for good quality
3383 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3384 movement and no overshoots.<wbr/> When the AF trigger is not
3385 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3386 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3387 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3388 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3389 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3390 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3391
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3392 Once cancel is received,<wbr/> the algorithm should transition
3393 back to INACTIVE and resume passive scan.<wbr/> Note that this
3394 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3395 ongoing PASSIVE_<wbr/>SCAN must immediately be
3396 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3397 </li>
3398 <li>
3399 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3400 <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]3401 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3402 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3403
3404 The focusing behavior should be suitable for still image
3405 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3406 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3407 algorithm should start in INACTIVE state,<wbr/> and then
3408 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3409 appropriate as it attempts to maintain focus.<wbr/> When the AF
3410 trigger is activated,<wbr/> the algorithm should finish its
3411 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3412 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3413 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3414
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3415 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3416 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3417 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3418 </li>
3419 <li>
3420 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3421 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
3422 trigger is ignored,<wbr/> AF state should always be
3423 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3424 </li>
3425 </ul>
3426
3427 </td> <!-- entry_type -->
3428
3429 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3430 <p>Whether AF is currently enabled,<wbr/> and what
3431mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3432 </td>
3433
3434 <td class="entry_units">
3435 </td>
3436
3437 <td class="entry_range">
3438 </td>
3439
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3440 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3441 <ul class="entry_tags">
3442 <li><a href="#tag_BC">BC</a></li>
3443 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3444 </td>
3445
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3446 </tr>
3447 <tr class="entries_header">
3448 <th class="th_details" colspan="5">Details</th>
3449 </tr>
3450 <tr class="entry_cont">
3451 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3452 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame^]3453<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
3454the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
3455in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3456 </td>
3457 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3458
3459
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3460 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3461 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3462
3463
3464 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3465 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3466 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3467 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3468 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3469 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3470 <span class="entry_type_container">x</span>
3471
3472 <span class="entry_type_array">
3473 5 x area_count
3474 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3475 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3476
3477
3478 </td> <!-- entry_type -->
3479
3480 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3481 <p>List of areas to use for focus
3482estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3483 </td>
3484
3485 <td class="entry_units">
3486 </td>
3487
3488 <td class="entry_range">
3489 </td>
3490
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3491 <td class="entry_tags">
3492 <ul class="entry_tags">
3493 <li><a href="#tag_BC">BC</a></li>
3494 </ul>
3495 </td>
3496
3497 </tr>
3498 <tr class="entries_header">
3499 <th class="th_details" colspan="5">Details</th>
3500 </tr>
3501 <tr class="entry_cont">
3502 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3503 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3504xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3505specified coordinates.<wbr/></p>
3506<p>The coordinate system is based on the active pixel array,<wbr/>
3507with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3508(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3509<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3510bottom-right pixel in the active pixel array.<wbr/> The weight
3511should be nonnegative.<wbr/></p>
3512<p>If all regions have 0 weight,<wbr/> then no specific focus area
3513needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3514outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]3515should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3516used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3517 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3518 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3519
3520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3521 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3522 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3523
3524
3525 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3526 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3527 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3528 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3529 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3530 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3531
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3532 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3533
3534 <ul class="entry_type_enum">
3535 <li>
3536 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3537 <span class="entry_type_enum_notes">AF off or has not yet tried to scan/<wbr/>been asked
3538 to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3539 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3540 </li>
3541 <li>
3542 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3543 <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]3544 currently doing an AF scan initiated by a continuous
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3545 autofocus mode</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3546 </li>
3547 <li>
3548 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3549 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3550 believes it is in focus,<wbr/> but may restart scanning at
3551 any time.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3552 </li>
3553 <li>
3554 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3555 <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]3556 an AF scan because it was triggered by AF
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3557 trigger</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3558 </li>
3559 <li>
3560 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3561 <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]3562 believes it is focused correctly and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3563 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3564 </li>
3565 <li>
3566 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3567 <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]3568 failed to focus successfully and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3569 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3570 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3571 <li>
3572 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3573 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3574 passive scan without finding focus,<wbr/> and may restart
3575 scanning at any time.<wbr/></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3576 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3577 </ul>
3578
3579 </td> <!-- entry_type -->
3580
3581 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3582 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3583 </td>
3584
3585 <td class="entry_units">
3586 </td>
3587
3588 <td class="entry_range">
3589 </td>
3590
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3591 <td class="entry_tags">
3592 </td>
3593
3594 </tr>
3595 <tr class="entries_header">
3596 <th class="th_details" colspan="5">Details</th>
3597 </tr>
3598 <tr class="entry_cont">
3599 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3600 <p>Whenever the AF algorithm state changes,<wbr/> a
3601MSG_<wbr/>AUTOFOCUS notification must be send if a notification
3602callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3603 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3604 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3605
3606
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3607 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3608 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3609
3610
3611 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3612 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3613 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3614 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3615 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3616 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3617
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3618 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3619
3620
3621 </td> <!-- entry_type -->
3622
3623 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3624 <p>The ID sent with the latest
3625CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3626 </td>
3627
3628 <td class="entry_units">
3629 </td>
3630
3631 <td class="entry_range">
3632 </td>
3633
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3634 <td class="entry_tags">
3635 </td>
3636
3637 </tr>
3638 <tr class="entries_header">
3639 <th class="th_details" colspan="5">Details</th>
3640 </tr>
3641 <tr class="entry_cont">
3642 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3643 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
3644received yet by HAL.<wbr/> Always updated even if AF algorithm
3645ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3646 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3647 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3648
3649
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3650 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3651 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3652
3653
3654 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3655 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3656 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3657 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3658 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3659 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3660
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3661 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3662
3663 <ul class="entry_type_enum">
3664 <li>
3665 <span class="entry_type_enum_name">OFF</span>
3666 </li>
3667 <li>
3668 <span class="entry_type_enum_name">AUTO</span>
3669 </li>
3670 <li>
3671 <span class="entry_type_enum_name">INCANDESCENT</span>
3672 </li>
3673 <li>
3674 <span class="entry_type_enum_name">FLUORESCENT</span>
3675 </li>
3676 <li>
3677 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
3678 </li>
3679 <li>
3680 <span class="entry_type_enum_name">DAYLIGHT</span>
3681 </li>
3682 <li>
3683 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
3684 </li>
3685 <li>
3686 <span class="entry_type_enum_name">TWILIGHT</span>
3687 </li>
3688 <li>
3689 <span class="entry_type_enum_name">SHADE</span>
3690 </li>
3691 </ul>
3692
3693 </td> <!-- entry_type -->
3694
3695 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3696 <p>Whether AWB is currently setting the color
3697transform fields,<wbr/> and what its illumination target
3698is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3699 </td>
3700
3701 <td class="entry_units">
3702 </td>
3703
3704 <td class="entry_range">
3705 </td>
3706
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3707 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3708 <ul class="entry_tags">
3709 <li><a href="#tag_BC">BC</a></li>
3710 <li><a href="#tag_AWB">AWB</a></li>
3711 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3712 </td>
3713
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3714 </tr>
3715 <tr class="entries_header">
3716 <th class="th_details" colspan="5">Details</th>
3717 </tr>
3718 <tr class="entry_cont">
3719 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3720 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3721<p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3722 </td>
3723 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3724
3725
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3726 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3727 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3728
3729
3730 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3731 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3732 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3733 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3734 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3735 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3736 <span class="entry_type_container">x</span>
3737
3738 <span class="entry_type_array">
3739 5 x area_count
3740 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3741 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3742
3743
3744 </td> <!-- entry_type -->
3745
3746 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3747 <p>List of areas to use for illuminant
3748estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3749 </td>
3750
3751 <td class="entry_units">
3752 </td>
3753
3754 <td class="entry_range">
3755 </td>
3756
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3757 <td class="entry_tags">
3758 <ul class="entry_tags">
3759 <li><a href="#tag_BC">BC</a></li>
3760 </ul>
3761 </td>
3762
3763 </tr>
3764 <tr class="entries_header">
3765 <th class="th_details" colspan="5">Details</th>
3766 </tr>
3767 <tr class="entry_cont">
3768 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3769 <p>Only used in AUTO mode.<wbr/></p>
3770<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3771xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3772specified coordinates.<wbr/></p>
3773<p>The coordinate system is based on the active pixel array,<wbr/>
3774with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3775(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3776<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3777bottom-right pixel in the active pixel array.<wbr/> The weight
3778should be nonnegative.<wbr/></p>
3779<p>If all regions have 0 weight,<wbr/> then no specific metering area
3780needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3781outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]3782should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3783used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3784 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3785 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3786
3787
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3788 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3789 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3790
3791
3792 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3793 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3794 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3795 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3796 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3797 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3798
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3799 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3800
3801 <ul class="entry_type_enum">
3802 <li>
3803 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3804 <span class="entry_type_enum_notes">AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
3805 starts in this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3806 </li>
3807 <li>
3808 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3809 <span class="entry_type_enum_notes">AWB doesn't yet have a good set of control
3810 values for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3811 </li>
3812 <li>
3813 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3814 <span class="entry_type_enum_notes">AWB has a good set of control values for the
3815 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3816 </li>
3817 <li>
3818 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3819 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3820 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3821 </li>
3822 </ul>
3823
3824 </td> <!-- entry_type -->
3825
3826 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3827 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3828 </td>
3829
3830 <td class="entry_units">
3831 </td>
3832
3833 <td class="entry_range">
3834 </td>
3835
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3836 <td class="entry_tags">
3837 </td>
3838
3839 </tr>
3840 <tr class="entries_header">
3841 <th class="th_details" colspan="5">Details</th>
3842 </tr>
3843 <tr class="entry_cont">
3844 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3845 <p>Whenever the AWB algorithm state changes,<wbr/> a
3846MSG_<wbr/>AUTOWHITEBALANCE notification must be send if a
3847notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3848 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3849 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3850
3851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3852 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3853 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3854
3855
3856 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3857 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3858 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3859 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3860 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3861 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3862
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3863 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3864
3865 <ul class="entry_type_enum">
3866 <li>
3867 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3868 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
3869 routines are disabled,<wbr/> no other settings in
3870 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3871 </li>
3872 <li>
3873 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3874 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
3875 Manual control of capture parameters is disabled.<wbr/> All
3876 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
3877 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3878 </li>
3879 <li>
3880 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3881 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
3882 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3883 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3884 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
3885 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3886 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3887 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3888 </li>
3889 </ul>
3890
3891 </td> <!-- entry_type -->
3892
3893 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3894 <p>Overall mode of 3A control
3895routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3896 </td>
3897
3898 <td class="entry_units">
3899 </td>
3900
3901 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3902 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3903 </td>
3904
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3905 <td class="entry_tags">
3906 <ul class="entry_tags">
3907 <li><a href="#tag_BC">BC</a></li>
3908 </ul>
3909 </td>
3910
3911 </tr>
3912 <tr class="entries_header">
3913 <th class="th_details" colspan="5">Details</th>
3914 </tr>
3915 <tr class="entry_cont">
3916 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3917 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
3918by the HAL is disabled.<wbr/> The application must set the fields for
3919capture parameters itself.<wbr/></p>
3920<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3921android.<wbr/>control.<wbr/>* are in effect,<wbr/> such as <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3922<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
3923android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
3924one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
3925as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3926<a href="#static_android.control.sceneModeOverrides">android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3927 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3928 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3929
3930
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3931 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3932 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3933
3934
3935
3936 <!-- end of kind -->
3937 </tbody>
3938
3939 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3940 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3941
3942
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3943 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3944
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3945 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3946 <tr>
3947 <th class="th_name">Property Name</th>
3948 <th class="th_type">Type</th>
3949 <th class="th_description">Description</th>
3950 <th class="th_units">Units</th>
3951 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3952 <th class="th_tags">Tags</th>
3953 </tr>
3954 </thead>
3955
3956 <tbody>
3957
3958
3959
3960
3961
3962
3963
3964
3965
3966
3967 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3968 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3969 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3970 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3971 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3972 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3973
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3974 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3975
3976 <ul class="entry_type_enum">
3977 <li>
3978 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3979 <span class="entry_type_enum_notes">Minimal or no slowdown of frame rate compared to
3980 Bayer RAW output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3981 </li>
3982 <li>
3983 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3984 <span class="entry_type_enum_notes">High-quality may reduce output frame
3985 rate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3986 </li>
3987 </ul>
3988
3989 </td> <!-- entry_type -->
3990
3991 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3992 <p>Controls the quality of the demosaicing
3993processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3994 </td>
3995
3996 <td class="entry_units">
3997 </td>
3998
3999 <td class="entry_range">
4000 </td>
4001
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4002 <td class="entry_tags">
4003 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4004 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4005 </ul>
4006 </td>
4007
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4008 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4009
4010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4011 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4012 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4013
4014
4015
4016 <!-- end of kind -->
4017 </tbody>
4018
4019 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4020 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4021
4022
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4023 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4024
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4025 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4026 <tr>
4027 <th class="th_name">Property Name</th>
4028 <th class="th_type">Type</th>
4029 <th class="th_description">Description</th>
4030 <th class="th_units">Units</th>
4031 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4032 <th class="th_tags">Tags</th>
4033 </tr>
4034 </thead>
4035
4036 <tbody>
4037
4038
4039
4040
4041
4042
4043
4044
4045
4046
4047 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4048 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4049 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4050 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4051 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4052 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4053
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4054 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4055
4056 <ul class="entry_type_enum">
4057 <li>
4058 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4059 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4060 </li>
4061 <li>
4062 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4063 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
4064 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4065 </li>
4066 <li>
4067 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4068 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4069 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4070 </li>
4071 </ul>
4072
4073 </td> <!-- entry_type -->
4074
4075 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4076 <p>Operation mode for edge
4077enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4078 </td>
4079
4080 <td class="entry_units">
4081 </td>
4082
4083 <td class="entry_range">
4084 </td>
4085
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4086 <td class="entry_tags">
4087 </td>
4088
4089 </tr>
4090 <tr class="entries_header">
4091 <th class="th_details" colspan="5">Details</th>
4092 </tr>
4093 <tr class="entry_cont">
4094 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4095 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4096enhancement will be applied by the HAL.<wbr/></p>
4097<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
4098will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
4099HAL should use the highest-quality enhancement algorithms,<wbr/>
4100even if it slows down capture rate.<wbr/> FAST means the HAL should
4101not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4102 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4103 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4104
4105
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4106 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4107 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4108
4109
4110 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4111 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4112 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4113 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4114 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4115 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4116
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4117 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4118
4119
4120 </td> <!-- entry_type -->
4121
4122 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4123 <p>Control the amount of edge enhancement
4124applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4125 </td>
4126
4127 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4128 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4129 </td>
4130
4131 <td class="entry_range">
4132 </td>
4133
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4134 <td class="entry_tags">
4135 </td>
4136
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4137 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4138
4139
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4140 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4141 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4142
4143
4144
4145 <!-- end of kind -->
4146 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4147 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4148
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4149 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4150 <tr>
4151 <th class="th_name">Property Name</th>
4152 <th class="th_type">Type</th>
4153 <th class="th_description">Description</th>
4154 <th class="th_units">Units</th>
4155 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4156 <th class="th_tags">Tags</th>
4157 </tr>
4158 </thead>
4159
4160 <tbody>
4161
4162
4163
4164
4165
4166
4167
4168
4169
4170
4171 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4172 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4173 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4174 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4175 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4176 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4177
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4178 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4179
4180 <ul class="entry_type_enum">
4181 <li>
4182 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4183 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4184 </li>
4185 <li>
4186 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4187 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
4188 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4189 </li>
4190 <li>
4191 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4192 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4193 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4194 </li>
4195 </ul>
4196
4197 </td> <!-- entry_type -->
4198
4199 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4200 <p>Operation mode for edge
4201enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4202 </td>
4203
4204 <td class="entry_units">
4205 </td>
4206
4207 <td class="entry_range">
4208 </td>
4209
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4210 <td class="entry_tags">
4211 </td>
4212
4213 </tr>
4214 <tr class="entries_header">
4215 <th class="th_details" colspan="5">Details</th>
4216 </tr>
4217 <tr class="entry_cont">
4218 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4219 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4220enhancement will be applied by the HAL.<wbr/></p>
4221<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
4222will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
4223HAL should use the highest-quality enhancement algorithms,<wbr/>
4224even if it slows down capture rate.<wbr/> FAST means the HAL should
4225not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4226 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4227 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4228
4229
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4230 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4231 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4232
4233
4234
4235 <!-- end of kind -->
4236 </tbody>
4237
4238 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4239 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4240
4241
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4242 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4243
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4244 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4245 <tr>
4246 <th class="th_name">Property Name</th>
4247 <th class="th_type">Type</th>
4248 <th class="th_description">Description</th>
4249 <th class="th_units">Units</th>
4250 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4251 <th class="th_tags">Tags</th>
4252 </tr>
4253 </thead>
4254
4255 <tbody>
4256
4257
4258
4259
4260
4261
4262
4263
4264
4265
4266 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4267 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4268 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4269 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4270 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4271 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4272
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4273 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4274
4275
4276 </td> <!-- entry_type -->
4277
4278 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4279 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4280 </td>
4281
4282 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4283 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4284 </td>
4285
4286 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4287 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4288 </td>
4289
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4290 <td class="entry_tags">
4291 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4292 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4293 </ul>
4294 </td>
4295
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4296 </tr>
4297 <tr class="entries_header">
4298 <th class="th_details" colspan="5">Details</th>
4299 </tr>
4300 <tr class="entry_cont">
4301 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4302 <p>Power for snapshot may use a different scale than
4303for torch mode.<wbr/> Only one entry for torch mode will be
4304used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4305 </td>
4306 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4307
4308
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4309 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4310 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4311
4312
4313 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4314 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4315 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4316 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4317 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4318 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4319
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4320 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4321
4322
4323 </td> <!-- entry_type -->
4324
4325 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4326 <p>Firing time of flash relative to start of
4327exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4328 </td>
4329
4330 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4331 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4332 </td>
4333
4334 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4335 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4336 </td>
4337
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4338 <td class="entry_tags">
4339 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4340 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4341 </ul>
4342 </td>
4343
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4344 </tr>
4345 <tr class="entries_header">
4346 <th class="th_details" colspan="5">Details</th>
4347 </tr>
4348 <tr class="entry_cont">
4349 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4350 <p>Clamped to (0,<wbr/> exposure time - flash
4351duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4352 </td>
4353 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4354
4355
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4356 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4357 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4358
4359
4360 <tr class="entry" id="controls_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4361 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4362 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4363 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4364 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4365 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4366
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4367 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4368
4369 <ul class="entry_type_enum">
4370 <li>
4371 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4372 <span class="entry_type_enum_notes">Do not fire the flash for this
4373 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4374 </li>
4375 <li>
4376 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4377 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4378 for this capture based on firingPower,<wbr/>
4379 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4380 </li>
4381 <li>
4382 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4383 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4384 continuously on,<wbr/> power set by
4385 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4386 </li>
4387 </ul>
4388
4389 </td> <!-- entry_type -->
4390
4391 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4392 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4393 </td>
4394
4395 <td class="entry_units">
4396 </td>
4397
4398 <td class="entry_range">
4399 </td>
4400
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4401 <td class="entry_tags">
4402 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4403 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4404 </ul>
4405 </td>
4406
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4407 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4408
4409
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4410 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4411 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4412
4413
4414
4415 <!-- end of kind -->
4416 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4417 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4418
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4419 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4420 <tr>
4421 <th class="th_name">Property Name</th>
4422 <th class="th_type">Type</th>
4423 <th class="th_description">Description</th>
4424 <th class="th_units">Units</th>
4425 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4426 <th class="th_tags">Tags</th>
4427 </tr>
4428 </thead>
4429
4430 <tbody>
4431
4432
4433
4434
4435
4436
4437
4438
4439
4440
4441
4442
4443 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4444 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4445 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4446 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4447 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4448 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4449
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4450 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4451
4452
4453 </td> <!-- entry_type -->
4454
4455 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4456 <p>Whether this camera has a
4457flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4458 </td>
4459
4460 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4461 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4462 </td>
4463
4464 <td class="entry_range">
4465 </td>
4466
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4467 <td class="entry_tags">
4468 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4469 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4470 </ul>
4471 </td>
4472
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4473 </tr>
4474 <tr class="entries_header">
4475 <th class="th_details" colspan="5">Details</th>
4476 </tr>
4477 <tr class="entry_cont">
4478 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4479 <p>If no flash,<wbr/> none of the flash controls do
4480anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4481 </td>
4482 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4483
4484
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4485 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4486 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4487
4488
4489 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4490 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4491 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4492 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4493 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4494 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4495
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4496 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4497
4498
4499 </td> <!-- entry_type -->
4500
4501 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4502 <p>Time taken before flash can fire
4503again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4504 </td>
4505
4506 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4507 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4508 </td>
4509
4510 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4511 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4512 </td>
4513
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4514 <td class="entry_tags">
4515 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4516 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4517 </ul>
4518 </td>
4519
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4520 </tr>
4521 <tr class="entries_header">
4522 <th class="th_details" colspan="5">Details</th>
4523 </tr>
4524 <tr class="entry_cont">
4525 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4526 <p>1 second too long/<wbr/>too short for recharge? Should
4527this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4528 </td>
4529 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4530
4531
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4532 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4533 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4534
4535
4536
4537
4538
4539 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4540 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4541 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4542 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4543 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4544 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4545
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4546 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4547
4548
4549 </td> <!-- entry_type -->
4550
4551 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4552 <p>The x,<wbr/>y whitepoint of the
4553flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4554 </td>
4555
4556 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4557 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4558 </td>
4559
4560 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4561 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4562 </td>
4563
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4564 <td class="entry_tags">
4565 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4566 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4567 </ul>
4568 </td>
4569
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4570 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4571
4572
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4573 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4574 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4575
4576
4577 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4578 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4579 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4580 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4581 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4582 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4583
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4584 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4585
4586
4587 </td> <!-- entry_type -->
4588
4589 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4590 <p>Max energy output of the flash for a full
4591power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4592 </td>
4593
4594 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4595 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4596 </td>
4597
4598 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]4599 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4600 </td>
4601
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4602 <td class="entry_tags">
4603 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4604 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4605 </ul>
4606 </td>
4607
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4608 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4609
4610
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4611 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4612 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4613
4614
4615
4616 <!-- end of kind -->
4617 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4618 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4619
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4620 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4621 <tr>
4622 <th class="th_name">Property Name</th>
4623 <th class="th_type">Type</th>
4624 <th class="th_description">Description</th>
4625 <th class="th_units">Units</th>
4626 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4627 <th class="th_tags">Tags</th>
4628 </tr>
4629 </thead>
4630
4631 <tbody>
4632
4633
4634
4635
4636
4637
4638
4639
4640
4641
4642 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4643 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4644 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4645 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4646 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4647 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4648
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4649 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4650
4651
4652 </td> <!-- entry_type -->
4653
4654 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4655 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4656 </td>
4657
4658 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4659 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4660 </td>
4661
4662 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4663 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4664 </td>
4665
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4666 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4667 <ul class="entry_tags">
4668 <li><a href="#tag_V1">V1</a></li>
4669 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4670 </td>
4671
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4672 </tr>
4673 <tr class="entries_header">
4674 <th class="th_details" colspan="5">Details</th>
4675 </tr>
4676 <tr class="entry_cont">
4677 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4678 <p>Power for snapshot may use a different scale than
4679for torch mode.<wbr/> Only one entry for torch mode will be
4680used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4681 </td>
4682 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4683
4684
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4685 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4686 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4687
4688
4689 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4690 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4691 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4692 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4693 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4694 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4695
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4696 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4697
4698
4699 </td> <!-- entry_type -->
4700
4701 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4702 <p>Firing time of flash relative to start of
4703exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4704 </td>
4705
4706 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4707 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4708 </td>
4709
4710 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4711 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4712 </td>
4713
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4714 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4715 <ul class="entry_tags">
4716 <li><a href="#tag_V1">V1</a></li>
4717 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4718 </td>
4719
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4720 </tr>
4721 <tr class="entries_header">
4722 <th class="th_details" colspan="5">Details</th>
4723 </tr>
4724 <tr class="entry_cont">
4725 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4726 <p>Clamped to (0,<wbr/> exposure time - flash
4727duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4728 </td>
4729 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4730
4731
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4732 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4733 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4734
4735
4736 <tr class="entry" id="dynamic_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4737 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4738 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4739 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4740 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4741 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4742
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4743 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4744
4745 <ul class="entry_type_enum">
4746 <li>
4747 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4748 <span class="entry_type_enum_notes">Do not fire the flash for this
4749 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4750 </li>
4751 <li>
4752 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4753 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4754 for this capture based on firingPower,<wbr/>
4755 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4756 </li>
4757 <li>
4758 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4759 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4760 continuously on,<wbr/> power set by
4761 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4762 </li>
4763 </ul>
4764
4765 </td> <!-- entry_type -->
4766
4767 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4768 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4769 </td>
4770
4771 <td class="entry_units">
4772 </td>
4773
4774 <td class="entry_range">
4775 </td>
4776
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4777 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4778 <ul class="entry_tags">
4779 <li><a href="#tag_BC">BC</a></li>
4780 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4781 </td>
4782
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4783 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4784
4785
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4786 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4787 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4788
4789
4790 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4791 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4792 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4793 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4794 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4795 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4796
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4797 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4798
4799 <ul class="entry_type_enum">
4800 <li>
4801 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4802 <span class="entry_type_enum_notes">No flash on camera</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4803 </li>
4804 <li>
4805 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4806 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4807 charging and cannot be fired</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4808 </li>
4809 <li>
4810 <span class="entry_type_enum_name">READY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4811 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4812 ready to fire</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4813 </li>
4814 <li>
4815 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4816 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash fired
4817 for this capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4818 </li>
4819 </ul>
4820
4821 </td> <!-- entry_type -->
4822
4823 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4824 <p>Current state of the flash
4825unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4826 </td>
4827
4828 <td class="entry_units">
4829 </td>
4830
4831 <td class="entry_range">
4832 </td>
4833
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4834 <td class="entry_tags">
4835 </td>
4836
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4837 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4838
4839
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4840 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4841 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4842
4843
4844
4845 <!-- end of kind -->
4846 </tbody>
4847
4848 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4849 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4850
4851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4852 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4853
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4854 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4855 <tr>
4856 <th class="th_name">Property Name</th>
4857 <th class="th_type">Type</th>
4858 <th class="th_description">Description</th>
4859 <th class="th_units">Units</th>
4860 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4861 <th class="th_tags">Tags</th>
4862 </tr>
4863 </thead>
4864
4865 <tbody>
4866
4867
4868
4869
4870
4871
4872
4873
4874
4875
4876 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4877 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4878 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4879 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4880 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4881 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4882
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4883 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4884
4885 <ul class="entry_type_enum">
4886 <li>
4887 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4888 <span class="entry_type_enum_notes">No geometric correction is
4889 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4890 </li>
4891 <li>
4892 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4893 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
4894 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4895 </li>
4896 <li>
4897 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4898 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4899 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4900 </li>
4901 </ul>
4902
4903 </td> <!-- entry_type -->
4904
4905 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4906 <p>Operating mode of geometric
4907correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4908 </td>
4909
4910 <td class="entry_units">
4911 </td>
4912
4913 <td class="entry_range">
4914 </td>
4915
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4916 <td class="entry_tags">
4917 </td>
4918
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4919 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4920
4921
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4922 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4923 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4924
4925
4926 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4927 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4928 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4929 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4930 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4931 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4932
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4933 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4934
4935
4936 </td> <!-- entry_type -->
4937
4938 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4939 <p>Control the amount of shading correction
4940applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4941 </td>
4942
4943 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4944 unitless: 1-10; 10 is full shading
4945 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4946 </td>
4947
4948 <td class="entry_range">
4949 </td>
4950
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4951 <td class="entry_tags">
4952 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4953 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4954 </ul>
4955 </td>
4956
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4957 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4958
4959
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4960 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4961 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4962
4963
4964
4965 <!-- end of kind -->
4966 </tbody>
4967
4968 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4969 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4970
4971
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4972 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4973
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4974 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4975 <tr>
4976 <th class="th_name">Property Name</th>
4977 <th class="th_type">Type</th>
4978 <th class="th_description">Description</th>
4979 <th class="th_units">Units</th>
4980 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4981 <th class="th_tags">Tags</th>
4982 </tr>
4983 </thead>
4984
4985 <tbody>
4986
4987
4988
4989
4990
4991
4992
4993
4994
4995
4996 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4997 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4998 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4999 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5000 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5001 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5002
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5003 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5004
5005 <ul class="entry_type_enum">
5006 <li>
5007 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5008 <span class="entry_type_enum_notes">No hot pixel correction can be
5009 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5010 </li>
5011 <li>
5012 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5013 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
5014 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5015 </li>
5016 <li>
5017 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5018 <span class="entry_type_enum_notes">Frame rate may be reduced by high
5019 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5020 </li>
5021 </ul>
5022
5023 </td> <!-- entry_type -->
5024
5025 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5026 <p>Set operational mode for hot pixel
5027correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5028 </td>
5029
5030 <td class="entry_units">
5031 </td>
5032
5033 <td class="entry_range">
5034 </td>
5035
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5036 <td class="entry_tags">
5037 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5038 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5039 </ul>
5040 </td>
5041
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5042 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5043
5044
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5045 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5046 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5047
5048
5049
5050 <!-- end of kind -->
5051 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5052 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5053
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5054 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5055 <tr>
5056 <th class="th_name">Property Name</th>
5057 <th class="th_type">Type</th>
5058 <th class="th_description">Description</th>
5059 <th class="th_units">Units</th>
5060 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5061 <th class="th_tags">Tags</th>
5062 </tr>
5063 </thead>
5064
5065 <tbody>
5066
5067
5068
5069
5070
5071
5072
5073
5074
5075
5076
5077
5078 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5079 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5080 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5081 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5082 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5083 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5084 <span class="entry_type_container">x</span>
5085
5086 <span class="entry_type_array">
5087 2 x n
5088 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5089 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5090 <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]5091
5092
5093 </td> <!-- entry_type -->
5094
5095 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5096 <p>Location of hot/<wbr/>defective pixels on
5097sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5098 </td>
5099
5100 <td class="entry_units">
5101 </td>
5102
5103 <td class="entry_range">
5104 </td>
5105
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5106 <td class="entry_tags">
5107 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5108 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5109 </ul>
5110 </td>
5111
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5112 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5113
5114
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5115 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5116 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5117
5118
5119
5120
5121
5122
5123 <!-- end of kind -->
5124 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5125 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5126
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5127 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5128 <tr>
5129 <th class="th_name">Property Name</th>
5130 <th class="th_type">Type</th>
5131 <th class="th_description">Description</th>
5132 <th class="th_units">Units</th>
5133 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5134 <th class="th_tags">Tags</th>
5135 </tr>
5136 </thead>
5137
5138 <tbody>
5139
5140
5141
5142
5143
5144
5145
5146
5147
5148
5149 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5150 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5151 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5152 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5153 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5154 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5155
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5156 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5157
5158 <ul class="entry_type_enum">
5159 <li>
5160 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5161 <span class="entry_type_enum_notes">No hot pixel correction can be
5162 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5163 </li>
5164 <li>
5165 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5166 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
5167 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5168 </li>
5169 <li>
5170 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5171 <span class="entry_type_enum_notes">Frame rate may be reduced by high
5172 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5173 </li>
5174 </ul>
5175
5176 </td> <!-- entry_type -->
5177
5178 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5179 <p>Set operational mode for hot pixel
5180correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5181 </td>
5182
5183 <td class="entry_units">
5184 </td>
5185
5186 <td class="entry_range">
5187 </td>
5188
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5189 <td class="entry_tags">
5190 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5191 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5192 </ul>
5193 </td>
5194
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5195 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5196
5197
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5198 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5199 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5200
5201
5202
5203 <!-- end of kind -->
5204 </tbody>
5205
5206 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5207 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5208
5209
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5210 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5211
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5212 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5213 <tr>
5214 <th class="th_name">Property Name</th>
5215 <th class="th_type">Type</th>
5216 <th class="th_description">Description</th>
5217 <th class="th_units">Units</th>
5218 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5219 <th class="th_tags">Tags</th>
5220 </tr>
5221 </thead>
5222
5223 <tbody>
5224
5225
5226
5227
5228
5229
5230
5231
5232
5233
5234 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5235 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5236 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5237 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5238 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5239 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5240 <span class="entry_type_container">x</span>
5241
5242 <span class="entry_type_array">
5243 3
5244 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5245 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5246 <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]5247
5248
5249 </td> <!-- entry_type -->
5250
5251 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5252 <p>GPS coordinates to include in output JPEG
5253EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5254 </td>
5255
5256 <td class="entry_units">
5257 </td>
5258
5259 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5260 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5261 </td>
5262
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5263 <td class="entry_tags">
5264 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5265 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5266 </ul>
5267 </td>
5268
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5269 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5270
5271
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5272 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5273 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5274
5275
5276 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5277 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5278 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5279 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5280 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5281 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5282
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5283 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5284
5285
5286 </td> <!-- entry_type -->
5287
5288 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5289 <p>32 characters describing GPS algorithm to
5290include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5291 </td>
5292
5293 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5294 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5295 </td>
5296
5297 <td class="entry_range">
5298 </td>
5299
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5300 <td class="entry_tags">
5301 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5302 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5303 </ul>
5304 </td>
5305
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5306 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5307
5308
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5309 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5310 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5311
5312
5313 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5314 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5315 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5316 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5317 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5318 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5319
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5320 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5321
5322
5323 </td> <!-- entry_type -->
5324
5325 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5326 <p>Time GPS fix was made to include in
5327EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5328 </td>
5329
5330 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5331 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5332 </td>
5333
5334 <td class="entry_range">
5335 </td>
5336
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5337 <td class="entry_tags">
5338 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5339 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5340 </ul>
5341 </td>
5342
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5343 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5344
5345
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5346 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5347 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5348
5349
5350 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5351 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5352 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5353 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5354 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5355 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5356
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5357 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5358
5359
5360 </td> <!-- entry_type -->
5361
5362 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5363 <p>Orientation of JPEG image to
5364write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5365 </td>
5366
5367 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5368 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5369 </td>
5370
5371 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5372 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5373 </td>
5374
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5375 <td class="entry_tags">
5376 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5377 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5378 </ul>
5379 </td>
5380
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]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 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5389 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5390 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5391 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5392 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5393 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5394
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5395 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5396
5397
5398 </td> <!-- entry_type -->
5399
5400 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5401 <p>Compression quality of the final JPEG
5402image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5403 </td>
5404
5405 <td class="entry_units">
5406 </td>
5407
5408 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5409 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5410 </td>
5411
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5412 <td class="entry_tags">
5413 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5414 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5415 </ul>
5416 </td>
5417
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5418 </tr>
5419 <tr class="entries_header">
5420 <th class="th_details" colspan="5">Details</th>
5421 </tr>
5422 <tr class="entry_cont">
5423 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5424 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5425 </td>
5426 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5427
5428
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5429 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5430 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5431
5432
5433 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5434 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5435 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5436 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5437 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5438 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5439
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5440 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5441
5442
5443 </td> <!-- entry_type -->
5444
5445 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5446 <p>Compression quality of JPEG
5447thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5448 </td>
5449
5450 <td class="entry_units">
5451 </td>
5452
5453 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5454 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5455 </td>
5456
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5457 <td class="entry_tags">
5458 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5459 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5460 </ul>
5461 </td>
5462
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5463 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5464
5465
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5466 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5467 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5468
5469
5470 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5471 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5472 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5473 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5474 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5475 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5476 <span class="entry_type_container">x</span>
5477
5478 <span class="entry_type_array">
5479 2
5480 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5481 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5482
5483
5484 </td> <!-- entry_type -->
5485
5486 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5487 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5488 </td>
5489
5490 <td class="entry_units">
5491 </td>
5492
5493 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5494 <p>Size must be one of the size from <a href="#static_android.jpeg.availableThumbnailSizes">android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5495 </td>
5496
5497 <td class="entry_tags">
5498 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5499 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5500 </ul>
5501 </td>
5502
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5503 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5504 <tr class="entries_header">
5505 <th class="th_details" colspan="5">Details</th>
5506 </tr>
5507 <tr class="entry_cont">
5508 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5509 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5510but the captured JPEG must still be a valid image.<wbr/></p>
5511<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5512the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5513 </td>
5514 </tr>
5515
5516
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5517 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5518 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5519
5520
5521
5522 <!-- end of kind -->
5523 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5524 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5525
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5526 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5527 <tr>
5528 <th class="th_name">Property Name</th>
5529 <th class="th_type">Type</th>
5530 <th class="th_description">Description</th>
5531 <th class="th_units">Units</th>
5532 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5533 <th class="th_tags">Tags</th>
5534 </tr>
5535 </thead>
5536
5537 <tbody>
5538
5539
5540
5541
5542
5543
5544
5545
5546
5547
5548 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5549 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5550 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5551 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5552 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5553 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5554 <span class="entry_type_container">x</span>
5555
5556 <span class="entry_type_array">
5557 2 x n
5558 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5559 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5560
5561
5562 </td> <!-- entry_type -->
5563
5564 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5565 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5566 </td>
5567
5568 <td class="entry_units">
5569 </td>
5570
5571 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5572 <p>Must include at least one valid resolution,<wbr/> plus
5573(0,<wbr/>0) for no thumbnail generation,<wbr/> and each size must be distinct.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5574 </td>
5575
5576 <td class="entry_tags">
5577 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5578 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5579 </ul>
5580 </td>
5581
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5582 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5583 <tr class="entries_header">
5584 <th class="th_details" colspan="5">Details</th>
5585 </tr>
5586 <tr class="entry_cont">
5587 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5588 <p>Below condiditions must be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5589<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5590<li>The sizes must be sorted by increasing pixel area (width x height).<wbr/>
5591If 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]5592<li>The aspect ratio of the largest thumbnail size must be same as the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5593aspect ratio of largest size in <a href="#static_android.scaler.availableJpegSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes</a>.<wbr/>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5594The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5595in a given size list.<wbr/></li>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5596<li>Each size in <a href="#static_android.scaler.availableJpegSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes</a> must have at least
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5597one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
5598and vice versa.<wbr/></li>
5599<li>All non (0,<wbr/> 0) sizes must have non-zero widths and heights.<wbr/></li>
5600</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5601 </td>
5602 </tr>
5603
5604
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5605 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5606 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5607
5608
5609 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5610 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5611 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5612 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5613 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5614 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5615
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5616 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5617
5618
5619 </td> <!-- entry_type -->
5620
5621 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5622 <p>Maximum size in bytes for the compressed
5623JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5624 </td>
5625
5626 <td class="entry_units">
5627 </td>
5628
5629 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5630 <p>Must be large enough to fit any JPEG produced by
5631the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5632 </td>
5633
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5634 <td class="entry_tags">
5635 </td>
5636
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5637 </tr>
5638 <tr class="entries_header">
5639 <th class="th_details" colspan="5">Details</th>
5640 </tr>
5641 <tr class="entry_cont">
5642 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5643 <p>This is used for sizing the gralloc buffers for
5644JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5645 </td>
5646 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5647
5648
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5649 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5650 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5651
5652
5653
5654 <!-- end of kind -->
5655 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5656 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5657
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5658 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5659 <tr>
5660 <th class="th_name">Property Name</th>
5661 <th class="th_type">Type</th>
5662 <th class="th_description">Description</th>
5663 <th class="th_units">Units</th>
5664 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5665 <th class="th_tags">Tags</th>
5666 </tr>
5667 </thead>
5668
5669 <tbody>
5670
5671
5672
5673
5674
5675
5676
5677
5678
5679
5680 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5681 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5682 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5683 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5684 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5685 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5686 <span class="entry_type_container">x</span>
5687
5688 <span class="entry_type_array">
5689 3
5690 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5691 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5692 <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]5693
5694
5695 </td> <!-- entry_type -->
5696
5697 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5698 <p>GPS coordinates to include in output JPEG
5699EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5700 </td>
5701
5702 <td class="entry_units">
5703 </td>
5704
5705 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5706 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5707 </td>
5708
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5709 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5710 <ul class="entry_tags">
5711 <li><a href="#tag_BC">BC</a></li>
5712 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5713 </td>
5714
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5715 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5716
5717
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5718 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5719 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5720
5721
5722 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5723 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5724 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5725 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5726 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5727 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5728
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5729 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5730
5731
5732 </td> <!-- entry_type -->
5733
5734 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5735 <p>32 characters describing GPS algorithm to
5736include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5737 </td>
5738
5739 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5740 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5741 </td>
5742
5743 <td class="entry_range">
5744 </td>
5745
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5746 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5747 <ul class="entry_tags">
5748 <li><a href="#tag_BC">BC</a></li>
5749 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5750 </td>
5751
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5752 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5753
5754
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5755 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5756 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5757
5758
5759 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5760 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5761 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5762 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5763 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5764 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5765
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5766 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5767
5768
5769 </td> <!-- entry_type -->
5770
5771 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5772 <p>Time GPS fix was made to include in
5773EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5774 </td>
5775
5776 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5777 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5778 </td>
5779
5780 <td class="entry_range">
5781 </td>
5782
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5783 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5784 <ul class="entry_tags">
5785 <li><a href="#tag_BC">BC</a></li>
5786 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5787 </td>
5788
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5789 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5790
5791
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5792 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5793 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5794
5795
5796 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5797 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5798 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5799 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5800 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5801 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5802
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5803 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5804
5805
5806 </td> <!-- entry_type -->
5807
5808 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5809 <p>Orientation of JPEG image to
5810write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5811 </td>
5812
5813 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5814 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5815 </td>
5816
5817 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5818 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5819 </td>
5820
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5821 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5822 <ul class="entry_tags">
5823 <li><a href="#tag_BC">BC</a></li>
5824 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5825 </td>
5826
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5827 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5828
5829
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5830 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5831 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5832
5833
5834 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5835 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5836 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5837 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5838 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5839 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5840
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5841 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5842
5843
5844 </td> <!-- entry_type -->
5845
5846 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5847 <p>Compression quality of the final JPEG
5848image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5849 </td>
5850
5851 <td class="entry_units">
5852 </td>
5853
5854 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5855 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5856 </td>
5857
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5858 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5859 <ul class="entry_tags">
5860 <li><a href="#tag_BC">BC</a></li>
5861 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5862 </td>
5863
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5864 </tr>
5865 <tr class="entries_header">
5866 <th class="th_details" colspan="5">Details</th>
5867 </tr>
5868 <tr class="entry_cont">
5869 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5870 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5871 </td>
5872 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5873
5874
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5875 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5876 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5877
5878
5879 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5880 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5881 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5882 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5883 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5884 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5885
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5886 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5887
5888
5889 </td> <!-- entry_type -->
5890
5891 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5892 <p>The size of the compressed JPEG image,<wbr/> in
5893bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5894 </td>
5895
5896 <td class="entry_units">
5897 </td>
5898
5899 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]5900 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5901 </td>
5902
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5903 <td class="entry_tags">
5904 </td>
5905
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>If no JPEG output is produced for the request,<wbr/>
5913this must be 0.<wbr/></p>
5914<p>Otherwise,<wbr/> this describes the real size of the compressed
5915JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5916if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
5917has <a href="#dynamic_android.jpeg.size">android.<wbr/>jpeg.<wbr/>size</a> = 500000,<wbr/> then the output buffer from
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5918the JPEG stream will be 1000000 bytes,<wbr/> of which the first
5919500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5920 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5921 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5922
5923
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5924 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5925 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5926
5927
5928 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5929 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5930 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5931 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5932 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5933 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5934
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5935 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5936
5937
5938 </td> <!-- entry_type -->
5939
5940 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5941 <p>Compression quality of JPEG
5942thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5943 </td>
5944
5945 <td class="entry_units">
5946 </td>
5947
5948 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5949 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5950 </td>
5951
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5952 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5953 <ul class="entry_tags">
5954 <li><a href="#tag_BC">BC</a></li>
5955 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5956 </td>
5957
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5958 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5959
5960
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5961 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5962 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5963
5964
5965 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5966 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5967 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5968 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5969 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5970 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5971 <span class="entry_type_container">x</span>
5972
5973 <span class="entry_type_array">
5974 2
5975 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5976 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5977
5978
5979 </td> <!-- entry_type -->
5980
5981 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5982 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5983 </td>
5984
5985 <td class="entry_units">
5986 </td>
5987
5988 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5989 <p>Size must be one of the size from <a href="#static_android.jpeg.availableThumbnailSizes">android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5990 </td>
5991
5992 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5993 <ul class="entry_tags">
5994 <li><a href="#tag_BC">BC</a></li>
5995 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5996 </td>
5997
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5998 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5999 <tr class="entries_header">
6000 <th class="th_details" colspan="5">Details</th>
6001 </tr>
6002 <tr class="entry_cont">
6003 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6004 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
6005but the captured JPEG must still be a valid image.<wbr/></p>
6006<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6007the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6008 </td>
6009 </tr>
6010
6011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6012 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6013 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6014
6015
6016
6017 <!-- end of kind -->
6018 </tbody>
6019
6020 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6021 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6022
6023
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6024 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6025
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6026 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6027 <tr>
6028 <th class="th_name">Property Name</th>
6029 <th class="th_type">Type</th>
6030 <th class="th_description">Description</th>
6031 <th class="th_units">Units</th>
6032 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6033 <th class="th_tags">Tags</th>
6034 </tr>
6035 </thead>
6036
6037 <tbody>
6038
6039
6040
6041
6042
6043
6044
6045
6046
6047
6048 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6049 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6050 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6051 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6052 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6053 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6054
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6055 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6056
6057
6058 </td> <!-- entry_type -->
6059
6060 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6061 <p>The ratio of lens focal length to the effective
6062aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6063 </td>
6064
6065 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6066 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6067 </td>
6068
6069 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6070 <p><a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6071 </td>
6072
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6073 <td class="entry_tags">
6074 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6075 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6076 </ul>
6077 </td>
6078
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6079 </tr>
6080 <tr class="entries_header">
6081 <th class="th_details" colspan="5">Details</th>
6082 </tr>
6083 <tr class="entry_cont">
6084 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6085 <p>This will only be supported on the camera devices that
6086have variable aperture lens.<wbr/> The aperture value can only be
6087one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
6088<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
6089this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
6090<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
6091to achieve manual exposure control.<wbr/></p>
6092<p>The requested aperture value may take several frames to reach the
6093requested value; the camera device will report the current (intermediate)
6094aperture size in capture result metadata while the aperture is changing.<wbr/></p>
6095<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
6096the ON modes,<wbr/> this will be overridden by the camera device
6097auto-exposure algorithm,<wbr/> the overridden values are then provided
6098back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6099 </td>
6100 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6101
6102
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6103 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6104 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6105
6106
6107 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6108 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6109 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6110 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6111 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6112 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6113
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6114 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6115
6116
6117 </td> <!-- entry_type -->
6118
6119 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6120 <p>State of lens neutral density
6121filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6122 </td>
6123
6124 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6125 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6126 </td>
6127
6128 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6129 <p><a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6130 </td>
6131
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6132 <td class="entry_tags">
6133 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6134 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6135 </ul>
6136 </td>
6137
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6138 </tr>
6139 <tr class="entries_header">
6140 <th class="th_details" colspan="5">Details</th>
6141 </tr>
6142 <tr class="entry_cont">
6143 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6144 <p>Will not be supported on most devices.<wbr/> Can only
6145pick from supported list</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="controls_android.lens.focalLength">
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/>focal<wbr/>Length
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
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6161 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6162
6163
6164 </td> <!-- entry_type -->
6165
6166 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6167 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6168 </td>
6169
6170 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6171 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6172 </td>
6173
6174 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6175 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6176 </td>
6177
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6178 <td class="entry_tags">
6179 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6180 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6181 </ul>
6182 </td>
6183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6184 </tr>
6185 <tr class="entries_header">
6186 <th class="th_details" colspan="5">Details</th>
6187 </tr>
6188 <tr class="entry_cont">
6189 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6190 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6191 </td>
6192 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6193
6194
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6195 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6196 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6197
6198
6199 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6200 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6201 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6202 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6203 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6204 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6205
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6206 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6207
6208
6209 </td> <!-- entry_type -->
6210
6211 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6212 <p>Distance to plane of sharpest focus,<wbr/>
6213measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6214 </td>
6215
6216 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6217 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6218 </td>
6219
6220 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6221 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6222 </td>
6223
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6224 <td class="entry_tags">
6225 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6226 <li><a href="#tag_BC">BC</a></li>
6227 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6228 </ul>
6229 </td>
6230
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6231 </tr>
6232 <tr class="entries_header">
6233 <th class="th_details" colspan="5">Details</th>
6234 </tr>
6235 <tr class="entry_cont">
6236 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6237 <p>0 = infinity focus.<wbr/> Used value should be clamped
6238to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6239 </td>
6240 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6241
6242
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6243 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6244 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6245
6246
6247 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6248 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6249 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6250 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6251 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6252 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6253
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6254 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6255
6256 <ul class="entry_type_enum">
6257 <li>
6258 <span class="entry_type_enum_name">OFF</span>
6259 </li>
6260 <li>
6261 <span class="entry_type_enum_name">ON</span>
6262 <span class="entry_type_enum_optional">optional</span>
6263 </li>
6264 </ul>
6265
6266 </td> <!-- entry_type -->
6267
6268 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6269 <p>Whether optical image stabilization is
6270enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6271 </td>
6272
6273 <td class="entry_units">
6274 </td>
6275
6276 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6277 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6278 </td>
6279
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6280 <td class="entry_tags">
6281 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6282 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6283 </ul>
6284 </td>
6285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6286 </tr>
6287 <tr class="entries_header">
6288 <th class="th_details" colspan="5">Details</th>
6289 </tr>
6290 <tr class="entry_cont">
6291 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6292 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6293 </td>
6294 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6295
6296
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6297 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6298 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6299
6300
6301
6302 <!-- end of kind -->
6303 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6304 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6305
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6306 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6307 <tr>
6308 <th class="th_name">Property Name</th>
6309 <th class="th_type">Type</th>
6310 <th class="th_description">Description</th>
6311 <th class="th_units">Units</th>
6312 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6313 <th class="th_tags">Tags</th>
6314 </tr>
6315 </thead>
6316
6317 <tbody>
6318
6319
6320
6321
6322
6323
6324
6325
6326
6327
6328
6329
6330 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6331 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6332 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6333 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6334 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6335 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6336 <span class="entry_type_container">x</span>
6337
6338 <span class="entry_type_array">
6339 n
6340 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6341 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6342
6343
6344 </td> <!-- entry_type -->
6345
6346 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6347 <p>List of supported aperture
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6348values.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6349 </td>
6350
6351 <td class="entry_units">
6352 </td>
6353
6354 <td class="entry_range">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6355 <p>one entry required,<wbr/> &amp;&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6356 </td>
6357
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6358 <td class="entry_tags">
6359 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6360 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6361 </ul>
6362 </td>
6363
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6364 </tr>
6365 <tr class="entries_header">
6366 <th class="th_details" colspan="5">Details</th>
6367 </tr>
6368 <tr class="entry_cont">
6369 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6370 <p>If the camera device doesn't support variable apertures,<wbr/>
6371listed value will be the fixed aperture.<wbr/></p>
6372<p>If the camera device supports variable apertures,<wbr/> the aperture value
6373in this list will be sorted in ascending order.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6374 </td>
6375 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6376
6377
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6378 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6379 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6380
6381
6382 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6383 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6384 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6385 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6386 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6387 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6388 <span class="entry_type_container">x</span>
6389
6390 <span class="entry_type_array">
6391 n
6392 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6393 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6394
6395
6396 </td> <!-- entry_type -->
6397
6398 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6399 <p>List of supported ND filter
6400values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6401 </td>
6402
6403 <td class="entry_units">
6404 </td>
6405
6406 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6407 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6408 </td>
6409
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6410 <td class="entry_tags">
6411 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6412 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6413 </ul>
6414 </td>
6415
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6416 </tr>
6417 <tr class="entries_header">
6418 <th class="th_details" colspan="5">Details</th>
6419 </tr>
6420 <tr class="entry_cont">
6421 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6422 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6423lists the available exposure index values for dimming
6424(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6425light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6426 </td>
6427 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6428
6429
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6430 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6431 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6432
6433
6434 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6435 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6436 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6437 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6438 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6439 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6440 <span class="entry_type_container">x</span>
6441
6442 <span class="entry_type_array">
6443 n
6444 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6445 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6446 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6447
6448
6449 </td> <!-- entry_type -->
6450
6451 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6452 <p>If fitted with optical zoom,<wbr/> what focal
6453lengths are available.<wbr/> If not,<wbr/> the static focal
6454length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6455 </td>
6456
6457 <td class="entry_units">
6458 </td>
6459
6460 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6461 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6462 </td>
6463
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6464 <td class="entry_tags">
6465 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6466 <li><a href="#tag_BC">BC</a></li>
6467 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6468 </ul>
6469 </td>
6470
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6471 </tr>
6472 <tr class="entries_header">
6473 <th class="th_details" colspan="5">Details</th>
6474 </tr>
6475 <tr class="entry_cont">
6476 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6477 <p>If optical zoom not supported,<wbr/> only one value
6478should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6479 </td>
6480 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6481
6482
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6483 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6484 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6485
6486
6487 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6488 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6489 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6490 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6491 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6492 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6493 <span class="entry_type_container">x</span>
6494
6495 <span class="entry_type_array">
6496 n
6497 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6498 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6499 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6500
6501
6502 </td> <!-- entry_type -->
6503
6504 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6505 <p>List of supported optical image
6506stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6507 </td>
6508
6509 <td class="entry_units">
6510 </td>
6511
6512 <td class="entry_range">
6513 </td>
6514
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6515 <td class="entry_tags">
6516 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6517 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6518 </ul>
6519 </td>
6520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6521 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6522
6523
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6524 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6525 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6526
6527
6528 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6529 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6530 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6531 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6532 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6533 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6534 <span class="entry_type_container">x</span>
6535
6536 <span class="entry_type_array">
6537 2 x 3 x n x m
6538 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6539 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6540 <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]6541
6542
6543 </td> <!-- entry_type -->
6544
6545 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6546 <p>A low-resolution map for correction of
6547geometric distortions and chromatic aberrations,<wbr/> per
6548color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6549 </td>
6550
6551 <td class="entry_units">
6552 </td>
6553
6554 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6555 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6556 </td>
6557
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6558 <td class="entry_tags">
6559 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6560 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6561 </ul>
6562 </td>
6563
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6564 </tr>
6565 <tr class="entries_header">
6566 <th class="th_details" colspan="5">Details</th>
6567 </tr>
6568 <tr class="entry_cont">
6569 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6570 <p>[DNG wants a function instead].<wbr/> What's easiest
6571for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
6572j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
6573j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
6574entry 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]6575 </td>
6576 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6577
6578
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6579 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6580 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6581
6582
6583 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6584 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6585 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6586 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6587 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6588 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6589 <span class="entry_type_container">x</span>
6590
6591 <span class="entry_type_array">
6592 2
6593 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6594 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6595 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6596
6597
6598 </td> <!-- entry_type -->
6599
6600 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6601 <p>Dimensions of geometric correction
6602map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6603 </td>
6604
6605 <td class="entry_units">
6606 </td>
6607
6608 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6609 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6610 </td>
6611
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6612 <td class="entry_tags">
6613 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6614 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6615 </ul>
6616 </td>
6617
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6618 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6619
6620
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6621 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6622 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6623
6624
6625 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6626 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6627 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6628 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6629 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6630 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6631
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6632 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6633
6634
6635 </td> <!-- entry_type -->
6636
6637 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6638 <p>Hyperfocal distance for this lens; set to
66390 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6640 </td>
6641
6642 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6643 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6644 </td>
6645
6646 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6647 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6648 </td>
6649
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6650 <td class="entry_tags">
6651 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6652 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6653 </ul>
6654 </td>
6655
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6656 </tr>
6657 <tr class="entries_header">
6658 <th class="th_details" colspan="5">Details</th>
6659 </tr>
6660 <tr class="entry_cont">
6661 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6662 <p>The hyperfocal distance is used for the old
6663API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6664 </td>
6665 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6666
6667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6668 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6669 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6670
6671
6672 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6673 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6674 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6675 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6676 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6677 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6678
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6679 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6680
6681
6682 </td> <!-- entry_type -->
6683
6684 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6685 <p>Shortest distance from frontmost surface
6686of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6687 </td>
6688
6689 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6690 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6691 </td>
6692
6693 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6694 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6695 </td>
6696
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6697 <td class="entry_tags">
6698 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6699 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6700 </ul>
6701 </td>
6702
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6703 </tr>
6704 <tr class="entries_header">
6705 <th class="th_details" colspan="5">Details</th>
6706 </tr>
6707 <tr class="entry_cont">
6708 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6709 <p>If the lens is fixed-focus,<wbr/> this should be
67100</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6711 </td>
6712 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6713
6714
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6715 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6716 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6717
6718
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6719 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6720 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6721 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6722 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6723 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6724 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6725 <span class="entry_type_container">x</span>
6726
6727 <span class="entry_type_array">
6728 2
6729 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6730 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6731 <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]6732
6733
6734 </td> <!-- entry_type -->
6735
6736 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6737 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6738 </td>
6739
6740 <td class="entry_units">
6741 </td>
6742
6743 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6744 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6745 </td>
6746
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6747 <td class="entry_tags">
6748 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6749 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6750 </ul>
6751 </td>
6752
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6753 </tr>
6754 <tr class="entries_header">
6755 <th class="th_details" colspan="5">Details</th>
6756 </tr>
6757 <tr class="entry_cont">
6758 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6759 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
6760must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6761 </td>
6762 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6763
6764
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6765 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6766 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6767
6768
6769
6770
6771
6772 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6773 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6774 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6775 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6776 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6777 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6778
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6779 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6780
6781 <ul class="entry_type_enum">
6782 <li>
6783 <span class="entry_type_enum_name">FRONT</span>
6784 </li>
6785 <li>
6786 <span class="entry_type_enum_name">BACK</span>
6787 </li>
6788 </ul>
6789
6790 </td> <!-- entry_type -->
6791
6792 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6793 <p>Direction the camera faces relative to
6794device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6795 </td>
6796
6797 <td class="entry_units">
6798 </td>
6799
6800 <td class="entry_range">
6801 </td>
6802
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6803 <td class="entry_tags">
6804 </td>
6805
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6806 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6807
6808
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6809 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6810 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6811
6812
6813 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6814 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6815 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6816 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6817 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6818 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6819 <span class="entry_type_container">x</span>
6820
6821 <span class="entry_type_array">
6822 2
6823 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6824 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6825 <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]6826
6827
6828 </td> <!-- entry_type -->
6829
6830 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6831 <p>Relative angle of camera optical axis to the
6832perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6833 </td>
6834
6835 <td class="entry_units">
6836 </td>
6837
6838 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6839 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6840 </td>
6841
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6842 <td class="entry_tags">
6843 <ul class="entry_tags">
6844 <li><a href="#tag_ADV">ADV</a></li>
6845 </ul>
6846 </td>
6847
6848 </tr>
6849 <tr class="entries_header">
6850 <th class="th_details" colspan="5">Details</th>
6851 </tr>
6852 <tr class="entry_cont">
6853 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6854 <p>Examples:</p>
6855<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6856is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6857<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6858device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6859<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
6860the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6861<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6862direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6863 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6864 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6865
6866
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6867 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6868 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6869
6870
6871 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6872 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6873 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6874 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6875 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6876 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6877 <span class="entry_type_container">x</span>
6878
6879 <span class="entry_type_array">
6880 3, location in mm, in the sensor coordinate
6881 system
6882 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6883 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6884
6885
6886 </td> <!-- entry_type -->
6887
6888 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6889 <p>Coordinates of camera optical axis on
6890device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6891 </td>
6892
6893 <td class="entry_units">
6894 </td>
6895
6896 <td class="entry_range">
6897 </td>
6898
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6899 <td class="entry_tags">
6900 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6901 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6902 </ul>
6903 </td>
6904
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6905 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6906
6907
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6908 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6909 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6910
6911
6912
6913 <!-- end of kind -->
6914 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6915 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6916
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6917 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6918 <tr>
6919 <th class="th_name">Property Name</th>
6920 <th class="th_type">Type</th>
6921 <th class="th_description">Description</th>
6922 <th class="th_units">Units</th>
6923 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6924 <th class="th_tags">Tags</th>
6925 </tr>
6926 </thead>
6927
6928 <tbody>
6929
6930
6931
6932
6933
6934
6935
6936
6937
6938
6939 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6940 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6941 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6942 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6943 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6944 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6945
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6946 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6947
6948
6949 </td> <!-- entry_type -->
6950
6951 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6952 <p>The ratio of lens focal length to the effective
6953aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6954 </td>
6955
6956 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6957 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6958 </td>
6959
6960 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6961 <p><a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6962 </td>
6963
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6964 <td class="entry_tags">
6965 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6966 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6967 </ul>
6968 </td>
6969
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6970 </tr>
6971 <tr class="entries_header">
6972 <th class="th_details" colspan="5">Details</th>
6973 </tr>
6974 <tr class="entry_cont">
6975 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6976 <p>This will only be supported on the camera devices that
6977have variable aperture lens.<wbr/> The aperture value can only be
6978one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
6979<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
6980this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
6981<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
6982to achieve manual exposure control.<wbr/></p>
6983<p>The requested aperture value may take several frames to reach the
6984requested value; the camera device will report the current (intermediate)
6985aperture size in capture result metadata while the aperture is changing.<wbr/></p>
6986<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
6987the ON modes,<wbr/> this will be overridden by the camera device
6988auto-exposure algorithm,<wbr/> the overridden values are then provided
6989back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6990 </td>
6991 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6992
6993
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6994 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6995 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6996
6997
6998 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6999 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7000 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7001 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7002 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7003 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7004
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7005 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7006
7007
7008 </td> <!-- entry_type -->
7009
7010 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7011 <p>State of lens neutral density
7012filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7013 </td>
7014
7015 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7016 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7017 </td>
7018
7019 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7020 <p><a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7021 </td>
7022
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7023 <td class="entry_tags">
7024 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7025 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7026 </ul>
7027 </td>
7028
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7029 </tr>
7030 <tr class="entries_header">
7031 <th class="th_details" colspan="5">Details</th>
7032 </tr>
7033 <tr class="entry_cont">
7034 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7035 <p>Will not be supported on most devices.<wbr/> Can only
7036pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7037 </td>
7038 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7039
7040
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7041 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7042 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7043
7044
7045 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7046 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7047 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7048 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7049 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7050 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7051
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7052 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7053
7054
7055 </td> <!-- entry_type -->
7056
7057 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7058 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7059 </td>
7060
7061 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7062 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7063 </td>
7064
7065 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7066 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7067 </td>
7068
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7069 <td class="entry_tags">
7070 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7071 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7072 </ul>
7073 </td>
7074
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7075 </tr>
7076 <tr class="entries_header">
7077 <th class="th_details" colspan="5">Details</th>
7078 </tr>
7079 <tr class="entry_cont">
7080 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7081 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7082 </td>
7083 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7084
7085
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7086 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7087 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7088
7089
7090 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7091 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7092 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7093 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7094 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7095 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7096
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7097 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7098
7099
7100 </td> <!-- entry_type -->
7101
7102 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7103 <p>Distance to plane of sharpest focus,<wbr/>
7104measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7105 </td>
7106
7107 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7108 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7109 </td>
7110
7111 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7112 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7113 </td>
7114
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7115 <td class="entry_tags">
7116 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7117 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7118 </ul>
7119 </td>
7120
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7121 </tr>
7122 <tr class="entries_header">
7123 <th class="th_details" colspan="5">Details</th>
7124 </tr>
7125 <tr class="entry_cont">
7126 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7127 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7128 </td>
7129 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7130
7131
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7132 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7133 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7134
7135
7136 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7137 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7138 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7139 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7140 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7141 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7142 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7143
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7144 <span class="entry_type_array">
7145 2
7146 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7147 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7148 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7149
7150
7151 </td> <!-- entry_type -->
7152
7153 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7154 <p>The range of scene distances that are in
7155sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7156 </td>
7157
7158 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7159 pair of focus distances in diopters: (near,<wbr/>
7160 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7161 </td>
7162
7163 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7164 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7165 </td>
7166
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7167 <td class="entry_tags">
7168 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7169 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7170 </ul>
7171 </td>
7172
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7173 </tr>
7174 <tr class="entries_header">
7175 <th class="th_details" colspan="5">Details</th>
7176 </tr>
7177 <tr class="entry_cont">
7178 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7179 <p>If variable focus not supported,<wbr/> can still report
7180fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7181 </td>
7182 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7183
7184
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7185 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7186 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7187
7188
7189 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7190 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7191 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7192 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7193 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7194 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7195
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7196 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7197
7198 <ul class="entry_type_enum">
7199 <li>
7200 <span class="entry_type_enum_name">OFF</span>
7201 </li>
7202 <li>
7203 <span class="entry_type_enum_name">ON</span>
7204 <span class="entry_type_enum_optional">optional</span>
7205 </li>
7206 </ul>
7207
7208 </td> <!-- entry_type -->
7209
7210 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7211 <p>Whether optical image stabilization is
7212enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7213 </td>
7214
7215 <td class="entry_units">
7216 </td>
7217
7218 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7219 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7220 </td>
7221
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7222 <td class="entry_tags">
7223 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7224 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7225 </ul>
7226 </td>
7227
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7228 </tr>
7229 <tr class="entries_header">
7230 <th class="th_details" colspan="5">Details</th>
7231 </tr>
7232 <tr class="entry_cont">
7233 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7234 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7235 </td>
7236 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7237
7238
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7239 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7240 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7241
7242
7243 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7244 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7245 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7246 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7247 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7248 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7249
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7250 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7251
7252 <ul class="entry_type_enum">
7253 <li>
7254 <span class="entry_type_enum_name">STATIONARY</span>
7255 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7256 <li>
7257 <span class="entry_type_enum_name">MOVING</span>
7258 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7259 </ul>
7260
7261 </td> <!-- entry_type -->
7262
7263 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7264 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7265 </td>
7266
7267 <td class="entry_units">
7268 </td>
7269
7270 <td class="entry_range">
7271 </td>
7272
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7273 <td class="entry_tags">
7274 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7275 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7276 </ul>
7277 </td>
7278
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7279 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7280
7281
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7282 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7283 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7284
7285
7286
7287 <!-- end of kind -->
7288 </tbody>
7289
7290 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7291 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7292
7293
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7294 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7295
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7296 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7297 <tr>
7298 <th class="th_name">Property Name</th>
7299 <th class="th_type">Type</th>
7300 <th class="th_description">Description</th>
7301 <th class="th_units">Units</th>
7302 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7303 <th class="th_tags">Tags</th>
7304 </tr>
7305 </thead>
7306
7307 <tbody>
7308
7309
7310
7311
7312
7313
7314
7315
7316
7317
7318 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7319 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7320 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7321 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7322 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7323 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7324
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7325 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7326
7327 <ul class="entry_type_enum">
7328 <li>
7329 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7330 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7331 </li>
7332 <li>
7333 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7334 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7335 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7336 </li>
7337 <li>
7338 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7339 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7340 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7341 </li>
7342 </ul>
7343
7344 </td> <!-- entry_type -->
7345
7346 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7347 <p>Mode of operation for the noise reduction
7348algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7349 </td>
7350
7351 <td class="entry_units">
7352 </td>
7353
7354 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7355 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7356 </td>
7357
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7358 <td class="entry_tags">
7359 <ul class="entry_tags">
7360 <li><a href="#tag_V1">V1</a></li>
7361 </ul>
7362 </td>
7363
7364 </tr>
7365 <tr class="entries_header">
7366 <th class="th_details" colspan="5">Details</th>
7367 </tr>
7368 <tr class="entry_cont">
7369 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7370 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7371will be applied by the HAL.<wbr/></p>
7372<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7373will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7374should use the highest-quality noise filtering algorithms,<wbr/>
7375even if it slows down capture rate.<wbr/> FAST means the HAL should not
7376slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7377 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7378 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7379
7380
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7381 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7382 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7383
7384
7385 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7386 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7387 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7388 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7389 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7390 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7391
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7392 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7393
7394
7395 </td> <!-- entry_type -->
7396
7397 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7398 <p>Control the amount of noise reduction
7399applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7400 </td>
7401
7402 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7403 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7404 </td>
7405
7406 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7407 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7408 </td>
7409
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7410 <td class="entry_tags">
7411 </td>
7412
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7413 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7414
7415
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7416 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7417 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7418
7419
7420
7421 <!-- end of kind -->
7422 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7423 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7424
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7425 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7426 <tr>
7427 <th class="th_name">Property Name</th>
7428 <th class="th_type">Type</th>
7429 <th class="th_description">Description</th>
7430 <th class="th_units">Units</th>
7431 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7432 <th class="th_tags">Tags</th>
7433 </tr>
7434 </thead>
7435
7436 <tbody>
7437
7438
7439
7440
7441
7442
7443
7444
7445
7446
7447 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7448 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7449 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7450 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7451 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7452 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7453
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7454 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7455
7456 <ul class="entry_type_enum">
7457 <li>
7458 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7459 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7460 </li>
7461 <li>
7462 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7463 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7464 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7465 </li>
7466 <li>
7467 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7468 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7469 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7470 </li>
7471 </ul>
7472
7473 </td> <!-- entry_type -->
7474
7475 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7476 <p>Mode of operation for the noise reduction
7477algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7478 </td>
7479
7480 <td class="entry_units">
7481 </td>
7482
7483 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7484 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7485 </td>
7486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7487 <td class="entry_tags">
7488 <ul class="entry_tags">
7489 <li><a href="#tag_V1">V1</a></li>
7490 </ul>
7491 </td>
7492
7493 </tr>
7494 <tr class="entries_header">
7495 <th class="th_details" colspan="5">Details</th>
7496 </tr>
7497 <tr class="entry_cont">
7498 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7499 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7500will be applied by the HAL.<wbr/></p>
7501<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7502will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7503should use the highest-quality noise filtering algorithms,<wbr/>
7504even if it slows down capture rate.<wbr/> FAST means the HAL should not
7505slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7506 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7507 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7508
7509
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7510 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7511 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7512
7513
7514
7515 <!-- end of kind -->
7516 </tbody>
7517
7518 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7519 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7520
7521
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7522 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7523
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7524 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7525 <tr>
7526 <th class="th_name">Property Name</th>
7527 <th class="th_type">Type</th>
7528 <th class="th_description">Description</th>
7529 <th class="th_units">Units</th>
7530 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7531 <th class="th_tags">Tags</th>
7532 </tr>
7533 </thead>
7534
7535 <tbody>
7536
7537
7538
7539
7540
7541
7542
7543
7544
7545
7546 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7547 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7548 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7549 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7550 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7551 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7552
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7553 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7554
7555
7556 </td> <!-- entry_type -->
7557
7558 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7559 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7560scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7561region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
7562and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7563 </td>
7564
7565 <td class="entry_units">
7566 </td>
7567
7568 <td class="entry_range">
7569 </td>
7570
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7571 <td class="entry_tags">
7572 </td>
7573
7574 </tr>
7575 <tr class="entries_header">
7576 <th class="th_details" colspan="5">Details</th>
7577 </tr>
7578 <tr class="entry_cont">
7579 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7580 <p>Normalized coordinates refer to those in the
7581(-1000,<wbr/>1000) range mentioned in the
7582android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7583<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7584sensor array-relative coordinates for all region data.<wbr/> Does
7585not need to be listed in static metadata.<wbr/> Support will be
7586removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7587 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7588 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7589
7590
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7591 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7592 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7593
7594
7595 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7596 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7597 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7598 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7599 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7600 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7601
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7602 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7603
7604
7605 </td> <!-- entry_type -->
7606
7607 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7608 <p>If set to 1,<wbr/> then the camera service always
7609switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
7610trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7611 </td>
7612
7613 <td class="entry_units">
7614 </td>
7615
7616 <td class="entry_range">
7617 </td>
7618
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7619 <td class="entry_tags">
7620 </td>
7621
7622 </tr>
7623 <tr class="entries_header">
7624 <th class="th_details" colspan="5">Details</th>
7625 </tr>
7626 <tr class="entry_cont">
7627 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7628 <p>HAL implementations should implement AF trigger
7629modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
7630CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
7631not need to be listed in static metadata.<wbr/> Support will be
7632removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7633 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7634 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7635
7636
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7637 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7638 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7639
7640
7641 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7642 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7643 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7644 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7645 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7646 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7647
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7648 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7649
7650
7651 </td> <!-- entry_type -->
7652
7653 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7654 <p>If set to 1,<wbr/> the camera service uses
7655CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
7656HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
7657shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7658 </td>
7659
7660 <td class="entry_units">
7661 </td>
7662
7663 <td class="entry_range">
7664 </td>
7665
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7666 <td class="entry_tags">
7667 </td>
7668
7669 </tr>
7670 <tr class="entries_header">
7671 <th class="th_details" colspan="5">Details</th>
7672 </tr>
7673 <tr class="entry_cont">
7674 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7675 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7676to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7677zero-shutter-lag,<wbr/> instead of relying on an explicit
7678format setting.<wbr/> Does not need to be listed in static
7679metadata.<wbr/> Support will be removed in future versions of
7680camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7681 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7682 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7683
7684
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7685 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7686 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7687
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7688
7689 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7690 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7691 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7692 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7693 <td class="entry_type">
7694 <span class="entry_type_name">byte</span>
7695
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7696 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7697
7698
7699 </td> <!-- entry_type -->
7700
7701 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7702 <p>If set to 1,<wbr/> the HAL will always split result
7703metadata for a single capture into multiple buffers,<wbr/>
7704returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7705 </td>
7706
7707 <td class="entry_units">
7708 </td>
7709
7710 <td class="entry_range">
7711 </td>
7712
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7713 <td class="entry_tags">
7714 </td>
7715
7716 </tr>
7717 <tr class="entries_header">
7718 <th class="th_details" colspan="5">Details</th>
7719 </tr>
7720 <tr class="entry_cont">
7721 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7722 <p>Does not need to be listed in static
7723metadata.<wbr/> Support for partial results will be reworked in
7724future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7725working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7726consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7727 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7728 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7729
7730
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7731 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7732 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7733
7734
7735
7736 <!-- end of kind -->
7737 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7738 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7739
7740 <thead class="entries_header">
7741 <tr>
7742 <th class="th_name">Property Name</th>
7743 <th class="th_type">Type</th>
7744 <th class="th_description">Description</th>
7745 <th class="th_units">Units</th>
7746 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7747 <th class="th_tags">Tags</th>
7748 </tr>
7749 </thead>
7750
7751 <tbody>
7752
7753
7754
7755
7756
7757
7758
7759
7760
7761
7762 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7763 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7764 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7765 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7766 <td class="entry_type">
7767 <span class="entry_type_name entry_type_name_enum">byte</span>
7768
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7769 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7770
7771 <ul class="entry_type_enum">
7772 <li>
7773 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7774 <span class="entry_type_enum_notes">The last or only metadata result buffer
7775 for this capture.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7776 </li>
7777 <li>
7778 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7779 <span class="entry_type_enum_notes">A partial buffer of result metadata for this
7780 capture.<wbr/> More result buffers for this capture will be sent
7781 by the HAL,<wbr/> the last of which will be marked
7782 FINAL.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7783 </li>
7784 </ul>
7785
7786 </td> <!-- entry_type -->
7787
7788 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7789 <p>Whether a result given to the framework is the
7790final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7791subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7792values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7793 </td>
7794
7795 <td class="entry_units">
7796 </td>
7797
7798 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7799 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7800 </td>
7801
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7802 <td class="entry_tags">
7803 </td>
7804
7805 </tr>
7806 <tr class="entries_header">
7807 <th class="th_details" colspan="5">Details</th>
7808 </tr>
7809 <tr class="entry_cont">
7810 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7811 <p>The entries in the result metadata buffers for a
7812single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7813FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7814requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
7815always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
7816before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
7817in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
7818capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
7819only 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]7820 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7821 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7822
7823
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7824 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7825 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7826
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7827
7828
7829 <!-- end of kind -->
7830 </tbody>
7831
7832 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7833 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7834
7835
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7836 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7837
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7838 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7839 <tr>
7840 <th class="th_name">Property Name</th>
7841 <th class="th_type">Type</th>
7842 <th class="th_description">Description</th>
7843 <th class="th_units">Units</th>
7844 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7845 <th class="th_tags">Tags</th>
7846 </tr>
7847 </thead>
7848
7849 <tbody>
7850
7851
7852
7853
7854
7855
7856
7857
7858
7859
7860 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7861 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7862 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7863 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7864 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7865 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7866
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7867 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7868
7869
7870 </td> <!-- entry_type -->
7871
7872 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7873 <p>A frame counter set by the framework.<wbr/> Must
7874be maintained unchanged in output frame.<wbr/> This value monotonically
7875increases with every new result (that is,<wbr/> each new result has a unique
7876frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7877 </td>
7878
7879 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7880 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7881 </td>
7882
7883 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7884 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7885 </td>
7886
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7887 <td class="entry_tags">
7888 </td>
7889
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7890 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7891
7892
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7893 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7894 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7895
7896
7897 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7898 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7899 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7900 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7901 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7902 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7903
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7904 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7905
7906
7907 </td> <!-- entry_type -->
7908
7909 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7910 <p>An application-specified ID for the current
7911request.<wbr/> Must be maintained unchanged in output
7912frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7913 </td>
7914
7915 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7916 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7917 </td>
7918
7919 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7920 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7921 </td>
7922
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7923 <td class="entry_tags">
7924 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7925 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7926 </ul>
7927 </td>
7928
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7929 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7930
7931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7932 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7933 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7934
7935
7936 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7937 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7938 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7939 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7940 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7941 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7942 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7943
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7944 <span class="entry_type_array">
7945 n
7946 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7947 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7948
7949
7950 </td> <!-- entry_type -->
7951
7952 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7953 <p>List which camera reprocess stream is used
7954for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7955 </td>
7956
7957 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7958 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7959 </td>
7960
7961 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7962 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
7963reprocess stream ID.<wbr/></p>
7964<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
7965reprocess streams may be included in a single request; they
7966must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7967 </td>
7968
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7969 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7970 <ul class="entry_tags">
7971 <li><a href="#tag_HAL2">HAL2</a></li>
7972 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7973 </td>
7974
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7975 </tr>
7976 <tr class="entries_header">
7977 <th class="th_details" colspan="5">Details</th>
7978 </tr>
7979 <tr class="entry_cont">
7980 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7981 <p>Only meaningful when <a href="#controls_android.request.type">android.<wbr/>request.<wbr/>type</a> ==
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7982REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7983 </td>
7984 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7985
7986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7987 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7988 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7989
7990
7991 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7992 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7993 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7994 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7995 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7996 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7997
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7998 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7999
8000 <ul class="entry_type_enum">
8001 <li>
8002 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8003 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
8004 for application-bound buffer data.<wbr/> If no
8005 application-bound streams exist,<wbr/> no frame should be
8006 placed in the output frame queue.<wbr/> If such streams
8007 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8008 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8009 information.<wbr/> Timestamp information should still be
8010 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8011 </li>
8012 <li>
8013 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8014 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8015 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8016 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8017 </li>
8018 </ul>
8019
8020 </td> <!-- entry_type -->
8021
8022 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8023 <p>How much metadata to produce on
8024output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8025 </td>
8026
8027 <td class="entry_units">
8028 </td>
8029
8030 <td class="entry_range">
8031 </td>
8032
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8033 <td class="entry_tags">
8034 </td>
8035
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8036 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8037
8038
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8039 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8040 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8041
8042
8043 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8044 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8045 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8046 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8047 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8048 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8049 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8050
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8051 <span class="entry_type_array">
8052 n
8053 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8054 <span class="entry_type_visibility"> [system]</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>Lists which camera output streams image data
8061from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8062 </td>
8063
8064 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8065 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8066 </td>
8067
8068 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8069 <p>List must only include streams that have been
8070created</p>
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">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8074 <ul class="entry_tags">
8075 <li><a href="#tag_HAL2">HAL2</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>
8080 <tr class="entries_header">
8081 <th class="th_details" colspan="5">Details</th>
8082 </tr>
8083 <tr class="entry_cont">
8084 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8085 <p>If no output streams are listed,<wbr/> then the image
8086data should simply be discarded.<wbr/> The image data must
8087still be captured for metadata and statistics production,<wbr/>
8088and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8089 </td>
8090 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8091
8092
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8093 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8094 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8095
8096
8097 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8098 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8099 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8100 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8101 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8102 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8103
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8104 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8105
8106 <ul class="entry_type_enum">
8107 <li>
8108 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8109 <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]8110 and process it according to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8111 settings</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8112 </li>
8113 <li>
8114 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8115 <span class="entry_type_enum_notes">Process previously captured data; the
8116 android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
8117 source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
8118 needed for reprocessing with [RP]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8119 </li>
8120 </ul>
8121
8122 </td> <!-- entry_type -->
8123
8124 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8125 <p>The type of the request; either CAPTURE or
8126REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8127 </td>
8128
8129 <td class="entry_units">
8130 </td>
8131
8132 <td class="entry_range">
8133 </td>
8134
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8135 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8136 <ul class="entry_tags">
8137 <li><a href="#tag_HAL2">HAL2</a></li>
8138 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8139 </td>
8140
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8141 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8142
8143
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8144 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8145 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8146
8147
8148
8149 <!-- end of kind -->
8150 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8151 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8152
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8153 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8154 <tr>
8155 <th class="th_name">Property Name</th>
8156 <th class="th_type">Type</th>
8157 <th class="th_description">Description</th>
8158 <th class="th_units">Units</th>
8159 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8160 <th class="th_tags">Tags</th>
8161 </tr>
8162 </thead>
8163
8164 <tbody>
8165
8166
8167
8168
8169
8170
8171
8172
8173
8174
8175 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8176 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8177 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8178 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8179 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8180 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8181 <span class="entry_type_container">x</span>
8182
8183 <span class="entry_type_array">
8184 3
8185 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8186 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8187
8188
8189 </td> <!-- entry_type -->
8190
8191 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8192 <p>How many output streams can be allocated at
8193the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8194 </td>
8195
8196 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8197 The number of raw sensor streams; the number of
8198 processed,<wbr/> uncompressed streams; and the number of
8199 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8200 </td>
8201
8202 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8203 <p>&gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8204for processed,<wbr/> uncompressed streams</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8205 </td>
8206
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8207 <td class="entry_tags">
8208 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8209 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8210 </ul>
8211 </td>
8212
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8213 </tr>
8214 <tr class="entries_header">
8215 <th class="th_details" colspan="5">Details</th>
8216 </tr>
8217 <tr class="entry_cont">
8218 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8219 <p>Video snapshot with preview callbacks requires 3
8220processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8221one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8222 </td>
8223 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8224
8225
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8226 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8227 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8228
8229
8230 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8231 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8232 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8233 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8234 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8235 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8236 <span class="entry_type_container">x</span>
8237
8238 <span class="entry_type_array">
8239 1
8240 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8241 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8242
8243
8244 </td> <!-- entry_type -->
8245
8246 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8247 <p>How many reprocessing streams of any type
8248can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8249 </td>
8250
8251 <td class="entry_units">
8252 </td>
8253
8254 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8255 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8256 </td>
8257
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8258 <td class="entry_tags">
8259 </td>
8260
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8261 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8262
8263
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8264 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8265 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8266
8267
8268
8269 <!-- end of kind -->
8270 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8271 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8272
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8273 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8274 <tr>
8275 <th class="th_name">Property Name</th>
8276 <th class="th_type">Type</th>
8277 <th class="th_description">Description</th>
8278 <th class="th_units">Units</th>
8279 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8280 <th class="th_tags">Tags</th>
8281 </tr>
8282 </thead>
8283
8284 <tbody>
8285
8286
8287
8288
8289
8290
8291
8292
8293
8294
8295 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8296 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8297 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8298 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8299 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8300 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8301
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8302 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8303
8304
8305 </td> <!-- entry_type -->
8306
8307 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8308 <p>A frame counter set by the framework.<wbr/> This value monotonically
8309increases with every new result (that is,<wbr/> each new result has a unique
8310frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8311 </td>
8312
8313 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8314 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8315 </td>
8316
8317 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8318 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8319 </td>
8320
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8321 <td class="entry_tags">
8322 </td>
8323
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8324 </tr>
8325 <tr class="entries_header">
8326 <th class="th_details" colspan="5">Details</th>
8327 </tr>
8328 <tr class="entry_cont">
8329 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8330 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8331 </td>
8332 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8333
8334
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8335 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8336 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8337
8338
8339 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8340 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8341 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8342 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8343 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8344 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8345
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8346 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8347
8348
8349 </td> <!-- entry_type -->
8350
8351 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8352 <p>An application-specified ID for the current
8353request.<wbr/> Must be maintained unchanged in output
8354frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8355 </td>
8356
8357 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8358 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8359 </td>
8360
8361 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8362 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8363 </td>
8364
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8365 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8366 <ul class="entry_tags">
8367 <li><a href="#tag_V1">V1</a></li>
8368 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8369 </td>
8370
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8371 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8372
8373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8374 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8375 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8376
8377
8378 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8379 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8380 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8381 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8382 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8383 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8384
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8385 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8386
8387 <ul class="entry_type_enum">
8388 <li>
8389 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8390 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
8391 for application-bound buffer data.<wbr/> If no
8392 application-bound streams exist,<wbr/> no frame should be
8393 placed in the output frame queue.<wbr/> If such streams
8394 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8395 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8396 information.<wbr/> Timestamp information should still be
8397 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8398 </li>
8399 <li>
8400 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8401 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8402 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8403 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8404 </li>
8405 </ul>
8406
8407 </td> <!-- entry_type -->
8408
8409 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8410 <p>How much metadata to produce on
8411output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8412 </td>
8413
8414 <td class="entry_units">
8415 </td>
8416
8417 <td class="entry_range">
8418 </td>
8419
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8420 <td class="entry_tags">
8421 </td>
8422
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8423 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8424
8425
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8426 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8427 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8428
8429
8430 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8431 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8432 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8433 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8434 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8435 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8436 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8437
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8438 <span class="entry_type_array">
8439 n
8440 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8441 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8442
8443
8444 </td> <!-- entry_type -->
8445
8446 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8447 <p>Lists which camera output streams image data
8448from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8449 </td>
8450
8451 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8452 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8453 </td>
8454
8455 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8456 <p>List must only include streams that have been
8457created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8458 </td>
8459
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8460 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8461 <ul class="entry_tags">
8462 <li><a href="#tag_HAL2">HAL2</a></li>
8463 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8464 </td>
8465
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8466 </tr>
8467 <tr class="entries_header">
8468 <th class="th_details" colspan="5">Details</th>
8469 </tr>
8470 <tr class="entry_cont">
8471 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8472 <p>If no output streams are listed,<wbr/> then the image
8473data should simply be discarded.<wbr/> The image data must
8474still be captured for metadata and statistics production,<wbr/>
8475and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8476 </td>
8477 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8478
8479
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8480 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8481 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8482
8483
8484
8485 <!-- end of kind -->
8486 </tbody>
8487
8488 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8489 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8490
8491
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8492 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8493
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8494 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8495 <tr>
8496 <th class="th_name">Property Name</th>
8497 <th class="th_type">Type</th>
8498 <th class="th_description">Description</th>
8499 <th class="th_units">Units</th>
8500 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8501 <th class="th_tags">Tags</th>
8502 </tr>
8503 </thead>
8504
8505 <tbody>
8506
8507
8508
8509
8510
8511
8512
8513
8514
8515
8516 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8517 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8518 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8519 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8520 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8521 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8522 <span class="entry_type_container">x</span>
8523
8524 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8525 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8526 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8527 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8528
8529
8530 </td> <!-- entry_type -->
8531
8532 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8533 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8534<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8535(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8536output.<wbr/> Each stream must use this rectangle to produce its
8537output,<wbr/> cropping to a smaller region if necessary to
8538maintain the stream's aspect ratio.<wbr/></p>
8539<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8540 </td>
8541
8542 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8543 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8544 in pixels; (0,<wbr/>0) is top-left corner of
8545 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8546 </td>
8547
8548 <td class="entry_range">
8549 </td>
8550
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8551 <td class="entry_tags">
8552 <ul class="entry_tags">
8553 <li><a href="#tag_BC">BC</a></li>
8554 </ul>
8555 </td>
8556
8557 </tr>
8558 <tr class="entries_header">
8559 <th class="th_details" colspan="5">Details</th>
8560 </tr>
8561 <tr class="entry_cont">
8562 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8563 <p>Any additional per-stream cropping must be done to
8564maximize the final pixel area of the stream.<wbr/></p>
8565<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8566ratio,<wbr/> then 4:3 streams should use the exact crop
8567region.<wbr/> 16:9 streams should further crop vertically
8568(letterbox).<wbr/></p>
8569<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8570outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8571streams should match exactly.<wbr/> These additional crops must
8572be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8573<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8574times,<wbr/> no matter what the relative aspect ratios of the
8575crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8576corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8577larger than active pixel array.<wbr/> Width and height may be
8578rounded to nearest larger supportable width,<wbr/> especially
8579for raw output,<wbr/> where only a few fixed scales may be
8580possible.<wbr/> The width and height of the crop region cannot
8581be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8582android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8583activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8584respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8585 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8586 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8587
8588
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8589 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8590 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8591
8592
8593
8594 <!-- end of kind -->
8595 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8596 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8597
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8598 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8599 <tr>
8600 <th class="th_name">Property Name</th>
8601 <th class="th_type">Type</th>
8602 <th class="th_description">Description</th>
8603 <th class="th_units">Units</th>
8604 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8605 <th class="th_tags">Tags</th>
8606 </tr>
8607 </thead>
8608
8609 <tbody>
8610
8611
8612
8613
8614
8615
8616
8617
8618
8619
8620 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8621 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8622 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8623 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8624 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8625 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8626 <span class="entry_type_container">x</span>
8627
8628 <span class="entry_type_array">
8629 n
8630 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]8631 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8632 <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]8633
8634 <ul class="entry_type_enum">
8635 <li>
8636 <span class="entry_type_enum_name">RAW_SENSOR</span>
8637 <span class="entry_type_enum_value">0x20</span>
8638 </li>
8639 <li>
8640 <span class="entry_type_enum_name">YV12</span>
8641 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8642 <span class="entry_type_enum_notes">YCrCb 4:2:0 Planar</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8643 </li>
8644 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8645 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8646 <span class="entry_type_enum_value">0x11</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8647 <span class="entry_type_enum_notes">NV21</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8648 </li>
8649 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8650 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
8651 <span class="entry_type_enum_value">0x22</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8652 <span class="entry_type_enum_notes">Hal Implementation Defined</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8653 </li>
8654 <li>
8655 <span class="entry_type_enum_name">YCbCr_420_888</span>
8656 <span class="entry_type_enum_value">0x23</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8657 <span class="entry_type_enum_notes">Flexible YUV420 Format</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8658 </li>
8659 <li>
8660 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8661 <span class="entry_type_enum_value">0x21</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8662 <span class="entry_type_enum_notes">JPEG</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8663 </li>
8664 </ul>
8665
8666 </td> <!-- entry_type -->
8667
8668 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8669 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8670 </td>
8671
8672 <td class="entry_units">
8673 </td>
8674
8675 <td class="entry_range">
8676 </td>
8677
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8678 <td class="entry_tags">
8679 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8680 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8681 </ul>
8682 </td>
8683
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8684 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8685
8686
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8687 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8688 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8689
8690
8691 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8692 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8693 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8694 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8695 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8696 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8697 <span class="entry_type_container">x</span>
8698
8699 <span class="entry_type_array">
8700 n
8701 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8702 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8703
8704
8705 </td> <!-- entry_type -->
8706
8707 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8708 <p>The minimum frame duration that is supported
8709for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8710correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8711stream is active and captured in a burst,<wbr/> with all
8712processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8713 </td>
8714
8715 <td class="entry_units">
8716 </td>
8717
8718 <td class="entry_range">
8719 </td>
8720
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8721 <td class="entry_tags">
8722 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8723 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8724 </ul>
8725 </td>
8726
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8727 </tr>
8728 <tr class="entries_header">
8729 <th class="th_details" colspan="5">Details</th>
8730 </tr>
8731 <tr class="entry_cont">
8732 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8733 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8734frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8735durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8736 </td>
8737 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8738
8739
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8740 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8741 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8742
8743
8744 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8745 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8746 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8747 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8748 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8749 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8750 <span class="entry_type_container">x</span>
8751
8752 <span class="entry_type_array">
8753 n x 2
8754 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8755 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8756
8757
8758 </td> <!-- entry_type -->
8759
8760 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8761 <p>The resolutions available for output from
8762the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8763 </td>
8764
8765 <td class="entry_units">
8766 </td>
8767
8768 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8769 <p>Must include: - sensor maximum resolution Should
8770include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8771 </td>
8772
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8773 <td class="entry_tags">
8774 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8775 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8776 </ul>
8777 </td>
8778
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8779 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8780
8781
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8782 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8783 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8784
8785
8786 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8787 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8788 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8789 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8790 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8791 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8792
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8793 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8794
8795
8796 </td> <!-- entry_type -->
8797
8798 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8799 <p>The maximum ratio between active area width
8800and crop region width,<wbr/> or between active area height and
8801crop region height,<wbr/> if the crop region height is larger
8802than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8803 </td>
8804
8805 <td class="entry_units">
8806 </td>
8807
8808 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8809 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8810 </td>
8811
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8812 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8813 <ul class="entry_tags">
8814 <li><a href="#tag_BC">BC</a></li>
8815 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8816 </td>
8817
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8818 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8819
8820
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8821 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8822 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8823
8824
8825 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8826 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8827 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8828 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8829 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8830 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8831 <span class="entry_type_container">x</span>
8832
8833 <span class="entry_type_array">
8834 n
8835 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8836 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8837
8838
8839 </td> <!-- entry_type -->
8840
8841 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8842 <p>The minimum frame duration that is supported
8843for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8844correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8845stream is active,<wbr/> with all processing set to
8846FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8847 </td>
8848
8849 <td class="entry_units">
8850 </td>
8851
8852 <td class="entry_range">
8853 </td>
8854
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8855 <td class="entry_tags">
8856 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8857 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8858 </ul>
8859 </td>
8860
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8861 </tr>
8862 <tr class="entries_header">
8863 <th class="th_details" colspan="5">Details</th>
8864 </tr>
8865 <tr class="entry_cont">
8866 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8867 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8868frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8869durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8870 </td>
8871 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8872
8873
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8874 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8875 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8876
8877
8878 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8879 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8880 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8881 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8882 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8883 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8884 <span class="entry_type_container">x</span>
8885
8886 <span class="entry_type_array">
8887 n x 2
8888 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8889 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8890
8891
8892 </td> <!-- entry_type -->
8893
8894 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8895 <p>The resolutions available for use with
8896processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
8897platform opaque YUV/<wbr/>RGB streams to the GPU or video
8898encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8899 </td>
8900
8901 <td class="entry_units">
8902 </td>
8903
8904 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8905 <p>Must include: - sensor maximum resolution -
8906standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
8907resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8908 </td>
8909
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8910 <td class="entry_tags">
8911 <ul class="entry_tags">
8912 <li><a href="#tag_BC">BC</a></li>
8913 </ul>
8914 </td>
8915
8916 </tr>
8917 <tr class="entries_header">
8918 <th class="th_details" colspan="5">Details</th>
8919 </tr>
8920 <tr class="entry_cont">
8921 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8922 <p>The actual supported resolution list may be limited by
8923consumer end points for different use cases.<wbr/> For example,<wbr/> for
8924recording use case,<wbr/> the largest supported resolution may be
8925limited by max supported size from encoder,<wbr/> for preview use
8926case,<wbr/> the largest supported resolution may be limited by max
8927resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8928 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8929 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8930
8931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8932 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8933 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8934
8935
8936 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8937 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8938 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8939 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8940 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8941 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8942 <span class="entry_type_container">x</span>
8943
8944 <span class="entry_type_array">
8945 n
8946 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8947 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8948
8949
8950 </td> <!-- entry_type -->
8951
8952 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8953 <p>The minimum frame duration that is supported
8954for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8955correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8956is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8957 </td>
8958
8959 <td class="entry_units">
8960 </td>
8961
8962 <td class="entry_range">
8963 </td>
8964
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8965 <td class="entry_tags">
8966 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8967 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8968 </ul>
8969 </td>
8970
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8971 </tr>
8972 <tr class="entries_header">
8973 <th class="th_details" colspan="5">Details</th>
8974 </tr>
8975 <tr class="entry_cont">
8976 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8977 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8978frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8979durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8980 </td>
8981 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8982
8983
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8984 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8985 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8986
8987
8988 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8989 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8990 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8991 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8992 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8993 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8994 <span class="entry_type_container">x</span>
8995
8996 <span class="entry_type_array">
8997 n x 2
8998 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8999 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9000
9001
9002 </td> <!-- entry_type -->
9003
9004 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9005 <p>The resolutions available for use with raw
9006sensor output streams,<wbr/> listed as width,<wbr/>
9007height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9008 </td>
9009
9010 <td class="entry_units">
9011 </td>
9012
9013 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9014 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9015 </td>
9016
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9017 <td class="entry_tags">
9018 </td>
9019
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9020 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9021
9022
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9023 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9024 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9025
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9026
9027
9028 <!-- end of kind -->
9029 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9030 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9031
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9032 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9033 <tr>
9034 <th class="th_name">Property Name</th>
9035 <th class="th_type">Type</th>
9036 <th class="th_description">Description</th>
9037 <th class="th_units">Units</th>
9038 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9039 <th class="th_tags">Tags</th>
9040 </tr>
9041 </thead>
9042
9043 <tbody>
9044
9045
9046
9047
9048
9049
9050
9051
9052
9053
9054 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9055 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9056 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9057 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9058 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9059 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9060 <span class="entry_type_container">x</span>
9061
9062 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9063 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9064 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9065 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9066
9067
9068 </td> <!-- entry_type -->
9069
9070 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9071 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9072<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9073(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9074output.<wbr/> Each stream must use this rectangle to produce its
9075output,<wbr/> cropping to a smaller region if necessary to
9076maintain the stream's aspect ratio.<wbr/></p>
9077<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9078 </td>
9079
9080 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9081 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9082 in pixels; (0,<wbr/>0) is top-left corner of
9083 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9084 </td>
9085
9086 <td class="entry_range">
9087 </td>
9088
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9089 <td class="entry_tags">
9090 <ul class="entry_tags">
9091 <li><a href="#tag_BC">BC</a></li>
9092 </ul>
9093 </td>
9094
9095 </tr>
9096 <tr class="entries_header">
9097 <th class="th_details" colspan="5">Details</th>
9098 </tr>
9099 <tr class="entry_cont">
9100 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9101 <p>Any additional per-stream cropping must be done to
9102maximize the final pixel area of the stream.<wbr/></p>
9103<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9104ratio,<wbr/> then 4:3 streams should use the exact crop
9105region.<wbr/> 16:9 streams should further crop vertically
9106(letterbox).<wbr/></p>
9107<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9108outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9109streams should match exactly.<wbr/> These additional crops must
9110be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9111<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9112times,<wbr/> no matter what the relative aspect ratios of the
9113crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9114corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9115larger than active pixel array.<wbr/> Width and height may be
9116rounded to nearest larger supportable width,<wbr/> especially
9117for raw output,<wbr/> where only a few fixed scales may be
9118possible.<wbr/> The width and height of the crop region cannot
9119be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9120android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9121activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9122respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9123 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9124 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9125
9126
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9127 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9128 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9129
9130
9131
9132 <!-- end of kind -->
9133 </tbody>
9134
9135 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9136 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9137
9138
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9139 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9140
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9141 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9142 <tr>
9143 <th class="th_name">Property Name</th>
9144 <th class="th_type">Type</th>
9145 <th class="th_description">Description</th>
9146 <th class="th_units">Units</th>
9147 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9148 <th class="th_tags">Tags</th>
9149 </tr>
9150 </thead>
9151
9152 <tbody>
9153
9154
9155
9156
9157
9158
9159
9160
9161
9162
9163 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9164 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9165 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9166 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9167 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9168 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9169
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9170 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9171
9172
9173 </td> <!-- entry_type -->
9174
9175 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9176 <p>Duration each pixel is exposed to
9177light.<wbr/></p>
9178<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
9179duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9180 </td>
9181
9182 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9183 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9184 </td>
9185
9186 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9187 <p><a href="#static_android.sensor.info.exposureTimeRange">android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9188 </td>
9189
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9190 <td class="entry_tags">
9191 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9192 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9193 </ul>
9194 </td>
9195
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9196 </tr>
9197 <tr class="entries_header">
9198 <th class="th_details" colspan="5">Details</th>
9199 </tr>
9200 <tr class="entry_cont">
9201 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9202 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9203 </td>
9204 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9205
9206
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9207 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9208 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9209
9210
9211 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9212 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9213 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9214 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9215 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9216 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9217
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9218 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9219
9220
9221 </td> <!-- entry_type -->
9222
9223 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9224 <p>Duration from start of frame exposure to
9225start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9226 </td>
9227
9228 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9229 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9230 </td>
9231
9232 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9233 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9234android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9235 </td>
9236
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9237 <td class="entry_tags">
9238 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9239 <li><a href="#tag_V1">V1</a></li>
9240 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9241 </ul>
9242 </td>
9243
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9244 </tr>
9245 <tr class="entries_header">
9246 <th class="th_details" colspan="5">Details</th>
9247 </tr>
9248 <tr class="entry_cont">
9249 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9250 <p>Exposure time has priority,<wbr/> so duration is set to
9251max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9252 </td>
9253 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9254
9255
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9256 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9257 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9258
9259
9260 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9261 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9262 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9263 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9264 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9265 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9266
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9267 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9268
9269
9270 </td> <!-- entry_type -->
9271
9272 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9273 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9274implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9275below 'maximum analog sensitivity'.<wbr/></p>
9276<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9277gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9278 </td>
9279
9280 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9281 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9282 </td>
9283
9284 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9285 <p><a href="#static_android.sensor.info.sensitivityRange">android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9286 </td>
9287
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9288 <td class="entry_tags">
9289 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9290 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9291 </ul>
9292 </td>
9293
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9294 </tr>
9295 <tr class="entries_header">
9296 <th class="th_details" colspan="5">Details</th>
9297 </tr>
9298 <tr class="entry_cont">
9299 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9300 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9301 </td>
9302 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9303
9304
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9305 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9306 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9307
9308
9309
9310 <!-- end of kind -->
9311 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9312 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9313
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9314 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9315 <tr>
9316 <th class="th_name">Property Name</th>
9317 <th class="th_type">Type</th>
9318 <th class="th_description">Description</th>
9319 <th class="th_units">Units</th>
9320 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9321 <th class="th_tags">Tags</th>
9322 </tr>
9323 </thead>
9324
9325 <tbody>
9326
9327
9328
9329
9330
9331
9332
9333
9334
9335
9336
9337
9338 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9339 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9340 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9341 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9342 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9343 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9344 <span class="entry_type_container">x</span>
9345
9346 <span class="entry_type_array">
9347 4
9348 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9349 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9350 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9351
9352
9353 </td> <!-- entry_type -->
9354
9355 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9356 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9357active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9358pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9359 </td>
9360
9361 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9362 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9363 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9364 </td>
9365
9366 <td class="entry_range">
9367 </td>
9368
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9369 <td class="entry_tags">
9370 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9371 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9372 </ul>
9373 </td>
9374
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9375 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9376
9377
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9378 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9379 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9380
9381
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9382 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9383 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9384 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9385 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9386 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9387 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9388 <span class="entry_type_container">x</span>
9389
9390 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9391 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9392 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9393 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9394 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9395
9396
9397 </td> <!-- entry_type -->
9398
9399 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9400 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9401 </td>
9402
9403 <td class="entry_units">
9404 </td>
9405
9406 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9407 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9408 </td>
9409
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9410 <td class="entry_tags">
9411 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9412 <li><a href="#tag_BC">BC</a></li>
9413 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9414 </ul>
9415 </td>
9416
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9417 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9418
9419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9420 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9421 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9422
9423
9424 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9425 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9426 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9427 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9428 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9429 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9430
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9431 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9432
9433 <ul class="entry_type_enum">
9434 <li>
9435 <span class="entry_type_enum_name">RGGB</span>
9436 </li>
9437 <li>
9438 <span class="entry_type_enum_name">GRBG</span>
9439 </li>
9440 <li>
9441 <span class="entry_type_enum_name">GBRG</span>
9442 </li>
9443 <li>
9444 <span class="entry_type_enum_name">BGGR</span>
9445 </li>
9446 <li>
9447 <span class="entry_type_enum_name">RGB</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9448 <span class="entry_type_enum_notes">Sensor is not Bayer; output has 3 16-bit
9449 values for each pixel,<wbr/> instead of just 1 16-bit value
9450 per pixel.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9451 </li>
9452 </ul>
9453
9454 </td> <!-- entry_type -->
9455
9456 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9457 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9458represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9459the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9460 </td>
9461
9462 <td class="entry_units">
9463 </td>
9464
9465 <td class="entry_range">
9466 </td>
9467
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9468 <td class="entry_tags">
9469 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9470 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9471 </ul>
9472 </td>
9473
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9474 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9475
9476
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9477 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9478 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9479
9480
9481 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9482 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9483 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9484 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9485 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9486 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9487 <span class="entry_type_container">x</span>
9488
9489 <span class="entry_type_array">
9490 2
9491 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9492 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9493 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9494
9495
9496 </td> <!-- entry_type -->
9497
9498 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9499 <p>Range of valid exposure
9500times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9501 </td>
9502
9503 <td class="entry_units">
9504 </td>
9505
9506 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9507 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
9508sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9509 </td>
9510
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9511 <td class="entry_tags">
9512 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9513 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9514 </ul>
9515 </td>
9516
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9517 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9518
9519
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9520 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9521 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9522
9523
9524 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9525 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9526 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9527 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9528 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9529 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9530
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9531 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9532
9533
9534 </td> <!-- entry_type -->
9535
9536 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9537 <p>Maximum possible frame duration (minimum frame
9538rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9539 </td>
9540
9541 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9542 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9543 </td>
9544
9545 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9546 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]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_BC">BC</a></li>
9552 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9553 </ul>
9554 </td>
9555
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9556 </tr>
9557 <tr class="entries_header">
9558 <th class="th_details" colspan="5">Details</th>
9559 </tr>
9560 <tr class="entry_cont">
9561 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9562 <p>Minimum duration is a function of resolution,<wbr/>
9563processing settings.<wbr/> See
9564android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
9565android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9566<a href="#static_android.scaler.availableRawMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations</a></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9567 </td>
9568 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9569
9570
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9571 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9572 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9573
9574
9575 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9576 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9577 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9578 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9579 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9580 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9581 <span class="entry_type_container">x</span>
9582
9583 <span class="entry_type_array">
9584 2
9585 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]9586 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9587 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9588
9589
9590 </td> <!-- entry_type -->
9591
9592 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9593 <p>The physical dimensions of the full pixel
9594array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9595 </td>
9596
9597 <td class="entry_units">
9598 </td>
9599
9600 <td class="entry_range">
9601 </td>
9602
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9603 <td class="entry_tags">
9604 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9605 <li><a href="#tag_V1">V1</a></li>
9606 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9607 </ul>
9608 </td>
9609
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9610 </tr>
9611 <tr class="entries_header">
9612 <th class="th_details" colspan="5">Details</th>
9613 </tr>
9614 <tr class="entry_cont">
9615 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9616 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9617 </td>
9618 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9619
9620
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9621 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9622 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9623
9624
9625 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9626 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9627 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9628 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9629 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9630 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9631 <span class="entry_type_container">x</span>
9632
9633 <span class="entry_type_array">
9634 2
9635 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9636 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9637
9638
9639 </td> <!-- entry_type -->
9640
9641 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9642 <p>Dimensions of full pixel array,<wbr/> possibly
9643including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9644 </td>
9645
9646 <td class="entry_units">
9647 </td>
9648
9649 <td class="entry_range">
9650 </td>
9651
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9652 <td class="entry_tags">
9653 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9654 <li><a href="#tag_DNG">DNG</a></li>
9655 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9656 </ul>
9657 </td>
9658
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9659 </tr>
9660 <tr class="entries_header">
9661 <th class="th_details" colspan="5">Details</th>
9662 </tr>
9663 <tr class="entry_cont">
9664 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9665 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9666match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9667android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9668 </td>
9669 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9670
9671
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9672 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9673 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9674
9675
9676 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9677 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9678 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9679 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9680 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9681 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9682
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9683 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9684
9685
9686 </td> <!-- entry_type -->
9687
9688 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9689 <p>Maximum raw value output by
9690sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9691 </td>
9692
9693 <td class="entry_units">
9694 </td>
9695
9696 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9697 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9698 </td>
9699
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9700 <td class="entry_tags">
9701 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9702 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9703 </ul>
9704 </td>
9705
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9706 </tr>
9707 <tr class="entries_header">
9708 <th class="th_details" colspan="5">Details</th>
9709 </tr>
9710 <tr class="entry_cont">
9711 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9712 <p>Defines sensor bit depth (10-14 bits is
9713expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9714 </td>
9715 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9716
9717
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9718 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9719 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9720
9721
9722
9723
9724
9725 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9726 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9727 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9728 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9729 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9730 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9731
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9732 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9733
9734
9735 </td> <!-- entry_type -->
9736
9737 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9738 <p>Gain factor from electrons to raw units when
9739ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9740 </td>
9741
9742 <td class="entry_units">
9743 </td>
9744
9745 <td class="entry_range">
9746 </td>
9747
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9748 <td class="entry_tags">
9749 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9750 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9751 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9752 </ul>
9753 </td>
9754
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9755 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9756
9757
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9758 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9759 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9760
9761
9762 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9763 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9764 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9765 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9766 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9767 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9768 <span class="entry_type_container">x</span>
9769
9770 <span class="entry_type_array">
9771 4
9772 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9773 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9774 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9775
9776
9777 </td> <!-- entry_type -->
9778
9779 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9780 <p>A fixed black level offset for each of the
9781Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9782 </td>
9783
9784 <td class="entry_units">
9785 </td>
9786
9787 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9788 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9789 </td>
9790
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9791 <td class="entry_tags">
9792 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9793 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9794 </ul>
9795 </td>
9796
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9797 </tr>
9798 <tr class="entries_header">
9799 <th class="th_details" colspan="5">Details</th>
9800 </tr>
9801 <tr class="entry_cont">
9802 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9803 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
9804tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9805 </td>
9806 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9807
9808
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9809 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9810 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9811
9812
9813 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9814 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9815 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9816 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9817 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9818 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9819 <span class="entry_type_container">x</span>
9820
9821 <span class="entry_type_array">
9822 9
9823 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9824 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9825 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9826
9827
9828 </td> <!-- entry_type -->
9829
9830 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9831 <p>Per-device calibration on top of color space
9832transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9833 </td>
9834
9835 <td class="entry_units">
9836 </td>
9837
9838 <td class="entry_range">
9839 </td>
9840
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9841 <td class="entry_tags">
9842 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9843 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9844 </ul>
9845 </td>
9846
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9847 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9848
9849
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9850 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9851 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9852
9853
9854 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9855 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9856 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9857 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9858 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9859 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9860 <span class="entry_type_container">x</span>
9861
9862 <span class="entry_type_array">
9863 9
9864 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9865 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9866 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9867
9868
9869 </td> <!-- entry_type -->
9870
9871 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9872 <p>Per-device calibration on top of color space
9873transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9874 </td>
9875
9876 <td class="entry_units">
9877 </td>
9878
9879 <td class="entry_range">
9880 </td>
9881
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9882 <td class="entry_tags">
9883 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9884 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9885 </ul>
9886 </td>
9887
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9888 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9889
9890
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9891 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9892 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9893
9894
9895 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9896 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9897 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9898 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9899 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9900 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9901 <span class="entry_type_container">x</span>
9902
9903 <span class="entry_type_array">
9904 9
9905 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9906 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9907 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9908
9909
9910 </td> <!-- entry_type -->
9911
9912 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9913 <p>Linear mapping from XYZ (D50) color space to
9914reference linear sensor color,<wbr/> for first reference
9915illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9916 </td>
9917
9918 <td class="entry_units">
9919 </td>
9920
9921 <td class="entry_range">
9922 </td>
9923
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9924 <td class="entry_tags">
9925 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9926 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9927 </ul>
9928 </td>
9929
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9930 </tr>
9931 <tr class="entries_header">
9932 <th class="th_details" colspan="5">Details</th>
9933 </tr>
9934 <tr class="entry_cont">
9935 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9936 <p>Use as follows XYZ = inv(transform) * clip( (raw -
9937black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
9938At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9939 </td>
9940 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9941
9942
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9943 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9944 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9945
9946
9947 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9948 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9949 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9950 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9951 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9952 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9953 <span class="entry_type_container">x</span>
9954
9955 <span class="entry_type_array">
9956 9
9957 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9958 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9959 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9960
9961
9962 </td> <!-- entry_type -->
9963
9964 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9965 <p>Linear mapping from XYZ (D50) color space to
9966reference linear sensor color,<wbr/> for second reference
9967illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9968 </td>
9969
9970 <td class="entry_units">
9971 </td>
9972
9973 <td class="entry_range">
9974 </td>
9975
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9976 <td class="entry_tags">
9977 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9978 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9979 </ul>
9980 </td>
9981
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9982 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9983
9984
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9985 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9986 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9987
9988
9989 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9990 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9991 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9992 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9993 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9994 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9995 <span class="entry_type_container">x</span>
9996
9997 <span class="entry_type_array">
9998 9
9999 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10000 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10001 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10002
10003
10004 </td> <!-- entry_type -->
10005
10006 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10007 <p>Used by DNG for better WB
10008adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10009 </td>
10010
10011 <td class="entry_units">
10012 </td>
10013
10014 <td class="entry_range">
10015 </td>
10016
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10017 <td class="entry_tags">
10018 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10019 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10020 </ul>
10021 </td>
10022
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10023 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10024
10025
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10026 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10027 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10028
10029
10030 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10031 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10032 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10033 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10034 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10035 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10036 <span class="entry_type_container">x</span>
10037
10038 <span class="entry_type_array">
10039 9
10040 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10041 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10042 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10043
10044
10045 </td> <!-- entry_type -->
10046
10047 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10048 <p>Used by DNG for better WB
10049adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10050 </td>
10051
10052 <td class="entry_units">
10053 </td>
10054
10055 <td class="entry_range">
10056 </td>
10057
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10058 <td class="entry_tags">
10059 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10060 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10061 </ul>
10062 </td>
10063
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10064 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10065
10066
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10067 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10068 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10069
10070
10071 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10072 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10073 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10074 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10075 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10076 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10077
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10078 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10079
10080
10081 </td> <!-- entry_type -->
10082
10083 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10084 <p>Maximum sensitivity that is implemented
10085purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10086 </td>
10087
10088 <td class="entry_units">
10089 </td>
10090
10091 <td class="entry_range">
10092 </td>
10093
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10094 <td class="entry_tags">
10095 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10096 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10097 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10098 </ul>
10099 </td>
10100
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10101 </tr>
10102 <tr class="entries_header">
10103 <th class="th_details" colspan="5">Details</th>
10104 </tr>
10105 <tr class="entry_cont">
10106 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10107 <p>For <a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> values less than or
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10108equal to this,<wbr/> all applied gain must be analog.<wbr/> For
10109values above this,<wbr/> it can be a mix of analog and
10110digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10111 </td>
10112 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10113
10114
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10115 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10116 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10117
10118
10119 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10120 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10121 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10122 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10123 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10124 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10125 <span class="entry_type_container">x</span>
10126
10127 <span class="entry_type_array">
10128 2
10129 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10130 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10131 <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]10132
10133
10134 </td> <!-- entry_type -->
10135
10136 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10137 <p>Estimation of sensor noise
10138characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10139 </td>
10140
10141 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10142 var(raw pixel value) = electrons * (baseGainFactor
10143 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
10144 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10145 </td>
10146
10147 <td class="entry_range">
10148 </td>
10149
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10150 <td class="entry_tags">
10151 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10152 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10153 </ul>
10154 </td>
10155
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10156 </tr>
10157 <tr class="entries_header">
10158 <th class="th_details" colspan="5">Details</th>
10159 </tr>
10160 <tr class="entry_cont">
10161 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10162 <p>A represents sensor read noise before analog
10163amplification; B represents noise from A/<wbr/>D conversion and
10164other circuits after amplification.<wbr/> Both noise sources
10165are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
10166across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10167 </td>
10168 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10169
10170
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10171 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10172 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10173
10174
10175 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10176 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10177 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10178 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10179 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10180 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10181
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10182 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10183
10184
10185 </td> <!-- entry_type -->
10186
10187 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10188 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10189image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10190screen in its native orientation.<wbr/> Also defines the
10191direction of rolling shutter readout,<wbr/> which is from top
10192to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10193 </td>
10194
10195 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10196 degrees clockwise rotation,<wbr/> only multiples of
10197 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10198 </td>
10199
10200 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10201 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10202 </td>
10203
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10204 <td class="entry_tags">
10205 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10206 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10207 </ul>
10208 </td>
10209
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10210 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10211
10212
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10213 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10214 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10215
10216
10217 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10218 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10219 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10220 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10221 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10222 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10223
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10224 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10225
10226 <ul class="entry_type_enum">
10227 <li>
10228 <span class="entry_type_enum_name">DAYLIGHT</span>
10229 <span class="entry_type_enum_value">1</span>
10230 </li>
10231 <li>
10232 <span class="entry_type_enum_name">FLUORESCENT</span>
10233 <span class="entry_type_enum_value">2</span>
10234 </li>
10235 <li>
10236 <span class="entry_type_enum_name">TUNGSTEN</span>
10237 <span class="entry_type_enum_value">3</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10238 <span class="entry_type_enum_notes">Incandescent light</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10239 </li>
10240 <li>
10241 <span class="entry_type_enum_name">FLASH</span>
10242 <span class="entry_type_enum_value">4</span>
10243 </li>
10244 <li>
10245 <span class="entry_type_enum_name">FINE_WEATHER</span>
10246 <span class="entry_type_enum_value">9</span>
10247 </li>
10248 <li>
10249 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10250 <span class="entry_type_enum_value">10</span>
10251 </li>
10252 <li>
10253 <span class="entry_type_enum_name">SHADE</span>
10254 <span class="entry_type_enum_value">11</span>
10255 </li>
10256 <li>
10257 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10258 <span class="entry_type_enum_value">12</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10259 <span class="entry_type_enum_notes">D 5700 - 7100K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10260 </li>
10261 <li>
10262 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10263 <span class="entry_type_enum_value">13</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10264 <span class="entry_type_enum_notes">N 4600 - 5400K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10265 </li>
10266 <li>
10267 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10268 <span class="entry_type_enum_value">14</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10269 <span class="entry_type_enum_notes">W 3900 - 4500K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10270 </li>
10271 <li>
10272 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10273 <span class="entry_type_enum_value">15</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10274 <span class="entry_type_enum_notes">WW 3200 - 3700K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10275 </li>
10276 <li>
10277 <span class="entry_type_enum_name">STANDARD_A</span>
10278 <span class="entry_type_enum_value">17</span>
10279 </li>
10280 <li>
10281 <span class="entry_type_enum_name">STANDARD_B</span>
10282 <span class="entry_type_enum_value">18</span>
10283 </li>
10284 <li>
10285 <span class="entry_type_enum_name">STANDARD_C</span>
10286 <span class="entry_type_enum_value">19</span>
10287 </li>
10288 <li>
10289 <span class="entry_type_enum_name">D55</span>
10290 <span class="entry_type_enum_value">20</span>
10291 </li>
10292 <li>
10293 <span class="entry_type_enum_name">D65</span>
10294 <span class="entry_type_enum_value">21</span>
10295 </li>
10296 <li>
10297 <span class="entry_type_enum_name">D75</span>
10298 <span class="entry_type_enum_value">22</span>
10299 </li>
10300 <li>
10301 <span class="entry_type_enum_name">D50</span>
10302 <span class="entry_type_enum_value">23</span>
10303 </li>
10304 <li>
10305 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10306 <span class="entry_type_enum_value">24</span>
10307 </li>
10308 </ul>
10309
10310 </td> <!-- entry_type -->
10311
10312 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10313 <p>Light source used to define transform
103141</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10315 </td>
10316
10317 <td class="entry_units">
10318 </td>
10319
10320 <td class="entry_range">
10321 </td>
10322
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10323 <td class="entry_tags">
10324 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10325 <li><a href="#tag_DNG">DNG</a></li>
10326 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10327 </ul>
10328 </td>
10329
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10330 </tr>
10331 <tr class="entries_header">
10332 <th class="th_details" colspan="5">Details</th>
10333 </tr>
10334 <tr class="entry_cont">
10335 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10336 <p>[EXIF LightSource tag] Must all these be
10337supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10338 </td>
10339 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10340
10341
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10342 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10343 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10344
10345
10346 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10347 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10348 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10349 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10350 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10351 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10352
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10353 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10354
10355
10356 </td> <!-- entry_type -->
10357
10358 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10359 <p>Light source used to define transform
103602</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10361 </td>
10362
10363 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10364 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10365 </td>
10366
10367 <td class="entry_range">
10368 </td>
10369
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10370 <td class="entry_tags">
10371 </td>
10372
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10373 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10374
10375
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10376 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10377 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10378
10379
10380
10381 <!-- end of kind -->
10382 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10383 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10384
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10385 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10386 <tr>
10387 <th class="th_name">Property Name</th>
10388 <th class="th_type">Type</th>
10389 <th class="th_description">Description</th>
10390 <th class="th_units">Units</th>
10391 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10392 <th class="th_tags">Tags</th>
10393 </tr>
10394 </thead>
10395
10396 <tbody>
10397
10398
10399
10400
10401
10402
10403
10404
10405
10406
10407 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10408 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10409 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10410 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10411 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10412 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10413
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10414 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10415
10416
10417 </td> <!-- entry_type -->
10418
10419 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10420 <p>Duration each pixel is exposed to
10421light.<wbr/></p>
10422<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
10423duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10424 </td>
10425
10426 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10427 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10428 </td>
10429
10430 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10431 <p><a href="#static_android.sensor.info.exposureTimeRange">android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10432 </td>
10433
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10434 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10435 <ul class="entry_tags">
10436 <li><a href="#tag_V1">V1</a></li>
10437 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10438 </td>
10439
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10440 </tr>
10441 <tr class="entries_header">
10442 <th class="th_details" colspan="5">Details</th>
10443 </tr>
10444 <tr class="entry_cont">
10445 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10446 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10447 </td>
10448 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10449
10450
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10451 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10452 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10453
10454
10455 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10456 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10457 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10458 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10459 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10460 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10461
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10462 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10463
10464
10465 </td> <!-- entry_type -->
10466
10467 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10468 <p>Duration from start of frame exposure to
10469start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10470 </td>
10471
10472 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10473 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10474 </td>
10475
10476 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10477 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
10478android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10479 </td>
10480
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10481 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10482 <ul class="entry_tags">
10483 <li><a href="#tag_V1">V1</a></li>
10484 <li><a href="#tag_BC">BC</a></li>
10485 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10486 </td>
10487
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10488 </tr>
10489 <tr class="entries_header">
10490 <th class="th_details" colspan="5">Details</th>
10491 </tr>
10492 <tr class="entry_cont">
10493 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10494 <p>Exposure time has priority,<wbr/> so duration is set to
10495max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10496 </td>
10497 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10498
10499
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10500 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10501 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10502
10503
10504 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10505 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10506 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10507 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10508 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10509 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10510
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10511 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10512
10513
10514 </td> <!-- entry_type -->
10515
10516 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10517 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10518implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10519below 'maximum analog sensitivity'.<wbr/></p>
10520<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10521gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10522 </td>
10523
10524 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10525 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10526 </td>
10527
10528 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10529 <p><a href="#static_android.sensor.info.sensitivityRange">android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10530 </td>
10531
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10532 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10533 <ul class="entry_tags">
10534 <li><a href="#tag_V1">V1</a></li>
10535 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10536 </td>
10537
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10538 </tr>
10539 <tr class="entries_header">
10540 <th class="th_details" colspan="5">Details</th>
10541 </tr>
10542 <tr class="entry_cont">
10543 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10544 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10545 </td>
10546 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10547
10548
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10549 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10550 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10551
10552
10553 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10554 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10555 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10556 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10557 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10558 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10559
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10560 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10561
10562
10563 </td> <!-- entry_type -->
10564
10565 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10566 <p>Time at start of exposure of first
10567row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10568 </td>
10569
10570 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10571 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10572 </td>
10573
10574 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10575 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10576 </td>
10577
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10578 <td class="entry_tags">
10579 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10580 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10581 </ul>
10582 </td>
10583
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10584 </tr>
10585 <tr class="entries_header">
10586 <th class="th_details" colspan="5">Details</th>
10587 </tr>
10588 <tr class="entry_cont">
10589 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10590 <p>Monotonic,<wbr/> should be synced to other timestamps in
10591system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10592 </td>
10593 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10594
10595
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10596 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10597 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10598
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10599
10600 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10601 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10602 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10603 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10604 <td class="entry_type">
10605 <span class="entry_type_name">float</span>
10606
10607 <span class="entry_type_visibility"> [public]</span>
10608
10609
10610 </td> <!-- entry_type -->
10611
10612 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10613 <p>The temperature of the sensor,<wbr/> sampled at the time
10614exposure began for this frame.<wbr/></p>
10615<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
10616somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10617 </td>
10618
10619 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10620 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10621 </td>
10622
10623 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10624 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10625 </td>
10626
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10627 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10628 <ul class="entry_tags">
10629 <li><a href="#tag_FULL">FULL</a></li>
10630 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10631 </td>
10632
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10633 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10634
10635
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10636 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10637 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10638
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10639
10640
10641 <!-- end of kind -->
10642 </tbody>
10643
10644 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10645 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10646
10647
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10648 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10649
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10650 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10651 <tr>
10652 <th class="th_name">Property Name</th>
10653 <th class="th_type">Type</th>
10654 <th class="th_description">Description</th>
10655 <th class="th_units">Units</th>
10656 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10657 <th class="th_tags">Tags</th>
10658 </tr>
10659 </thead>
10660
10661 <tbody>
10662
10663
10664
10665
10666
10667
10668
10669
10670
10671
10672 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10673 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10674 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10675 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10676 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10677 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10678
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10679 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10680
10681 <ul class="entry_type_enum">
10682 <li>
10683 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10684 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10685 </li>
10686 <li>
10687 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10688 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10689 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10690 </li>
10691 <li>
10692 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10693 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10694 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10695 </li>
10696 </ul>
10697
10698 </td> <!-- entry_type -->
10699
10700 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10701 <p>Quality of lens shading correction applied
10702to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10703 </td>
10704
10705 <td class="entry_units">
10706 </td>
10707
10708 <td class="entry_range">
10709 </td>
10710
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10711 <td class="entry_tags">
10712 </td>
10713
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10714 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10715
10716
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10717 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10718 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10719
10720
10721 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10722 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10723 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10724 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10725 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10726 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10727
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10728 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10729
10730
10731 </td> <!-- entry_type -->
10732
10733 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10734 <p>Control the amount of shading correction
10735applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10736 </td>
10737
10738 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10739 unitless: 1-10; 10 is full shading
10740 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10741 </td>
10742
10743 <td class="entry_range">
10744 </td>
10745
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10746 <td class="entry_tags">
10747 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10748 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10749 </ul>
10750 </td>
10751
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10752 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10753
10754
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10755 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10756 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10757
10758
10759
10760 <!-- end of kind -->
10761 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10762 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10763
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10764 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10765 <tr>
10766 <th class="th_name">Property Name</th>
10767 <th class="th_type">Type</th>
10768 <th class="th_description">Description</th>
10769 <th class="th_units">Units</th>
10770 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10771 <th class="th_tags">Tags</th>
10772 </tr>
10773 </thead>
10774
10775 <tbody>
10776
10777
10778
10779
10780
10781
10782
10783
10784
10785
10786 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10787 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10788 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10789 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10790 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10791 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10792
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10793 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10794
10795 <ul class="entry_type_enum">
10796 <li>
10797 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10798 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10799 </li>
10800 <li>
10801 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10802 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10803 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10804 </li>
10805 <li>
10806 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10807 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10808 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10809 </li>
10810 </ul>
10811
10812 </td> <!-- entry_type -->
10813
10814 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10815 <p>Quality of lens shading correction applied
10816to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10817 </td>
10818
10819 <td class="entry_units">
10820 </td>
10821
10822 <td class="entry_range">
10823 </td>
10824
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10825 <td class="entry_tags">
10826 </td>
10827
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10828 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10829
10830
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10831 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10832 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10833
10834
10835
10836 <!-- end of kind -->
10837 </tbody>
10838
10839 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10840 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10841
10842
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10843 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10844
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10845 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10846 <tr>
10847 <th class="th_name">Property Name</th>
10848 <th class="th_type">Type</th>
10849 <th class="th_description">Description</th>
10850 <th class="th_units">Units</th>
10851 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10852 <th class="th_tags">Tags</th>
10853 </tr>
10854 </thead>
10855
10856 <tbody>
10857
10858
10859
10860
10861
10862
10863
10864
10865
10866
10867 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10868 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10869 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10870 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10871 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10872 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10873
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10874 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10875
10876 <ul class="entry_type_enum">
10877 <li>
10878 <span class="entry_type_enum_name">OFF</span>
10879 </li>
10880 <li>
10881 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10882 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
10883 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10884 </li>
10885 <li>
10886 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10887 <span class="entry_type_enum_notes">Optional Return all face
10888 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10889 </li>
10890 </ul>
10891
10892 </td> <!-- entry_type -->
10893
10894 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10895 <p>State of the face detector
10896unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10897 </td>
10898
10899 <td class="entry_units">
10900 </td>
10901
10902 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10903 <p><a href="#static_android.statistics.info.availableFaceDetectModes">android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10904 </td>
10905
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10906 <td class="entry_tags">
10907 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10908 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10909 </ul>
10910 </td>
10911
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10912 </tr>
10913 <tr class="entries_header">
10914 <th class="th_details" colspan="5">Details</th>
10915 </tr>
10916 <tr class="entry_cont">
10917 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10918 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10919should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10920fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10921<a href="#static_android.statistics.info.availableFaceDetectModes">android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes</a>.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10922 </td>
10923 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10924
10925
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10926 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10927 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10928
10929
10930 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10931 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10932 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10933 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10934 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10935 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10936
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10937 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10938
10939 <ul class="entry_type_enum">
10940 <li>
10941 <span class="entry_type_enum_name">OFF</span>
10942 </li>
10943 <li>
10944 <span class="entry_type_enum_name">ON</span>
10945 </li>
10946 </ul>
10947
10948 </td> <!-- entry_type -->
10949
10950 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10951 <p>Operating mode for histogram
10952generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10953 </td>
10954
10955 <td class="entry_units">
10956 </td>
10957
10958 <td class="entry_range">
10959 </td>
10960
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10961 <td class="entry_tags">
10962 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10963 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10964 </ul>
10965 </td>
10966
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10967 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10968
10969
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10970 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10971 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10972
10973
10974 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10975 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10976 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10977 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10978 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10979 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10980
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10981 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10982
10983 <ul class="entry_type_enum">
10984 <li>
10985 <span class="entry_type_enum_name">OFF</span>
10986 </li>
10987 <li>
10988 <span class="entry_type_enum_name">ON</span>
10989 </li>
10990 </ul>
10991
10992 </td> <!-- entry_type -->
10993
10994 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10995 <p>Operating mode for sharpness map
10996generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10997 </td>
10998
10999 <td class="entry_units">
11000 </td>
11001
11002 <td class="entry_range">
11003 </td>
11004
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11005 <td class="entry_tags">
11006 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11007 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11008 </ul>
11009 </td>
11010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11011 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11012
11013
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11014 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11015 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11016
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11017
11018 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11019 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11020 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11021 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11022 <td class="entry_type">
11023 <span class="entry_type_name entry_type_name_enum">byte</span>
11024
11025 <span class="entry_type_visibility"> [public]</span>
11026
11027 <ul class="entry_type_enum">
11028 <li>
11029 <span class="entry_type_enum_name">OFF</span>
11030 </li>
11031 <li>
11032 <span class="entry_type_enum_name">ON</span>
11033 </li>
11034 </ul>
11035
11036 </td> <!-- entry_type -->
11037
11038 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11039 <p>Whether the HAL needs to output the lens
11040shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11041 </td>
11042
11043 <td class="entry_units">
11044 </td>
11045
11046 <td class="entry_range">
11047 </td>
11048
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11049 <td class="entry_tags">
11050 </td>
11051
11052 </tr>
11053 <tr class="entries_header">
11054 <th class="th_details" colspan="5">Details</th>
11055 </tr>
11056 <tr class="entry_cont">
11057 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11058 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11059<a href="#dynamic_android.statistics.lensShadingMap">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map</a> must be provided in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11060the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11061 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11062 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11063
11064
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11065 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11066 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11067
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11068
11069
11070 <!-- end of kind -->
11071 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11072 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11073
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11074 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11075 <tr>
11076 <th class="th_name">Property Name</th>
11077 <th class="th_type">Type</th>
11078 <th class="th_description">Description</th>
11079 <th class="th_units">Units</th>
11080 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11081 <th class="th_tags">Tags</th>
11082 </tr>
11083 </thead>
11084
11085 <tbody>
11086
11087
11088
11089
11090
11091
11092
11093
11094
11095
11096
11097
11098 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11099 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11100 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11101 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11102 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11103 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11104 <span class="entry_type_container">x</span>
11105
11106 <span class="entry_type_array">
11107 n
11108 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11109 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11110 <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]11111
11112
11113 </td> <!-- entry_type -->
11114
11115 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11116 <p>Which face detection modes are available,<wbr/>
11117if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11118 </td>
11119
11120 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11121 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11122 OFF
11123 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11124 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11125 </td>
11126
11127 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11128 </td>
11129
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11130 <td class="entry_tags">
11131 </td>
11132
11133 </tr>
11134 <tr class="entries_header">
11135 <th class="th_details" colspan="5">Details</th>
11136 </tr>
11137 <tr class="entry_cont">
11138 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11139 <p>OFF means face detection is disabled,<wbr/> it must
11140be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11141<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11142<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
11143<a href="#dynamic_android.statistics.faceScores">android.<wbr/>statistics.<wbr/>face<wbr/>Scores</a> outputs.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11144<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11145<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
11146<a href="#dynamic_android.statistics.faceLandmarks">android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks</a> outputs.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11147 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11148 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11149
11150
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11151 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11152 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11153
11154
11155 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11156 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11157 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11158 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11159 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11160 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11161
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11162 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11163
11164
11165 </td> <!-- entry_type -->
11166
11167 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11168 <p>Number of histogram buckets
11169supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11170 </td>
11171
11172 <td class="entry_units">
11173 </td>
11174
11175 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11176 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11177 </td>
11178
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11179 <td class="entry_tags">
11180 </td>
11181
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11182 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11183
11184
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11185 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11186 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11187
11188
11189 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11190 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11191 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11192 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11193 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11194 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11195
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11196 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11197
11198
11199 </td> <!-- entry_type -->
11200
11201 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11202 <p>Maximum number of simultaneously detectable
11203faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11204 </td>
11205
11206 <td class="entry_units">
11207 </td>
11208
11209 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11210 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11211modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11212 </td>
11213
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11214 <td class="entry_tags">
11215 </td>
11216
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11217 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11218
11219
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11220 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11221 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11222
11223
11224 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11225 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11226 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11227 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11228 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11229 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11230
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11231 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11232
11233
11234 </td> <!-- entry_type -->
11235
11236 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11237 <p>Maximum value possible for a histogram
11238bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11239 </td>
11240
11241 <td class="entry_units">
11242 </td>
11243
11244 <td class="entry_range">
11245 </td>
11246
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11247 <td class="entry_tags">
11248 </td>
11249
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11250 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11251
11252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11253 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11254 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11255
11256
11257 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11258 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11259 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11260 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11261 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11262 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11263
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11264 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11265
11266
11267 </td> <!-- entry_type -->
11268
11269 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11270 <p>Maximum value possible for a sharpness map
11271region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11272 </td>
11273
11274 <td class="entry_units">
11275 </td>
11276
11277 <td class="entry_range">
11278 </td>
11279
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11280 <td class="entry_tags">
11281 </td>
11282
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11283 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11284
11285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11286 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11287 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11288
11289
11290 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11291 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11292 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11293 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11294 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11295 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11296 <span class="entry_type_container">x</span>
11297
11298 <span class="entry_type_array">
11299 2
11300 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11301 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11302 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11303
11304
11305 </td> <!-- entry_type -->
11306
11307 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11308 <p>Dimensions of the sharpness
11309map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11310 </td>
11311
11312 <td class="entry_units">
11313 </td>
11314
11315 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11316 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11317 </td>
11318
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11319 <td class="entry_tags">
11320 </td>
11321
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11322 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11323
11324
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11325 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11326 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11327
11328
11329
11330
11331
11332
11333 <!-- end of kind -->
11334 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11335 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11336
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11337 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11338 <tr>
11339 <th class="th_name">Property Name</th>
11340 <th class="th_type">Type</th>
11341 <th class="th_description">Description</th>
11342 <th class="th_units">Units</th>
11343 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11344 <th class="th_tags">Tags</th>
11345 </tr>
11346 </thead>
11347
11348 <tbody>
11349
11350
11351
11352
11353
11354
11355
11356
11357
11358
11359 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11360 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11361 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11362 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11363 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11364 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11365
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11366 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11367
11368 <ul class="entry_type_enum">
11369 <li>
11370 <span class="entry_type_enum_name">OFF</span>
11371 </li>
11372 <li>
11373 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11374 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
11375 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11376 </li>
11377 <li>
11378 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11379 <span class="entry_type_enum_notes">Optional Return all face
11380 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11381 </li>
11382 </ul>
11383
11384 </td> <!-- entry_type -->
11385
11386 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11387 <p>State of the face detector
11388unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11389 </td>
11390
11391 <td class="entry_units">
11392 </td>
11393
11394 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11395 <p><a href="#static_android.statistics.info.availableFaceDetectModes">android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11396 </td>
11397
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11398 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11399 <ul class="entry_tags">
11400 <li><a href="#tag_BC">BC</a></li>
11401 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11402 </td>
11403
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11404 </tr>
11405 <tr class="entries_header">
11406 <th class="th_details" colspan="5">Details</th>
11407 </tr>
11408 <tr class="entry_cont">
11409 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11410 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11411should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11412fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11413<a href="#static_android.statistics.info.availableFaceDetectModes">android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes</a>.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11414 </td>
11415 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11416
11417
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11418 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11419 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11420
11421
11422 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11423 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11424 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11425 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11426 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11427 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11428 <span class="entry_type_container">x</span>
11429
11430 <span class="entry_type_array">
11431 n
11432 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11433 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11434
11435
11436 </td> <!-- entry_type -->
11437
11438 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11439 <p>List of unique IDs for detected
11440faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11441 </td>
11442
11443 <td class="entry_units">
11444 </td>
11445
11446 <td class="entry_range">
11447 </td>
11448
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11449 <td class="entry_tags">
11450 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11451 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11452 </ul>
11453 </td>
11454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11455 </tr>
11456 <tr class="entries_header">
11457 <th class="th_details" colspan="5">Details</th>
11458 </tr>
11459 <tr class="entry_cont">
11460 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11461 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11462 </td>
11463 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11464
11465
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11466 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11467 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11468
11469
11470 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11471 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11472 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11473 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11474 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11475 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11476 <span class="entry_type_container">x</span>
11477
11478 <span class="entry_type_array">
11479 n x 6
11480 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11481 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11482 <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]11483
11484
11485 </td> <!-- entry_type -->
11486
11487 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11488 <p>List of landmarks for detected
11489faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11490 </td>
11491
11492 <td class="entry_units">
11493 </td>
11494
11495 <td class="entry_range">
11496 </td>
11497
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11498 <td class="entry_tags">
11499 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11500 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11501 </ul>
11502 </td>
11503
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11504 </tr>
11505 <tr class="entries_header">
11506 <th class="th_details" colspan="5">Details</th>
11507 </tr>
11508 <tr class="entry_cont">
11509 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11510 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11511 </td>
11512 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11513
11514
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11515 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11516 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11517
11518
11519 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11520 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11521 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11522 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11523 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11524 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11525 <span class="entry_type_container">x</span>
11526
11527 <span class="entry_type_array">
11528 n x 4
11529 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11530 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11531 <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]11532
11533
11534 </td> <!-- entry_type -->
11535
11536 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11537 <p>List of the bounding rectangles for detected
11538faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11539 </td>
11540
11541 <td class="entry_units">
11542 </td>
11543
11544 <td class="entry_range">
11545 </td>
11546
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11547 <td class="entry_tags">
11548 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11549 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11550 </ul>
11551 </td>
11552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11553 </tr>
11554 <tr class="entries_header">
11555 <th class="th_details" colspan="5">Details</th>
11556 </tr>
11557 <tr class="entry_cont">
11558 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11559 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11560 </td>
11561 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11562
11563
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11564 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11565 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11566
11567
11568 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11569 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11570 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11571 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11572 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11573 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11574 <span class="entry_type_container">x</span>
11575
11576 <span class="entry_type_array">
11577 n
11578 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11579 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11580
11581
11582 </td> <!-- entry_type -->
11583
11584 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11585 <p>List of the face confidence scores for
11586detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11587 </td>
11588
11589 <td class="entry_units">
11590 </td>
11591
11592 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11593 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11594 </td>
11595
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11596 <td class="entry_tags">
11597 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11598 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11599 </ul>
11600 </td>
11601
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11602 </tr>
11603 <tr class="entries_header">
11604 <th class="th_details" colspan="5">Details</th>
11605 </tr>
11606 <tr class="entry_cont">
11607 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11608 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
11609meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11610 </td>
11611 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11612
11613
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11614 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11615 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11616
11617
11618 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11619 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11620 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11621 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11622 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11623 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11624 <span class="entry_type_container">x</span>
11625
11626 <span class="entry_type_array">
11627 n x 3
11628 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11629 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11630 <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]11631
11632
11633 </td> <!-- entry_type -->
11634
11635 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11636 <p>A 3-channel histogram based on the raw
11637sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11638 </td>
11639
11640 <td class="entry_units">
11641 </td>
11642
11643 <td class="entry_range">
11644 </td>
11645
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11646 <td class="entry_tags">
11647 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11648 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11649 </ul>
11650 </td>
11651
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11652 </tr>
11653 <tr class="entries_header">
11654 <th class="th_details" colspan="5">Details</th>
11655 </tr>
11656 <tr class="entry_cont">
11657 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11658 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11659(with w = <a href="#static_android.sensor.info.whiteLevel">android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level</a>) of [ k * w/<wbr/>N,<wbr/>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11660(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
11661supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11662 </td>
11663 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11664
11665
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11666 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11667 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11668
11669
11670 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11671 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11672 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11673 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11674 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11675 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11676
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11677 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11678
11679 <ul class="entry_type_enum">
11680 <li>
11681 <span class="entry_type_enum_name">OFF</span>
11682 </li>
11683 <li>
11684 <span class="entry_type_enum_name">ON</span>
11685 </li>
11686 </ul>
11687
11688 </td> <!-- entry_type -->
11689
11690 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11691 <p>Operating mode for histogram
11692generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11693 </td>
11694
11695 <td class="entry_units">
11696 </td>
11697
11698 <td class="entry_range">
11699 </td>
11700
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11701 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11702 <ul class="entry_tags">
11703 <li><a href="#tag_V1">V1</a></li>
11704 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11705 </td>
11706
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11707 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11708
11709
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11710 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11711 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11712
11713
11714 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11715 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11716 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11717 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11718 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11719 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11720 <span class="entry_type_container">x</span>
11721
11722 <span class="entry_type_array">
11723 n x m x 3
11724 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11725 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11726 <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]11727
11728
11729 </td> <!-- entry_type -->
11730
11731 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11732 <p>A 3-channel sharpness map,<wbr/> based on the raw
11733sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11734 </td>
11735
11736 <td class="entry_units">
11737 </td>
11738
11739 <td class="entry_range">
11740 </td>
11741
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11742 <td class="entry_tags">
11743 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11744 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11745 </ul>
11746 </td>
11747
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11748 </tr>
11749 <tr class="entries_header">
11750 <th class="th_details" colspan="5">Details</th>
11751 </tr>
11752 <tr class="entry_cont">
11753 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11754 <p>If only a monochrome sharpness map is supported,<wbr/>
11755all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11756 </td>
11757 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11758
11759
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11760 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11761 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11762
11763
11764 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11765 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11766 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11767 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11768 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11769 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11770
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11771 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11772
11773 <ul class="entry_type_enum">
11774 <li>
11775 <span class="entry_type_enum_name">OFF</span>
11776 </li>
11777 <li>
11778 <span class="entry_type_enum_name">ON</span>
11779 </li>
11780 </ul>
11781
11782 </td> <!-- entry_type -->
11783
11784 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11785 <p>Operating mode for sharpness map
11786generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11787 </td>
11788
11789 <td class="entry_units">
11790 </td>
11791
11792 <td class="entry_range">
11793 </td>
11794
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11795 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11796 <ul class="entry_tags">
11797 <li><a href="#tag_V1">V1</a></li>
11798 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11799 </td>
11800
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11801 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11802
11803
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11804 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11805 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11806
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11807
11808 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11809 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11810 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11811 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11812 <td class="entry_type">
11813 <span class="entry_type_name">float</span>
11814 <span class="entry_type_container">x</span>
11815
11816 <span class="entry_type_array">
11817 4 x n x m
11818 </span>
11819 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11820 <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]11821
11822
11823 </td> <!-- entry_type -->
11824
11825 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11826 <p>The shading map is a low-resolution floating-point map
11827that lists the coefficients used to correct for vignetting,<wbr/> for each
11828Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11829 </td>
11830
11831 <td class="entry_units">
11832 </td>
11833
11834 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11835 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11836 </td>
11837
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11838 <td class="entry_tags">
11839 </td>
11840
11841 </tr>
11842 <tr class="entries_header">
11843 <th class="th_details" colspan="5">Details</th>
11844 </tr>
11845 <tr class="entry_cont">
11846 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11847 <p>The least shaded section of the image should have a gain factor
11848of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11849<p>When <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> = TRANSFORM_<wbr/>MATRIX,<wbr/> the map
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11850must take into account the colorCorrection settings.<wbr/></p>
11851<p>The shading map is for the entire active pixel array,<wbr/> and is not
11852affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11853entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11854pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
11855map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
11856(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
11857pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
11858The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
11859<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
11860channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
11861The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11862is provided in the camera static metadata by <a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a>.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11863<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
11864and must be smaller than 64x64.<wbr/></p>
11865<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11866<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
11867<a href="#dynamic_android.statistics.lensShadingMap">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map</a> =
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11868[ 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/>
11869 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/>
11870 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/>
11871 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/>
11872 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/>
11873 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]11874</code></pre>
11875<p>The low-resolution scaling map images for each channel are
11876(displayed using nearest-neighbor interpolation):</p>
11877<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
11878<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
11879<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
11880<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]11881<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11882image 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]11883<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]11884 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11885 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11886
11887
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11888 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11889 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11890
11891
11892 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11893 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11894 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11895 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11896 <td class="entry_type">
11897 <span class="entry_type_name">float</span>
11898 <span class="entry_type_container">x</span>
11899
11900 <span class="entry_type_array">
11901 4
11902 </span>
11903 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11904 <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]11905
11906
11907 </td> <!-- entry_type -->
11908
11909 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11910 <p>The best-fit color channel gains calculated
11911by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11912 </td>
11913
11914 <td class="entry_units">
11915 </td>
11916
11917 <td class="entry_range">
11918 </td>
11919
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11920 <td class="entry_tags">
11921 </td>
11922
11923 </tr>
11924 <tr class="entries_header">
11925 <th class="th_details" colspan="5">Details</th>
11926 </tr>
11927 <tr class="entry_cont">
11928 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11929 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11930since statistics processing on data from a new frame
11931typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11932applied to that frame.<wbr/></p>
11933<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11934see <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> for details.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11935<p>This value should always be calculated by the AWB block,<wbr/>
11936regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11937 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11938 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11939
11940
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11941 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11942 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11943
11944
11945 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11946 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11947 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11948 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11949 <td class="entry_type">
11950 <span class="entry_type_name">rational</span>
11951 <span class="entry_type_container">x</span>
11952
11953 <span class="entry_type_array">
11954 3 x 3
11955 </span>
11956 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11957 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11958
11959
11960 </td> <!-- entry_type -->
11961
11962 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11963 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11964calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11965output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11966 </td>
11967
11968 <td class="entry_units">
11969 </td>
11970
11971 <td class="entry_range">
11972 </td>
11973
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11974 <td class="entry_tags">
11975 </td>
11976
11977 </tr>
11978 <tr class="entries_header">
11979 <th class="th_details" colspan="5">Details</th>
11980 </tr>
11981 <tr class="entry_cont">
11982 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11983 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11984statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11985for the next frame.<wbr/> These are the values the HAL believes
11986are the best fit for the current output frame.<wbr/> This may
11987be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11988statistics processing on data from a new frame typically
11989completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11990that frame.<wbr/></p>
11991<p>These estimates must be provided for all frames,<wbr/> even if
11992capture settings and color transforms are set by the application.<wbr/></p>
11993<p>This value should always be calculated by the AWB block,<wbr/>
11994regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11995 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11996 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11997
11998
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11999 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12000 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12001
12002
12003 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12004 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12005 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12006 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12007 <td class="entry_type">
12008 <span class="entry_type_name entry_type_name_enum">byte</span>
12009
12010 <span class="entry_type_visibility"> [public]</span>
12011
12012 <ul class="entry_type_enum">
12013 <li>
12014 <span class="entry_type_enum_name">NONE</span>
12015 </li>
12016 <li>
12017 <span class="entry_type_enum_name">50HZ</span>
12018 </li>
12019 <li>
12020 <span class="entry_type_enum_name">60HZ</span>
12021 </li>
12022 </ul>
12023
12024 </td> <!-- entry_type -->
12025
12026 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12027 <p>The HAL estimated scene illumination lighting
12028frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12029 </td>
12030
12031 <td class="entry_units">
12032 </td>
12033
12034 <td class="entry_range">
12035 </td>
12036
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12037 <td class="entry_tags">
12038 </td>
12039
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12040 </tr>
12041 <tr class="entries_header">
12042 <th class="th_details" colspan="5">Details</th>
12043 </tr>
12044 <tr class="entry_cont">
12045 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12046 <p>Report NONE if there doesn't appear to be flickering
12047illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12048 </td>
12049 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12050
12051
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12052 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12053 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12054
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12055
12056
12057 <!-- end of kind -->
12058 </tbody>
12059
12060 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12061 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12062
12063
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12064 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12065
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12066 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12067 <tr>
12068 <th class="th_name">Property Name</th>
12069 <th class="th_type">Type</th>
12070 <th class="th_description">Description</th>
12071 <th class="th_units">Units</th>
12072 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12073 <th class="th_tags">Tags</th>
12074 </tr>
12075 </thead>
12076
12077 <tbody>
12078
12079
12080
12081
12082
12083
12084
12085
12086
12087
12088 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12089 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12090 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12091 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12092 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12093 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12094 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12095
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12096 <span class="entry_type_array">
12097 n x 2
12098 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12099 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12100 <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]12101
12102
12103 </td> <!-- entry_type -->
12104
12105 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12106 <p>Table mapping blue input values to output
12107values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12108 </td>
12109
12110 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12111 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12112 </td>
12113
12114 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12115 <p>same as <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12116 </td>
12117
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12118 <td class="entry_tags">
12119 </td>
12120
12121 </tr>
12122 <tr class="entries_header">
12123 <th class="th_details" colspan="5">Details</th>
12124 </tr>
12125 <tr class="entry_cont">
12126 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12127 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12128channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12129<p>See <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12130 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12131 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12132
12133
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12134 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12135 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12136
12137
12138 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12139 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12140 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12141 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12142 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12143 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12144 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12145
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12146 <span class="entry_type_array">
12147 n x 2
12148 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12149 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12150 <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]12151
12152
12153 </td> <!-- entry_type -->
12154
12155 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12156 <p>Table mapping green input values to output
12157values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12158 </td>
12159
12160 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12161 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12162 </td>
12163
12164 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12165 <p>same as <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12166 </td>
12167
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12168 <td class="entry_tags">
12169 </td>
12170
12171 </tr>
12172 <tr class="entries_header">
12173 <th class="th_details" colspan="5">Details</th>
12174 </tr>
12175 <tr class="entry_cont">
12176 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12177 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12178channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12179<p>See <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12180 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12181 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12182
12183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12184 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12185 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12186
12187
12188 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12189 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12190 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12191 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12192 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12193 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12194 <span class="entry_type_container">x</span>
12195
12196 <span class="entry_type_array">
12197 n x 2
12198 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12199 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12200 <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]12201
12202
12203 </td> <!-- entry_type -->
12204
12205 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12206 <p>Table mapping red input values to output
12207values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12208 </td>
12209
12210 <td class="entry_units">
12211 </td>
12212
12213 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12214 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12215 </td>
12216
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12217 <td class="entry_tags">
12218 <ul class="entry_tags">
12219 <li><a href="#tag_DNG">DNG</a></li>
12220 </ul>
12221 </td>
12222
12223 </tr>
12224 <tr class="entries_header">
12225 <th class="th_details" colspan="5">Details</th>
12226 </tr>
12227 <tr class="entry_cont">
12228 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12229 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12230channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12231<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12232the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12233are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12234between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12235<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12236defined points.<wbr/> The points will be listed in increasing
12237order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
122380.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12239for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
122400.<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]12241 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12242 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12243
12244
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12245 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12246 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12247
12248
12249 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12250 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12251 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12252 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12253 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12254 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12255
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12256 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12257
12258 <ul class="entry_type_enum">
12259 <li>
12260 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12261 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12262 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12263 </li>
12264 <li>
12265 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12266 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12267 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12268 </li>
12269 <li>
12270 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12271 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12272 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12273 </li>
12274 </ul>
12275
12276 </td> <!-- entry_type -->
12277
12278 <td class="entry_description">
12279 </td>
12280
12281 <td class="entry_units">
12282 </td>
12283
12284 <td class="entry_range">
12285 </td>
12286
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12287 <td class="entry_tags">
12288 </td>
12289
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12290 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12291
12292
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12293 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12294 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12295
12296
12297
12298 <!-- end of kind -->
12299 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12300 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12301
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12302 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12303 <tr>
12304 <th class="th_name">Property Name</th>
12305 <th class="th_type">Type</th>
12306 <th class="th_description">Description</th>
12307 <th class="th_units">Units</th>
12308 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12309 <th class="th_tags">Tags</th>
12310 </tr>
12311 </thead>
12312
12313 <tbody>
12314
12315
12316
12317
12318
12319
12320
12321
12322
12323
12324 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12325 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12326 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12327 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12328 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12329 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12330
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12331 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12332
12333
12334 </td> <!-- entry_type -->
12335
12336 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12337 <p>Maximum number of supported points in the
12338tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12339 </td>
12340
12341 <td class="entry_units">
12342 </td>
12343
12344 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]12345 <p>&gt;= 128</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12346 </td>
12347
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12348 <td class="entry_tags">
12349 </td>
12350
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12351 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12352
12353
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12354 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12355 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12356
12357
12358
12359 <!-- end of kind -->
12360 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12361 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12362
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12363 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12364 <tr>
12365 <th class="th_name">Property Name</th>
12366 <th class="th_type">Type</th>
12367 <th class="th_description">Description</th>
12368 <th class="th_units">Units</th>
12369 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12370 <th class="th_tags">Tags</th>
12371 </tr>
12372 </thead>
12373
12374 <tbody>
12375
12376
12377
12378
12379
12380
12381
12382
12383
12384
12385 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12386 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12387 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12388 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12389 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12390 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12391 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12392
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12393 <span class="entry_type_array">
12394 n x 2
12395 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12396 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12397 <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]12398
12399
12400 </td> <!-- entry_type -->
12401
12402 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12403 <p>Table mapping blue input values to output
12404values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12405 </td>
12406
12407 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12408 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12409 </td>
12410
12411 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12412 <p>same as <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12413 </td>
12414
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12415 <td class="entry_tags">
12416 </td>
12417
12418 </tr>
12419 <tr class="entries_header">
12420 <th class="th_details" colspan="5">Details</th>
12421 </tr>
12422 <tr class="entry_cont">
12423 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12424 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12425channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12426<p>See <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12427 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12428 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12429
12430
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12431 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12432 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12433
12434
12435 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12436 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12437 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12438 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12439 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12440 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12441 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12442
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12443 <span class="entry_type_array">
12444 n x 2
12445 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12446 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12447 <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]12448
12449
12450 </td> <!-- entry_type -->
12451
12452 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12453 <p>Table mapping green input values to output
12454values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12455 </td>
12456
12457 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12458 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12459 </td>
12460
12461 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12462 <p>same as <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12463 </td>
12464
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12465 <td class="entry_tags">
12466 </td>
12467
12468 </tr>
12469 <tr class="entries_header">
12470 <th class="th_details" colspan="5">Details</th>
12471 </tr>
12472 <tr class="entry_cont">
12473 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12474 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12475channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12476<p>See <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12477 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12478 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12479
12480
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12481 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12482 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12483
12484
12485 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12486 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12487 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12488 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12489 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12490 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12491 <span class="entry_type_container">x</span>
12492
12493 <span class="entry_type_array">
12494 n x 2
12495 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12496 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12497 <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]12498
12499
12500 </td> <!-- entry_type -->
12501
12502 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12503 <p>Table mapping red input values to output
12504values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12505 </td>
12506
12507 <td class="entry_units">
12508 </td>
12509
12510 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12511 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12512 </td>
12513
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12514 <td class="entry_tags">
12515 <ul class="entry_tags">
12516 <li><a href="#tag_DNG">DNG</a></li>
12517 </ul>
12518 </td>
12519
12520 </tr>
12521 <tr class="entries_header">
12522 <th class="th_details" colspan="5">Details</th>
12523 </tr>
12524 <tr class="entry_cont">
12525 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12526 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12527channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12528<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12529the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12530are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12531between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12532<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12533defined points.<wbr/> The points will be listed in increasing
12534order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
125350.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12536for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
125370.<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]12538 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12539 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12540
12541
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12542 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12543 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12544
12545
12546 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12547 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12548 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12549 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12550 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12551 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12552
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12553 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12554
12555 <ul class="entry_type_enum">
12556 <li>
12557 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12558 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12559 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12560 </li>
12561 <li>
12562 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12563 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12564 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12565 </li>
12566 <li>
12567 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12568 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12569 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12570 </li>
12571 </ul>
12572
12573 </td> <!-- entry_type -->
12574
12575 <td class="entry_description">
12576 </td>
12577
12578 <td class="entry_units">
12579 </td>
12580
12581 <td class="entry_range">
12582 </td>
12583
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12584 <td class="entry_tags">
12585 </td>
12586
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12587 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12588
12589
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12590 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12591 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12592
12593
12594
12595 <!-- end of kind -->
12596 </tbody>
12597
12598 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12599 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12600
12601
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12602 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12603
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12604 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12605 <tr>
12606 <th class="th_name">Property Name</th>
12607 <th class="th_type">Type</th>
12608 <th class="th_description">Description</th>
12609 <th class="th_units">Units</th>
12610 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12611 <th class="th_tags">Tags</th>
12612 </tr>
12613 </thead>
12614
12615 <tbody>
12616
12617
12618
12619
12620
12621
12622
12623
12624
12625
12626 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12627 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12628 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12629 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12630 <td class="entry_type">
12631 <span class="entry_type_name entry_type_name_enum">byte</span>
12632
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12633 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12634
12635 <ul class="entry_type_enum">
12636 <li>
12637 <span class="entry_type_enum_name">OFF</span>
12638 </li>
12639 <li>
12640 <span class="entry_type_enum_name">ON</span>
12641 </li>
12642 </ul>
12643
12644 </td> <!-- entry_type -->
12645
12646 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12647 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12648that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12649Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12650disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12651any untrusted applications.<wbr/></p>
12652<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12653transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12654data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12655<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]12656doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12657 </td>
12658
12659 <td class="entry_units">
12660 </td>
12661
12662 <td class="entry_range">
12663 </td>
12664
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12665 <td class="entry_tags">
12666 </td>
12667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12668 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12669
12670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12671 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12672 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12673
12674
12675
12676 <!-- end of kind -->
12677 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12678 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12679
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12680 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12681 <tr>
12682 <th class="th_name">Property Name</th>
12683 <th class="th_type">Type</th>
12684 <th class="th_description">Description</th>
12685 <th class="th_units">Units</th>
12686 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12687 <th class="th_tags">Tags</th>
12688 </tr>
12689 </thead>
12690
12691 <tbody>
12692
12693
12694
12695
12696
12697
12698
12699
12700
12701
12702 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12703 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12704 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12705 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12706 <td class="entry_type">
12707 <span class="entry_type_name entry_type_name_enum">byte</span>
12708
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12709 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12710
12711 <ul class="entry_type_enum">
12712 <li>
12713 <span class="entry_type_enum_name">OFF</span>
12714 </li>
12715 <li>
12716 <span class="entry_type_enum_name">ON</span>
12717 </li>
12718 </ul>
12719
12720 </td> <!-- entry_type -->
12721
12722 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12723 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12724that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12725Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12726disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12727any untrusted applications.<wbr/></p>
12728<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12729transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12730data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12731<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]12732doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12733 </td>
12734
12735 <td class="entry_units">
12736 </td>
12737
12738 <td class="entry_range">
12739 </td>
12740
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12741 <td class="entry_tags">
12742 </td>
12743
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12744 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12745
12746
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12747 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12748 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12749
12750
12751
12752 <!-- end of kind -->
12753 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12754 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12755
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12756 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12757 <tr>
12758 <th class="th_name">Property Name</th>
12759 <th class="th_type">Type</th>
12760 <th class="th_description">Description</th>
12761 <th class="th_units">Units</th>
12762 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12763 <th class="th_tags">Tags</th>
12764 </tr>
12765 </thead>
12766
12767 <tbody>
12768
12769
12770
12771
12772
12773
12774
12775
12776
12777
12778 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12779 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12780 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12781 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12782 <td class="entry_type">
12783 <span class="entry_type_name entry_type_name_enum">byte</span>
12784 <span class="entry_type_container">x</span>
12785
12786 <span class="entry_type_array">
12787 n
12788 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12789 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12790
12791 <ul class="entry_type_enum">
12792 <li>
12793 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12794 <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]12795 </li>
12796 </ul>
12797
12798 </td> <!-- entry_type -->
12799
12800 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12801 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12802 </td>
12803
12804 <td class="entry_units">
12805 </td>
12806
12807 <td class="entry_range">
12808 </td>
12809
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12810 <td class="entry_tags">
12811 </td>
12812
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12813 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12814
12815
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12816 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12817 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12818
12819
12820
12821 <!-- end of kind -->
12822 </tbody>
12823
12824 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12825 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12826
12827
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12828 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12829
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12830 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12831 <tr>
12832 <th class="th_name">Property Name</th>
12833 <th class="th_type">Type</th>
12834 <th class="th_description">Description</th>
12835 <th class="th_units">Units</th>
12836 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12837 <th class="th_tags">Tags</th>
12838 </tr>
12839 </thead>
12840
12841 <tbody>
12842
12843
12844
12845
12846
12847
12848
12849
12850
12851
12852 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12853 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12854 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12855 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12856 <td class="entry_type">
12857 <span class="entry_type_name entry_type_name_enum">byte</span>
12858
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12859 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12860
12861 <ul class="entry_type_enum">
12862 <li>
12863 <span class="entry_type_enum_name">LIMITED</span>
12864 </li>
12865 <li>
12866 <span class="entry_type_enum_name">FULL</span>
12867 </li>
12868 </ul>
12869
12870 </td> <!-- entry_type -->
12871
12872 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12873 <p>The camera 3 HAL device can implement one of two possible
12874operational modes; limited and full.<wbr/> Full support is
12875expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12876hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12877camera HAL device v1 implementation,<wbr/> and is expected from
12878older or inexpensive devices.<wbr/> Full is a strict superset of
12879limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
12880<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]12881 </td>
12882
12883 <td class="entry_units">
12884 </td>
12885
12886 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12887 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12888 </td>
12889
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12890 <td class="entry_tags">
12891 </td>
12892
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12893 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12894
12895
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12896 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12897 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12898
12899
12900
12901 <!-- end of kind -->
12902 </tbody>
12903
12904 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12905 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12906
12907
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12908 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12909
12910 <thead class="entries_header">
12911 <tr>
12912 <th class="th_name">Property Name</th>
12913 <th class="th_type">Type</th>
12914 <th class="th_description">Description</th>
12915 <th class="th_units">Units</th>
12916 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12917 <th class="th_tags">Tags</th>
12918 </tr>
12919 </thead>
12920
12921 <tbody>
12922
12923
12924
12925
12926
12927
12928
12929
12930
12931
12932 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12933 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12934 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12935 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12936 <td class="entry_type">
12937 <span class="entry_type_name entry_type_name_enum">byte</span>
12938
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12939 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12940
12941 <ul class="entry_type_enum">
12942 <li>
12943 <span class="entry_type_enum_name">OFF</span>
12944 </li>
12945 <li>
12946 <span class="entry_type_enum_name">ON</span>
12947 </li>
12948 </ul>
12949
12950 </td> <!-- entry_type -->
12951
12952 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12953 <p>Whether black-level compensation is locked
12954to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12955 </td>
12956
12957 <td class="entry_units">
12958 </td>
12959
12960 <td class="entry_range">
12961 </td>
12962
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12963 <td class="entry_tags">
12964 <ul class="entry_tags">
12965 <li><a href="#tag_HAL2">HAL2</a></li>
12966 </ul>
12967 </td>
12968
12969 </tr>
12970 <tr class="entries_header">
12971 <th class="th_details" colspan="5">Details</th>
12972 </tr>
12973 <tr class="entry_cont">
12974 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12975 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12976compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12977OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12978<p>Since changes to certain capture parameters (such as
12979exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12980compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12981the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12982metadata.<wbr/></p>
12983<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12984<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12985<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12986<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12987<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12988<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12989<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12990<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12991</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12992<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12993device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12994result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12995<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12996<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12997<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12998<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12999<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
13000<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13001<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13002</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13003<p>This indicates to the application that on frame 4,<wbr/> black
13004levels were reset due to exposure value changes,<wbr/> and pixel
13005values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13006<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13007possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13008other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13009or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13010 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13011 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13012
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13013 <tr class="entries_header">
13014 <th class="th_details" colspan="5">HAL Implementation Details</th>
13015 </tr>
13016 <tr class="entry_cont">
13017 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13018 <p>If for some reason black level locking is no longer possible
13019(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13020black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13021override this request (and it must report 'OFF' when this
13022does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13023possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13024 </td>
13025 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13026
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13027 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13028 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13029
13030
13031
13032 <!-- end of kind -->
13033 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13034 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13035
13036 <thead class="entries_header">
13037 <tr>
13038 <th class="th_name">Property Name</th>
13039 <th class="th_type">Type</th>
13040 <th class="th_description">Description</th>
13041 <th class="th_units">Units</th>
13042 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13043 <th class="th_tags">Tags</th>
13044 </tr>
13045 </thead>
13046
13047 <tbody>
13048
13049
13050
13051
13052
13053
13054
13055
13056
13057
13058 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13059 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13060 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13061 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13062 <td class="entry_type">
13063 <span class="entry_type_name entry_type_name_enum">byte</span>
13064
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13065 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13066
13067 <ul class="entry_type_enum">
13068 <li>
13069 <span class="entry_type_enum_name">OFF</span>
13070 </li>
13071 <li>
13072 <span class="entry_type_enum_name">ON</span>
13073 </li>
13074 </ul>
13075
13076 </td> <!-- entry_type -->
13077
13078 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13079 <p>Whether black-level compensation is locked
13080to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13081 </td>
13082
13083 <td class="entry_units">
13084 </td>
13085
13086 <td class="entry_range">
13087 </td>
13088
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13089 <td class="entry_tags">
13090 <ul class="entry_tags">
13091 <li><a href="#tag_HAL2">HAL2</a></li>
13092 </ul>
13093 </td>
13094
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13095 </tr>
13096 <tr class="entries_header">
13097 <th class="th_details" colspan="5">Details</th>
13098 </tr>
13099 <tr class="entry_cont">
13100 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13101 <p>Whether the black level offset was locked for this frame.<wbr/> Should be
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13102ON if <a href="#controls_android.blackLevel.lock">android.<wbr/>black<wbr/>Level.<wbr/>lock</a> was ON in the capture request,<wbr/> unless
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13103a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13104perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13105 </td>
13106 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13107
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13108 <tr class="entries_header">
13109 <th class="th_details" colspan="5">HAL Implementation Details</th>
13110 </tr>
13111 <tr class="entry_cont">
13112 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13113 <p>If for some reason black level locking is no longer possible
13114(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13115black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13116override this request (and it must report 'OFF' when this
13117does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13118possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13119 </td>
13120 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13121
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13122 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13123 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13124
13125
13126
13127 <!-- end of kind -->
13128 </tbody>
13129
13130 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13131<!-- </namespace> -->
13132 </table>
13133
13134 <div class="tags" id="tag_index">
13135 <h2>Tags</h2>
13136 <ul>
13137 <li id="tag_AWB">AWB -
13138 Needed for auto white balance
13139
13140 <ul class="tags_entries">
13141 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13142 </ul>
13143 </li> <!-- tag_AWB -->
13144 <li id="tag_BC">BC -
13145 Needed for backwards compatibility with old Java API
13146
13147 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]13148 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13149 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
13150 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
13151 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
13152 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
13153 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13154 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13155 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
13156 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13157 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13158 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
13159 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13160 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
13161 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
13162 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
13163 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
13164 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
13165 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]13166 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13167 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
13168 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
13169 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
13170 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
13171 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
13172 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
13173 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
13174 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
13175 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
13176 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
13177 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
13178 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
13179 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
13180 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
13181 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
13182 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
13183 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
13184 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
13185 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
13186 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13187 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13188 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
13189 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
13190 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
13191 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
13192 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
13193 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
13194 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]13195 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13196 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
13197 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
13198 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13199 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13200 <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]13201 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13202 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13203 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13204 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
13205 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
13206 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
13207 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
13208 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
13209 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
13210 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
13211 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
13212 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
13213 </ul>
13214 </li> <!-- tag_BC -->
13215 <li id="tag_V1">V1 -
13216 New features for first camera 2 release (API1)
13217
13218 <ul class="tags_entries">
13219 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13220 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13221 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13222 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13223 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13224 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13225 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13226 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13227 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13228 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13229 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13230 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13231 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13232 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13233 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13234 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13235 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13236 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13237 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13238 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13239 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13240 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13241 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13242 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13243 <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]13244 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13245 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13246 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13247 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13248 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13249 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13250 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13251 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13252 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13253 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13254 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13255 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13256 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13257 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13258 </ul>
13259 </li> <!-- tag_V1 -->
13260 <li id="tag_ADV">ADV - None
13261 <ul class="tags_entries">
13262 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13263 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13264 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13265 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13266 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13267 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13268 </ul>
13269 </li> <!-- tag_ADV -->
13270 <li id="tag_DNG">DNG -
13271 Needed for DNG file support
13272
13273 <ul class="tags_entries">
13274 <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]13275 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13276 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13277 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13278 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13279 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13280 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13281 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13282 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13283 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13284 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13285 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13286 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13287 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13288 </ul>
13289 </li> <!-- tag_DNG -->
13290 <li id="tag_EXIF">EXIF - None
13291 <ul class="tags_entries">
13292 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13293 </ul>
13294 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13295 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13296 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13297
13298 <ul class="tags_entries">
13299 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13300 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13301 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13302 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13303 </ul>
13304 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13305 <li id="tag_FULL">FULL -
13306 Entry is required for full hardware level devices, and optional for other hardware levels
13307
13308 <ul class="tags_entries">
13309 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13310 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13311 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13312 </ul>
13313 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13314 </ul>
13315 </div>
13316
13317 [ <a href="#">top</a> ]
13318
13319</body>
13320</html>