Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / 9fa0d90ffe79b92476f6b8eb66b53e32c0a30d45 / . / camera / docs / docs.html
blob: 48dd8601b39a45e5b87902ef20f9dd4113dd6727 [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>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1684<p>If lens is controlled by HAL auto-focus algorithm,<wbr/> the HAL should
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1685report the current AF status in <a href="#dynamic_android.control.afState">android.<wbr/>control.<wbr/>af<wbr/>State</a> in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1686result 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">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2676 <td class="entry_name" rowspan="1">
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
2694selected</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">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2701 <p>OFF must be included.<wbr/> AUTO must be supported if
2702lens allows for changing focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2703 </td>
2704
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2705 <td class="entry_tags">
2706 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2707 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2708 </ul>
2709 </td>
2710
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2711 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2712
2713
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2714 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2715 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2716
2717
2718 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2719 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2720 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2721 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2722 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2723 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2724 <span class="entry_type_container">x</span>
2725
2726 <span class="entry_type_array">
2727 n
2728 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2729 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2730 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2731
2732
2733 </td> <!-- entry_type -->
2734
2735 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2736 <p>what subset of the full color effect enum
2737list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2738 </td>
2739
2740 <td class="entry_units">
2741 </td>
2742
2743 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2744 <p>OFF must be listed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2745 </td>
2746
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2747 <td class="entry_tags">
2748 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2749 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2750 </ul>
2751 </td>
2752
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2753 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2754
2755
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2756 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2757 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2758
2759
2760 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2761 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2762 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2763 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2764 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2765 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2766 <span class="entry_type_container">x</span>
2767
2768 <span class="entry_type_array">
2769 n
2770 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2771 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2772 <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]2773
2774
2775 </td> <!-- entry_type -->
2776
2777 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2778 <p>what subset of the scene mode enum list is
2779supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2780 </td>
2781
2782 <td class="entry_units">
2783 </td>
2784
2785 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2786 <p>SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2787detection is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2788 </td>
2789
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2790 <td class="entry_tags">
2791 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2792 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2793 </ul>
2794 </td>
2795
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2796 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2797
2798
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2799 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2800 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2801
2802
2803 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2804 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2805 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2806 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2807 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2808 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2809 <span class="entry_type_container">x</span>
2810
2811 <span class="entry_type_array">
2812 n
2813 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2814 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2815 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2816
2817
2818 </td> <!-- entry_type -->
2819
2820 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2821 <p>List of video stabilization modes that can
2822be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2823 </td>
2824
2825 <td class="entry_units">
2826 </td>
2827
2828 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2829 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2830 </td>
2831
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2832 <td class="entry_tags">
2833 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2834 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2835 </ul>
2836 </td>
2837
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2838 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2839
2840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2841 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2842 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2843
2844
2845 <tr class="entry" id="static_android.control.awbAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2846 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2847 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2848 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2849 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2850 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2851 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2852
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2853 <span class="entry_type_array">
2854 n
2855 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2856 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2857 <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]2858
2859
2860 </td> <!-- entry_type -->
2861
2862 <td class="entry_description">
2863 </td>
2864
2865 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2866 </td>
2867
2868 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2869 <p>OFF,<wbr/> AUTO must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2870 </td>
2871
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2872 <td class="entry_tags">
2873 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2874 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2875 </ul>
2876 </td>
2877
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2878 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2879
2880
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2881 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2882 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2883
2884
2885 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2886 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2887 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2888 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2889 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2890 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2891
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2892 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2893
2894
2895 </td> <!-- entry_type -->
2896
2897 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2898 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
2899regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2900 </td>
2901
2902 <td class="entry_units">
2903 </td>
2904
2905 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2906 <blockquote>
2907<p>= 1</p>
2908</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2909 </td>
2910
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2911 <td class="entry_tags">
2912 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2913 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2914 </ul>
2915 </td>
2916
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2917 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2918
2919
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2920 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2921 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2922
2923
2924 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2925 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2926 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2927 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2928 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2929 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2930 <span class="entry_type_container">x</span>
2931
2932 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2933 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2934 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2935 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2936
2937
2938 </td> <!-- entry_type -->
2939
2940 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2941 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
2942each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2943 </td>
2944
2945 <td class="entry_units">
2946 </td>
2947
2948 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2949 <p>For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
2950awbMode,<wbr/> and afMode that the HAL wants to use for that
2951scene mode.<wbr/></p>
2952<p>For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
2953order of increasing index</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2954 </td>
2955
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2956 <td class="entry_tags">
2957 <ul class="entry_tags">
2958 <li><a href="#tag_BC">BC</a></li>
2959 </ul>
2960 </td>
2961
2962 </tr>
2963 <tr class="entries_header">
2964 <th class="th_details" colspan="5">Details</th>
2965 </tr>
2966 <tr class="entry_cont">
2967 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2968 <p>When a scene mode is enabled,<wbr/> the HAL is expected
2969to override aeMode,<wbr/> awbMode,<wbr/> and afMode with its
2970preferred settings for that scene mode.<wbr/></p>
2971<p>To simplify communication with old camera API applications,<wbr/>
2972the service wants this override list in the static metadata.<wbr/>
2973The order of this list matches that of availableSceneModes,<wbr/>
2974with 3 entires for each scene mode.<wbr/> The overrides listed
2975for SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
2976mode,<wbr/> the application-set aeMode,<wbr/> awbMode,<wbr/> and afMode are
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2977used 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]2978AUTO.<wbr/></p>
2979<p>It is recommended that for FACE_<wbr/>PRIORITY,<wbr/> the overrides
2980should be set to 0.<wbr/> As an example,<wbr/> if availableSceneModes is
2981{ FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT },<wbr/> then the service expects
2982this field to have 9 entries; for example { 0 ,<wbr/> 0,<wbr/> 0,<wbr/>
2983ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
2984INCANDESCENT,<wbr/> AUTO }</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2985 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2986 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2987
2988
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2989 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2990 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2991
2992
2993
2994 <!-- end of kind -->
2995 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2996 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2997
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2998 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2999 <tr>
3000 <th class="th_name">Property Name</th>
3001 <th class="th_type">Type</th>
3002 <th class="th_description">Description</th>
3003 <th class="th_units">Units</th>
3004 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3005 <th class="th_tags">Tags</th>
3006 </tr>
3007 </thead>
3008
3009 <tbody>
3010
3011
3012
3013
3014
3015
3016
3017
3018
3019
3020 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3021 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3022 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3023 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3024 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3025 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3026
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3027 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3028
3029
3030 </td> <!-- entry_type -->
3031
3032 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3033 <p>The ID sent with the latest
3034CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3035 </td>
3036
3037 <td class="entry_units">
3038 </td>
3039
3040 <td class="entry_range">
3041 </td>
3042
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3043 <td class="entry_tags">
3044 </td>
3045
3046 </tr>
3047 <tr class="entries_header">
3048 <th class="th_details" colspan="5">Details</th>
3049 </tr>
3050 <tr class="entry_cont">
3051 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3052 <p>Must be 0 if no
3053CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
3054by HAL.<wbr/> Always updated even if AE algorithm ignores the
3055trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3056 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3057 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3058
3059
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3060 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3061 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3062
3063
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame^]3064 <tr class="entry" id="dynamic_android.control.aeMode">
3065 <td class="entry_name" rowspan="3">
3066 android.<wbr/>control.<wbr/>ae<wbr/>Mode
3067 </td>
3068 <td class="entry_type">
3069 <span class="entry_type_name entry_type_name_enum">byte</span>
3070
3071 <span class="entry_type_visibility"> [public]</span>
3072
3073 <ul class="entry_type_enum">
3074 <li>
3075 <span class="entry_type_enum_name">OFF</span>
3076 <span class="entry_type_enum_notes">
3077 The camera device's autoexposure routine is disabled;
3078 the application-selected android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
3079 android.<wbr/>sensor.<wbr/>sensitivity and
3080 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are used by the camera
3081 device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
3082 a flash unit for this camera device.<wbr/>
3083 </span>
3084 </li>
3085 <li>
3086 <span class="entry_type_enum_name">ON</span>
3087 <span class="entry_type_enum_notes">
3088 The camera device's autoexposure routine is active,<wbr/>
3089 with no flash control.<wbr/> The application's values for
3090 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
3091 android.<wbr/>sensor.<wbr/>sensitivity,<wbr/> and
3092 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are ignored.<wbr/> The
3093 application has control over the various
3094 android.<wbr/>flash.<wbr/>* fields.<wbr/>
3095 </span>
3096 </li>
3097 <li>
3098 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
3099 <span class="entry_type_enum_notes">
3100 Like ON,<wbr/> except that the camera device also controls
3101 the camera's flash unit,<wbr/> firing it in low-light
3102 conditions.<wbr/> The flash may be fired during a
3103 precapture sequence (triggered by
3104 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and may be fired
3105 for captures for which the
3106 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
3107 STILL_<wbr/>CAPTURE
3108 </span>
3109 </li>
3110 <li>
3111 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
3112 <span class="entry_type_enum_notes">
3113 Like ON,<wbr/> except that the camera device also controls
3114 the camera's flash unit,<wbr/> always firing it for still
3115 captures.<wbr/> The flash may be fired during a precapture
3116 sequence (triggered by
3117 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and will always
3118 be fired for captures for which the
3119 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
3120 STILL_<wbr/>CAPTURE
3121 </span>
3122 </li>
3123 <li>
3124 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
3125 <span class="entry_type_enum_notes">
3126 Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
3127 reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
3128 a red eye reduction flash will fire during the
3129 precapture sequence.<wbr/>
3130 </span>
3131 </li>
3132 </ul>
3133
3134 </td> <!-- entry_type -->
3135
3136 <td class="entry_description">
3137 <p>The desired mode for the camera device's
3138auto-exposure routine.<wbr/></p>
3139 </td>
3140
3141 <td class="entry_units">
3142 </td>
3143
3144 <td class="entry_range">
3145 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
3146 </td>
3147
3148 <td class="entry_tags">
3149 <ul class="entry_tags">
3150 <li><a href="#tag_BC">BC</a></li>
3151 </ul>
3152 </td>
3153
3154 </tr>
3155 <tr class="entries_header">
3156 <th class="th_details" colspan="5">Details</th>
3157 </tr>
3158 <tr class="entry_cont">
3159 <td class="entry_details" colspan="5">
3160 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
3161AUTO.<wbr/></p>
3162<p>When set to any of the ON modes,<wbr/> the camera device's
3163auto-exposure routine is enabled,<wbr/> overriding the
3164application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
3165and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3166<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3167<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
3168is selected,<wbr/> the camera device's flash unit controls are
3169also overridden.<wbr/></p>
3170<p>The FLASH modes are only available if the camera device
3171has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
3172<p>If flash TORCH mode is desired,<wbr/> this field must be set to
3173ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
3174<p>When set to any of the ON modes,<wbr/> the values chosen by the
3175camera device auto-exposure routine for the overridden
3176fields for a given capture will be available in its
3177CaptureResult.<wbr/></p>
3178 </td>
3179 </tr>
3180
3181
3182 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3183 <!-- end of entry -->
3184
3185
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3186 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3187 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3188 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3189 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3190 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3191 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3192 <span class="entry_type_container">x</span>
3193
3194 <span class="entry_type_array">
3195 5 x area_count
3196 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3197 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3198
3199
3200 </td> <!-- entry_type -->
3201
3202 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3203 <p>List of areas to use for
3204metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3205 </td>
3206
3207 <td class="entry_units">
3208 </td>
3209
3210 <td class="entry_range">
3211 </td>
3212
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3213 <td class="entry_tags">
3214 <ul class="entry_tags">
3215 <li><a href="#tag_BC">BC</a></li>
3216 </ul>
3217 </td>
3218
3219 </tr>
3220 <tr class="entries_header">
3221 <th class="th_details" colspan="5">Details</th>
3222 </tr>
3223 <tr class="entry_cont">
3224 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3225 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3226xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3227specified coordinates.<wbr/></p>
3228<p>The coordinate system is based on the active pixel array,<wbr/>
3229with (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]3230(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3231<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]3232bottom-right pixel in the active pixel array.<wbr/> The weight
3233should be nonnegative.<wbr/></p>
3234<p>If all regions have 0 weight,<wbr/> then no specific metering area
3235needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3236outside 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]3237should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3238used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3239 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3240 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3241
3242
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3243 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3244 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3245
3246
3247 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3248 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3249 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3250 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3251 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3252 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3253
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3254 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3255
3256 <ul class="entry_type_enum">
3257 <li>
3258 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3259 <span class="entry_type_enum_notes">AE is off.<wbr/> When a camera device is opened,<wbr/> it starts in
3260 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3261 </li>
3262 <li>
3263 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3264 <span class="entry_type_enum_notes">AE doesn't yet have a good set of control values
3265 for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3266 </li>
3267 <li>
3268 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3269 <span class="entry_type_enum_notes">AE has a good set of control values for the
3270 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3271 </li>
3272 <li>
3273 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3274 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3275 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3276 </li>
3277 <li>
3278 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3279 <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]3280 needs to be fired for good quality still
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3281 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3282 </li>
3283 <li>
3284 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3285 <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]3286 (through the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3287 trigger_<wbr/>action(CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING)
3288 call),<wbr/> and is currently executing it.<wbr/> Once PRECAPTURE
3289 completes,<wbr/> AE will transition to CONVERGED or
3290 FLASH_<wbr/>REQUIRED as appropriate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3291 </li>
3292 </ul>
3293
3294 </td> <!-- entry_type -->
3295
3296 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3297 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3298 </td>
3299
3300 <td class="entry_units">
3301 </td>
3302
3303 <td class="entry_range">
3304 </td>
3305
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3306 <td class="entry_tags">
3307 </td>
3308
3309 </tr>
3310 <tr class="entries_header">
3311 <th class="th_details" colspan="5">Details</th>
3312 </tr>
3313 <tr class="entry_cont">
3314 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3315 <p>Whenever the AE algorithm state changes,<wbr/> a
3316MSG_<wbr/>AUTOEXPOSURE notification must be send if a
3317notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3318 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3319 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3320
3321
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3322 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3323 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3324
3325
3326 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3327 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3328 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3329 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3330 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3331 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3332
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3333 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3334
3335 <ul class="entry_type_enum">
3336 <li>
3337 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3338 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
3339 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
3340 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3341 </li>
3342 <li>
3343 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3344 <span class="entry_type_enum_notes">
3345 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3346
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3347 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
3348 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3349 the autofocus trigger action is called.<wbr/> When that trigger
3350 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3351 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3352
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3353 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3354 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3355 </li>
3356 <li>
3357 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3358 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
3359 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3360
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3361 When that trigger is activated,<wbr/> AF must transition to
3362 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3363 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3364 position to default,<wbr/> and sets the AF state to
3365 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3366 </li>
3367 <li>
3368 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3369 <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]3370 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3371 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3372
3373 The focusing behavior should be suitable for good quality
3374 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3375 movement and no overshoots.<wbr/> When the AF trigger is not
3376 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3377 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3378 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3379 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3380 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3381 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3382
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3383 Once cancel is received,<wbr/> the algorithm should transition
3384 back to INACTIVE and resume passive scan.<wbr/> Note that this
3385 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3386 ongoing PASSIVE_<wbr/>SCAN must immediately be
3387 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3388 </li>
3389 <li>
3390 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3391 <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]3392 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3393 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3394
3395 The focusing behavior should be suitable for still image
3396 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3397 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3398 algorithm should start in INACTIVE state,<wbr/> and then
3399 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3400 appropriate as it attempts to maintain focus.<wbr/> When the AF
3401 trigger is activated,<wbr/> the algorithm should finish its
3402 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3403 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3404 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3405
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3406 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3407 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3408 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3409 </li>
3410 <li>
3411 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3412 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
3413 trigger is ignored,<wbr/> AF state should always be
3414 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3415 </li>
3416 </ul>
3417
3418 </td> <!-- entry_type -->
3419
3420 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3421 <p>Whether AF is currently enabled,<wbr/> and what
3422mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3423 </td>
3424
3425 <td class="entry_units">
3426 </td>
3427
3428 <td class="entry_range">
3429 </td>
3430
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3431 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3432 <ul class="entry_tags">
3433 <li><a href="#tag_BC">BC</a></li>
3434 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3435 </td>
3436
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3437 </tr>
3438 <tr class="entries_header">
3439 <th class="th_details" colspan="5">Details</th>
3440 </tr>
3441 <tr class="entry_cont">
3442 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3443 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3444<p>If lens is controlled by HAL auto-focus algorithm,<wbr/> the HAL should
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3445report the current AF status in <a href="#dynamic_android.control.afState">android.<wbr/>control.<wbr/>af<wbr/>State</a> in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3446result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3447 </td>
3448 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3449
3450
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3451 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3452 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3453
3454
3455 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3456 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3457 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3458 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3459 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3460 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3461 <span class="entry_type_container">x</span>
3462
3463 <span class="entry_type_array">
3464 5 x area_count
3465 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3466 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3467
3468
3469 </td> <!-- entry_type -->
3470
3471 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3472 <p>List of areas to use for focus
3473estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3474 </td>
3475
3476 <td class="entry_units">
3477 </td>
3478
3479 <td class="entry_range">
3480 </td>
3481
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3482 <td class="entry_tags">
3483 <ul class="entry_tags">
3484 <li><a href="#tag_BC">BC</a></li>
3485 </ul>
3486 </td>
3487
3488 </tr>
3489 <tr class="entries_header">
3490 <th class="th_details" colspan="5">Details</th>
3491 </tr>
3492 <tr class="entry_cont">
3493 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3494 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3495xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3496specified coordinates.<wbr/></p>
3497<p>The coordinate system is based on the active pixel array,<wbr/>
3498with (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]3499(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3500<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]3501bottom-right pixel in the active pixel array.<wbr/> The weight
3502should be nonnegative.<wbr/></p>
3503<p>If all regions have 0 weight,<wbr/> then no specific focus area
3504needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3505outside 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]3506should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3507used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3508 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3509 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3510
3511
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3512 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3513 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3514
3515
3516 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3517 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3518 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3519 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3520 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3521 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3522
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3523 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3524
3525 <ul class="entry_type_enum">
3526 <li>
3527 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3528 <span class="entry_type_enum_notes">AF off or has not yet tried to scan/<wbr/>been asked
3529 to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3530 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3531 </li>
3532 <li>
3533 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3534 <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]3535 currently doing an AF scan initiated by a continuous
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3536 autofocus mode</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3537 </li>
3538 <li>
3539 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3540 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3541 believes it is in focus,<wbr/> but may restart scanning at
3542 any time.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3543 </li>
3544 <li>
3545 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3546 <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]3547 an AF scan because it was triggered by AF
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3548 trigger</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3549 </li>
3550 <li>
3551 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3552 <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]3553 believes it is focused correctly and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3554 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3555 </li>
3556 <li>
3557 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3558 <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]3559 failed to focus successfully and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3560 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3561 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3562 <li>
3563 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3564 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3565 passive scan without finding focus,<wbr/> and may restart
3566 scanning at any time.<wbr/></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3567 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3568 </ul>
3569
3570 </td> <!-- entry_type -->
3571
3572 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3573 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3574 </td>
3575
3576 <td class="entry_units">
3577 </td>
3578
3579 <td class="entry_range">
3580 </td>
3581
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3582 <td class="entry_tags">
3583 </td>
3584
3585 </tr>
3586 <tr class="entries_header">
3587 <th class="th_details" colspan="5">Details</th>
3588 </tr>
3589 <tr class="entry_cont">
3590 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3591 <p>Whenever the AF algorithm state changes,<wbr/> a
3592MSG_<wbr/>AUTOFOCUS notification must be send if a notification
3593callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3594 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3595 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3596
3597
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3598 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3599 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3600
3601
3602 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3603 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3604 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3605 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3606 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3607 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3608
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3609 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3610
3611
3612 </td> <!-- entry_type -->
3613
3614 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3615 <p>The ID sent with the latest
3616CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3617 </td>
3618
3619 <td class="entry_units">
3620 </td>
3621
3622 <td class="entry_range">
3623 </td>
3624
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3625 <td class="entry_tags">
3626 </td>
3627
3628 </tr>
3629 <tr class="entries_header">
3630 <th class="th_details" colspan="5">Details</th>
3631 </tr>
3632 <tr class="entry_cont">
3633 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3634 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
3635received yet by HAL.<wbr/> Always updated even if AF algorithm
3636ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3637 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3638 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3639
3640
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3641 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3642 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3643
3644
3645 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3646 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3647 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3648 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3649 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3650 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3651
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3652 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3653
3654 <ul class="entry_type_enum">
3655 <li>
3656 <span class="entry_type_enum_name">OFF</span>
3657 </li>
3658 <li>
3659 <span class="entry_type_enum_name">AUTO</span>
3660 </li>
3661 <li>
3662 <span class="entry_type_enum_name">INCANDESCENT</span>
3663 </li>
3664 <li>
3665 <span class="entry_type_enum_name">FLUORESCENT</span>
3666 </li>
3667 <li>
3668 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
3669 </li>
3670 <li>
3671 <span class="entry_type_enum_name">DAYLIGHT</span>
3672 </li>
3673 <li>
3674 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
3675 </li>
3676 <li>
3677 <span class="entry_type_enum_name">TWILIGHT</span>
3678 </li>
3679 <li>
3680 <span class="entry_type_enum_name">SHADE</span>
3681 </li>
3682 </ul>
3683
3684 </td> <!-- entry_type -->
3685
3686 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3687 <p>Whether AWB is currently setting the color
3688transform fields,<wbr/> and what its illumination target
3689is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3690 </td>
3691
3692 <td class="entry_units">
3693 </td>
3694
3695 <td class="entry_range">
3696 </td>
3697
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3698 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3699 <ul class="entry_tags">
3700 <li><a href="#tag_BC">BC</a></li>
3701 <li><a href="#tag_AWB">AWB</a></li>
3702 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3703 </td>
3704
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3705 </tr>
3706 <tr class="entries_header">
3707 <th class="th_details" colspan="5">Details</th>
3708 </tr>
3709 <tr class="entry_cont">
3710 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3711 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3712<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]3713 </td>
3714 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3715
3716
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3717 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3718 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3719
3720
3721 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3722 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3723 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3724 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3725 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3726 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3727 <span class="entry_type_container">x</span>
3728
3729 <span class="entry_type_array">
3730 5 x area_count
3731 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3732 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3733
3734
3735 </td> <!-- entry_type -->
3736
3737 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3738 <p>List of areas to use for illuminant
3739estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3740 </td>
3741
3742 <td class="entry_units">
3743 </td>
3744
3745 <td class="entry_range">
3746 </td>
3747
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3748 <td class="entry_tags">
3749 <ul class="entry_tags">
3750 <li><a href="#tag_BC">BC</a></li>
3751 </ul>
3752 </td>
3753
3754 </tr>
3755 <tr class="entries_header">
3756 <th class="th_details" colspan="5">Details</th>
3757 </tr>
3758 <tr class="entry_cont">
3759 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3760 <p>Only used in AUTO mode.<wbr/></p>
3761<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3762xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3763specified coordinates.<wbr/></p>
3764<p>The coordinate system is based on the active pixel array,<wbr/>
3765with (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]3766(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3767<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]3768bottom-right pixel in the active pixel array.<wbr/> The weight
3769should be nonnegative.<wbr/></p>
3770<p>If all regions have 0 weight,<wbr/> then no specific metering area
3771needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3772outside 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]3773should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3774used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3775 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3776 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3777
3778
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3779 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3780 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3781
3782
3783 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3784 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3785 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3786 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3787 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3788 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3789
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3790 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3791
3792 <ul class="entry_type_enum">
3793 <li>
3794 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3795 <span class="entry_type_enum_notes">AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
3796 starts in this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3797 </li>
3798 <li>
3799 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3800 <span class="entry_type_enum_notes">AWB doesn't yet have a good set of control
3801 values for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3802 </li>
3803 <li>
3804 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3805 <span class="entry_type_enum_notes">AWB has a good set of control values for the
3806 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3807 </li>
3808 <li>
3809 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3810 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3811 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3812 </li>
3813 </ul>
3814
3815 </td> <!-- entry_type -->
3816
3817 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3818 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3819 </td>
3820
3821 <td class="entry_units">
3822 </td>
3823
3824 <td class="entry_range">
3825 </td>
3826
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3827 <td class="entry_tags">
3828 </td>
3829
3830 </tr>
3831 <tr class="entries_header">
3832 <th class="th_details" colspan="5">Details</th>
3833 </tr>
3834 <tr class="entry_cont">
3835 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3836 <p>Whenever the AWB algorithm state changes,<wbr/> a
3837MSG_<wbr/>AUTOWHITEBALANCE notification must be send if a
3838notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3839 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3840 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3841
3842
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3843 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3844 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3845
3846
3847 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3848 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3849 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3850 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3851 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3852 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3853
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3854 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3855
3856 <ul class="entry_type_enum">
3857 <li>
3858 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3859 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
3860 routines are disabled,<wbr/> no other settings in
3861 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3862 </li>
3863 <li>
3864 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3865 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
3866 Manual control of capture parameters is disabled.<wbr/> All
3867 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
3868 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3869 </li>
3870 <li>
3871 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3872 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
3873 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3874 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3875 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
3876 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3877 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3878 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3879 </li>
3880 </ul>
3881
3882 </td> <!-- entry_type -->
3883
3884 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3885 <p>Overall mode of 3A control
3886routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3887 </td>
3888
3889 <td class="entry_units">
3890 </td>
3891
3892 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3893 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3894 </td>
3895
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3896 <td class="entry_tags">
3897 <ul class="entry_tags">
3898 <li><a href="#tag_BC">BC</a></li>
3899 </ul>
3900 </td>
3901
3902 </tr>
3903 <tr class="entries_header">
3904 <th class="th_details" colspan="5">Details</th>
3905 </tr>
3906 <tr class="entry_cont">
3907 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3908 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
3909by the HAL is disabled.<wbr/> The application must set the fields for
3910capture parameters itself.<wbr/></p>
3911<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3912android.<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]3913<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
3914android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
3915one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
3916as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3917<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]3918 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3919 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3920
3921
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3922 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3923 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3924
3925
3926
3927 <!-- end of kind -->
3928 </tbody>
3929
3930 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3931 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3932
3933
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3934 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3935
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3936 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3937 <tr>
3938 <th class="th_name">Property Name</th>
3939 <th class="th_type">Type</th>
3940 <th class="th_description">Description</th>
3941 <th class="th_units">Units</th>
3942 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3943 <th class="th_tags">Tags</th>
3944 </tr>
3945 </thead>
3946
3947 <tbody>
3948
3949
3950
3951
3952
3953
3954
3955
3956
3957
3958 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3959 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3960 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3961 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3962 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3963 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3964
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3965 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3966
3967 <ul class="entry_type_enum">
3968 <li>
3969 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3970 <span class="entry_type_enum_notes">Minimal or no slowdown of frame rate compared to
3971 Bayer RAW output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3972 </li>
3973 <li>
3974 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3975 <span class="entry_type_enum_notes">High-quality may reduce output frame
3976 rate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3977 </li>
3978 </ul>
3979
3980 </td> <!-- entry_type -->
3981
3982 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3983 <p>Controls the quality of the demosaicing
3984processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3985 </td>
3986
3987 <td class="entry_units">
3988 </td>
3989
3990 <td class="entry_range">
3991 </td>
3992
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3993 <td class="entry_tags">
3994 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3995 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3996 </ul>
3997 </td>
3998
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3999 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4000
4001
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4002 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4003 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4004
4005
4006
4007 <!-- end of kind -->
4008 </tbody>
4009
4010 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4011 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4012
4013
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4014 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4015
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4016 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4017 <tr>
4018 <th class="th_name">Property Name</th>
4019 <th class="th_type">Type</th>
4020 <th class="th_description">Description</th>
4021 <th class="th_units">Units</th>
4022 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4023 <th class="th_tags">Tags</th>
4024 </tr>
4025 </thead>
4026
4027 <tbody>
4028
4029
4030
4031
4032
4033
4034
4035
4036
4037
4038 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4039 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4040 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4041 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4042 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4043 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4044
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4045 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4046
4047 <ul class="entry_type_enum">
4048 <li>
4049 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4050 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4051 </li>
4052 <li>
4053 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4054 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
4055 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4056 </li>
4057 <li>
4058 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4059 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4060 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4061 </li>
4062 </ul>
4063
4064 </td> <!-- entry_type -->
4065
4066 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4067 <p>Operation mode for edge
4068enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4069 </td>
4070
4071 <td class="entry_units">
4072 </td>
4073
4074 <td class="entry_range">
4075 </td>
4076
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4077 <td class="entry_tags">
4078 </td>
4079
4080 </tr>
4081 <tr class="entries_header">
4082 <th class="th_details" colspan="5">Details</th>
4083 </tr>
4084 <tr class="entry_cont">
4085 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4086 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4087enhancement will be applied by the HAL.<wbr/></p>
4088<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
4089will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
4090HAL should use the highest-quality enhancement algorithms,<wbr/>
4091even if it slows down capture rate.<wbr/> FAST means the HAL should
4092not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4093 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4094 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4095
4096
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4097 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4098 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4099
4100
4101 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4102 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4103 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4104 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4105 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4106 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4107
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4108 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4109
4110
4111 </td> <!-- entry_type -->
4112
4113 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4114 <p>Control the amount of edge enhancement
4115applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4116 </td>
4117
4118 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4119 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4120 </td>
4121
4122 <td class="entry_range">
4123 </td>
4124
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4125 <td class="entry_tags">
4126 </td>
4127
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4128 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4129
4130
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4131 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4132 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4133
4134
4135
4136 <!-- end of kind -->
4137 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4138 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4139
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4140 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4141 <tr>
4142 <th class="th_name">Property Name</th>
4143 <th class="th_type">Type</th>
4144 <th class="th_description">Description</th>
4145 <th class="th_units">Units</th>
4146 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4147 <th class="th_tags">Tags</th>
4148 </tr>
4149 </thead>
4150
4151 <tbody>
4152
4153
4154
4155
4156
4157
4158
4159
4160
4161
4162 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4163 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4164 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4165 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4166 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4167 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4168
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4169 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4170
4171 <ul class="entry_type_enum">
4172 <li>
4173 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4174 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4175 </li>
4176 <li>
4177 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4178 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
4179 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4180 </li>
4181 <li>
4182 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4183 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4184 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4185 </li>
4186 </ul>
4187
4188 </td> <!-- entry_type -->
4189
4190 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4191 <p>Operation mode for edge
4192enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4193 </td>
4194
4195 <td class="entry_units">
4196 </td>
4197
4198 <td class="entry_range">
4199 </td>
4200
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4201 <td class="entry_tags">
4202 </td>
4203
4204 </tr>
4205 <tr class="entries_header">
4206 <th class="th_details" colspan="5">Details</th>
4207 </tr>
4208 <tr class="entry_cont">
4209 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4210 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4211enhancement will be applied by the HAL.<wbr/></p>
4212<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
4213will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
4214HAL should use the highest-quality enhancement algorithms,<wbr/>
4215even if it slows down capture rate.<wbr/> FAST means the HAL should
4216not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4217 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4218 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4219
4220
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4221 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4222 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4223
4224
4225
4226 <!-- end of kind -->
4227 </tbody>
4228
4229 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4230 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4231
4232
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4233 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4234
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4235 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4236 <tr>
4237 <th class="th_name">Property Name</th>
4238 <th class="th_type">Type</th>
4239 <th class="th_description">Description</th>
4240 <th class="th_units">Units</th>
4241 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4242 <th class="th_tags">Tags</th>
4243 </tr>
4244 </thead>
4245
4246 <tbody>
4247
4248
4249
4250
4251
4252
4253
4254
4255
4256
4257 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4258 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4259 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4260 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4261 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4262 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4263
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4264 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4265
4266
4267 </td> <!-- entry_type -->
4268
4269 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4270 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4271 </td>
4272
4273 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4274 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4275 </td>
4276
4277 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4278 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4279 </td>
4280
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4281 <td class="entry_tags">
4282 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4283 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4284 </ul>
4285 </td>
4286
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4287 </tr>
4288 <tr class="entries_header">
4289 <th class="th_details" colspan="5">Details</th>
4290 </tr>
4291 <tr class="entry_cont">
4292 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4293 <p>Power for snapshot may use a different scale than
4294for torch mode.<wbr/> Only one entry for torch mode will be
4295used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4296 </td>
4297 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4298
4299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4300 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4301 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4302
4303
4304 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4305 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4306 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4307 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4308 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4309 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4310
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4311 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4312
4313
4314 </td> <!-- entry_type -->
4315
4316 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4317 <p>Firing time of flash relative to start of
4318exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4319 </td>
4320
4321 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4322 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4323 </td>
4324
4325 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4326 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4327 </td>
4328
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4329 <td class="entry_tags">
4330 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4331 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4332 </ul>
4333 </td>
4334
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4335 </tr>
4336 <tr class="entries_header">
4337 <th class="th_details" colspan="5">Details</th>
4338 </tr>
4339 <tr class="entry_cont">
4340 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4341 <p>Clamped to (0,<wbr/> exposure time - flash
4342duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4343 </td>
4344 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4345
4346
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4347 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4348 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4349
4350
4351 <tr class="entry" id="controls_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4352 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4353 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4354 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4355 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4356 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4357
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4358 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4359
4360 <ul class="entry_type_enum">
4361 <li>
4362 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4363 <span class="entry_type_enum_notes">Do not fire the flash for this
4364 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4365 </li>
4366 <li>
4367 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4368 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4369 for this capture based on firingPower,<wbr/>
4370 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4371 </li>
4372 <li>
4373 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4374 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4375 continuously on,<wbr/> power set by
4376 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4377 </li>
4378 </ul>
4379
4380 </td> <!-- entry_type -->
4381
4382 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4383 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4384 </td>
4385
4386 <td class="entry_units">
4387 </td>
4388
4389 <td class="entry_range">
4390 </td>
4391
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4392 <td class="entry_tags">
4393 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4394 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4395 </ul>
4396 </td>
4397
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4398 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4399
4400
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4401 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4402 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4403
4404
4405
4406 <!-- end of kind -->
4407 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4408 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4409
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4410 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4411 <tr>
4412 <th class="th_name">Property Name</th>
4413 <th class="th_type">Type</th>
4414 <th class="th_description">Description</th>
4415 <th class="th_units">Units</th>
4416 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4417 <th class="th_tags">Tags</th>
4418 </tr>
4419 </thead>
4420
4421 <tbody>
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432
4433
4434 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4435 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4436 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4437 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4438 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4439 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4440
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4441 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4442
4443
4444 </td> <!-- entry_type -->
4445
4446 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4447 <p>Whether this camera has a
4448flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4449 </td>
4450
4451 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4452 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4453 </td>
4454
4455 <td class="entry_range">
4456 </td>
4457
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4458 <td class="entry_tags">
4459 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4460 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4461 </ul>
4462 </td>
4463
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4464 </tr>
4465 <tr class="entries_header">
4466 <th class="th_details" colspan="5">Details</th>
4467 </tr>
4468 <tr class="entry_cont">
4469 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4470 <p>If no flash,<wbr/> none of the flash controls do
4471anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4472 </td>
4473 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4474
4475
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4476 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4477 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4478
4479
4480 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4481 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4482 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4483 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4484 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4485 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4486
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4487 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4488
4489
4490 </td> <!-- entry_type -->
4491
4492 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4493 <p>Time taken before flash can fire
4494again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4495 </td>
4496
4497 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4498 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4499 </td>
4500
4501 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4502 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4503 </td>
4504
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4505 <td class="entry_tags">
4506 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4507 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4508 </ul>
4509 </td>
4510
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4511 </tr>
4512 <tr class="entries_header">
4513 <th class="th_details" colspan="5">Details</th>
4514 </tr>
4515 <tr class="entry_cont">
4516 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4517 <p>1 second too long/<wbr/>too short for recharge? Should
4518this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4519 </td>
4520 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4521
4522
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4523 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4524 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4525
4526
4527
4528
4529
4530 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4531 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4532 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4533 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4534 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4535 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4536
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4537 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4538
4539
4540 </td> <!-- entry_type -->
4541
4542 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4543 <p>The x,<wbr/>y whitepoint of the
4544flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4545 </td>
4546
4547 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4548 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4549 </td>
4550
4551 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4552 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4553 </td>
4554
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4555 <td class="entry_tags">
4556 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4557 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4558 </ul>
4559 </td>
4560
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4561 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4562
4563
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4564 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4565 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4566
4567
4568 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4569 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4570 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4571 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4572 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4573 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4574
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4575 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4576
4577
4578 </td> <!-- entry_type -->
4579
4580 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4581 <p>Max energy output of the flash for a full
4582power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4583 </td>
4584
4585 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4586 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4587 </td>
4588
4589 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4590 <blockquote>
4591<p>= 0</p>
4592</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4593 </td>
4594
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4595 <td class="entry_tags">
4596 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4597 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4598 </ul>
4599 </td>
4600
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4601 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4602
4603
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4604 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4605 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4606
4607
4608
4609 <!-- end of kind -->
4610 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4611 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4612
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4613 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4614 <tr>
4615 <th class="th_name">Property Name</th>
4616 <th class="th_type">Type</th>
4617 <th class="th_description">Description</th>
4618 <th class="th_units">Units</th>
4619 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4620 <th class="th_tags">Tags</th>
4621 </tr>
4622 </thead>
4623
4624 <tbody>
4625
4626
4627
4628
4629
4630
4631
4632
4633
4634
4635 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4636 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4637 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4638 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4639 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4640 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4641
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4642 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4643
4644
4645 </td> <!-- entry_type -->
4646
4647 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4648 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4649 </td>
4650
4651 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4652 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4653 </td>
4654
4655 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4656 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4657 </td>
4658
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4659 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4660 <ul class="entry_tags">
4661 <li><a href="#tag_V1">V1</a></li>
4662 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4663 </td>
4664
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4665 </tr>
4666 <tr class="entries_header">
4667 <th class="th_details" colspan="5">Details</th>
4668 </tr>
4669 <tr class="entry_cont">
4670 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4671 <p>Power for snapshot may use a different scale than
4672for torch mode.<wbr/> Only one entry for torch mode will be
4673used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4674 </td>
4675 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4676
4677
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4678 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4679 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4680
4681
4682 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4683 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4684 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4685 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4686 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4687 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4688
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4689 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4690
4691
4692 </td> <!-- entry_type -->
4693
4694 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4695 <p>Firing time of flash relative to start of
4696exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4697 </td>
4698
4699 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4700 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4701 </td>
4702
4703 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4704 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4705 </td>
4706
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4707 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4708 <ul class="entry_tags">
4709 <li><a href="#tag_V1">V1</a></li>
4710 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4711 </td>
4712
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4713 </tr>
4714 <tr class="entries_header">
4715 <th class="th_details" colspan="5">Details</th>
4716 </tr>
4717 <tr class="entry_cont">
4718 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4719 <p>Clamped to (0,<wbr/> exposure time - flash
4720duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4721 </td>
4722 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4723
4724
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4725 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4726 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4727
4728
4729 <tr class="entry" id="dynamic_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4730 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4731 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4732 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4733 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4734 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4735
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4736 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4737
4738 <ul class="entry_type_enum">
4739 <li>
4740 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4741 <span class="entry_type_enum_notes">Do not fire the flash for this
4742 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4743 </li>
4744 <li>
4745 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4746 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4747 for this capture based on firingPower,<wbr/>
4748 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4749 </li>
4750 <li>
4751 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4752 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4753 continuously on,<wbr/> power set by
4754 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4755 </li>
4756 </ul>
4757
4758 </td> <!-- entry_type -->
4759
4760 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4761 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4762 </td>
4763
4764 <td class="entry_units">
4765 </td>
4766
4767 <td class="entry_range">
4768 </td>
4769
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4770 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4771 <ul class="entry_tags">
4772 <li><a href="#tag_BC">BC</a></li>
4773 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4774 </td>
4775
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4776 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4777
4778
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4779 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4780 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4781
4782
4783 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4784 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4785 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4786 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4787 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4788 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4789
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4790 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4791
4792 <ul class="entry_type_enum">
4793 <li>
4794 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4795 <span class="entry_type_enum_notes">No flash on camera</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4796 </li>
4797 <li>
4798 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4799 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4800 charging and cannot be fired</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4801 </li>
4802 <li>
4803 <span class="entry_type_enum_name">READY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4804 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4805 ready to fire</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4806 </li>
4807 <li>
4808 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4809 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash fired
4810 for this capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4811 </li>
4812 </ul>
4813
4814 </td> <!-- entry_type -->
4815
4816 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4817 <p>Current state of the flash
4818unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4819 </td>
4820
4821 <td class="entry_units">
4822 </td>
4823
4824 <td class="entry_range">
4825 </td>
4826
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4827 <td class="entry_tags">
4828 </td>
4829
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4830 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4831
4832
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4833 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4834 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4835
4836
4837
4838 <!-- end of kind -->
4839 </tbody>
4840
4841 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4842 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4843
4844
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4845 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4846
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4847 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4848 <tr>
4849 <th class="th_name">Property Name</th>
4850 <th class="th_type">Type</th>
4851 <th class="th_description">Description</th>
4852 <th class="th_units">Units</th>
4853 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4854 <th class="th_tags">Tags</th>
4855 </tr>
4856 </thead>
4857
4858 <tbody>
4859
4860
4861
4862
4863
4864
4865
4866
4867
4868
4869 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4870 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4871 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4872 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4873 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4874 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4875
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4876 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4877
4878 <ul class="entry_type_enum">
4879 <li>
4880 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4881 <span class="entry_type_enum_notes">No geometric correction is
4882 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4883 </li>
4884 <li>
4885 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4886 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
4887 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4888 </li>
4889 <li>
4890 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4891 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4892 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4893 </li>
4894 </ul>
4895
4896 </td> <!-- entry_type -->
4897
4898 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4899 <p>Operating mode of geometric
4900correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4901 </td>
4902
4903 <td class="entry_units">
4904 </td>
4905
4906 <td class="entry_range">
4907 </td>
4908
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4909 <td class="entry_tags">
4910 </td>
4911
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4912 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4913
4914
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4915 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4916 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4917
4918
4919 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4920 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4921 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4922 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4923 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4924 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4925
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4926 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4927
4928
4929 </td> <!-- entry_type -->
4930
4931 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4932 <p>Control the amount of shading correction
4933applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4934 </td>
4935
4936 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4937 unitless: 1-10; 10 is full shading
4938 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4939 </td>
4940
4941 <td class="entry_range">
4942 </td>
4943
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4944 <td class="entry_tags">
4945 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4946 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4947 </ul>
4948 </td>
4949
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4950 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4951
4952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4953 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4954 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4955
4956
4957
4958 <!-- end of kind -->
4959 </tbody>
4960
4961 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4962 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4963
4964
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4965 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4966
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4967 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4968 <tr>
4969 <th class="th_name">Property Name</th>
4970 <th class="th_type">Type</th>
4971 <th class="th_description">Description</th>
4972 <th class="th_units">Units</th>
4973 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4974 <th class="th_tags">Tags</th>
4975 </tr>
4976 </thead>
4977
4978 <tbody>
4979
4980
4981
4982
4983
4984
4985
4986
4987
4988
4989 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4990 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4991 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4992 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4993 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4994 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4995
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4996 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4997
4998 <ul class="entry_type_enum">
4999 <li>
5000 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5001 <span class="entry_type_enum_notes">No hot pixel correction can be
5002 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5003 </li>
5004 <li>
5005 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5006 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
5007 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5008 </li>
5009 <li>
5010 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5011 <span class="entry_type_enum_notes">Frame rate may be reduced by high
5012 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5013 </li>
5014 </ul>
5015
5016 </td> <!-- entry_type -->
5017
5018 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5019 <p>Set operational mode for hot pixel
5020correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5021 </td>
5022
5023 <td class="entry_units">
5024 </td>
5025
5026 <td class="entry_range">
5027 </td>
5028
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5029 <td class="entry_tags">
5030 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5031 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5032 </ul>
5033 </td>
5034
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5035 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5036
5037
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5038 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5039 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5040
5041
5042
5043 <!-- end of kind -->
5044 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5045 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5046
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5047 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5048 <tr>
5049 <th class="th_name">Property Name</th>
5050 <th class="th_type">Type</th>
5051 <th class="th_description">Description</th>
5052 <th class="th_units">Units</th>
5053 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5054 <th class="th_tags">Tags</th>
5055 </tr>
5056 </thead>
5057
5058 <tbody>
5059
5060
5061
5062
5063
5064
5065
5066
5067
5068
5069
5070
5071 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5072 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5073 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5074 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5075 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5076 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5077 <span class="entry_type_container">x</span>
5078
5079 <span class="entry_type_array">
5080 2 x n
5081 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5082 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5083 <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]5084
5085
5086 </td> <!-- entry_type -->
5087
5088 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5089 <p>Location of hot/<wbr/>defective pixels on
5090sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5091 </td>
5092
5093 <td class="entry_units">
5094 </td>
5095
5096 <td class="entry_range">
5097 </td>
5098
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5099 <td class="entry_tags">
5100 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5101 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5102 </ul>
5103 </td>
5104
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5105 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5106
5107
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5108 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5109 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5110
5111
5112
5113
5114
5115
5116 <!-- end of kind -->
5117 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5118 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5119
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5120 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5121 <tr>
5122 <th class="th_name">Property Name</th>
5123 <th class="th_type">Type</th>
5124 <th class="th_description">Description</th>
5125 <th class="th_units">Units</th>
5126 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5127 <th class="th_tags">Tags</th>
5128 </tr>
5129 </thead>
5130
5131 <tbody>
5132
5133
5134
5135
5136
5137
5138
5139
5140
5141
5142 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5143 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5144 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5145 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5146 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5147 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5148
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5149 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5150
5151 <ul class="entry_type_enum">
5152 <li>
5153 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5154 <span class="entry_type_enum_notes">No hot pixel correction can be
5155 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5156 </li>
5157 <li>
5158 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5159 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
5160 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5161 </li>
5162 <li>
5163 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5164 <span class="entry_type_enum_notes">Frame rate may be reduced by high
5165 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5166 </li>
5167 </ul>
5168
5169 </td> <!-- entry_type -->
5170
5171 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5172 <p>Set operational mode for hot pixel
5173correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5174 </td>
5175
5176 <td class="entry_units">
5177 </td>
5178
5179 <td class="entry_range">
5180 </td>
5181
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5182 <td class="entry_tags">
5183 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5184 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5185 </ul>
5186 </td>
5187
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5188 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5189
5190
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5191 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5192 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5193
5194
5195
5196 <!-- end of kind -->
5197 </tbody>
5198
5199 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5200 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5201
5202
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5203 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5204
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5205 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5206 <tr>
5207 <th class="th_name">Property Name</th>
5208 <th class="th_type">Type</th>
5209 <th class="th_description">Description</th>
5210 <th class="th_units">Units</th>
5211 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5212 <th class="th_tags">Tags</th>
5213 </tr>
5214 </thead>
5215
5216 <tbody>
5217
5218
5219
5220
5221
5222
5223
5224
5225
5226
5227 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5228 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5229 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5230 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5231 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5232 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5233 <span class="entry_type_container">x</span>
5234
5235 <span class="entry_type_array">
5236 3
5237 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5238 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5239 <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]5240
5241
5242 </td> <!-- entry_type -->
5243
5244 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5245 <p>GPS coordinates to include in output JPEG
5246EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5247 </td>
5248
5249 <td class="entry_units">
5250 </td>
5251
5252 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5253 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5254 </td>
5255
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5256 <td class="entry_tags">
5257 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5258 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5259 </ul>
5260 </td>
5261
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5262 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5263
5264
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5265 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5266 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5267
5268
5269 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5270 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5271 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5272 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5273 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5274 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5275
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5276 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5277
5278
5279 </td> <!-- entry_type -->
5280
5281 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5282 <p>32 characters describing GPS algorithm to
5283include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5284 </td>
5285
5286 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5287 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5288 </td>
5289
5290 <td class="entry_range">
5291 </td>
5292
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5293 <td class="entry_tags">
5294 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5295 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5296 </ul>
5297 </td>
5298
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5299 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5300
5301
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5302 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5303 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5304
5305
5306 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5307 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5308 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5309 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5310 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5311 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5312
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5313 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5314
5315
5316 </td> <!-- entry_type -->
5317
5318 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5319 <p>Time GPS fix was made to include in
5320EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5321 </td>
5322
5323 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5324 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5325 </td>
5326
5327 <td class="entry_range">
5328 </td>
5329
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5330 <td class="entry_tags">
5331 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5332 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5333 </ul>
5334 </td>
5335
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5336 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5337
5338
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5339 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5340 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5341
5342
5343 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5344 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5345 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5346 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5347 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5348 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5349
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5350 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5351
5352
5353 </td> <!-- entry_type -->
5354
5355 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5356 <p>Orientation of JPEG image to
5357write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5358 </td>
5359
5360 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5361 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5362 </td>
5363
5364 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5365 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5366 </td>
5367
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5368 <td class="entry_tags">
5369 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5370 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5371 </ul>
5372 </td>
5373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5374 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5375
5376
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5377 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5378 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5379
5380
5381 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5382 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5383 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5384 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5385 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5386 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5387
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5388 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5389
5390
5391 </td> <!-- entry_type -->
5392
5393 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5394 <p>Compression quality of the final JPEG
5395image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5396 </td>
5397
5398 <td class="entry_units">
5399 </td>
5400
5401 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5402 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5403 </td>
5404
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5405 <td class="entry_tags">
5406 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5407 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5408 </ul>
5409 </td>
5410
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5411 </tr>
5412 <tr class="entries_header">
5413 <th class="th_details" colspan="5">Details</th>
5414 </tr>
5415 <tr class="entry_cont">
5416 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5417 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5418 </td>
5419 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5420
5421
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5422 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5423 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5424
5425
5426 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5427 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5428 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5429 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5430 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5431 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5432
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5433 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5434
5435
5436 </td> <!-- entry_type -->
5437
5438 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5439 <p>Compression quality of JPEG
5440thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5441 </td>
5442
5443 <td class="entry_units">
5444 </td>
5445
5446 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5447 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5448 </td>
5449
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5450 <td class="entry_tags">
5451 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5452 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5453 </ul>
5454 </td>
5455
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5456 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5457
5458
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5459 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5460 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5461
5462
5463 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5464 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5465 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5466 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5467 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5468 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5469 <span class="entry_type_container">x</span>
5470
5471 <span class="entry_type_array">
5472 2
5473 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5474 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5475
5476
5477 </td> <!-- entry_type -->
5478
5479 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5480 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5481 </td>
5482
5483 <td class="entry_units">
5484 </td>
5485
5486 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5487 <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]5488 </td>
5489
5490 <td class="entry_tags">
5491 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5492 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5493 </ul>
5494 </td>
5495
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5496 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5497 <tr class="entries_header">
5498 <th class="th_details" colspan="5">Details</th>
5499 </tr>
5500 <tr class="entry_cont">
5501 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5502 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5503but the captured JPEG must still be a valid image.<wbr/></p>
5504<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5505the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5506 </td>
5507 </tr>
5508
5509
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5510 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5511 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5512
5513
5514
5515 <!-- end of kind -->
5516 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5517 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5518
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5519 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5520 <tr>
5521 <th class="th_name">Property Name</th>
5522 <th class="th_type">Type</th>
5523 <th class="th_description">Description</th>
5524 <th class="th_units">Units</th>
5525 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5526 <th class="th_tags">Tags</th>
5527 </tr>
5528 </thead>
5529
5530 <tbody>
5531
5532
5533
5534
5535
5536
5537
5538
5539
5540
5541 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5542 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5543 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5544 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5545 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5546 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5547 <span class="entry_type_container">x</span>
5548
5549 <span class="entry_type_array">
5550 2 x n
5551 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5552 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5553
5554
5555 </td> <!-- entry_type -->
5556
5557 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5558 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5559 </td>
5560
5561 <td class="entry_units">
5562 </td>
5563
5564 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5565 <p>Must include at least one valid resolution,<wbr/> plus
5566(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]5567 </td>
5568
5569 <td class="entry_tags">
5570 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5571 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5572 </ul>
5573 </td>
5574
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5575 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5576 <tr class="entries_header">
5577 <th class="th_details" colspan="5">Details</th>
5578 </tr>
5579 <tr class="entry_cont">
5580 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5581 <p>Below condiditions must be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5582<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5583<li>The sizes must be sorted by increasing pixel area (width x height).<wbr/>
5584If 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]5585<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]5586aspect 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]5587The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5588in a given size list.<wbr/></li>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5589<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]5590one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
5591and vice versa.<wbr/></li>
5592<li>All non (0,<wbr/> 0) sizes must have non-zero widths and heights.<wbr/></li>
5593</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5594 </td>
5595 </tr>
5596
5597
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5598 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5599 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5600
5601
5602 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5603 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5604 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5605 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5606 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5607 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5608
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5609 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5610
5611
5612 </td> <!-- entry_type -->
5613
5614 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5615 <p>Maximum size in bytes for the compressed
5616JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5617 </td>
5618
5619 <td class="entry_units">
5620 </td>
5621
5622 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5623 <p>Must be large enough to fit any JPEG produced by
5624the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5625 </td>
5626
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5627 <td class="entry_tags">
5628 </td>
5629
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5630 </tr>
5631 <tr class="entries_header">
5632 <th class="th_details" colspan="5">Details</th>
5633 </tr>
5634 <tr class="entry_cont">
5635 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5636 <p>This is used for sizing the gralloc buffers for
5637JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5638 </td>
5639 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5640
5641
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5642 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5643 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5644
5645
5646
5647 <!-- end of kind -->
5648 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5649 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5650
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5651 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5652 <tr>
5653 <th class="th_name">Property Name</th>
5654 <th class="th_type">Type</th>
5655 <th class="th_description">Description</th>
5656 <th class="th_units">Units</th>
5657 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5658 <th class="th_tags">Tags</th>
5659 </tr>
5660 </thead>
5661
5662 <tbody>
5663
5664
5665
5666
5667
5668
5669
5670
5671
5672
5673 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5674 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5675 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5676 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5677 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5678 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5679 <span class="entry_type_container">x</span>
5680
5681 <span class="entry_type_array">
5682 3
5683 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5684 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5685 <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]5686
5687
5688 </td> <!-- entry_type -->
5689
5690 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5691 <p>GPS coordinates to include in output JPEG
5692EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5693 </td>
5694
5695 <td class="entry_units">
5696 </td>
5697
5698 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5699 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5700 </td>
5701
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5702 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5703 <ul class="entry_tags">
5704 <li><a href="#tag_BC">BC</a></li>
5705 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5706 </td>
5707
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5708 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5709
5710
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5711 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5712 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5713
5714
5715 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5716 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5717 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5718 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5719 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5720 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5721
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5722 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5723
5724
5725 </td> <!-- entry_type -->
5726
5727 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5728 <p>32 characters describing GPS algorithm to
5729include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5730 </td>
5731
5732 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5733 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5734 </td>
5735
5736 <td class="entry_range">
5737 </td>
5738
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5739 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5740 <ul class="entry_tags">
5741 <li><a href="#tag_BC">BC</a></li>
5742 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5743 </td>
5744
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5745 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5746
5747
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5748 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5749 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5750
5751
5752 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5753 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5754 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5755 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5756 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5757 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5758
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5759 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5760
5761
5762 </td> <!-- entry_type -->
5763
5764 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5765 <p>Time GPS fix was made to include in
5766EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5767 </td>
5768
5769 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5770 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5771 </td>
5772
5773 <td class="entry_range">
5774 </td>
5775
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5776 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5777 <ul class="entry_tags">
5778 <li><a href="#tag_BC">BC</a></li>
5779 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5780 </td>
5781
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5782 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5783
5784
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5785 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5786 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5787
5788
5789 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5790 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5791 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5792 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5793 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5794 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5795
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5796 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5797
5798
5799 </td> <!-- entry_type -->
5800
5801 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5802 <p>Orientation of JPEG image to
5803write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5804 </td>
5805
5806 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5807 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5808 </td>
5809
5810 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5811 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5812 </td>
5813
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5814 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5815 <ul class="entry_tags">
5816 <li><a href="#tag_BC">BC</a></li>
5817 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5818 </td>
5819
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5820 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5821
5822
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5823 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5824 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5825
5826
5827 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5828 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5829 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5830 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5831 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5832 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5833
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5834 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5835
5836
5837 </td> <!-- entry_type -->
5838
5839 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5840 <p>Compression quality of the final JPEG
5841image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5842 </td>
5843
5844 <td class="entry_units">
5845 </td>
5846
5847 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5848 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5849 </td>
5850
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5851 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5852 <ul class="entry_tags">
5853 <li><a href="#tag_BC">BC</a></li>
5854 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5855 </td>
5856
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5857 </tr>
5858 <tr class="entries_header">
5859 <th class="th_details" colspan="5">Details</th>
5860 </tr>
5861 <tr class="entry_cont">
5862 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5863 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5864 </td>
5865 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5866
5867
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5868 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5869 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5870
5871
5872 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5873 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5874 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5875 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5876 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5877 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5878
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5879 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5880
5881
5882 </td> <!-- entry_type -->
5883
5884 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5885 <p>The size of the compressed JPEG image,<wbr/> in
5886bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5887 </td>
5888
5889 <td class="entry_units">
5890 </td>
5891
5892 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5893 <blockquote>
5894<p>= 0</p>
5895</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5896 </td>
5897
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5898 <td class="entry_tags">
5899 </td>
5900
5901 </tr>
5902 <tr class="entries_header">
5903 <th class="th_details" colspan="5">Details</th>
5904 </tr>
5905 <tr class="entry_cont">
5906 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5907 <p>If no JPEG output is produced for the request,<wbr/>
5908this must be 0.<wbr/></p>
5909<p>Otherwise,<wbr/> this describes the real size of the compressed
5910JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5911if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
5912has <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]5913the JPEG stream will be 1000000 bytes,<wbr/> of which the first
5914500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5915 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5916 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5917
5918
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5919 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5920 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5921
5922
5923 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5924 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5925 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5926 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5927 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5928 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5929
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5930 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5931
5932
5933 </td> <!-- entry_type -->
5934
5935 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5936 <p>Compression quality of JPEG
5937thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5938 </td>
5939
5940 <td class="entry_units">
5941 </td>
5942
5943 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5944 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5945 </td>
5946
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5947 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5948 <ul class="entry_tags">
5949 <li><a href="#tag_BC">BC</a></li>
5950 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5951 </td>
5952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5953 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5954
5955
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5956 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5957 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5958
5959
5960 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5961 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5962 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5963 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5964 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5965 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5966 <span class="entry_type_container">x</span>
5967
5968 <span class="entry_type_array">
5969 2
5970 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5971 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5972
5973
5974 </td> <!-- entry_type -->
5975
5976 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5977 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5978 </td>
5979
5980 <td class="entry_units">
5981 </td>
5982
5983 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5984 <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]5985 </td>
5986
5987 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5988 <ul class="entry_tags">
5989 <li><a href="#tag_BC">BC</a></li>
5990 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5991 </td>
5992
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5993 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5994 <tr class="entries_header">
5995 <th class="th_details" colspan="5">Details</th>
5996 </tr>
5997 <tr class="entry_cont">
5998 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5999 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
6000but the captured JPEG must still be a valid image.<wbr/></p>
6001<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6002the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6003 </td>
6004 </tr>
6005
6006
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6007 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6008 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6009
6010
6011
6012 <!-- end of kind -->
6013 </tbody>
6014
6015 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6016 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6017
6018
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6019 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6020
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6021 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6022 <tr>
6023 <th class="th_name">Property Name</th>
6024 <th class="th_type">Type</th>
6025 <th class="th_description">Description</th>
6026 <th class="th_units">Units</th>
6027 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6028 <th class="th_tags">Tags</th>
6029 </tr>
6030 </thead>
6031
6032 <tbody>
6033
6034
6035
6036
6037
6038
6039
6040
6041
6042
6043 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6044 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6045 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6046 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6047 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6048 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6049
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6050 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6051
6052
6053 </td> <!-- entry_type -->
6054
6055 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6056 <p>Size of the lens aperture</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6057 </td>
6058
6059 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6060 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6061 </td>
6062
6063 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6064 <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]6065 </td>
6066
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6067 <td class="entry_tags">
6068 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6069 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6070 </ul>
6071 </td>
6072
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6073 </tr>
6074 <tr class="entries_header">
6075 <th class="th_details" colspan="5">Details</th>
6076 </tr>
6077 <tr class="entry_cont">
6078 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6079 <p>Will not be supported on most devices.<wbr/> Can only
6080pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6081 </td>
6082 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6083
6084
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6085 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6086 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6087
6088
6089 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6090 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6091 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6092 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6093 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6094 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6095
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6096 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6097
6098
6099 </td> <!-- entry_type -->
6100
6101 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6102 <p>State of lens neutral density
6103filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6104 </td>
6105
6106 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6107 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6108 </td>
6109
6110 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6111 <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]6112 </td>
6113
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6114 <td class="entry_tags">
6115 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6116 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6117 </ul>
6118 </td>
6119
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6120 </tr>
6121 <tr class="entries_header">
6122 <th class="th_details" colspan="5">Details</th>
6123 </tr>
6124 <tr class="entry_cont">
6125 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6126 <p>Will not be supported on most devices.<wbr/> Can only
6127pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6128 </td>
6129 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6130
6131
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6132 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6133 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6134
6135
6136 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6137 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6138 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6139 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6140 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6141 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6142
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6143 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6144
6145
6146 </td> <!-- entry_type -->
6147
6148 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6149 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6150 </td>
6151
6152 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6153 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6154 </td>
6155
6156 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6157 <blockquote>
6158<p>0</p>
6159</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6160 </td>
6161
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6162 <td class="entry_tags">
6163 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6164 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6165 </ul>
6166 </td>
6167
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6168 </tr>
6169 <tr class="entries_header">
6170 <th class="th_details" colspan="5">Details</th>
6171 </tr>
6172 <tr class="entry_cont">
6173 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6174 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6175 </td>
6176 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6177
6178
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6179 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6180 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6181
6182
6183 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6184 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6185 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6186 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6187 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6188 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6189
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6190 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6191
6192
6193 </td> <!-- entry_type -->
6194
6195 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6196 <p>Distance to plane of sharpest focus,<wbr/>
6197measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6198 </td>
6199
6200 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6201 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6202 </td>
6203
6204 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6205 <blockquote>
6206<p>= 0</p>
6207</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6208 </td>
6209
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6210 <td class="entry_tags">
6211 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6212 <li><a href="#tag_BC">BC</a></li>
6213 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6214 </ul>
6215 </td>
6216
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6217 </tr>
6218 <tr class="entries_header">
6219 <th class="th_details" colspan="5">Details</th>
6220 </tr>
6221 <tr class="entry_cont">
6222 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6223 <p>0 = infinity focus.<wbr/> Used value should be clamped
6224to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6225 </td>
6226 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6227
6228
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6229 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6230 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6231
6232
6233 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6234 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6235 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6236 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6237 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6238 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6239
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6240 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6241
6242 <ul class="entry_type_enum">
6243 <li>
6244 <span class="entry_type_enum_name">OFF</span>
6245 </li>
6246 <li>
6247 <span class="entry_type_enum_name">ON</span>
6248 <span class="entry_type_enum_optional">optional</span>
6249 </li>
6250 </ul>
6251
6252 </td> <!-- entry_type -->
6253
6254 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6255 <p>Whether optical image stabilization is
6256enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6257 </td>
6258
6259 <td class="entry_units">
6260 </td>
6261
6262 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6263 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6264 </td>
6265
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6266 <td class="entry_tags">
6267 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6268 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6269 </ul>
6270 </td>
6271
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6272 </tr>
6273 <tr class="entries_header">
6274 <th class="th_details" colspan="5">Details</th>
6275 </tr>
6276 <tr class="entry_cont">
6277 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6278 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6279 </td>
6280 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6281
6282
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6283 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6284 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6285
6286
6287
6288 <!-- end of kind -->
6289 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6290 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6291
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6292 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6293 <tr>
6294 <th class="th_name">Property Name</th>
6295 <th class="th_type">Type</th>
6296 <th class="th_description">Description</th>
6297 <th class="th_units">Units</th>
6298 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6299 <th class="th_tags">Tags</th>
6300 </tr>
6301 </thead>
6302
6303 <tbody>
6304
6305
6306
6307
6308
6309
6310
6311
6312
6313
6314
6315
6316 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6317 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6318 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6319 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6320 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6321 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6322 <span class="entry_type_container">x</span>
6323
6324 <span class="entry_type_array">
6325 n
6326 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6327 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6328
6329
6330 </td> <!-- entry_type -->
6331
6332 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6333 <p>List of supported aperture
6334values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6335 </td>
6336
6337 <td class="entry_units">
6338 </td>
6339
6340 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6341 <p>one entry required,<wbr/> &gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6342 </td>
6343
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6344 <td class="entry_tags">
6345 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6346 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6347 </ul>
6348 </td>
6349
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6350 </tr>
6351 <tr class="entries_header">
6352 <th class="th_details" colspan="5">Details</th>
6353 </tr>
6354 <tr class="entry_cont">
6355 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6356 <p>If variable aperture not available,<wbr/> only setting
6357should be for the fixed aperture</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6358 </td>
6359 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6360
6361
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6362 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6363 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6364
6365
6366 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6367 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6368 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6369 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6370 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6371 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6372 <span class="entry_type_container">x</span>
6373
6374 <span class="entry_type_array">
6375 n
6376 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6377 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6378
6379
6380 </td> <!-- entry_type -->
6381
6382 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6383 <p>List of supported ND filter
6384values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6385 </td>
6386
6387 <td class="entry_units">
6388 </td>
6389
6390 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6391 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6392 </td>
6393
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6394 <td class="entry_tags">
6395 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6396 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6397 </ul>
6398 </td>
6399
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6400 </tr>
6401 <tr class="entries_header">
6402 <th class="th_details" colspan="5">Details</th>
6403 </tr>
6404 <tr class="entry_cont">
6405 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6406 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6407lists the available exposure index values for dimming
6408(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6409light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6410 </td>
6411 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6412
6413
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6414 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6415 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6416
6417
6418 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6419 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6420 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6421 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6422 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6423 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6424 <span class="entry_type_container">x</span>
6425
6426 <span class="entry_type_array">
6427 n
6428 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6429 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6430 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6431
6432
6433 </td> <!-- entry_type -->
6434
6435 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6436 <p>If fitted with optical zoom,<wbr/> what focal
6437lengths are available.<wbr/> If not,<wbr/> the static focal
6438length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6439 </td>
6440
6441 <td class="entry_units">
6442 </td>
6443
6444 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6445 <blockquote>
6446<p>0</p>
6447</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6448 </td>
6449
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6450 <td class="entry_tags">
6451 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6452 <li><a href="#tag_BC">BC</a></li>
6453 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6454 </ul>
6455 </td>
6456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6457 </tr>
6458 <tr class="entries_header">
6459 <th class="th_details" colspan="5">Details</th>
6460 </tr>
6461 <tr class="entry_cont">
6462 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6463 <p>If optical zoom not supported,<wbr/> only one value
6464should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6465 </td>
6466 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6467
6468
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6469 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6470 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6471
6472
6473 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6474 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6475 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6476 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6477 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6478 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6479 <span class="entry_type_container">x</span>
6480
6481 <span class="entry_type_array">
6482 n
6483 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6484 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6485 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6486
6487
6488 </td> <!-- entry_type -->
6489
6490 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6491 <p>List of supported optical image
6492stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6493 </td>
6494
6495 <td class="entry_units">
6496 </td>
6497
6498 <td class="entry_range">
6499 </td>
6500
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6501 <td class="entry_tags">
6502 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6503 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6504 </ul>
6505 </td>
6506
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6507 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6508
6509
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6510 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6511 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6512
6513
6514 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6515 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6516 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6517 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6518 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6519 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6520 <span class="entry_type_container">x</span>
6521
6522 <span class="entry_type_array">
6523 2 x 3 x n x m
6524 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6525 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6526 <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]6527
6528
6529 </td> <!-- entry_type -->
6530
6531 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6532 <p>A low-resolution map for correction of
6533geometric distortions and chromatic aberrations,<wbr/> per
6534color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6535 </td>
6536
6537 <td class="entry_units">
6538 </td>
6539
6540 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6541 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6542 </td>
6543
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6544 <td class="entry_tags">
6545 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6546 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6547 </ul>
6548 </td>
6549
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6550 </tr>
6551 <tr class="entries_header">
6552 <th class="th_details" colspan="5">Details</th>
6553 </tr>
6554 <tr class="entry_cont">
6555 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6556 <p>[DNG wants a function instead].<wbr/> What's easiest
6557for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
6558j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
6559j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
6560entry 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]6561 </td>
6562 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6563
6564
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6565 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6566 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6567
6568
6569 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6570 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6571 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6572 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6573 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6574 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6575 <span class="entry_type_container">x</span>
6576
6577 <span class="entry_type_array">
6578 2
6579 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6580 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6581 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6582
6583
6584 </td> <!-- entry_type -->
6585
6586 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6587 <p>Dimensions of geometric correction
6588map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6589 </td>
6590
6591 <td class="entry_units">
6592 </td>
6593
6594 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6595 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6596 </td>
6597
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6598 <td class="entry_tags">
6599 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6600 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6601 </ul>
6602 </td>
6603
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6604 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6605
6606
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6607 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6608 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6609
6610
6611 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6612 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6613 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6614 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6615 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6616 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6617
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6618 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6619
6620
6621 </td> <!-- entry_type -->
6622
6623 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6624 <p>Hyperfocal distance for this lens; set to
66250 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6626 </td>
6627
6628 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6629 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6630 </td>
6631
6632 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6633 <blockquote>
6634<p>= 0</p>
6635</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6636 </td>
6637
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6638 <td class="entry_tags">
6639 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6640 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6641 </ul>
6642 </td>
6643
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6644 </tr>
6645 <tr class="entries_header">
6646 <th class="th_details" colspan="5">Details</th>
6647 </tr>
6648 <tr class="entry_cont">
6649 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6650 <p>The hyperfocal distance is used for the old
6651API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6652 </td>
6653 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6654
6655
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6656 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6657 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6658
6659
6660 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6661 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6662 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6663 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6664 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6665 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6666
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6667 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6668
6669
6670 </td> <!-- entry_type -->
6671
6672 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6673 <p>Shortest distance from frontmost surface
6674of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6675 </td>
6676
6677 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6678 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6679 </td>
6680
6681 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6682 <blockquote>
6683<p>= 0</p>
6684</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6685 </td>
6686
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6687 <td class="entry_tags">
6688 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6689 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6690 </ul>
6691 </td>
6692
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6693 </tr>
6694 <tr class="entries_header">
6695 <th class="th_details" colspan="5">Details</th>
6696 </tr>
6697 <tr class="entry_cont">
6698 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6699 <p>If the lens is fixed-focus,<wbr/> this should be
67000</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6701 </td>
6702 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6703
6704
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6705 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6706 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6707
6708
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6709 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6710 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6711 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6712 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6713 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6714 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6715 <span class="entry_type_container">x</span>
6716
6717 <span class="entry_type_array">
6718 2
6719 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6720 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6721 <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]6722
6723
6724 </td> <!-- entry_type -->
6725
6726 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6727 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6728 </td>
6729
6730 <td class="entry_units">
6731 </td>
6732
6733 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6734 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6735 </td>
6736
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6737 <td class="entry_tags">
6738 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6739 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6740 </ul>
6741 </td>
6742
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6743 </tr>
6744 <tr class="entries_header">
6745 <th class="th_details" colspan="5">Details</th>
6746 </tr>
6747 <tr class="entry_cont">
6748 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6749 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
6750must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6751 </td>
6752 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6753
6754
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6755 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6756 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6757
6758
6759
6760
6761
6762 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6763 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6764 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6765 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6766 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6767 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6768
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6769 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6770
6771 <ul class="entry_type_enum">
6772 <li>
6773 <span class="entry_type_enum_name">FRONT</span>
6774 </li>
6775 <li>
6776 <span class="entry_type_enum_name">BACK</span>
6777 </li>
6778 </ul>
6779
6780 </td> <!-- entry_type -->
6781
6782 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6783 <p>Direction the camera faces relative to
6784device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6785 </td>
6786
6787 <td class="entry_units">
6788 </td>
6789
6790 <td class="entry_range">
6791 </td>
6792
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6793 <td class="entry_tags">
6794 </td>
6795
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6796 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6797
6798
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6799 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6800 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6801
6802
6803 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6804 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6805 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6806 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6807 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6808 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6809 <span class="entry_type_container">x</span>
6810
6811 <span class="entry_type_array">
6812 2
6813 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6814 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6815 <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]6816
6817
6818 </td> <!-- entry_type -->
6819
6820 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6821 <p>Relative angle of camera optical axis to the
6822perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6823 </td>
6824
6825 <td class="entry_units">
6826 </td>
6827
6828 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6829 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6830 </td>
6831
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6832 <td class="entry_tags">
6833 <ul class="entry_tags">
6834 <li><a href="#tag_ADV">ADV</a></li>
6835 </ul>
6836 </td>
6837
6838 </tr>
6839 <tr class="entries_header">
6840 <th class="th_details" colspan="5">Details</th>
6841 </tr>
6842 <tr class="entry_cont">
6843 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6844 <p>Examples:</p>
6845<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6846is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6847<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6848device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6849<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
6850the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6851<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6852direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6853 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6854 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6855
6856
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6857 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6858 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6859
6860
6861 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6862 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6863 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6864 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6865 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6866 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6867 <span class="entry_type_container">x</span>
6868
6869 <span class="entry_type_array">
6870 3, location in mm, in the sensor coordinate
6871 system
6872 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6873 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6874
6875
6876 </td> <!-- entry_type -->
6877
6878 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6879 <p>Coordinates of camera optical axis on
6880device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6881 </td>
6882
6883 <td class="entry_units">
6884 </td>
6885
6886 <td class="entry_range">
6887 </td>
6888
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6889 <td class="entry_tags">
6890 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6891 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6892 </ul>
6893 </td>
6894
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6895 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6896
6897
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6898 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6899 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6900
6901
6902
6903 <!-- end of kind -->
6904 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6905 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6906
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6907 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6908 <tr>
6909 <th class="th_name">Property Name</th>
6910 <th class="th_type">Type</th>
6911 <th class="th_description">Description</th>
6912 <th class="th_units">Units</th>
6913 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6914 <th class="th_tags">Tags</th>
6915 </tr>
6916 </thead>
6917
6918 <tbody>
6919
6920
6921
6922
6923
6924
6925
6926
6927
6928
6929 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6930 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6931 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6932 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6933 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6934 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6935
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6936 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6937
6938
6939 </td> <!-- entry_type -->
6940
6941 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6942 <p>Size of the lens aperture</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6943 </td>
6944
6945 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6946 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6947 </td>
6948
6949 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6950 <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]6951 </td>
6952
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6953 <td class="entry_tags">
6954 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6955 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6956 </ul>
6957 </td>
6958
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6959 </tr>
6960 <tr class="entries_header">
6961 <th class="th_details" colspan="5">Details</th>
6962 </tr>
6963 <tr class="entry_cont">
6964 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6965 <p>Will not be supported on most devices.<wbr/> Can only
6966pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6967 </td>
6968 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6969
6970
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6971 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6972 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6973
6974
6975 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6976 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6977 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6978 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6979 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6980 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6981
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6982 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6983
6984
6985 </td> <!-- entry_type -->
6986
6987 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6988 <p>State of lens neutral density
6989filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6990 </td>
6991
6992 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6993 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6994 </td>
6995
6996 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6997 <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]6998 </td>
6999
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7000 <td class="entry_tags">
7001 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7002 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7003 </ul>
7004 </td>
7005
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7006 </tr>
7007 <tr class="entries_header">
7008 <th class="th_details" colspan="5">Details</th>
7009 </tr>
7010 <tr class="entry_cont">
7011 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7012 <p>Will not be supported on most devices.<wbr/> Can only
7013pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7014 </td>
7015 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7016
7017
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7018 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7019 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7020
7021
7022 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7023 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7024 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7025 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7026 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7027 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7028
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7029 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7030
7031
7032 </td> <!-- entry_type -->
7033
7034 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7035 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7036 </td>
7037
7038 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7039 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7040 </td>
7041
7042 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7043 <blockquote>
7044<p>0</p>
7045</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7046 </td>
7047
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7048 <td class="entry_tags">
7049 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7050 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7051 </ul>
7052 </td>
7053
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7054 </tr>
7055 <tr class="entries_header">
7056 <th class="th_details" colspan="5">Details</th>
7057 </tr>
7058 <tr class="entry_cont">
7059 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7060 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7061 </td>
7062 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7063
7064
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7065 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7066 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7067
7068
7069 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7070 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7071 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7072 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7073 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7074 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7075
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7076 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7077
7078
7079 </td> <!-- entry_type -->
7080
7081 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7082 <p>Distance to plane of sharpest focus,<wbr/>
7083measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7084 </td>
7085
7086 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7087 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7088 </td>
7089
7090 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7091 <blockquote>
7092<p>= 0</p>
7093</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7094 </td>
7095
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7096 <td class="entry_tags">
7097 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7098 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7099 </ul>
7100 </td>
7101
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7102 </tr>
7103 <tr class="entries_header">
7104 <th class="th_details" colspan="5">Details</th>
7105 </tr>
7106 <tr class="entry_cont">
7107 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7108 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7109 </td>
7110 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7111
7112
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7113 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7114 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7115
7116
7117 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7118 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7119 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7120 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7121 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7122 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7123 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7124
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7125 <span class="entry_type_array">
7126 2
7127 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7128 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7129 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7130
7131
7132 </td> <!-- entry_type -->
7133
7134 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7135 <p>The range of scene distances that are in
7136sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7137 </td>
7138
7139 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7140 pair of focus distances in diopters: (near,<wbr/>
7141 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7142 </td>
7143
7144 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7145 <blockquote>
7146<p>=0</p>
7147</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7148 </td>
7149
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7150 <td class="entry_tags">
7151 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7152 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7153 </ul>
7154 </td>
7155
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7156 </tr>
7157 <tr class="entries_header">
7158 <th class="th_details" colspan="5">Details</th>
7159 </tr>
7160 <tr class="entry_cont">
7161 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7162 <p>If variable focus not supported,<wbr/> can still report
7163fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7164 </td>
7165 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7166
7167
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7168 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7169 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7170
7171
7172 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7173 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7174 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7175 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7176 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7177 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7178
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7179 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7180
7181 <ul class="entry_type_enum">
7182 <li>
7183 <span class="entry_type_enum_name">OFF</span>
7184 </li>
7185 <li>
7186 <span class="entry_type_enum_name">ON</span>
7187 <span class="entry_type_enum_optional">optional</span>
7188 </li>
7189 </ul>
7190
7191 </td> <!-- entry_type -->
7192
7193 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7194 <p>Whether optical image stabilization is
7195enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7196 </td>
7197
7198 <td class="entry_units">
7199 </td>
7200
7201 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7202 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7203 </td>
7204
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7205 <td class="entry_tags">
7206 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7207 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7208 </ul>
7209 </td>
7210
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7211 </tr>
7212 <tr class="entries_header">
7213 <th class="th_details" colspan="5">Details</th>
7214 </tr>
7215 <tr class="entry_cont">
7216 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7217 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7218 </td>
7219 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7220
7221
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7222 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7223 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7224
7225
7226 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7227 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7228 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7229 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7230 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7231 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7232
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7233 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7234
7235 <ul class="entry_type_enum">
7236 <li>
7237 <span class="entry_type_enum_name">STATIONARY</span>
7238 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7239 <li>
7240 <span class="entry_type_enum_name">MOVING</span>
7241 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7242 </ul>
7243
7244 </td> <!-- entry_type -->
7245
7246 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7247 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7248 </td>
7249
7250 <td class="entry_units">
7251 </td>
7252
7253 <td class="entry_range">
7254 </td>
7255
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7256 <td class="entry_tags">
7257 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7258 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7259 </ul>
7260 </td>
7261
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7262 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7263
7264
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7265 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7266 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7267
7268
7269
7270 <!-- end of kind -->
7271 </tbody>
7272
7273 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7274 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7275
7276
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7277 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7278
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7279 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7280 <tr>
7281 <th class="th_name">Property Name</th>
7282 <th class="th_type">Type</th>
7283 <th class="th_description">Description</th>
7284 <th class="th_units">Units</th>
7285 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7286 <th class="th_tags">Tags</th>
7287 </tr>
7288 </thead>
7289
7290 <tbody>
7291
7292
7293
7294
7295
7296
7297
7298
7299
7300
7301 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7302 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7303 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7304 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7305 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7306 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7307
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7308 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7309
7310 <ul class="entry_type_enum">
7311 <li>
7312 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7313 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7314 </li>
7315 <li>
7316 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7317 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7318 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7319 </li>
7320 <li>
7321 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7322 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7323 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7324 </li>
7325 </ul>
7326
7327 </td> <!-- entry_type -->
7328
7329 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7330 <p>Mode of operation for the noise reduction
7331algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7332 </td>
7333
7334 <td class="entry_units">
7335 </td>
7336
7337 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7338 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7339 </td>
7340
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7341 <td class="entry_tags">
7342 <ul class="entry_tags">
7343 <li><a href="#tag_V1">V1</a></li>
7344 </ul>
7345 </td>
7346
7347 </tr>
7348 <tr class="entries_header">
7349 <th class="th_details" colspan="5">Details</th>
7350 </tr>
7351 <tr class="entry_cont">
7352 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7353 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7354will be applied by the HAL.<wbr/></p>
7355<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7356will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7357should use the highest-quality noise filtering algorithms,<wbr/>
7358even if it slows down capture rate.<wbr/> FAST means the HAL should not
7359slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7360 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7361 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7362
7363
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7364 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7365 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7366
7367
7368 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7369 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7370 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7371 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7372 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7373 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7374
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7375 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7376
7377
7378 </td> <!-- entry_type -->
7379
7380 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7381 <p>Control the amount of noise reduction
7382applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7383 </td>
7384
7385 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7386 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7387 </td>
7388
7389 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7390 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7391 </td>
7392
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7393 <td class="entry_tags">
7394 </td>
7395
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7396 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7397
7398
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7399 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7400 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7401
7402
7403
7404 <!-- end of kind -->
7405 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7406 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7407
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7408 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7409 <tr>
7410 <th class="th_name">Property Name</th>
7411 <th class="th_type">Type</th>
7412 <th class="th_description">Description</th>
7413 <th class="th_units">Units</th>
7414 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7415 <th class="th_tags">Tags</th>
7416 </tr>
7417 </thead>
7418
7419 <tbody>
7420
7421
7422
7423
7424
7425
7426
7427
7428
7429
7430 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7431 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7432 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7433 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7434 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7435 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7436
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7437 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7438
7439 <ul class="entry_type_enum">
7440 <li>
7441 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7442 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7443 </li>
7444 <li>
7445 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7446 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7447 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7448 </li>
7449 <li>
7450 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7451 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7452 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7453 </li>
7454 </ul>
7455
7456 </td> <!-- entry_type -->
7457
7458 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7459 <p>Mode of operation for the noise reduction
7460algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7461 </td>
7462
7463 <td class="entry_units">
7464 </td>
7465
7466 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7467 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7468 </td>
7469
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7470 <td class="entry_tags">
7471 <ul class="entry_tags">
7472 <li><a href="#tag_V1">V1</a></li>
7473 </ul>
7474 </td>
7475
7476 </tr>
7477 <tr class="entries_header">
7478 <th class="th_details" colspan="5">Details</th>
7479 </tr>
7480 <tr class="entry_cont">
7481 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7482 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7483will be applied by the HAL.<wbr/></p>
7484<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7485will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7486should use the highest-quality noise filtering algorithms,<wbr/>
7487even if it slows down capture rate.<wbr/> FAST means the HAL should not
7488slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7489 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7490 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7491
7492
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7493 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7494 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7495
7496
7497
7498 <!-- end of kind -->
7499 </tbody>
7500
7501 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7502 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7503
7504
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7505 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7506
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7507 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7508 <tr>
7509 <th class="th_name">Property Name</th>
7510 <th class="th_type">Type</th>
7511 <th class="th_description">Description</th>
7512 <th class="th_units">Units</th>
7513 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7514 <th class="th_tags">Tags</th>
7515 </tr>
7516 </thead>
7517
7518 <tbody>
7519
7520
7521
7522
7523
7524
7525
7526
7527
7528
7529 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7530 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7531 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7532 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7533 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7534 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7535
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7536 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7537
7538
7539 </td> <!-- entry_type -->
7540
7541 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7542 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7543scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7544region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
7545and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7546 </td>
7547
7548 <td class="entry_units">
7549 </td>
7550
7551 <td class="entry_range">
7552 </td>
7553
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7554 <td class="entry_tags">
7555 </td>
7556
7557 </tr>
7558 <tr class="entries_header">
7559 <th class="th_details" colspan="5">Details</th>
7560 </tr>
7561 <tr class="entry_cont">
7562 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7563 <p>Normalized coordinates refer to those in the
7564(-1000,<wbr/>1000) range mentioned in the
7565android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7566<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7567sensor array-relative coordinates for all region data.<wbr/> Does
7568not need to be listed in static metadata.<wbr/> Support will be
7569removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7570 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7571 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7572
7573
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7574 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7575 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7576
7577
7578 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7579 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7580 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7581 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7582 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7583 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7584
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7585 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7586
7587
7588 </td> <!-- entry_type -->
7589
7590 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7591 <p>If set to 1,<wbr/> then the camera service always
7592switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
7593trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7594 </td>
7595
7596 <td class="entry_units">
7597 </td>
7598
7599 <td class="entry_range">
7600 </td>
7601
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7602 <td class="entry_tags">
7603 </td>
7604
7605 </tr>
7606 <tr class="entries_header">
7607 <th class="th_details" colspan="5">Details</th>
7608 </tr>
7609 <tr class="entry_cont">
7610 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7611 <p>HAL implementations should implement AF trigger
7612modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
7613CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
7614not need to be listed in static metadata.<wbr/> Support will be
7615removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7616 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7617 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7618
7619
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7620 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7621 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7622
7623
7624 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7625 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7626 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7627 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7628 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7629 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7630
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7631 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7632
7633
7634 </td> <!-- entry_type -->
7635
7636 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7637 <p>If set to 1,<wbr/> the camera service uses
7638CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
7639HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
7640shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7641 </td>
7642
7643 <td class="entry_units">
7644 </td>
7645
7646 <td class="entry_range">
7647 </td>
7648
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7649 <td class="entry_tags">
7650 </td>
7651
7652 </tr>
7653 <tr class="entries_header">
7654 <th class="th_details" colspan="5">Details</th>
7655 </tr>
7656 <tr class="entry_cont">
7657 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7658 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7659to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7660zero-shutter-lag,<wbr/> instead of relying on an explicit
7661format setting.<wbr/> Does not need to be listed in static
7662metadata.<wbr/> Support will be removed in future versions of
7663camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7664 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7665 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7666
7667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7668 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7669 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7670
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7671
7672 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7673 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7674 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7675 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7676 <td class="entry_type">
7677 <span class="entry_type_name">byte</span>
7678
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7679 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7680
7681
7682 </td> <!-- entry_type -->
7683
7684 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7685 <p>If set to 1,<wbr/> the HAL will always split result
7686metadata for a single capture into multiple buffers,<wbr/>
7687returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7688 </td>
7689
7690 <td class="entry_units">
7691 </td>
7692
7693 <td class="entry_range">
7694 </td>
7695
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7696 <td class="entry_tags">
7697 </td>
7698
7699 </tr>
7700 <tr class="entries_header">
7701 <th class="th_details" colspan="5">Details</th>
7702 </tr>
7703 <tr class="entry_cont">
7704 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7705 <p>Does not need to be listed in static
7706metadata.<wbr/> Support for partial results will be reworked in
7707future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7708working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7709consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7710 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7711 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7712
7713
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7714 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7715 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7716
7717
7718
7719 <!-- end of kind -->
7720 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7721 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7722
7723 <thead class="entries_header">
7724 <tr>
7725 <th class="th_name">Property Name</th>
7726 <th class="th_type">Type</th>
7727 <th class="th_description">Description</th>
7728 <th class="th_units">Units</th>
7729 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7730 <th class="th_tags">Tags</th>
7731 </tr>
7732 </thead>
7733
7734 <tbody>
7735
7736
7737
7738
7739
7740
7741
7742
7743
7744
7745 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7746 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7747 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7748 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7749 <td class="entry_type">
7750 <span class="entry_type_name entry_type_name_enum">byte</span>
7751
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7752 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7753
7754 <ul class="entry_type_enum">
7755 <li>
7756 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7757 <span class="entry_type_enum_notes">The last or only metadata result buffer
7758 for this capture.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7759 </li>
7760 <li>
7761 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7762 <span class="entry_type_enum_notes">A partial buffer of result metadata for this
7763 capture.<wbr/> More result buffers for this capture will be sent
7764 by the HAL,<wbr/> the last of which will be marked
7765 FINAL.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7766 </li>
7767 </ul>
7768
7769 </td> <!-- entry_type -->
7770
7771 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7772 <p>Whether a result given to the framework is the
7773final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7774subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7775values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7776 </td>
7777
7778 <td class="entry_units">
7779 </td>
7780
7781 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7782 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7783 </td>
7784
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7785 <td class="entry_tags">
7786 </td>
7787
7788 </tr>
7789 <tr class="entries_header">
7790 <th class="th_details" colspan="5">Details</th>
7791 </tr>
7792 <tr class="entry_cont">
7793 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7794 <p>The entries in the result metadata buffers for a
7795single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7796FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7797requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
7798always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
7799before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
7800in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
7801capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
7802only 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]7803 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7804 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7805
7806
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7807 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7808 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7809
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7810
7811
7812 <!-- end of kind -->
7813 </tbody>
7814
7815 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7816 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7817
7818
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7819 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7820
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7821 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7822 <tr>
7823 <th class="th_name">Property Name</th>
7824 <th class="th_type">Type</th>
7825 <th class="th_description">Description</th>
7826 <th class="th_units">Units</th>
7827 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7828 <th class="th_tags">Tags</th>
7829 </tr>
7830 </thead>
7831
7832 <tbody>
7833
7834
7835
7836
7837
7838
7839
7840
7841
7842
7843 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7844 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7845 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7846 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7847 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7848 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7849
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7850 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7851
7852
7853 </td> <!-- entry_type -->
7854
7855 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7856 <p>A frame counter set by the framework.<wbr/> Must
7857be maintained unchanged in output frame.<wbr/> This value monotonically
7858increases with every new result (that is,<wbr/> each new result has a unique
7859frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7860 </td>
7861
7862 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7863 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7864 </td>
7865
7866 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7867 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7868 </td>
7869
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7870 <td class="entry_tags">
7871 </td>
7872
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7873 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7874
7875
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7876 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7877 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7878
7879
7880 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7881 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7882 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7883 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7884 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7885 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7886
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7887 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7888
7889
7890 </td> <!-- entry_type -->
7891
7892 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7893 <p>An application-specified ID for the current
7894request.<wbr/> Must be maintained unchanged in output
7895frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7896 </td>
7897
7898 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7899 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7900 </td>
7901
7902 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7903 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7904 </td>
7905
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7906 <td class="entry_tags">
7907 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7908 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7909 </ul>
7910 </td>
7911
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7912 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7913
7914
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7915 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7916 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7917
7918
7919 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7920 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7921 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7922 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7923 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7924 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7925 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7926
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7927 <span class="entry_type_array">
7928 n
7929 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7930 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7931
7932
7933 </td> <!-- entry_type -->
7934
7935 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7936 <p>List which camera reprocess stream is used
7937for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7938 </td>
7939
7940 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7941 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7942 </td>
7943
7944 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7945 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
7946reprocess stream ID.<wbr/></p>
7947<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
7948reprocess streams may be included in a single request; they
7949must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7950 </td>
7951
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7952 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7953 <ul class="entry_tags">
7954 <li><a href="#tag_HAL2">HAL2</a></li>
7955 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7956 </td>
7957
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7958 </tr>
7959 <tr class="entries_header">
7960 <th class="th_details" colspan="5">Details</th>
7961 </tr>
7962 <tr class="entry_cont">
7963 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7964 <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]7965REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7966 </td>
7967 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7968
7969
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7970 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7971 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7972
7973
7974 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7975 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7976 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7977 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7978 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7979 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7980
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7981 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7982
7983 <ul class="entry_type_enum">
7984 <li>
7985 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7986 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
7987 for application-bound buffer data.<wbr/> If no
7988 application-bound streams exist,<wbr/> no frame should be
7989 placed in the output frame queue.<wbr/> If such streams
7990 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7991 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7992 information.<wbr/> Timestamp information should still be
7993 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7994 </li>
7995 <li>
7996 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7997 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7998 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7999 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8000 </li>
8001 </ul>
8002
8003 </td> <!-- entry_type -->
8004
8005 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8006 <p>How much metadata to produce on
8007output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8008 </td>
8009
8010 <td class="entry_units">
8011 </td>
8012
8013 <td class="entry_range">
8014 </td>
8015
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8016 <td class="entry_tags">
8017 </td>
8018
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8019 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8020
8021
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8022 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8023 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8024
8025
8026 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8027 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8028 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8029 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8030 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8031 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8032 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8033
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8034 <span class="entry_type_array">
8035 n
8036 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8037 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8038
8039
8040 </td> <!-- entry_type -->
8041
8042 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8043 <p>Lists which camera output streams image data
8044from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8045 </td>
8046
8047 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8048 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8049 </td>
8050
8051 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8052 <p>List must only include streams that have been
8053created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8054 </td>
8055
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8056 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8057 <ul class="entry_tags">
8058 <li><a href="#tag_HAL2">HAL2</a></li>
8059 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8060 </td>
8061
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8062 </tr>
8063 <tr class="entries_header">
8064 <th class="th_details" colspan="5">Details</th>
8065 </tr>
8066 <tr class="entry_cont">
8067 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8068 <p>If no output streams are listed,<wbr/> then the image
8069data should simply be discarded.<wbr/> The image data must
8070still be captured for metadata and statistics production,<wbr/>
8071and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8072 </td>
8073 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8074
8075
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8076 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8077 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8078
8079
8080 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8081 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8082 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8083 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8084 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8085 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8086
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8087 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8088
8089 <ul class="entry_type_enum">
8090 <li>
8091 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8092 <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]8093 and process it according to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8094 settings</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8095 </li>
8096 <li>
8097 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8098 <span class="entry_type_enum_notes">Process previously captured data; the
8099 android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
8100 source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
8101 needed for reprocessing with [RP]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8102 </li>
8103 </ul>
8104
8105 </td> <!-- entry_type -->
8106
8107 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8108 <p>The type of the request; either CAPTURE or
8109REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8110 </td>
8111
8112 <td class="entry_units">
8113 </td>
8114
8115 <td class="entry_range">
8116 </td>
8117
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8118 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8119 <ul class="entry_tags">
8120 <li><a href="#tag_HAL2">HAL2</a></li>
8121 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8122 </td>
8123
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8124 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8125
8126
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8127 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8128 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8129
8130
8131
8132 <!-- end of kind -->
8133 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8134 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8135
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8136 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8137 <tr>
8138 <th class="th_name">Property Name</th>
8139 <th class="th_type">Type</th>
8140 <th class="th_description">Description</th>
8141 <th class="th_units">Units</th>
8142 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8143 <th class="th_tags">Tags</th>
8144 </tr>
8145 </thead>
8146
8147 <tbody>
8148
8149
8150
8151
8152
8153
8154
8155
8156
8157
8158 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8159 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8160 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8161 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8162 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8163 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8164 <span class="entry_type_container">x</span>
8165
8166 <span class="entry_type_array">
8167 3
8168 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8169 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8170
8171
8172 </td> <!-- entry_type -->
8173
8174 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8175 <p>How many output streams can be allocated at
8176the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8177 </td>
8178
8179 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8180 The number of raw sensor streams; the number of
8181 processed,<wbr/> uncompressed streams; and the number of
8182 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8183 </td>
8184
8185 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8186 <blockquote>
8187<p>=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
8188for processed,<wbr/> uncompressed streams</p>
8189</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8190 </td>
8191
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8192 <td class="entry_tags">
8193 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8194 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8195 </ul>
8196 </td>
8197
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8198 </tr>
8199 <tr class="entries_header">
8200 <th class="th_details" colspan="5">Details</th>
8201 </tr>
8202 <tr class="entry_cont">
8203 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8204 <p>Video snapshot with preview callbacks requires 3
8205processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8206one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8207 </td>
8208 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8209
8210
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8211 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8212 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8213
8214
8215 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8216 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8217 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8218 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8219 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8220 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8221 <span class="entry_type_container">x</span>
8222
8223 <span class="entry_type_array">
8224 1
8225 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8226 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8227
8228
8229 </td> <!-- entry_type -->
8230
8231 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8232 <p>How many reprocessing streams of any type
8233can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8234 </td>
8235
8236 <td class="entry_units">
8237 </td>
8238
8239 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8240 <blockquote>
8241<p>= 1</p>
8242</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8243 </td>
8244
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8245 <td class="entry_tags">
8246 </td>
8247
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8248 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8249
8250
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8251 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8252 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8253
8254
8255
8256 <!-- end of kind -->
8257 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8258 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8259
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8260 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8261 <tr>
8262 <th class="th_name">Property Name</th>
8263 <th class="th_type">Type</th>
8264 <th class="th_description">Description</th>
8265 <th class="th_units">Units</th>
8266 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8267 <th class="th_tags">Tags</th>
8268 </tr>
8269 </thead>
8270
8271 <tbody>
8272
8273
8274
8275
8276
8277
8278
8279
8280
8281
8282 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8283 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8284 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8285 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8286 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8287 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8288
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8289 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8290
8291
8292 </td> <!-- entry_type -->
8293
8294 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8295 <p>A frame counter set by the framework.<wbr/> This value monotonically
8296increases with every new result (that is,<wbr/> each new result has a unique
8297frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8298 </td>
8299
8300 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8301 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8302 </td>
8303
8304 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8305 <blockquote>
8306<p>0</p>
8307</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8308 </td>
8309
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8310 <td class="entry_tags">
8311 </td>
8312
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8313 </tr>
8314 <tr class="entries_header">
8315 <th class="th_details" colspan="5">Details</th>
8316 </tr>
8317 <tr class="entry_cont">
8318 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8319 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8320 </td>
8321 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8322
8323
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8324 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8325 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8326
8327
8328 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8329 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8330 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8331 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8332 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8333 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8334
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8335 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8336
8337
8338 </td> <!-- entry_type -->
8339
8340 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8341 <p>An application-specified ID for the current
8342request.<wbr/> Must be maintained unchanged in output
8343frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8344 </td>
8345
8346 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8347 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8348 </td>
8349
8350 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8351 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8352 </td>
8353
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8354 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8355 <ul class="entry_tags">
8356 <li><a href="#tag_V1">V1</a></li>
8357 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8358 </td>
8359
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8360 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8361
8362
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8363 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8364 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8365
8366
8367 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8368 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8369 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8370 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8371 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8372 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8373
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8374 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8375
8376 <ul class="entry_type_enum">
8377 <li>
8378 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8379 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
8380 for application-bound buffer data.<wbr/> If no
8381 application-bound streams exist,<wbr/> no frame should be
8382 placed in the output frame queue.<wbr/> If such streams
8383 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8384 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8385 information.<wbr/> Timestamp information should still be
8386 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8387 </li>
8388 <li>
8389 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8390 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8391 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8392 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8393 </li>
8394 </ul>
8395
8396 </td> <!-- entry_type -->
8397
8398 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8399 <p>How much metadata to produce on
8400output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8401 </td>
8402
8403 <td class="entry_units">
8404 </td>
8405
8406 <td class="entry_range">
8407 </td>
8408
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8409 <td class="entry_tags">
8410 </td>
8411
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8412 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8413
8414
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8415 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8416 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8417
8418
8419 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8420 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8421 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8422 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8423 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8424 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8425 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8426
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8427 <span class="entry_type_array">
8428 n
8429 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8430 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8431
8432
8433 </td> <!-- entry_type -->
8434
8435 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8436 <p>Lists which camera output streams image data
8437from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8438 </td>
8439
8440 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8441 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8442 </td>
8443
8444 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8445 <p>List must only include streams that have been
8446created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8447 </td>
8448
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8449 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8450 <ul class="entry_tags">
8451 <li><a href="#tag_HAL2">HAL2</a></li>
8452 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8453 </td>
8454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8455 </tr>
8456 <tr class="entries_header">
8457 <th class="th_details" colspan="5">Details</th>
8458 </tr>
8459 <tr class="entry_cont">
8460 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8461 <p>If no output streams are listed,<wbr/> then the image
8462data should simply be discarded.<wbr/> The image data must
8463still be captured for metadata and statistics production,<wbr/>
8464and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8465 </td>
8466 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8467
8468
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8469 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8470 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8471
8472
8473
8474 <!-- end of kind -->
8475 </tbody>
8476
8477 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8478 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8479
8480
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8481 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8482
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8483 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8484 <tr>
8485 <th class="th_name">Property Name</th>
8486 <th class="th_type">Type</th>
8487 <th class="th_description">Description</th>
8488 <th class="th_units">Units</th>
8489 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8490 <th class="th_tags">Tags</th>
8491 </tr>
8492 </thead>
8493
8494 <tbody>
8495
8496
8497
8498
8499
8500
8501
8502
8503
8504
8505 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8506 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8507 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8508 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8509 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8510 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8511 <span class="entry_type_container">x</span>
8512
8513 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8514 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8515 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8516 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8517
8518
8519 </td> <!-- entry_type -->
8520
8521 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8522 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8523<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8524(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8525output.<wbr/> Each stream must use this rectangle to produce its
8526output,<wbr/> cropping to a smaller region if necessary to
8527maintain the stream's aspect ratio.<wbr/></p>
8528<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8529 </td>
8530
8531 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8532 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8533 in pixels; (0,<wbr/>0) is top-left corner of
8534 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8535 </td>
8536
8537 <td class="entry_range">
8538 </td>
8539
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8540 <td class="entry_tags">
8541 <ul class="entry_tags">
8542 <li><a href="#tag_BC">BC</a></li>
8543 </ul>
8544 </td>
8545
8546 </tr>
8547 <tr class="entries_header">
8548 <th class="th_details" colspan="5">Details</th>
8549 </tr>
8550 <tr class="entry_cont">
8551 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8552 <p>Any additional per-stream cropping must be done to
8553maximize the final pixel area of the stream.<wbr/></p>
8554<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8555ratio,<wbr/> then 4:3 streams should use the exact crop
8556region.<wbr/> 16:9 streams should further crop vertically
8557(letterbox).<wbr/></p>
8558<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8559outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8560streams should match exactly.<wbr/> These additional crops must
8561be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8562<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8563times,<wbr/> no matter what the relative aspect ratios of the
8564crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8565corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8566larger than active pixel array.<wbr/> Width and height may be
8567rounded to nearest larger supportable width,<wbr/> especially
8568for raw output,<wbr/> where only a few fixed scales may be
8569possible.<wbr/> The width and height of the crop region cannot
8570be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8571android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8572activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8573respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8574 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8575 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8576
8577
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8578 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8579 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8580
8581
8582
8583 <!-- end of kind -->
8584 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8585 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8586
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8587 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8588 <tr>
8589 <th class="th_name">Property Name</th>
8590 <th class="th_type">Type</th>
8591 <th class="th_description">Description</th>
8592 <th class="th_units">Units</th>
8593 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8594 <th class="th_tags">Tags</th>
8595 </tr>
8596 </thead>
8597
8598 <tbody>
8599
8600
8601
8602
8603
8604
8605
8606
8607
8608
8609 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8610 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8611 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8612 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8613 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8614 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8615 <span class="entry_type_container">x</span>
8616
8617 <span class="entry_type_array">
8618 n
8619 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]8620 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8621 <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]8622
8623 <ul class="entry_type_enum">
8624 <li>
8625 <span class="entry_type_enum_name">RAW_SENSOR</span>
8626 <span class="entry_type_enum_value">0x20</span>
8627 </li>
8628 <li>
8629 <span class="entry_type_enum_name">YV12</span>
8630 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8631 <span class="entry_type_enum_notes">YCrCb 4:2:0 Planar</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8632 </li>
8633 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8634 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8635 <span class="entry_type_enum_value">0x11</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8636 <span class="entry_type_enum_notes">NV21</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8637 </li>
8638 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8639 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
8640 <span class="entry_type_enum_value">0x22</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8641 <span class="entry_type_enum_notes">Hal Implementation Defined</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8642 </li>
8643 <li>
8644 <span class="entry_type_enum_name">YCbCr_420_888</span>
8645 <span class="entry_type_enum_value">0x23</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8646 <span class="entry_type_enum_notes">Flexible YUV420 Format</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8647 </li>
8648 <li>
8649 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8650 <span class="entry_type_enum_value">0x21</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8651 <span class="entry_type_enum_notes">JPEG</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8652 </li>
8653 </ul>
8654
8655 </td> <!-- entry_type -->
8656
8657 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8658 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8659 </td>
8660
8661 <td class="entry_units">
8662 </td>
8663
8664 <td class="entry_range">
8665 </td>
8666
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8667 <td class="entry_tags">
8668 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8669 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8670 </ul>
8671 </td>
8672
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8673 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8674
8675
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8676 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8677 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8678
8679
8680 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8681 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8682 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8683 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8684 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8685 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8686 <span class="entry_type_container">x</span>
8687
8688 <span class="entry_type_array">
8689 n
8690 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8691 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8692
8693
8694 </td> <!-- entry_type -->
8695
8696 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8697 <p>The minimum frame duration that is supported
8698for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8699correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8700stream is active and captured in a burst,<wbr/> with all
8701processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8702 </td>
8703
8704 <td class="entry_units">
8705 </td>
8706
8707 <td class="entry_range">
8708 </td>
8709
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8710 <td class="entry_tags">
8711 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8712 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8713 </ul>
8714 </td>
8715
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8716 </tr>
8717 <tr class="entries_header">
8718 <th class="th_details" colspan="5">Details</th>
8719 </tr>
8720 <tr class="entry_cont">
8721 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8722 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8723frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8724durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8725 </td>
8726 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8727
8728
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8729 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8730 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8731
8732
8733 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8734 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8735 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8736 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8737 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8738 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8739 <span class="entry_type_container">x</span>
8740
8741 <span class="entry_type_array">
8742 n x 2
8743 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8744 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8745
8746
8747 </td> <!-- entry_type -->
8748
8749 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8750 <p>The resolutions available for output from
8751the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8752 </td>
8753
8754 <td class="entry_units">
8755 </td>
8756
8757 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8758 <p>Must include: - sensor maximum resolution Should
8759include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8760 </td>
8761
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8762 <td class="entry_tags">
8763 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8764 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8765 </ul>
8766 </td>
8767
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8768 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8769
8770
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8771 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8772 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8773
8774
8775 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8776 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8777 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8778 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8779 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8780 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8781
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8782 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8783
8784
8785 </td> <!-- entry_type -->
8786
8787 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8788 <p>The maximum ratio between active area width
8789and crop region width,<wbr/> or between active area height and
8790crop region height,<wbr/> if the crop region height is larger
8791than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8792 </td>
8793
8794 <td class="entry_units">
8795 </td>
8796
8797 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8798 <blockquote>
8799<p>=1</p>
8800</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8801 </td>
8802
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8803 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8804 <ul class="entry_tags">
8805 <li><a href="#tag_BC">BC</a></li>
8806 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8807 </td>
8808
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8809 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8810
8811
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8812 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8813 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8814
8815
8816 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8817 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8818 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8819 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8820 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8821 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8822 <span class="entry_type_container">x</span>
8823
8824 <span class="entry_type_array">
8825 n
8826 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8827 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8828
8829
8830 </td> <!-- entry_type -->
8831
8832 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8833 <p>The minimum frame duration that is supported
8834for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8835correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8836stream is active,<wbr/> with all processing set to
8837FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8838 </td>
8839
8840 <td class="entry_units">
8841 </td>
8842
8843 <td class="entry_range">
8844 </td>
8845
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8846 <td class="entry_tags">
8847 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8848 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8849 </ul>
8850 </td>
8851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8852 </tr>
8853 <tr class="entries_header">
8854 <th class="th_details" colspan="5">Details</th>
8855 </tr>
8856 <tr class="entry_cont">
8857 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8858 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8859frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8860durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8861 </td>
8862 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8863
8864
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8865 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8866 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8867
8868
8869 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8870 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8871 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8872 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8873 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8874 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8875 <span class="entry_type_container">x</span>
8876
8877 <span class="entry_type_array">
8878 n x 2
8879 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8880 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8881
8882
8883 </td> <!-- entry_type -->
8884
8885 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8886 <p>The resolutions available for use with
8887processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
8888platform opaque YUV/<wbr/>RGB streams to the GPU or video
8889encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8890 </td>
8891
8892 <td class="entry_units">
8893 </td>
8894
8895 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8896 <p>Must include: - sensor maximum resolution -
8897standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
8898resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8899 </td>
8900
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8901 <td class="entry_tags">
8902 <ul class="entry_tags">
8903 <li><a href="#tag_BC">BC</a></li>
8904 </ul>
8905 </td>
8906
8907 </tr>
8908 <tr class="entries_header">
8909 <th class="th_details" colspan="5">Details</th>
8910 </tr>
8911 <tr class="entry_cont">
8912 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8913 <p>The actual supported resolution list may be limited by
8914consumer end points for different use cases.<wbr/> For example,<wbr/> for
8915recording use case,<wbr/> the largest supported resolution may be
8916limited by max supported size from encoder,<wbr/> for preview use
8917case,<wbr/> the largest supported resolution may be limited by max
8918resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8919 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8920 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8921
8922
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8923 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8924 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8925
8926
8927 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8928 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8929 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8930 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8931 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8932 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8933 <span class="entry_type_container">x</span>
8934
8935 <span class="entry_type_array">
8936 n
8937 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8938 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8939
8940
8941 </td> <!-- entry_type -->
8942
8943 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8944 <p>The minimum frame duration that is supported
8945for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8946correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8947is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8948 </td>
8949
8950 <td class="entry_units">
8951 </td>
8952
8953 <td class="entry_range">
8954 </td>
8955
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8956 <td class="entry_tags">
8957 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8958 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8959 </ul>
8960 </td>
8961
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8962 </tr>
8963 <tr class="entries_header">
8964 <th class="th_details" colspan="5">Details</th>
8965 </tr>
8966 <tr class="entry_cont">
8967 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8968 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8969frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8970durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8971 </td>
8972 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8973
8974
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8975 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8976 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8977
8978
8979 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8980 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8981 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8982 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8983 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8984 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8985 <span class="entry_type_container">x</span>
8986
8987 <span class="entry_type_array">
8988 n x 2
8989 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8990 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8991
8992
8993 </td> <!-- entry_type -->
8994
8995 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8996 <p>The resolutions available for use with raw
8997sensor output streams,<wbr/> listed as width,<wbr/>
8998height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8999 </td>
9000
9001 <td class="entry_units">
9002 </td>
9003
9004 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9005 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9006 </td>
9007
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9008 <td class="entry_tags">
9009 </td>
9010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9011 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9012
9013
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9014 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9015 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9016
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9017
9018
9019 <!-- end of kind -->
9020 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9021 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9022
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9023 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9024 <tr>
9025 <th class="th_name">Property Name</th>
9026 <th class="th_type">Type</th>
9027 <th class="th_description">Description</th>
9028 <th class="th_units">Units</th>
9029 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9030 <th class="th_tags">Tags</th>
9031 </tr>
9032 </thead>
9033
9034 <tbody>
9035
9036
9037
9038
9039
9040
9041
9042
9043
9044
9045 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9046 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9047 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9048 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9049 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9050 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9051 <span class="entry_type_container">x</span>
9052
9053 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9054 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9055 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9056 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9057
9058
9059 </td> <!-- entry_type -->
9060
9061 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9062 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9063<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9064(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9065output.<wbr/> Each stream must use this rectangle to produce its
9066output,<wbr/> cropping to a smaller region if necessary to
9067maintain the stream's aspect ratio.<wbr/></p>
9068<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9069 </td>
9070
9071 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9072 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9073 in pixels; (0,<wbr/>0) is top-left corner of
9074 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9075 </td>
9076
9077 <td class="entry_range">
9078 </td>
9079
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9080 <td class="entry_tags">
9081 <ul class="entry_tags">
9082 <li><a href="#tag_BC">BC</a></li>
9083 </ul>
9084 </td>
9085
9086 </tr>
9087 <tr class="entries_header">
9088 <th class="th_details" colspan="5">Details</th>
9089 </tr>
9090 <tr class="entry_cont">
9091 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9092 <p>Any additional per-stream cropping must be done to
9093maximize the final pixel area of the stream.<wbr/></p>
9094<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9095ratio,<wbr/> then 4:3 streams should use the exact crop
9096region.<wbr/> 16:9 streams should further crop vertically
9097(letterbox).<wbr/></p>
9098<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9099outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9100streams should match exactly.<wbr/> These additional crops must
9101be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9102<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9103times,<wbr/> no matter what the relative aspect ratios of the
9104crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9105corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9106larger than active pixel array.<wbr/> Width and height may be
9107rounded to nearest larger supportable width,<wbr/> especially
9108for raw output,<wbr/> where only a few fixed scales may be
9109possible.<wbr/> The width and height of the crop region cannot
9110be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9111android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9112activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9113respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9114 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9115 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9116
9117
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9118 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9119 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9120
9121
9122
9123 <!-- end of kind -->
9124 </tbody>
9125
9126 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9127 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9128
9129
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9130 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9131
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9132 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9133 <tr>
9134 <th class="th_name">Property Name</th>
9135 <th class="th_type">Type</th>
9136 <th class="th_description">Description</th>
9137 <th class="th_units">Units</th>
9138 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9139 <th class="th_tags">Tags</th>
9140 </tr>
9141 </thead>
9142
9143 <tbody>
9144
9145
9146
9147
9148
9149
9150
9151
9152
9153
9154 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9155 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9156 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9157 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9158 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9159 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9160
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9161 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9162
9163
9164 </td> <!-- entry_type -->
9165
9166 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9167 <p>Duration each pixel is exposed to
9168light.<wbr/></p>
9169<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
9170duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9171 </td>
9172
9173 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9174 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9175 </td>
9176
9177 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9178 <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]9179 </td>
9180
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9181 <td class="entry_tags">
9182 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9183 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9184 </ul>
9185 </td>
9186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9187 </tr>
9188 <tr class="entries_header">
9189 <th class="th_details" colspan="5">Details</th>
9190 </tr>
9191 <tr class="entry_cont">
9192 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9193 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9194 </td>
9195 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9196
9197
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9198 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9199 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9200
9201
9202 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9203 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9204 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9205 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9206 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9207 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9208
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9209 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9210
9211
9212 </td> <!-- entry_type -->
9213
9214 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9215 <p>Duration from start of frame exposure to
9216start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9217 </td>
9218
9219 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9220 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9221 </td>
9222
9223 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9224 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9225android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9226 </td>
9227
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9228 <td class="entry_tags">
9229 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9230 <li><a href="#tag_V1">V1</a></li>
9231 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9232 </ul>
9233 </td>
9234
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9235 </tr>
9236 <tr class="entries_header">
9237 <th class="th_details" colspan="5">Details</th>
9238 </tr>
9239 <tr class="entry_cont">
9240 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9241 <p>Exposure time has priority,<wbr/> so duration is set to
9242max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9243 </td>
9244 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9245
9246
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9247 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9248 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9249
9250
9251 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9252 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9253 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9254 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9255 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9256 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9257
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9258 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9259
9260
9261 </td> <!-- entry_type -->
9262
9263 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9264 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9265implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9266below 'maximum analog sensitivity'.<wbr/></p>
9267<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9268gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9269 </td>
9270
9271 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9272 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9273 </td>
9274
9275 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9276 <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]9277 </td>
9278
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9279 <td class="entry_tags">
9280 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9281 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9282 </ul>
9283 </td>
9284
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9285 </tr>
9286 <tr class="entries_header">
9287 <th class="th_details" colspan="5">Details</th>
9288 </tr>
9289 <tr class="entry_cont">
9290 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9291 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9292 </td>
9293 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9294
9295
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9296 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9297 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9298
9299
9300
9301 <!-- end of kind -->
9302 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9303 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9304
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9305 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9306 <tr>
9307 <th class="th_name">Property Name</th>
9308 <th class="th_type">Type</th>
9309 <th class="th_description">Description</th>
9310 <th class="th_units">Units</th>
9311 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9312 <th class="th_tags">Tags</th>
9313 </tr>
9314 </thead>
9315
9316 <tbody>
9317
9318
9319
9320
9321
9322
9323
9324
9325
9326
9327
9328
9329 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9330 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9331 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9332 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9333 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9334 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9335 <span class="entry_type_container">x</span>
9336
9337 <span class="entry_type_array">
9338 4
9339 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9340 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9341 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9342
9343
9344 </td> <!-- entry_type -->
9345
9346 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9347 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9348active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9349pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9350 </td>
9351
9352 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9353 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9354 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9355 </td>
9356
9357 <td class="entry_range">
9358 </td>
9359
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9360 <td class="entry_tags">
9361 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9362 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9363 </ul>
9364 </td>
9365
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9366 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9367
9368
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9369 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9370 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9371
9372
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9373 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9374 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9375 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9376 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9377 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9378 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9379 <span class="entry_type_container">x</span>
9380
9381 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9382 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9383 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9384 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9385 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9386
9387
9388 </td> <!-- entry_type -->
9389
9390 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9391 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9392 </td>
9393
9394 <td class="entry_units">
9395 </td>
9396
9397 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9398 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9399 </td>
9400
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9401 <td class="entry_tags">
9402 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9403 <li><a href="#tag_BC">BC</a></li>
9404 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9405 </ul>
9406 </td>
9407
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9408 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9409
9410
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9411 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9412 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9413
9414
9415 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9416 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9417 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9418 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9419 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9420 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9421
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9422 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9423
9424 <ul class="entry_type_enum">
9425 <li>
9426 <span class="entry_type_enum_name">RGGB</span>
9427 </li>
9428 <li>
9429 <span class="entry_type_enum_name">GRBG</span>
9430 </li>
9431 <li>
9432 <span class="entry_type_enum_name">GBRG</span>
9433 </li>
9434 <li>
9435 <span class="entry_type_enum_name">BGGR</span>
9436 </li>
9437 <li>
9438 <span class="entry_type_enum_name">RGB</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9439 <span class="entry_type_enum_notes">Sensor is not Bayer; output has 3 16-bit
9440 values for each pixel,<wbr/> instead of just 1 16-bit value
9441 per pixel.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9442 </li>
9443 </ul>
9444
9445 </td> <!-- entry_type -->
9446
9447 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9448 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9449represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9450the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9451 </td>
9452
9453 <td class="entry_units">
9454 </td>
9455
9456 <td class="entry_range">
9457 </td>
9458
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9459 <td class="entry_tags">
9460 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9461 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9462 </ul>
9463 </td>
9464
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9465 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9466
9467
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9468 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9469 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9470
9471
9472 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9473 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9474 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9475 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9476 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9477 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9478 <span class="entry_type_container">x</span>
9479
9480 <span class="entry_type_array">
9481 2
9482 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9483 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9484 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9485
9486
9487 </td> <!-- entry_type -->
9488
9489 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9490 <p>Range of valid exposure
9491times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9492 </td>
9493
9494 <td class="entry_units">
9495 </td>
9496
9497 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9498 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
9499sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9500 </td>
9501
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9502 <td class="entry_tags">
9503 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9504 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9505 </ul>
9506 </td>
9507
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9508 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9509
9510
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9511 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9512 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9513
9514
9515 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9516 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9517 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9518 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9519 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9520 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9521
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9522 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9523
9524
9525 </td> <!-- entry_type -->
9526
9527 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9528 <p>Maximum possible frame duration (minimum frame
9529rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9530 </td>
9531
9532 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9533 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9534 </td>
9535
9536 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9537 <blockquote>
9538<p>= 30e9</p>
9539</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9540 </td>
9541
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9542 <td class="entry_tags">
9543 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9544 <li><a href="#tag_BC">BC</a></li>
9545 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9546 </ul>
9547 </td>
9548
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9549 </tr>
9550 <tr class="entries_header">
9551 <th class="th_details" colspan="5">Details</th>
9552 </tr>
9553 <tr class="entry_cont">
9554 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9555 <p>Minimum duration is a function of resolution,<wbr/>
9556processing settings.<wbr/> See
9557android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
9558android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9559<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]9560 </td>
9561 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9562
9563
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9564 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9565 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9566
9567
9568 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9569 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9570 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9571 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9572 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9573 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9574 <span class="entry_type_container">x</span>
9575
9576 <span class="entry_type_array">
9577 2
9578 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]9579 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9580 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9581
9582
9583 </td> <!-- entry_type -->
9584
9585 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9586 <p>The physical dimensions of the full pixel
9587array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9588 </td>
9589
9590 <td class="entry_units">
9591 </td>
9592
9593 <td class="entry_range">
9594 </td>
9595
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9596 <td class="entry_tags">
9597 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9598 <li><a href="#tag_V1">V1</a></li>
9599 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9600 </ul>
9601 </td>
9602
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9603 </tr>
9604 <tr class="entries_header">
9605 <th class="th_details" colspan="5">Details</th>
9606 </tr>
9607 <tr class="entry_cont">
9608 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9609 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9610 </td>
9611 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9612
9613
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9614 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9615 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9616
9617
9618 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9619 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9620 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9621 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9622 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9623 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9624 <span class="entry_type_container">x</span>
9625
9626 <span class="entry_type_array">
9627 2
9628 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9629 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9630
9631
9632 </td> <!-- entry_type -->
9633
9634 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9635 <p>Dimensions of full pixel array,<wbr/> possibly
9636including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9637 </td>
9638
9639 <td class="entry_units">
9640 </td>
9641
9642 <td class="entry_range">
9643 </td>
9644
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9645 <td class="entry_tags">
9646 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9647 <li><a href="#tag_DNG">DNG</a></li>
9648 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9649 </ul>
9650 </td>
9651
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9652 </tr>
9653 <tr class="entries_header">
9654 <th class="th_details" colspan="5">Details</th>
9655 </tr>
9656 <tr class="entry_cont">
9657 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9658 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9659match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9660android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9661 </td>
9662 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9663
9664
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9665 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9666 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9667
9668
9669 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9670 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9671 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9672 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9673 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9674 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9675
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9676 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9677
9678
9679 </td> <!-- entry_type -->
9680
9681 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9682 <p>Maximum raw value output by
9683sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9684 </td>
9685
9686 <td class="entry_units">
9687 </td>
9688
9689 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9690 <blockquote>
9691<p>1024 (10-bit output)</p>
9692</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9693 </td>
9694
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9695 <td class="entry_tags">
9696 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9697 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9698 </ul>
9699 </td>
9700
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9701 </tr>
9702 <tr class="entries_header">
9703 <th class="th_details" colspan="5">Details</th>
9704 </tr>
9705 <tr class="entry_cont">
9706 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9707 <p>Defines sensor bit depth (10-14 bits is
9708expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9709 </td>
9710 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9711
9712
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9713 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9714 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9715
9716
9717
9718
9719
9720 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9721 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9722 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9723 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9724 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9725 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9726
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9727 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9728
9729
9730 </td> <!-- entry_type -->
9731
9732 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9733 <p>Gain factor from electrons to raw units when
9734ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9735 </td>
9736
9737 <td class="entry_units">
9738 </td>
9739
9740 <td class="entry_range">
9741 </td>
9742
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9743 <td class="entry_tags">
9744 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9745 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9746 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9747 </ul>
9748 </td>
9749
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9750 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9751
9752
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9753 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9754 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9755
9756
9757 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9758 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9759 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9760 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9761 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9762 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9763 <span class="entry_type_container">x</span>
9764
9765 <span class="entry_type_array">
9766 4
9767 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9768 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9769 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9770
9771
9772 </td> <!-- entry_type -->
9773
9774 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9775 <p>A fixed black level offset for each of the
9776Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9777 </td>
9778
9779 <td class="entry_units">
9780 </td>
9781
9782 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9783 <blockquote>
9784<p>= 0 each</p>
9785</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9786 </td>
9787
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9788 <td class="entry_tags">
9789 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9790 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9791 </ul>
9792 </td>
9793
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9794 </tr>
9795 <tr class="entries_header">
9796 <th class="th_details" colspan="5">Details</th>
9797 </tr>
9798 <tr class="entry_cont">
9799 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9800 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
9801tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9802 </td>
9803 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9804
9805
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9806 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9807 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9808
9809
9810 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9811 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9812 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9813 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9814 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9815 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9816 <span class="entry_type_container">x</span>
9817
9818 <span class="entry_type_array">
9819 9
9820 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9821 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9822 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9823
9824
9825 </td> <!-- entry_type -->
9826
9827 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9828 <p>Per-device calibration on top of color space
9829transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9830 </td>
9831
9832 <td class="entry_units">
9833 </td>
9834
9835 <td class="entry_range">
9836 </td>
9837
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9838 <td class="entry_tags">
9839 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9840 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9841 </ul>
9842 </td>
9843
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9844 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9845
9846
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9847 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9848 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9849
9850
9851 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9852 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9853 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9854 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9855 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9856 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9857 <span class="entry_type_container">x</span>
9858
9859 <span class="entry_type_array">
9860 9
9861 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9862 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9863 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9864
9865
9866 </td> <!-- entry_type -->
9867
9868 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9869 <p>Per-device calibration on top of color space
9870transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9871 </td>
9872
9873 <td class="entry_units">
9874 </td>
9875
9876 <td class="entry_range">
9877 </td>
9878
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9879 <td class="entry_tags">
9880 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9881 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9882 </ul>
9883 </td>
9884
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9885 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9886
9887
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9888 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9889 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9890
9891
9892 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9893 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9894 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9895 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9896 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9897 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9898 <span class="entry_type_container">x</span>
9899
9900 <span class="entry_type_array">
9901 9
9902 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9903 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9904 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9905
9906
9907 </td> <!-- entry_type -->
9908
9909 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9910 <p>Linear mapping from XYZ (D50) color space to
9911reference linear sensor color,<wbr/> for first reference
9912illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9913 </td>
9914
9915 <td class="entry_units">
9916 </td>
9917
9918 <td class="entry_range">
9919 </td>
9920
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9921 <td class="entry_tags">
9922 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9923 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9924 </ul>
9925 </td>
9926
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9927 </tr>
9928 <tr class="entries_header">
9929 <th class="th_details" colspan="5">Details</th>
9930 </tr>
9931 <tr class="entry_cont">
9932 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9933 <p>Use as follows XYZ = inv(transform) * clip( (raw -
9934black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
9935At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9936 </td>
9937 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9938
9939
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9940 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9941 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9942
9943
9944 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9945 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9946 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9947 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9948 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9949 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9950 <span class="entry_type_container">x</span>
9951
9952 <span class="entry_type_array">
9953 9
9954 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9955 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9956 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9957
9958
9959 </td> <!-- entry_type -->
9960
9961 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9962 <p>Linear mapping from XYZ (D50) color space to
9963reference linear sensor color,<wbr/> for second reference
9964illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9965 </td>
9966
9967 <td class="entry_units">
9968 </td>
9969
9970 <td class="entry_range">
9971 </td>
9972
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9973 <td class="entry_tags">
9974 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9975 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9976 </ul>
9977 </td>
9978
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9979 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9980
9981
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9982 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9983 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9984
9985
9986 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9987 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9988 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9989 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9990 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9991 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9992 <span class="entry_type_container">x</span>
9993
9994 <span class="entry_type_array">
9995 9
9996 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9997 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9998 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9999
10000
10001 </td> <!-- entry_type -->
10002
10003 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10004 <p>Used by DNG for better WB
10005adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10006 </td>
10007
10008 <td class="entry_units">
10009 </td>
10010
10011 <td class="entry_range">
10012 </td>
10013
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10014 <td class="entry_tags">
10015 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10016 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10017 </ul>
10018 </td>
10019
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10020 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10021
10022
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10023 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10024 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10025
10026
10027 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10028 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10029 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10030 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10031 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10032 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10033 <span class="entry_type_container">x</span>
10034
10035 <span class="entry_type_array">
10036 9
10037 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10038 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10039 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10040
10041
10042 </td> <!-- entry_type -->
10043
10044 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10045 <p>Used by DNG for better WB
10046adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10047 </td>
10048
10049 <td class="entry_units">
10050 </td>
10051
10052 <td class="entry_range">
10053 </td>
10054
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10055 <td class="entry_tags">
10056 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10057 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10058 </ul>
10059 </td>
10060
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10061 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10062
10063
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10064 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10065 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10066
10067
10068 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10069 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10070 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10071 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10072 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10073 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10074
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10075 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10076
10077
10078 </td> <!-- entry_type -->
10079
10080 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10081 <p>Maximum sensitivity that is implemented
10082purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10083 </td>
10084
10085 <td class="entry_units">
10086 </td>
10087
10088 <td class="entry_range">
10089 </td>
10090
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10091 <td class="entry_tags">
10092 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10093 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10094 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10095 </ul>
10096 </td>
10097
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10098 </tr>
10099 <tr class="entries_header">
10100 <th class="th_details" colspan="5">Details</th>
10101 </tr>
10102 <tr class="entry_cont">
10103 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10104 <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]10105equal to this,<wbr/> all applied gain must be analog.<wbr/> For
10106values above this,<wbr/> it can be a mix of analog and
10107digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10108 </td>
10109 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10110
10111
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10112 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10113 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10114
10115
10116 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10117 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10118 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10119 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10120 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10121 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10122 <span class="entry_type_container">x</span>
10123
10124 <span class="entry_type_array">
10125 2
10126 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10127 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10128 <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]10129
10130
10131 </td> <!-- entry_type -->
10132
10133 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10134 <p>Estimation of sensor noise
10135characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10136 </td>
10137
10138 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10139 var(raw pixel value) = electrons * (baseGainFactor
10140 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
10141 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10142 </td>
10143
10144 <td class="entry_range">
10145 </td>
10146
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10147 <td class="entry_tags">
10148 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10149 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10150 </ul>
10151 </td>
10152
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10153 </tr>
10154 <tr class="entries_header">
10155 <th class="th_details" colspan="5">Details</th>
10156 </tr>
10157 <tr class="entry_cont">
10158 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10159 <p>A represents sensor read noise before analog
10160amplification; B represents noise from A/<wbr/>D conversion and
10161other circuits after amplification.<wbr/> Both noise sources
10162are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
10163across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10164 </td>
10165 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10166
10167
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10168 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10169 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10170
10171
10172 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10173 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10174 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10175 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10176 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10177 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10178
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10179 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10180
10181
10182 </td> <!-- entry_type -->
10183
10184 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10185 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10186image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10187screen in its native orientation.<wbr/> Also defines the
10188direction of rolling shutter readout,<wbr/> which is from top
10189to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10190 </td>
10191
10192 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10193 degrees clockwise rotation,<wbr/> only multiples of
10194 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10195 </td>
10196
10197 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10198 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10199 </td>
10200
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10201 <td class="entry_tags">
10202 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10203 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10204 </ul>
10205 </td>
10206
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10207 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10208
10209
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10210 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10211 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10212
10213
10214 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10215 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10216 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10217 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10218 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10219 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10220
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10221 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10222
10223 <ul class="entry_type_enum">
10224 <li>
10225 <span class="entry_type_enum_name">DAYLIGHT</span>
10226 <span class="entry_type_enum_value">1</span>
10227 </li>
10228 <li>
10229 <span class="entry_type_enum_name">FLUORESCENT</span>
10230 <span class="entry_type_enum_value">2</span>
10231 </li>
10232 <li>
10233 <span class="entry_type_enum_name">TUNGSTEN</span>
10234 <span class="entry_type_enum_value">3</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10235 <span class="entry_type_enum_notes">Incandescent light</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10236 </li>
10237 <li>
10238 <span class="entry_type_enum_name">FLASH</span>
10239 <span class="entry_type_enum_value">4</span>
10240 </li>
10241 <li>
10242 <span class="entry_type_enum_name">FINE_WEATHER</span>
10243 <span class="entry_type_enum_value">9</span>
10244 </li>
10245 <li>
10246 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10247 <span class="entry_type_enum_value">10</span>
10248 </li>
10249 <li>
10250 <span class="entry_type_enum_name">SHADE</span>
10251 <span class="entry_type_enum_value">11</span>
10252 </li>
10253 <li>
10254 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10255 <span class="entry_type_enum_value">12</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10256 <span class="entry_type_enum_notes">D 5700 - 7100K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10257 </li>
10258 <li>
10259 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10260 <span class="entry_type_enum_value">13</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10261 <span class="entry_type_enum_notes">N 4600 - 5400K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10262 </li>
10263 <li>
10264 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10265 <span class="entry_type_enum_value">14</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10266 <span class="entry_type_enum_notes">W 3900 - 4500K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10267 </li>
10268 <li>
10269 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10270 <span class="entry_type_enum_value">15</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10271 <span class="entry_type_enum_notes">WW 3200 - 3700K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10272 </li>
10273 <li>
10274 <span class="entry_type_enum_name">STANDARD_A</span>
10275 <span class="entry_type_enum_value">17</span>
10276 </li>
10277 <li>
10278 <span class="entry_type_enum_name">STANDARD_B</span>
10279 <span class="entry_type_enum_value">18</span>
10280 </li>
10281 <li>
10282 <span class="entry_type_enum_name">STANDARD_C</span>
10283 <span class="entry_type_enum_value">19</span>
10284 </li>
10285 <li>
10286 <span class="entry_type_enum_name">D55</span>
10287 <span class="entry_type_enum_value">20</span>
10288 </li>
10289 <li>
10290 <span class="entry_type_enum_name">D65</span>
10291 <span class="entry_type_enum_value">21</span>
10292 </li>
10293 <li>
10294 <span class="entry_type_enum_name">D75</span>
10295 <span class="entry_type_enum_value">22</span>
10296 </li>
10297 <li>
10298 <span class="entry_type_enum_name">D50</span>
10299 <span class="entry_type_enum_value">23</span>
10300 </li>
10301 <li>
10302 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10303 <span class="entry_type_enum_value">24</span>
10304 </li>
10305 </ul>
10306
10307 </td> <!-- entry_type -->
10308
10309 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10310 <p>Light source used to define transform
103111</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10312 </td>
10313
10314 <td class="entry_units">
10315 </td>
10316
10317 <td class="entry_range">
10318 </td>
10319
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10320 <td class="entry_tags">
10321 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10322 <li><a href="#tag_DNG">DNG</a></li>
10323 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10324 </ul>
10325 </td>
10326
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10327 </tr>
10328 <tr class="entries_header">
10329 <th class="th_details" colspan="5">Details</th>
10330 </tr>
10331 <tr class="entry_cont">
10332 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10333 <p>[EXIF LightSource tag] Must all these be
10334supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10335 </td>
10336 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10337
10338
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10339 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10340 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10341
10342
10343 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10344 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10345 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10346 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10347 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10348 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10349
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10350 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10351
10352
10353 </td> <!-- entry_type -->
10354
10355 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10356 <p>Light source used to define transform
103572</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10358 </td>
10359
10360 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10361 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10362 </td>
10363
10364 <td class="entry_range">
10365 </td>
10366
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10367 <td class="entry_tags">
10368 </td>
10369
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10370 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10371
10372
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10373 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10374 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10375
10376
10377
10378 <!-- end of kind -->
10379 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10380 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10381
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10382 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10383 <tr>
10384 <th class="th_name">Property Name</th>
10385 <th class="th_type">Type</th>
10386 <th class="th_description">Description</th>
10387 <th class="th_units">Units</th>
10388 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10389 <th class="th_tags">Tags</th>
10390 </tr>
10391 </thead>
10392
10393 <tbody>
10394
10395
10396
10397
10398
10399
10400
10401
10402
10403
10404 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10405 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10406 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10407 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10408 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10409 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10410
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10411 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10412
10413
10414 </td> <!-- entry_type -->
10415
10416 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10417 <p>Duration each pixel is exposed to
10418light.<wbr/></p>
10419<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
10420duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10421 </td>
10422
10423 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10424 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10425 </td>
10426
10427 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10428 <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]10429 </td>
10430
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10431 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10432 <ul class="entry_tags">
10433 <li><a href="#tag_V1">V1</a></li>
10434 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10435 </td>
10436
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10437 </tr>
10438 <tr class="entries_header">
10439 <th class="th_details" colspan="5">Details</th>
10440 </tr>
10441 <tr class="entry_cont">
10442 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10443 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10444 </td>
10445 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10446
10447
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10448 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10449 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10450
10451
10452 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10453 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10454 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10455 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10456 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10457 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10458
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10459 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10460
10461
10462 </td> <!-- entry_type -->
10463
10464 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10465 <p>Duration from start of frame exposure to
10466start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10467 </td>
10468
10469 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10470 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10471 </td>
10472
10473 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10474 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
10475android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10476 </td>
10477
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10478 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10479 <ul class="entry_tags">
10480 <li><a href="#tag_V1">V1</a></li>
10481 <li><a href="#tag_BC">BC</a></li>
10482 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10483 </td>
10484
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10485 </tr>
10486 <tr class="entries_header">
10487 <th class="th_details" colspan="5">Details</th>
10488 </tr>
10489 <tr class="entry_cont">
10490 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10491 <p>Exposure time has priority,<wbr/> so duration is set to
10492max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10493 </td>
10494 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10495
10496
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10497 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10498 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10499
10500
10501 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10502 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10503 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10504 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10505 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10506 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10507
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10508 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10509
10510
10511 </td> <!-- entry_type -->
10512
10513 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10514 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10515implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10516below 'maximum analog sensitivity'.<wbr/></p>
10517<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10518gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10519 </td>
10520
10521 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10522 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10523 </td>
10524
10525 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10526 <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]10527 </td>
10528
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10529 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10530 <ul class="entry_tags">
10531 <li><a href="#tag_V1">V1</a></li>
10532 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10533 </td>
10534
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10535 </tr>
10536 <tr class="entries_header">
10537 <th class="th_details" colspan="5">Details</th>
10538 </tr>
10539 <tr class="entry_cont">
10540 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10541 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10542 </td>
10543 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10544
10545
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10546 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10547 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10548
10549
10550 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10551 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10552 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10553 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10554 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10555 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10556
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10557 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10558
10559
10560 </td> <!-- entry_type -->
10561
10562 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10563 <p>Time at start of exposure of first
10564row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10565 </td>
10566
10567 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10568 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10569 </td>
10570
10571 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10572 <blockquote>
10573<p>0</p>
10574</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10575 </td>
10576
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10577 <td class="entry_tags">
10578 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10579 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10580 </ul>
10581 </td>
10582
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10583 </tr>
10584 <tr class="entries_header">
10585 <th class="th_details" colspan="5">Details</th>
10586 </tr>
10587 <tr class="entry_cont">
10588 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10589 <p>Monotonic,<wbr/> should be synced to other timestamps in
10590system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10591 </td>
10592 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10593
10594
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10595 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10596 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10597
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10598
10599 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10600 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10601 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10602 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10603 <td class="entry_type">
10604 <span class="entry_type_name">float</span>
10605
10606 <span class="entry_type_visibility"> [public]</span>
10607
10608
10609 </td> <!-- entry_type -->
10610
10611 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10612 <p>The temperature of the sensor,<wbr/> sampled at the time
10613exposure began for this frame.<wbr/></p>
10614<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
10615somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10616 </td>
10617
10618 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10619 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10620 </td>
10621
10622 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10623 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10624 </td>
10625
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10626 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10627 <ul class="entry_tags">
10628 <li><a href="#tag_FULL">FULL</a></li>
10629 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10630 </td>
10631
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10632 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10633
10634
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10635 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10636 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10637
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10638
10639
10640 <!-- end of kind -->
10641 </tbody>
10642
10643 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10644 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10645
10646
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10647 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10648
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10649 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10650 <tr>
10651 <th class="th_name">Property Name</th>
10652 <th class="th_type">Type</th>
10653 <th class="th_description">Description</th>
10654 <th class="th_units">Units</th>
10655 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10656 <th class="th_tags">Tags</th>
10657 </tr>
10658 </thead>
10659
10660 <tbody>
10661
10662
10663
10664
10665
10666
10667
10668
10669
10670
10671 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10672 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10673 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10674 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10675 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10676 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10677
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10678 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10679
10680 <ul class="entry_type_enum">
10681 <li>
10682 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10683 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10684 </li>
10685 <li>
10686 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10687 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10688 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10689 </li>
10690 <li>
10691 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10692 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10693 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10694 </li>
10695 </ul>
10696
10697 </td> <!-- entry_type -->
10698
10699 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10700 <p>Quality of lens shading correction applied
10701to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10702 </td>
10703
10704 <td class="entry_units">
10705 </td>
10706
10707 <td class="entry_range">
10708 </td>
10709
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10710 <td class="entry_tags">
10711 </td>
10712
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10713 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10714
10715
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10716 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10717 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10718
10719
10720 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10721 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10722 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10723 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10724 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10725 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10726
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10727 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10728
10729
10730 </td> <!-- entry_type -->
10731
10732 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10733 <p>Control the amount of shading correction
10734applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10735 </td>
10736
10737 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10738 unitless: 1-10; 10 is full shading
10739 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10740 </td>
10741
10742 <td class="entry_range">
10743 </td>
10744
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10745 <td class="entry_tags">
10746 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10747 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10748 </ul>
10749 </td>
10750
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10751 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10752
10753
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10754 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10755 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10756
10757
10758
10759 <!-- end of kind -->
10760 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10761 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10762
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10763 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10764 <tr>
10765 <th class="th_name">Property Name</th>
10766 <th class="th_type">Type</th>
10767 <th class="th_description">Description</th>
10768 <th class="th_units">Units</th>
10769 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10770 <th class="th_tags">Tags</th>
10771 </tr>
10772 </thead>
10773
10774 <tbody>
10775
10776
10777
10778
10779
10780
10781
10782
10783
10784
10785 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10786 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10787 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10788 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10789 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10790 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10791
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10792 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10793
10794 <ul class="entry_type_enum">
10795 <li>
10796 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10797 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10798 </li>
10799 <li>
10800 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10801 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10802 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10803 </li>
10804 <li>
10805 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10806 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10807 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10808 </li>
10809 </ul>
10810
10811 </td> <!-- entry_type -->
10812
10813 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10814 <p>Quality of lens shading correction applied
10815to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10816 </td>
10817
10818 <td class="entry_units">
10819 </td>
10820
10821 <td class="entry_range">
10822 </td>
10823
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10824 <td class="entry_tags">
10825 </td>
10826
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10827 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10828
10829
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10830 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10831 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10832
10833
10834
10835 <!-- end of kind -->
10836 </tbody>
10837
10838 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10839 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10840
10841
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10842 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10843
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10844 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10845 <tr>
10846 <th class="th_name">Property Name</th>
10847 <th class="th_type">Type</th>
10848 <th class="th_description">Description</th>
10849 <th class="th_units">Units</th>
10850 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10851 <th class="th_tags">Tags</th>
10852 </tr>
10853 </thead>
10854
10855 <tbody>
10856
10857
10858
10859
10860
10861
10862
10863
10864
10865
10866 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10867 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10868 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10869 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10870 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10871 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10872
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10873 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10874
10875 <ul class="entry_type_enum">
10876 <li>
10877 <span class="entry_type_enum_name">OFF</span>
10878 </li>
10879 <li>
10880 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10881 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
10882 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10883 </li>
10884 <li>
10885 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10886 <span class="entry_type_enum_notes">Optional Return all face
10887 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10888 </li>
10889 </ul>
10890
10891 </td> <!-- entry_type -->
10892
10893 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10894 <p>State of the face detector
10895unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10896 </td>
10897
10898 <td class="entry_units">
10899 </td>
10900
10901 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10902 <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]10903 </td>
10904
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10905 <td class="entry_tags">
10906 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10907 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10908 </ul>
10909 </td>
10910
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10911 </tr>
10912 <tr class="entries_header">
10913 <th class="th_details" colspan="5">Details</th>
10914 </tr>
10915 <tr class="entry_cont">
10916 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10917 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10918should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10919fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10920<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]10921 </td>
10922 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10923
10924
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10925 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10926 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10927
10928
10929 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10930 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10931 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10932 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10933 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10934 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10935
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10936 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10937
10938 <ul class="entry_type_enum">
10939 <li>
10940 <span class="entry_type_enum_name">OFF</span>
10941 </li>
10942 <li>
10943 <span class="entry_type_enum_name">ON</span>
10944 </li>
10945 </ul>
10946
10947 </td> <!-- entry_type -->
10948
10949 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10950 <p>Operating mode for histogram
10951generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10952 </td>
10953
10954 <td class="entry_units">
10955 </td>
10956
10957 <td class="entry_range">
10958 </td>
10959
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10960 <td class="entry_tags">
10961 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10962 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10963 </ul>
10964 </td>
10965
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10966 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10967
10968
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10969 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10970 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10971
10972
10973 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10974 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10975 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10976 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10977 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10978 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10979
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10980 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10981
10982 <ul class="entry_type_enum">
10983 <li>
10984 <span class="entry_type_enum_name">OFF</span>
10985 </li>
10986 <li>
10987 <span class="entry_type_enum_name">ON</span>
10988 </li>
10989 </ul>
10990
10991 </td> <!-- entry_type -->
10992
10993 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10994 <p>Operating mode for sharpness map
10995generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10996 </td>
10997
10998 <td class="entry_units">
10999 </td>
11000
11001 <td class="entry_range">
11002 </td>
11003
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11004 <td class="entry_tags">
11005 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11006 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11007 </ul>
11008 </td>
11009
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11010 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11011
11012
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11013 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11014 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11015
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11016
11017 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11018 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11019 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11020 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11021 <td class="entry_type">
11022 <span class="entry_type_name entry_type_name_enum">byte</span>
11023
11024 <span class="entry_type_visibility"> [public]</span>
11025
11026 <ul class="entry_type_enum">
11027 <li>
11028 <span class="entry_type_enum_name">OFF</span>
11029 </li>
11030 <li>
11031 <span class="entry_type_enum_name">ON</span>
11032 </li>
11033 </ul>
11034
11035 </td> <!-- entry_type -->
11036
11037 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11038 <p>Whether the HAL needs to output the lens
11039shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11040 </td>
11041
11042 <td class="entry_units">
11043 </td>
11044
11045 <td class="entry_range">
11046 </td>
11047
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11048 <td class="entry_tags">
11049 </td>
11050
11051 </tr>
11052 <tr class="entries_header">
11053 <th class="th_details" colspan="5">Details</th>
11054 </tr>
11055 <tr class="entry_cont">
11056 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11057 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11058<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]11059the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11060 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11061 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11062
11063
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11064 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11065 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11066
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11067
11068
11069 <!-- end of kind -->
11070 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11071 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11072
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11073 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11074 <tr>
11075 <th class="th_name">Property Name</th>
11076 <th class="th_type">Type</th>
11077 <th class="th_description">Description</th>
11078 <th class="th_units">Units</th>
11079 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11080 <th class="th_tags">Tags</th>
11081 </tr>
11082 </thead>
11083
11084 <tbody>
11085
11086
11087
11088
11089
11090
11091
11092
11093
11094
11095
11096
11097 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11098 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11099 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11100 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11101 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11102 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11103 <span class="entry_type_container">x</span>
11104
11105 <span class="entry_type_array">
11106 n
11107 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11108 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11109 <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]11110
11111
11112 </td> <!-- entry_type -->
11113
11114 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11115 <p>Which face detection modes are available,<wbr/>
11116if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11117 </td>
11118
11119 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11120 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11121 OFF
11122 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11123 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11124 </td>
11125
11126 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11127 </td>
11128
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11129 <td class="entry_tags">
11130 </td>
11131
11132 </tr>
11133 <tr class="entries_header">
11134 <th class="th_details" colspan="5">Details</th>
11135 </tr>
11136 <tr class="entry_cont">
11137 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11138 <p>OFF means face detection is disabled,<wbr/> it must
11139be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11140<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11141<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
11142<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]11143<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11144<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
11145<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]11146 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11147 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11148
11149
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11150 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11151 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11152
11153
11154 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11155 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11156 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11157 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11158 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11159 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11160
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11161 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11162
11163
11164 </td> <!-- entry_type -->
11165
11166 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11167 <p>Number of histogram buckets
11168supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11169 </td>
11170
11171 <td class="entry_units">
11172 </td>
11173
11174 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11175 <blockquote>
11176<p>= 64</p>
11177</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11178 </td>
11179
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11180 <td class="entry_tags">
11181 </td>
11182
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11183 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11184
11185
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11186 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11187 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11188
11189
11190 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11191 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11192 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11193 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11194 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11195 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11196
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11197 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11198
11199
11200 </td> <!-- entry_type -->
11201
11202 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11203 <p>Maximum number of simultaneously detectable
11204faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11205 </td>
11206
11207 <td class="entry_units">
11208 </td>
11209
11210 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11211 <blockquote>
11212<p>= 4 if availableFaceDetectionModes lists
11213modes besides OFF,<wbr/> otherwise 0</p>
11214</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11215 </td>
11216
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11217 <td class="entry_tags">
11218 </td>
11219
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11220 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11221
11222
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11223 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11224 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11225
11226
11227 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11228 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11229 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11230 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11231 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11232 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11233
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11234 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11235
11236
11237 </td> <!-- entry_type -->
11238
11239 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11240 <p>Maximum value possible for a histogram
11241bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11242 </td>
11243
11244 <td class="entry_units">
11245 </td>
11246
11247 <td class="entry_range">
11248 </td>
11249
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11250 <td class="entry_tags">
11251 </td>
11252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11253 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11254
11255
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11256 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11257 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11258
11259
11260 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11261 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11262 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11263 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11264 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11265 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11266
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11267 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11268
11269
11270 </td> <!-- entry_type -->
11271
11272 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11273 <p>Maximum value possible for a sharpness map
11274region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11275 </td>
11276
11277 <td class="entry_units">
11278 </td>
11279
11280 <td class="entry_range">
11281 </td>
11282
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11283 <td class="entry_tags">
11284 </td>
11285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11286 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11287
11288
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11289 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11290 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11291
11292
11293 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11294 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11295 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11296 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11297 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11298 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11299 <span class="entry_type_container">x</span>
11300
11301 <span class="entry_type_array">
11302 2
11303 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11304 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11305 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11306
11307
11308 </td> <!-- entry_type -->
11309
11310 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11311 <p>Dimensions of the sharpness
11312map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11313 </td>
11314
11315 <td class="entry_units">
11316 </td>
11317
11318 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11319 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11320 </td>
11321
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11322 <td class="entry_tags">
11323 </td>
11324
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11325 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11326
11327
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11328 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11329 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11330
11331
11332
11333
11334
11335
11336 <!-- end of kind -->
11337 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11338 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11339
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11340 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11341 <tr>
11342 <th class="th_name">Property Name</th>
11343 <th class="th_type">Type</th>
11344 <th class="th_description">Description</th>
11345 <th class="th_units">Units</th>
11346 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11347 <th class="th_tags">Tags</th>
11348 </tr>
11349 </thead>
11350
11351 <tbody>
11352
11353
11354
11355
11356
11357
11358
11359
11360
11361
11362 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11363 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11364 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11365 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11366 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11367 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11368
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11369 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11370
11371 <ul class="entry_type_enum">
11372 <li>
11373 <span class="entry_type_enum_name">OFF</span>
11374 </li>
11375 <li>
11376 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11377 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
11378 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11379 </li>
11380 <li>
11381 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11382 <span class="entry_type_enum_notes">Optional Return all face
11383 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11384 </li>
11385 </ul>
11386
11387 </td> <!-- entry_type -->
11388
11389 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11390 <p>State of the face detector
11391unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11392 </td>
11393
11394 <td class="entry_units">
11395 </td>
11396
11397 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11398 <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]11399 </td>
11400
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11401 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11402 <ul class="entry_tags">
11403 <li><a href="#tag_BC">BC</a></li>
11404 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11405 </td>
11406
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11407 </tr>
11408 <tr class="entries_header">
11409 <th class="th_details" colspan="5">Details</th>
11410 </tr>
11411 <tr class="entry_cont">
11412 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11413 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11414should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11415fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11416<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]11417 </td>
11418 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11419
11420
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11421 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11422 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11423
11424
11425 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11426 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11427 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11428 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11429 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11430 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11431 <span class="entry_type_container">x</span>
11432
11433 <span class="entry_type_array">
11434 n
11435 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11436 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11437
11438
11439 </td> <!-- entry_type -->
11440
11441 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11442 <p>List of unique IDs for detected
11443faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11444 </td>
11445
11446 <td class="entry_units">
11447 </td>
11448
11449 <td class="entry_range">
11450 </td>
11451
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11452 <td class="entry_tags">
11453 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11454 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11455 </ul>
11456 </td>
11457
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11458 </tr>
11459 <tr class="entries_header">
11460 <th class="th_details" colspan="5">Details</th>
11461 </tr>
11462 <tr class="entry_cont">
11463 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11464 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11465 </td>
11466 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11467
11468
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11469 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11470 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11471
11472
11473 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11474 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11475 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11476 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11477 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11478 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11479 <span class="entry_type_container">x</span>
11480
11481 <span class="entry_type_array">
11482 n x 6
11483 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11484 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11485 <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]11486
11487
11488 </td> <!-- entry_type -->
11489
11490 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11491 <p>List of landmarks for detected
11492faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11493 </td>
11494
11495 <td class="entry_units">
11496 </td>
11497
11498 <td class="entry_range">
11499 </td>
11500
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11501 <td class="entry_tags">
11502 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11503 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11504 </ul>
11505 </td>
11506
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11507 </tr>
11508 <tr class="entries_header">
11509 <th class="th_details" colspan="5">Details</th>
11510 </tr>
11511 <tr class="entry_cont">
11512 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11513 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11514 </td>
11515 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11516
11517
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11518 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11519 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11520
11521
11522 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11523 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11524 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11525 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11526 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11527 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11528 <span class="entry_type_container">x</span>
11529
11530 <span class="entry_type_array">
11531 n x 4
11532 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11533 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11534 <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]11535
11536
11537 </td> <!-- entry_type -->
11538
11539 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11540 <p>List of the bounding rectangles for detected
11541faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11542 </td>
11543
11544 <td class="entry_units">
11545 </td>
11546
11547 <td class="entry_range">
11548 </td>
11549
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11550 <td class="entry_tags">
11551 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11552 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11553 </ul>
11554 </td>
11555
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11556 </tr>
11557 <tr class="entries_header">
11558 <th class="th_details" colspan="5">Details</th>
11559 </tr>
11560 <tr class="entry_cont">
11561 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11562 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11563 </td>
11564 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11565
11566
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11567 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11568 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11569
11570
11571 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11572 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11573 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11574 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11575 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11576 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11577 <span class="entry_type_container">x</span>
11578
11579 <span class="entry_type_array">
11580 n
11581 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11582 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11583
11584
11585 </td> <!-- entry_type -->
11586
11587 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11588 <p>List of the face confidence scores for
11589detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11590 </td>
11591
11592 <td class="entry_units">
11593 </td>
11594
11595 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11596 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11597 </td>
11598
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11599 <td class="entry_tags">
11600 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11601 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11602 </ul>
11603 </td>
11604
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11605 </tr>
11606 <tr class="entries_header">
11607 <th class="th_details" colspan="5">Details</th>
11608 </tr>
11609 <tr class="entry_cont">
11610 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11611 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
11612meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11613 </td>
11614 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11615
11616
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11617 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11618 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11619
11620
11621 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11622 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11623 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11624 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11625 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11626 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11627 <span class="entry_type_container">x</span>
11628
11629 <span class="entry_type_array">
11630 n x 3
11631 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11632 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11633 <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]11634
11635
11636 </td> <!-- entry_type -->
11637
11638 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11639 <p>A 3-channel histogram based on the raw
11640sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11641 </td>
11642
11643 <td class="entry_units">
11644 </td>
11645
11646 <td class="entry_range">
11647 </td>
11648
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11649 <td class="entry_tags">
11650 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11651 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11652 </ul>
11653 </td>
11654
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11655 </tr>
11656 <tr class="entries_header">
11657 <th class="th_details" colspan="5">Details</th>
11658 </tr>
11659 <tr class="entry_cont">
11660 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11661 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11662(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]11663(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
11664supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11665 </td>
11666 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11667
11668
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11669 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11670 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11671
11672
11673 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11674 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11675 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11676 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11677 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11678 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11679
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11680 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11681
11682 <ul class="entry_type_enum">
11683 <li>
11684 <span class="entry_type_enum_name">OFF</span>
11685 </li>
11686 <li>
11687 <span class="entry_type_enum_name">ON</span>
11688 </li>
11689 </ul>
11690
11691 </td> <!-- entry_type -->
11692
11693 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11694 <p>Operating mode for histogram
11695generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11696 </td>
11697
11698 <td class="entry_units">
11699 </td>
11700
11701 <td class="entry_range">
11702 </td>
11703
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11704 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11705 <ul class="entry_tags">
11706 <li><a href="#tag_V1">V1</a></li>
11707 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11708 </td>
11709
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11710 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11711
11712
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11713 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11714 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11715
11716
11717 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11718 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11719 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11720 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11721 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11722 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11723 <span class="entry_type_container">x</span>
11724
11725 <span class="entry_type_array">
11726 n x m x 3
11727 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11728 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11729 <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]11730
11731
11732 </td> <!-- entry_type -->
11733
11734 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11735 <p>A 3-channel sharpness map,<wbr/> based on the raw
11736sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11737 </td>
11738
11739 <td class="entry_units">
11740 </td>
11741
11742 <td class="entry_range">
11743 </td>
11744
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11745 <td class="entry_tags">
11746 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11747 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11748 </ul>
11749 </td>
11750
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11751 </tr>
11752 <tr class="entries_header">
11753 <th class="th_details" colspan="5">Details</th>
11754 </tr>
11755 <tr class="entry_cont">
11756 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11757 <p>If only a monochrome sharpness map is supported,<wbr/>
11758all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11759 </td>
11760 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11761
11762
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11763 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11764 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11765
11766
11767 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11768 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11769 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11770 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11771 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11772 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11773
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11774 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11775
11776 <ul class="entry_type_enum">
11777 <li>
11778 <span class="entry_type_enum_name">OFF</span>
11779 </li>
11780 <li>
11781 <span class="entry_type_enum_name">ON</span>
11782 </li>
11783 </ul>
11784
11785 </td> <!-- entry_type -->
11786
11787 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11788 <p>Operating mode for sharpness map
11789generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11790 </td>
11791
11792 <td class="entry_units">
11793 </td>
11794
11795 <td class="entry_range">
11796 </td>
11797
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11798 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11799 <ul class="entry_tags">
11800 <li><a href="#tag_V1">V1</a></li>
11801 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11802 </td>
11803
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11804 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11805
11806
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11807 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11808 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11809
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11810
11811 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11812 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11813 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11814 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11815 <td class="entry_type">
11816 <span class="entry_type_name">float</span>
11817 <span class="entry_type_container">x</span>
11818
11819 <span class="entry_type_array">
11820 4 x n x m
11821 </span>
11822 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11823 <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]11824
11825
11826 </td> <!-- entry_type -->
11827
11828 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11829 <p>The shading map is a low-resolution floating-point map
11830that lists the coefficients used to correct for vignetting,<wbr/> for each
11831Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11832 </td>
11833
11834 <td class="entry_units">
11835 </td>
11836
11837 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11838 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11839 </td>
11840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11841 <td class="entry_tags">
11842 </td>
11843
11844 </tr>
11845 <tr class="entries_header">
11846 <th class="th_details" colspan="5">Details</th>
11847 </tr>
11848 <tr class="entry_cont">
11849 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11850 <p>The least shaded section of the image should have a gain factor
11851of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11852<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]11853must take into account the colorCorrection settings.<wbr/></p>
11854<p>The shading map is for the entire active pixel array,<wbr/> and is not
11855affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11856entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11857pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
11858map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
11859(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
11860pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
11861The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
11862<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
11863channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
11864The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11865is 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]11866<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
11867and must be smaller than 64x64.<wbr/></p>
11868<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11869<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
11870<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]11871[ 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/>
11872 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/>
11873 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/>
11874 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/>
11875 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/>
11876 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]11877</code></pre>
11878<p>The low-resolution scaling map images for each channel are
11879(displayed using nearest-neighbor interpolation):</p>
11880<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
11881<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
11882<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
11883<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]11884<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11885image 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]11886<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]11887 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11888 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11889
11890
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11891 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11892 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11893
11894
11895 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11896 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11897 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11898 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11899 <td class="entry_type">
11900 <span class="entry_type_name">float</span>
11901 <span class="entry_type_container">x</span>
11902
11903 <span class="entry_type_array">
11904 4
11905 </span>
11906 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11907 <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]11908
11909
11910 </td> <!-- entry_type -->
11911
11912 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11913 <p>The best-fit color channel gains calculated
11914by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11915 </td>
11916
11917 <td class="entry_units">
11918 </td>
11919
11920 <td class="entry_range">
11921 </td>
11922
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11923 <td class="entry_tags">
11924 </td>
11925
11926 </tr>
11927 <tr class="entries_header">
11928 <th class="th_details" colspan="5">Details</th>
11929 </tr>
11930 <tr class="entry_cont">
11931 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11932 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11933since statistics processing on data from a new frame
11934typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11935applied to that frame.<wbr/></p>
11936<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11937see <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]11938<p>This value should always be calculated by the AWB block,<wbr/>
11939regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11940 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11941 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11942
11943
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11944 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11945 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11946
11947
11948 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11949 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11950 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11951 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11952 <td class="entry_type">
11953 <span class="entry_type_name">rational</span>
11954 <span class="entry_type_container">x</span>
11955
11956 <span class="entry_type_array">
11957 3 x 3
11958 </span>
11959 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11960 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11961
11962
11963 </td> <!-- entry_type -->
11964
11965 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11966 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11967calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11968output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11969 </td>
11970
11971 <td class="entry_units">
11972 </td>
11973
11974 <td class="entry_range">
11975 </td>
11976
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11977 <td class="entry_tags">
11978 </td>
11979
11980 </tr>
11981 <tr class="entries_header">
11982 <th class="th_details" colspan="5">Details</th>
11983 </tr>
11984 <tr class="entry_cont">
11985 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11986 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11987statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11988for the next frame.<wbr/> These are the values the HAL believes
11989are the best fit for the current output frame.<wbr/> This may
11990be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11991statistics processing on data from a new frame typically
11992completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11993that frame.<wbr/></p>
11994<p>These estimates must be provided for all frames,<wbr/> even if
11995capture settings and color transforms are set by the application.<wbr/></p>
11996<p>This value should always be calculated by the AWB block,<wbr/>
11997regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11998 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11999 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12000
12001
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12002 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12003 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12004
12005
12006 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12007 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12008 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12009 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12010 <td class="entry_type">
12011 <span class="entry_type_name entry_type_name_enum">byte</span>
12012
12013 <span class="entry_type_visibility"> [public]</span>
12014
12015 <ul class="entry_type_enum">
12016 <li>
12017 <span class="entry_type_enum_name">NONE</span>
12018 </li>
12019 <li>
12020 <span class="entry_type_enum_name">50HZ</span>
12021 </li>
12022 <li>
12023 <span class="entry_type_enum_name">60HZ</span>
12024 </li>
12025 </ul>
12026
12027 </td> <!-- entry_type -->
12028
12029 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12030 <p>The HAL estimated scene illumination lighting
12031frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12032 </td>
12033
12034 <td class="entry_units">
12035 </td>
12036
12037 <td class="entry_range">
12038 </td>
12039
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12040 <td class="entry_tags">
12041 </td>
12042
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12043 </tr>
12044 <tr class="entries_header">
12045 <th class="th_details" colspan="5">Details</th>
12046 </tr>
12047 <tr class="entry_cont">
12048 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12049 <p>Report NONE if there doesn't appear to be flickering
12050illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12051 </td>
12052 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12053
12054
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12055 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12056 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12057
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12058
12059
12060 <!-- end of kind -->
12061 </tbody>
12062
12063 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12064 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12065
12066
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12067 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12068
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12069 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12070 <tr>
12071 <th class="th_name">Property Name</th>
12072 <th class="th_type">Type</th>
12073 <th class="th_description">Description</th>
12074 <th class="th_units">Units</th>
12075 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12076 <th class="th_tags">Tags</th>
12077 </tr>
12078 </thead>
12079
12080 <tbody>
12081
12082
12083
12084
12085
12086
12087
12088
12089
12090
12091 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12092 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12093 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12094 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12095 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12096 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12097 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12098
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12099 <span class="entry_type_array">
12100 n x 2
12101 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12102 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12103 <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]12104
12105
12106 </td> <!-- entry_type -->
12107
12108 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12109 <p>Table mapping blue input values to output
12110values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12111 </td>
12112
12113 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12114 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12115 </td>
12116
12117 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12118 <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]12119 </td>
12120
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12121 <td class="entry_tags">
12122 </td>
12123
12124 </tr>
12125 <tr class="entries_header">
12126 <th class="th_details" colspan="5">Details</th>
12127 </tr>
12128 <tr class="entry_cont">
12129 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12130 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12131channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12132<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]12133 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12134 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12135
12136
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12137 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12138 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12139
12140
12141 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12142 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12143 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12144 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12145 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12146 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12147 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12148
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12149 <span class="entry_type_array">
12150 n x 2
12151 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12152 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12153 <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]12154
12155
12156 </td> <!-- entry_type -->
12157
12158 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12159 <p>Table mapping green input values to output
12160values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12161 </td>
12162
12163 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12164 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12165 </td>
12166
12167 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12168 <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]12169 </td>
12170
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12171 <td class="entry_tags">
12172 </td>
12173
12174 </tr>
12175 <tr class="entries_header">
12176 <th class="th_details" colspan="5">Details</th>
12177 </tr>
12178 <tr class="entry_cont">
12179 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12180 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12181channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12182<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]12183 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12184 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12185
12186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12187 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12188 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12189
12190
12191 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12192 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12193 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12194 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12195 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12196 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12197 <span class="entry_type_container">x</span>
12198
12199 <span class="entry_type_array">
12200 n x 2
12201 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12202 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12203 <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]12204
12205
12206 </td> <!-- entry_type -->
12207
12208 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12209 <p>Table mapping red input values to output
12210values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12211 </td>
12212
12213 <td class="entry_units">
12214 </td>
12215
12216 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12217 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12218 </td>
12219
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12220 <td class="entry_tags">
12221 <ul class="entry_tags">
12222 <li><a href="#tag_DNG">DNG</a></li>
12223 </ul>
12224 </td>
12225
12226 </tr>
12227 <tr class="entries_header">
12228 <th class="th_details" colspan="5">Details</th>
12229 </tr>
12230 <tr class="entry_cont">
12231 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12232 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12233channel,<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]12234<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12235the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12236are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12237between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12238<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12239defined points.<wbr/> The points will be listed in increasing
12240order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
122410.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12242for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
122430.<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]12244 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12245 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12246
12247
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12248 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12249 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12250
12251
12252 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12253 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12254 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12255 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12256 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12257 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12258
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12259 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12260
12261 <ul class="entry_type_enum">
12262 <li>
12263 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12264 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12265 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12266 </li>
12267 <li>
12268 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12269 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12270 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12271 </li>
12272 <li>
12273 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12274 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12275 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12276 </li>
12277 </ul>
12278
12279 </td> <!-- entry_type -->
12280
12281 <td class="entry_description">
12282 </td>
12283
12284 <td class="entry_units">
12285 </td>
12286
12287 <td class="entry_range">
12288 </td>
12289
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12290 <td class="entry_tags">
12291 </td>
12292
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12293 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12294
12295
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12296 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12297 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12298
12299
12300
12301 <!-- end of kind -->
12302 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12303 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12304
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12305 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12306 <tr>
12307 <th class="th_name">Property Name</th>
12308 <th class="th_type">Type</th>
12309 <th class="th_description">Description</th>
12310 <th class="th_units">Units</th>
12311 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12312 <th class="th_tags">Tags</th>
12313 </tr>
12314 </thead>
12315
12316 <tbody>
12317
12318
12319
12320
12321
12322
12323
12324
12325
12326
12327 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12328 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12329 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12330 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12331 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12332 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12333
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12334 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12335
12336
12337 </td> <!-- entry_type -->
12338
12339 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12340 <p>Maximum number of supported points in the
12341tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12342 </td>
12343
12344 <td class="entry_units">
12345 </td>
12346
12347 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12348 <blockquote>
12349<p>= 128</p>
12350</blockquote>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12351 </td>
12352
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12353 <td class="entry_tags">
12354 </td>
12355
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12356 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12357
12358
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12359 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12360 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12361
12362
12363
12364 <!-- end of kind -->
12365 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12366 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12367
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12368 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12369 <tr>
12370 <th class="th_name">Property Name</th>
12371 <th class="th_type">Type</th>
12372 <th class="th_description">Description</th>
12373 <th class="th_units">Units</th>
12374 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12375 <th class="th_tags">Tags</th>
12376 </tr>
12377 </thead>
12378
12379 <tbody>
12380
12381
12382
12383
12384
12385
12386
12387
12388
12389
12390 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12391 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12392 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12393 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12394 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12395 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12396 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12397
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12398 <span class="entry_type_array">
12399 n x 2
12400 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12401 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12402 <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]12403
12404
12405 </td> <!-- entry_type -->
12406
12407 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12408 <p>Table mapping blue input values to output
12409values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12410 </td>
12411
12412 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12413 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12414 </td>
12415
12416 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12417 <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]12418 </td>
12419
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12420 <td class="entry_tags">
12421 </td>
12422
12423 </tr>
12424 <tr class="entries_header">
12425 <th class="th_details" colspan="5">Details</th>
12426 </tr>
12427 <tr class="entry_cont">
12428 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12429 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12430channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12431<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]12432 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12433 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12434
12435
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12436 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12437 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12438
12439
12440 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12441 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12442 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12443 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12444 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12445 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12446 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12447
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12448 <span class="entry_type_array">
12449 n x 2
12450 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12451 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12452 <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]12453
12454
12455 </td> <!-- entry_type -->
12456
12457 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12458 <p>Table mapping green input values to output
12459values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12460 </td>
12461
12462 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12463 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12464 </td>
12465
12466 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12467 <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]12468 </td>
12469
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12470 <td class="entry_tags">
12471 </td>
12472
12473 </tr>
12474 <tr class="entries_header">
12475 <th class="th_details" colspan="5">Details</th>
12476 </tr>
12477 <tr class="entry_cont">
12478 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12479 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12480channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12481<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]12482 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12483 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12484
12485
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12486 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12487 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12488
12489
12490 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12491 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12492 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12493 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12494 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12495 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12496 <span class="entry_type_container">x</span>
12497
12498 <span class="entry_type_array">
12499 n x 2
12500 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12501 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12502 <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]12503
12504
12505 </td> <!-- entry_type -->
12506
12507 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12508 <p>Table mapping red input values to output
12509values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12510 </td>
12511
12512 <td class="entry_units">
12513 </td>
12514
12515 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12516 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12517 </td>
12518
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12519 <td class="entry_tags">
12520 <ul class="entry_tags">
12521 <li><a href="#tag_DNG">DNG</a></li>
12522 </ul>
12523 </td>
12524
12525 </tr>
12526 <tr class="entries_header">
12527 <th class="th_details" colspan="5">Details</th>
12528 </tr>
12529 <tr class="entry_cont">
12530 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12531 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12532channel,<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]12533<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12534the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12535are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12536between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12537<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12538defined points.<wbr/> The points will be listed in increasing
12539order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
125400.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12541for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
125420.<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]12543 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12544 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12545
12546
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12547 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12548 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12549
12550
12551 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12552 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12553 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12554 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12555 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12556 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12557
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12558 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12559
12560 <ul class="entry_type_enum">
12561 <li>
12562 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12563 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12564 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12565 </li>
12566 <li>
12567 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12568 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12569 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12570 </li>
12571 <li>
12572 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12573 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12574 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12575 </li>
12576 </ul>
12577
12578 </td> <!-- entry_type -->
12579
12580 <td class="entry_description">
12581 </td>
12582
12583 <td class="entry_units">
12584 </td>
12585
12586 <td class="entry_range">
12587 </td>
12588
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12589 <td class="entry_tags">
12590 </td>
12591
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12592 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12593
12594
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12595 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12596 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12597
12598
12599
12600 <!-- end of kind -->
12601 </tbody>
12602
12603 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12604 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12605
12606
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12607 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12608
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12609 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12610 <tr>
12611 <th class="th_name">Property Name</th>
12612 <th class="th_type">Type</th>
12613 <th class="th_description">Description</th>
12614 <th class="th_units">Units</th>
12615 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12616 <th class="th_tags">Tags</th>
12617 </tr>
12618 </thead>
12619
12620 <tbody>
12621
12622
12623
12624
12625
12626
12627
12628
12629
12630
12631 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12632 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12633 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12634 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12635 <td class="entry_type">
12636 <span class="entry_type_name entry_type_name_enum">byte</span>
12637
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12638 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12639
12640 <ul class="entry_type_enum">
12641 <li>
12642 <span class="entry_type_enum_name">OFF</span>
12643 </li>
12644 <li>
12645 <span class="entry_type_enum_name">ON</span>
12646 </li>
12647 </ul>
12648
12649 </td> <!-- entry_type -->
12650
12651 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12652 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12653that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12654Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12655disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12656any untrusted applications.<wbr/></p>
12657<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12658transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12659data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12660<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]12661doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12662 </td>
12663
12664 <td class="entry_units">
12665 </td>
12666
12667 <td class="entry_range">
12668 </td>
12669
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12670 <td class="entry_tags">
12671 </td>
12672
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12673 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12674
12675
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12676 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12677 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12678
12679
12680
12681 <!-- end of kind -->
12682 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12683 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12684
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12685 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12686 <tr>
12687 <th class="th_name">Property Name</th>
12688 <th class="th_type">Type</th>
12689 <th class="th_description">Description</th>
12690 <th class="th_units">Units</th>
12691 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12692 <th class="th_tags">Tags</th>
12693 </tr>
12694 </thead>
12695
12696 <tbody>
12697
12698
12699
12700
12701
12702
12703
12704
12705
12706
12707 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12708 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12709 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12710 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12711 <td class="entry_type">
12712 <span class="entry_type_name entry_type_name_enum">byte</span>
12713
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12714 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12715
12716 <ul class="entry_type_enum">
12717 <li>
12718 <span class="entry_type_enum_name">OFF</span>
12719 </li>
12720 <li>
12721 <span class="entry_type_enum_name">ON</span>
12722 </li>
12723 </ul>
12724
12725 </td> <!-- entry_type -->
12726
12727 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12728 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12729that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12730Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12731disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12732any untrusted applications.<wbr/></p>
12733<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12734transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12735data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12736<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]12737doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12738 </td>
12739
12740 <td class="entry_units">
12741 </td>
12742
12743 <td class="entry_range">
12744 </td>
12745
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12746 <td class="entry_tags">
12747 </td>
12748
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12749 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12750
12751
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12752 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12753 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12754
12755
12756
12757 <!-- end of kind -->
12758 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12759 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12760
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12761 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12762 <tr>
12763 <th class="th_name">Property Name</th>
12764 <th class="th_type">Type</th>
12765 <th class="th_description">Description</th>
12766 <th class="th_units">Units</th>
12767 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12768 <th class="th_tags">Tags</th>
12769 </tr>
12770 </thead>
12771
12772 <tbody>
12773
12774
12775
12776
12777
12778
12779
12780
12781
12782
12783 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12784 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12785 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12786 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12787 <td class="entry_type">
12788 <span class="entry_type_name entry_type_name_enum">byte</span>
12789 <span class="entry_type_container">x</span>
12790
12791 <span class="entry_type_array">
12792 n
12793 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12794 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12795
12796 <ul class="entry_type_enum">
12797 <li>
12798 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12799 <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]12800 </li>
12801 </ul>
12802
12803 </td> <!-- entry_type -->
12804
12805 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12806 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12807 </td>
12808
12809 <td class="entry_units">
12810 </td>
12811
12812 <td class="entry_range">
12813 </td>
12814
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12815 <td class="entry_tags">
12816 </td>
12817
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12818 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12819
12820
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12821 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12822 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12823
12824
12825
12826 <!-- end of kind -->
12827 </tbody>
12828
12829 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12830 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12831
12832
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12833 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12834
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12835 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12836 <tr>
12837 <th class="th_name">Property Name</th>
12838 <th class="th_type">Type</th>
12839 <th class="th_description">Description</th>
12840 <th class="th_units">Units</th>
12841 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12842 <th class="th_tags">Tags</th>
12843 </tr>
12844 </thead>
12845
12846 <tbody>
12847
12848
12849
12850
12851
12852
12853
12854
12855
12856
12857 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12858 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12859 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12860 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12861 <td class="entry_type">
12862 <span class="entry_type_name entry_type_name_enum">byte</span>
12863
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12864 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12865
12866 <ul class="entry_type_enum">
12867 <li>
12868 <span class="entry_type_enum_name">LIMITED</span>
12869 </li>
12870 <li>
12871 <span class="entry_type_enum_name">FULL</span>
12872 </li>
12873 </ul>
12874
12875 </td> <!-- entry_type -->
12876
12877 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12878 <p>The camera 3 HAL device can implement one of two possible
12879operational modes; limited and full.<wbr/> Full support is
12880expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12881hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12882camera HAL device v1 implementation,<wbr/> and is expected from
12883older or inexpensive devices.<wbr/> Full is a strict superset of
12884limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
12885<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]12886 </td>
12887
12888 <td class="entry_units">
12889 </td>
12890
12891 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12892 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12893 </td>
12894
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12895 <td class="entry_tags">
12896 </td>
12897
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12898 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12899
12900
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12901 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12902 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12903
12904
12905
12906 <!-- end of kind -->
12907 </tbody>
12908
12909 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12910 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12911
12912
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12913 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12914
12915 <thead class="entries_header">
12916 <tr>
12917 <th class="th_name">Property Name</th>
12918 <th class="th_type">Type</th>
12919 <th class="th_description">Description</th>
12920 <th class="th_units">Units</th>
12921 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12922 <th class="th_tags">Tags</th>
12923 </tr>
12924 </thead>
12925
12926 <tbody>
12927
12928
12929
12930
12931
12932
12933
12934
12935
12936
12937 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12938 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12939 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12940 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12941 <td class="entry_type">
12942 <span class="entry_type_name entry_type_name_enum">byte</span>
12943
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12944 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12945
12946 <ul class="entry_type_enum">
12947 <li>
12948 <span class="entry_type_enum_name">OFF</span>
12949 </li>
12950 <li>
12951 <span class="entry_type_enum_name">ON</span>
12952 </li>
12953 </ul>
12954
12955 </td> <!-- entry_type -->
12956
12957 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12958 <p>Whether black-level compensation is locked
12959to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12960 </td>
12961
12962 <td class="entry_units">
12963 </td>
12964
12965 <td class="entry_range">
12966 </td>
12967
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12968 <td class="entry_tags">
12969 <ul class="entry_tags">
12970 <li><a href="#tag_HAL2">HAL2</a></li>
12971 </ul>
12972 </td>
12973
12974 </tr>
12975 <tr class="entries_header">
12976 <th class="th_details" colspan="5">Details</th>
12977 </tr>
12978 <tr class="entry_cont">
12979 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12980 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12981compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12982OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12983<p>Since changes to certain capture parameters (such as
12984exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12985compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12986the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12987metadata.<wbr/></p>
12988<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12989<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12990<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12991<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12992<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12993<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12994<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12995<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12996</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12997<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12998device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12999result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13000<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13001<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13002<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13003<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13004<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
13005<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13006<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13007</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13008<p>This indicates to the application that on frame 4,<wbr/> black
13009levels were reset due to exposure value changes,<wbr/> and pixel
13010values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13011<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13012possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13013other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13014or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13015 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13016 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13017
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13018 <tr class="entries_header">
13019 <th class="th_details" colspan="5">HAL Implementation Details</th>
13020 </tr>
13021 <tr class="entry_cont">
13022 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13023 <p>If for some reason black level locking is no longer possible
13024(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13025black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13026override this request (and it must report 'OFF' when this
13027does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13028possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13029 </td>
13030 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13031
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13032 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13033 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13034
13035
13036
13037 <!-- end of kind -->
13038 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13039 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13040
13041 <thead class="entries_header">
13042 <tr>
13043 <th class="th_name">Property Name</th>
13044 <th class="th_type">Type</th>
13045 <th class="th_description">Description</th>
13046 <th class="th_units">Units</th>
13047 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13048 <th class="th_tags">Tags</th>
13049 </tr>
13050 </thead>
13051
13052 <tbody>
13053
13054
13055
13056
13057
13058
13059
13060
13061
13062
13063 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13064 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13065 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13066 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13067 <td class="entry_type">
13068 <span class="entry_type_name entry_type_name_enum">byte</span>
13069
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13070 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13071
13072 <ul class="entry_type_enum">
13073 <li>
13074 <span class="entry_type_enum_name">OFF</span>
13075 </li>
13076 <li>
13077 <span class="entry_type_enum_name">ON</span>
13078 </li>
13079 </ul>
13080
13081 </td> <!-- entry_type -->
13082
13083 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13084 <p>Whether black-level compensation is locked
13085to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13086 </td>
13087
13088 <td class="entry_units">
13089 </td>
13090
13091 <td class="entry_range">
13092 </td>
13093
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13094 <td class="entry_tags">
13095 <ul class="entry_tags">
13096 <li><a href="#tag_HAL2">HAL2</a></li>
13097 </ul>
13098 </td>
13099
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13100 </tr>
13101 <tr class="entries_header">
13102 <th class="th_details" colspan="5">Details</th>
13103 </tr>
13104 <tr class="entry_cont">
13105 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13106 <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]13107ON 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]13108a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13109perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13110 </td>
13111 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13112
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13113 <tr class="entries_header">
13114 <th class="th_details" colspan="5">HAL Implementation Details</th>
13115 </tr>
13116 <tr class="entry_cont">
13117 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13118 <p>If for some reason black level locking is no longer possible
13119(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13120black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13121override this request (and it must report 'OFF' when this
13122does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13123possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13124 </td>
13125 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13126
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13127 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13128 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13129
13130
13131
13132 <!-- end of kind -->
13133 </tbody>
13134
13135 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13136<!-- </namespace> -->
13137 </table>
13138
13139 <div class="tags" id="tag_index">
13140 <h2>Tags</h2>
13141 <ul>
13142 <li id="tag_AWB">AWB -
13143 Needed for auto white balance
13144
13145 <ul class="tags_entries">
13146 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13147 </ul>
13148 </li> <!-- tag_AWB -->
13149 <li id="tag_BC">BC -
13150 Needed for backwards compatibility with old Java API
13151
13152 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]13153 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13154 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
13155 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
13156 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
13157 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
13158 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13159 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13160 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
13161 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13162 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13163 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
13164 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13165 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
13166 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
13167 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
13168 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
13169 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
13170 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame^]13171 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13172 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
13173 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
13174 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
13175 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
13176 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
13177 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
13178 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
13179 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
13180 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
13181 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
13182 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
13183 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
13184 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
13185 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
13186 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
13187 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
13188 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
13189 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
13190 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
13191 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13192 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13193 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
13194 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
13195 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
13196 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
13197 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
13198 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
13199 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]13200 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13201 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
13202 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
13203 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13204 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13205 <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]13206 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13207 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13208 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13209 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
13210 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
13211 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
13212 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
13213 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
13214 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
13215 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
13216 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
13217 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
13218 </ul>
13219 </li> <!-- tag_BC -->
13220 <li id="tag_V1">V1 -
13221 New features for first camera 2 release (API1)
13222
13223 <ul class="tags_entries">
13224 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13225 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13226 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13227 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13228 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13229 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13230 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13231 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13232 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13233 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13234 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13235 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13236 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13237 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13238 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13239 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13240 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13241 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13242 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13243 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13244 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13245 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13246 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13247 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13248 <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]13249 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13250 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13251 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13252 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13253 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13254 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13255 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13256 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13257 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13258 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13259 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13260 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13261 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13262 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13263 </ul>
13264 </li> <!-- tag_V1 -->
13265 <li id="tag_ADV">ADV - None
13266 <ul class="tags_entries">
13267 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13268 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13269 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13270 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13271 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13272 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13273 </ul>
13274 </li> <!-- tag_ADV -->
13275 <li id="tag_DNG">DNG -
13276 Needed for DNG file support
13277
13278 <ul class="tags_entries">
13279 <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]13280 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13281 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13282 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13283 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13284 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13285 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13286 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13287 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13288 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13289 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13290 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13291 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13292 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13293 </ul>
13294 </li> <!-- tag_DNG -->
13295 <li id="tag_EXIF">EXIF - None
13296 <ul class="tags_entries">
13297 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13298 </ul>
13299 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13300 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13301 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13302
13303 <ul class="tags_entries">
13304 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13305 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13306 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13307 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13308 </ul>
13309 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13310 <li id="tag_FULL">FULL -
13311 Entry is required for full hardware level devices, and optional for other hardware levels
13312
13313 <ul class="tags_entries">
13314 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13315 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13316 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13317 </ul>
13318 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13319 </ul>
13320 </div>
13321
13322 [ <a href="#">top</a> ]
13323
13324</body>
13325</html>