Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / 7787f7fb72b4be4dd7f9dc5326ce7fd2cea772b9 / . / camera / docs / docs.html
blob: c702d8bb75eb69539c36a7c19a984ca5800904a0 [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">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]1669 <p><a href="#static_android.control.afAvailableModes">android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1670 </td>
1671
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1672 <td class="entry_tags">
1673 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1674 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1675 </ul>
1676 </td>
1677
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1678 </tr>
1679 <tr class="entries_header">
1680 <th class="th_details" colspan="5">Details</th>
1681 </tr>
1682 <tr class="entry_cont">
1683 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1684 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]1685<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
1686the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
1687in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1688 </td>
1689 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1690
1691
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1692 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1693 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1694
1695
1696 <tr class="entry" id="controls_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1697 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1698 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1699 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1700 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1701 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1702 <span class="entry_type_container">x</span>
1703
1704 <span class="entry_type_array">
1705 5 x area_count
1706 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1707 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1708
1709
1710 </td> <!-- entry_type -->
1711
1712 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1713 <p>List of areas to use for focus
1714estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1715 </td>
1716
1717 <td class="entry_units">
1718 </td>
1719
1720 <td class="entry_range">
1721 </td>
1722
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1723 <td class="entry_tags">
1724 <ul class="entry_tags">
1725 <li><a href="#tag_BC">BC</a></li>
1726 </ul>
1727 </td>
1728
1729 </tr>
1730 <tr class="entries_header">
1731 <th class="th_details" colspan="5">Details</th>
1732 </tr>
1733 <tr class="entry_cont">
1734 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1735 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1736xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1737specified coordinates.<wbr/></p>
1738<p>The coordinate system is based on the active pixel array,<wbr/>
1739with (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]1740(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1741<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]1742bottom-right pixel in the active pixel array.<wbr/> The weight
1743should be nonnegative.<wbr/></p>
1744<p>If all regions have 0 weight,<wbr/> then no specific focus area
1745needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1746outside 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]1747should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1748used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1749 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1750 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1751
1752
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1753 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1754 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1755
1756
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1757 <tr class="entry" id="controls_android.control.afTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1758 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1759 android.<wbr/>control.<wbr/>af<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1760 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1761 <td class="entry_type">
1762 <span class="entry_type_name entry_type_name_enum">byte</span>
1763
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1764 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1765
1766 <ul class="entry_type_enum">
1767 <li>
1768 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1769 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1770 </li>
1771 <li>
1772 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1773 <span class="entry_type_enum_notes">Autofocus must trigger now.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1774 </li>
1775 <li>
1776 <span class="entry_type_enum_name">CANCEL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1777 <span class="entry_type_enum_notes">Autofocus must return to initial
1778 state,<wbr/> and cancel any active trigger.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1779 </li>
1780 </ul>
1781
1782 </td> <!-- entry_type -->
1783
1784 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1785 <p>Whether the HAL must trigger autofocus.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1786 </td>
1787
1788 <td class="entry_units">
1789 </td>
1790
1791 <td class="entry_range">
1792 </td>
1793
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1794 <td class="entry_tags">
1795 <ul class="entry_tags">
1796 <li><a href="#tag_BC">BC</a></li>
1797 </ul>
1798 </td>
1799
1800 </tr>
1801 <tr class="entries_header">
1802 <th class="th_details" colspan="5">Details</th>
1803 </tr>
1804 <tr class="entry_cont">
1805 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1806 <p>This entry is normally set to IDLE,<wbr/> or is not
1807included at all in the request settings.<wbr/></p>
1808<p>When included and set to START,<wbr/> the HAL must trigger the
1809autofocus algorithm.<wbr/> The effect of AF trigger depends on the
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1810current AF mode and state; see the camera HAL device v3
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1811header for details.<wbr/> When set to CANCEL,<wbr/> the HAL must cancel
1812any active trigger,<wbr/> and return to initial AF state.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1813 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1814 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1815
1816
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1817 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1818 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1819
1820
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1821 <tr class="entry" id="controls_android.control.awbLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1822 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1823 android.<wbr/>control.<wbr/>awb<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1824 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1825 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1826 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1827
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1828 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1829
1830 <ul class="entry_type_enum">
1831 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1832 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1833 <span class="entry_type_enum_notes">Auto-whitebalance lock is disabled; the AWB
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1834 algorithm is free to update its parameters if in AUTO
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1835 mode.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1836 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1837 <li>
1838 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1839 <span class="entry_type_enum_notes">Auto-whitebalance lock is enabled; the AWB
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1840 algorithm must not update the exposure and sensitivity
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1841 parameters while the lock is active</span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1842 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1843 </ul>
1844
1845 </td> <!-- entry_type -->
1846
1847 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1848 <p>Whether AWB is currently locked to its
1849latest calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1850 </td>
1851
1852 <td class="entry_units">
1853 </td>
1854
1855 <td class="entry_range">
1856 </td>
1857
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1858 <td class="entry_tags">
1859 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1860 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1861 </ul>
1862 </td>
1863
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1864 </tr>
1865 <tr class="entries_header">
1866 <th class="th_details" colspan="5">Details</th>
1867 </tr>
1868 <tr class="entry_cont">
1869 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1870 <p>Note that AWB lock is only meaningful for AUTO
1871mode; in other modes,<wbr/> AWB is already fixed to a specific
1872setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1873 </td>
1874 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1875
1876
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1877 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1878 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1879
1880
1881 <tr class="entry" id="controls_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1882 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1883 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1884 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1885 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1886 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1887
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1888 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1889
1890 <ul class="entry_type_enum">
1891 <li>
1892 <span class="entry_type_enum_name">OFF</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]1893 <span class="entry_type_enum_notes">
1894 The camera device's auto white balance routine is disabled;
1895 the application-selected color transform matrix
1896 (android.<wbr/>color<wbr/>Correction.<wbr/>transform) and gains
1897 (android.<wbr/>color<wbr/>Correction.<wbr/>gains) are used by the camera
1898 device for manual white balance control.<wbr/>
1899 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1900 </li>
1901 <li>
1902 <span class="entry_type_enum_name">AUTO</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]1903 <span class="entry_type_enum_notes">
1904 The camera device's auto white balance routine is active;
1905 the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
1906 and android.<wbr/>color<wbr/>Correction.<wbr/>gains are ignored.<wbr/>
1907 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1908 </li>
1909 <li>
1910 <span class="entry_type_enum_name">INCANDESCENT</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]1911 <span class="entry_type_enum_notes">
1912 The camera device's auto white balance routine is disabled;
1913 the camera device uses incandescent light as the assumed scene
1914 illumination for white balance.<wbr/> While the exact white balance
1915 transforms are up to the camera device,<wbr/> they will approximately
1916 match the CIE standard illuminant A.<wbr/>
1917 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1918 </li>
1919 <li>
1920 <span class="entry_type_enum_name">FLUORESCENT</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]1921 <span class="entry_type_enum_notes">
1922 The camera device's auto white balance routine is disabled;
1923 the camera device uses fluorescent light as the assumed scene
1924 illumination for white balance.<wbr/> While the exact white balance
1925 transforms are up to the camera device,<wbr/> they will approximately
1926 match the CIE standard illuminant F2.<wbr/>
1927 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1928 </li>
1929 <li>
1930 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]1931 <span class="entry_type_enum_notes">
1932 The camera device's auto white balance routine is disabled;
1933 the camera device uses warm fluorescent light as the assumed scene
1934 illumination for white balance.<wbr/> While the exact white balance
1935 transforms are up to the camera device,<wbr/> they will approximately
1936 match the CIE standard illuminant F4.<wbr/>
1937 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1938 </li>
1939 <li>
1940 <span class="entry_type_enum_name">DAYLIGHT</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]1941 <span class="entry_type_enum_notes">
1942 The camera device's auto white balance routine is disabled;
1943 the camera device uses daylight light as the assumed scene
1944 illumination for white balance.<wbr/> While the exact white balance
1945 transforms are up to the camera device,<wbr/> they will approximately
1946 match the CIE standard illuminant D65.<wbr/>
1947 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1948 </li>
1949 <li>
1950 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]1951 <span class="entry_type_enum_notes">
1952 The camera device's auto white balance routine is disabled;
1953 the camera device uses cloudy daylight light as the assumed scene
1954 illumination for white balance.<wbr/>
1955 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1956 </li>
1957 <li>
1958 <span class="entry_type_enum_name">TWILIGHT</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]1959 <span class="entry_type_enum_notes">
1960 The camera device's auto white balance routine is disabled;
1961 the camera device uses twilight light as the assumed scene
1962 illumination for white balance.<wbr/>
1963 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1964 </li>
1965 <li>
1966 <span class="entry_type_enum_name">SHADE</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]1967 <span class="entry_type_enum_notes">
1968 The camera device's auto white balance routine is disabled;
1969 the camera device uses shade light as the assumed scene
1970 illumination for white balance.<wbr/>
1971 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1972 </li>
1973 </ul>
1974
1975 </td> <!-- entry_type -->
1976
1977 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1978 <p>Whether AWB is currently setting the color
1979transform fields,<wbr/> and what its illumination target
1980is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1981 </td>
1982
1983 <td class="entry_units">
1984 </td>
1985
1986 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]1987 <p><a href="#static_android.control.awbAvailableModes">android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1988 </td>
1989
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1990 <td class="entry_tags">
1991 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1992 <li><a href="#tag_BC">BC</a></li>
1993 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1994 </ul>
1995 </td>
1996
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1997 </tr>
1998 <tr class="entries_header">
1999 <th class="th_details" colspan="5">Details</th>
2000 </tr>
2001 <tr class="entry_cont">
2002 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]2003 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
2004<p>When set to the ON mode,<wbr/> the camera device's auto white balance
2005routine is enabled,<wbr/> overriding the application's selected
2006<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> and
2007<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
2008<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
2009routine is disabled.<wbr/> The applicantion manually controls the white
2010balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
2011and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
2012<p>When set to any other modes,<wbr/> the camera device's auto white balance
2013routine is disabled.<wbr/> The camera device uses each particular illumination
2014target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2015 </td>
2016 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2017
2018
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2019 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2020 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2021
2022
2023 <tr class="entry" id="controls_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2024 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2025 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2026 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2027 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2028 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2029 <span class="entry_type_container">x</span>
2030
2031 <span class="entry_type_array">
2032 5 x area_count
2033 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2034 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2035
2036
2037 </td> <!-- entry_type -->
2038
2039 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2040 <p>List of areas to use for illuminant
2041estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2042 </td>
2043
2044 <td class="entry_units">
2045 </td>
2046
2047 <td class="entry_range">
2048 </td>
2049
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2050 <td class="entry_tags">
2051 <ul class="entry_tags">
2052 <li><a href="#tag_BC">BC</a></li>
2053 </ul>
2054 </td>
2055
2056 </tr>
2057 <tr class="entries_header">
2058 <th class="th_details" colspan="5">Details</th>
2059 </tr>
2060 <tr class="entry_cont">
2061 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2062 <p>Only used in AUTO mode.<wbr/></p>
2063<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
2064xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
2065specified coordinates.<wbr/></p>
2066<p>The coordinate system is based on the active pixel array,<wbr/>
2067with (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]2068(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
2069<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]2070bottom-right pixel in the active pixel array.<wbr/> The weight
2071should be nonnegative.<wbr/></p>
2072<p>If all regions have 0 weight,<wbr/> then no specific metering area
2073needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2074outside 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]2075should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2076used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2077 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2078 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2079
2080
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2081 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2082 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2083
2084
2085 <tr class="entry" id="controls_android.control.captureIntent">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2086 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2087 android.<wbr/>control.<wbr/>capture<wbr/>Intent
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2088 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2089 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2090 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2091
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2092 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2093
2094 <ul class="entry_type_enum">
2095 <li>
2096 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2097 <span class="entry_type_enum_notes">This request doesn't fall into the other
2098 categories.<wbr/> Default to preview-like
2099 behavior.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2100 </li>
2101 <li>
2102 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2103 <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]2104 precapture trigger may be used to start off a metering
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2105 w/<wbr/>flash sequence</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2106 </li>
2107 <li>
2108 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2109 <span class="entry_type_enum_notes">This request is for a still capture-type
2110 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2111 </li>
2112 <li>
2113 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2114 <span class="entry_type_enum_notes">This request is for a video recording
2115 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2116 </li>
2117 <li>
2118 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2119 <span class="entry_type_enum_notes">This request is for a video snapshot (still
2120 image while recording video) usecase</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2121 </li>
2122 <li>
2123 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2124 <span class="entry_type_enum_notes">This request is for a ZSL usecase; the
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2125 application will stream full-resolution images and
2126 reprocess one or several later for a final
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2127 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2128 </li>
2129 </ul>
2130
2131 </td> <!-- entry_type -->
2132
2133 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2134 <p>Information to 3A routines about the purpose
2135of this capture,<wbr/> to help decide optimal 3A
2136strategy</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2137 </td>
2138
2139 <td class="entry_units">
2140 </td>
2141
2142 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2143 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2144 </td>
2145
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2146 <td class="entry_tags">
2147 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2148 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2149 </ul>
2150 </td>
2151
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2152 </tr>
2153 <tr class="entries_header">
2154 <th class="th_details" colspan="5">Details</th>
2155 </tr>
2156 <tr class="entry_cont">
2157 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2158 <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]2159 </td>
2160 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2161
2162
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2163 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2164 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2165
2166
2167 <tr class="entry" id="controls_android.control.effectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2168 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2169 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2170 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2171 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2172 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2173
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2174 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2175
2176 <ul class="entry_type_enum">
2177 <li>
2178 <span class="entry_type_enum_name">OFF</span>
2179 </li>
2180 <li>
2181 <span class="entry_type_enum_name">MONO</span>
2182 <span class="entry_type_enum_optional">optional</span>
2183 </li>
2184 <li>
2185 <span class="entry_type_enum_name">NEGATIVE</span>
2186 <span class="entry_type_enum_optional">optional</span>
2187 </li>
2188 <li>
2189 <span class="entry_type_enum_name">SOLARIZE</span>
2190 <span class="entry_type_enum_optional">optional</span>
2191 </li>
2192 <li>
2193 <span class="entry_type_enum_name">SEPIA</span>
2194 <span class="entry_type_enum_optional">optional</span>
2195 </li>
2196 <li>
2197 <span class="entry_type_enum_name">POSTERIZE</span>
2198 <span class="entry_type_enum_optional">optional</span>
2199 </li>
2200 <li>
2201 <span class="entry_type_enum_name">WHITEBOARD</span>
2202 <span class="entry_type_enum_optional">optional</span>
2203 </li>
2204 <li>
2205 <span class="entry_type_enum_name">BLACKBOARD</span>
2206 <span class="entry_type_enum_optional">optional</span>
2207 </li>
2208 <li>
2209 <span class="entry_type_enum_name">AQUA</span>
2210 <span class="entry_type_enum_optional">optional</span>
2211 </li>
2212 </ul>
2213
2214 </td> <!-- entry_type -->
2215
2216 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2217 <p>Whether any special color effect is in use.<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2218Only 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]2219 </td>
2220
2221 <td class="entry_units">
2222 </td>
2223
2224 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2225 <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]2226 </td>
2227
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2228 <td class="entry_tags">
2229 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2230 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2231 </ul>
2232 </td>
2233
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2234 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2235
2236
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2237 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2238 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2239
2240
2241 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2242 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2243 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2244 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2245 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2246 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2247
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2248 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2249
2250 <ul class="entry_type_enum">
2251 <li>
2252 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2253 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
2254 routines are disabled,<wbr/> no other settings in
2255 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2256 </li>
2257 <li>
2258 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2259 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
2260 Manual control of capture parameters is disabled.<wbr/> All
2261 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2262 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2263 </li>
2264 <li>
2265 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2266 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
2267 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2268 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2269 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2270 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2271 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2272 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2273 </li>
2274 </ul>
2275
2276 </td> <!-- entry_type -->
2277
2278 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2279 <p>Overall mode of 3A control
2280routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2281 </td>
2282
2283 <td class="entry_units">
2284 </td>
2285
2286 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2287 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2288 </td>
2289
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2290 <td class="entry_tags">
2291 <ul class="entry_tags">
2292 <li><a href="#tag_BC">BC</a></li>
2293 </ul>
2294 </td>
2295
2296 </tr>
2297 <tr class="entries_header">
2298 <th class="th_details" colspan="5">Details</th>
2299 </tr>
2300 <tr class="entry_cont">
2301 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2302 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
2303by the HAL is disabled.<wbr/> The application must set the fields for
2304capture parameters itself.<wbr/></p>
2305<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2306android.<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]2307<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
2308android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
2309one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
2310as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2311<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]2312 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2313 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2314
2315
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2316 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2317 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2318
2319
2320 <tr class="entry" id="controls_android.control.sceneMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2321 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2322 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2323 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2324 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2325 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2326
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2327 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2328
2329 <ul class="entry_type_enum">
2330 <li>
2331 <span class="entry_type_enum_name">UNSUPPORTED</span>
2332 <span class="entry_type_enum_value">0</span>
2333 </li>
2334 <li>
2335 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2336 <span class="entry_type_enum_notes">if face detection support exists Use face
2337 detection data to drive 3A routines.<wbr/> If face detection
2338 statistics are disabled,<wbr/> should still operate correctly
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2339 (but not return face detection statistics to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2340 framework).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2341
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2342 Unlike the other scene modes,<wbr/> aeMode,<wbr/> awbMode,<wbr/> and afMode
2343 remain active when FACE_<wbr/>PRIORITY is set.<wbr/> This is due to
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2344 compatibility concerns with the old camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2345 API</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2346 </li>
2347 <li>
2348 <span class="entry_type_enum_name">ACTION</span>
2349 <span class="entry_type_enum_optional">optional</span>
2350 </li>
2351 <li>
2352 <span class="entry_type_enum_name">PORTRAIT</span>
2353 <span class="entry_type_enum_optional">optional</span>
2354 </li>
2355 <li>
2356 <span class="entry_type_enum_name">LANDSCAPE</span>
2357 <span class="entry_type_enum_optional">optional</span>
2358 </li>
2359 <li>
2360 <span class="entry_type_enum_name">NIGHT</span>
2361 <span class="entry_type_enum_optional">optional</span>
2362 </li>
2363 <li>
2364 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2365 <span class="entry_type_enum_optional">optional</span>
2366 </li>
2367 <li>
2368 <span class="entry_type_enum_name">THEATRE</span>
2369 <span class="entry_type_enum_optional">optional</span>
2370 </li>
2371 <li>
2372 <span class="entry_type_enum_name">BEACH</span>
2373 <span class="entry_type_enum_optional">optional</span>
2374 </li>
2375 <li>
2376 <span class="entry_type_enum_name">SNOW</span>
2377 <span class="entry_type_enum_optional">optional</span>
2378 </li>
2379 <li>
2380 <span class="entry_type_enum_name">SUNSET</span>
2381 <span class="entry_type_enum_optional">optional</span>
2382 </li>
2383 <li>
2384 <span class="entry_type_enum_name">STEADYPHOTO</span>
2385 <span class="entry_type_enum_optional">optional</span>
2386 </li>
2387 <li>
2388 <span class="entry_type_enum_name">FIREWORKS</span>
2389 <span class="entry_type_enum_optional">optional</span>
2390 </li>
2391 <li>
2392 <span class="entry_type_enum_name">SPORTS</span>
2393 <span class="entry_type_enum_optional">optional</span>
2394 </li>
2395 <li>
2396 <span class="entry_type_enum_name">PARTY</span>
2397 <span class="entry_type_enum_optional">optional</span>
2398 </li>
2399 <li>
2400 <span class="entry_type_enum_name">CANDLELIGHT</span>
2401 <span class="entry_type_enum_optional">optional</span>
2402 </li>
2403 <li>
2404 <span class="entry_type_enum_name">BARCODE</span>
2405 <span class="entry_type_enum_optional">optional</span>
2406 </li>
2407 </ul>
2408
2409 </td> <!-- entry_type -->
2410
2411 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2412 <p>Which scene mode is active when
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2413<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]2414 </td>
2415
2416 <td class="entry_units">
2417 </td>
2418
2419 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2420 <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]2421 </td>
2422
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2423 <td class="entry_tags">
2424 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2425 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2426 </ul>
2427 </td>
2428
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2429 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2430
2431
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2432 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2433 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2434
2435
2436 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2437 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2438 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2439 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2440 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2441 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2442
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2443 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2444
2445 <ul class="entry_type_enum">
2446 <li>
2447 <span class="entry_type_enum_name">OFF</span>
2448 </li>
2449 <li>
2450 <span class="entry_type_enum_name">ON</span>
2451 </li>
2452 </ul>
2453
2454 </td> <!-- entry_type -->
2455
2456 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2457 <p>Whether video stabilization is
2458active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2459 </td>
2460
2461 <td class="entry_units">
2462 </td>
2463
2464 <td class="entry_range">
2465 </td>
2466
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2467 <td class="entry_tags">
2468 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2469 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2470 </ul>
2471 </td>
2472
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2473 </tr>
2474 <tr class="entries_header">
2475 <th class="th_details" colspan="5">Details</th>
2476 </tr>
2477 <tr class="entry_cont">
2478 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2479 <p>If enabled,<wbr/> video stabilization can modify the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2480<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]2481stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2482 </td>
2483 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2484
2485
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2486 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2487 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2488
2489
2490
2491 <!-- end of kind -->
2492 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2493 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2494
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2495 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2496 <tr>
2497 <th class="th_name">Property Name</th>
2498 <th class="th_type">Type</th>
2499 <th class="th_description">Description</th>
2500 <th class="th_units">Units</th>
2501 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2502 <th class="th_tags">Tags</th>
2503 </tr>
2504 </thead>
2505
2506 <tbody>
2507
2508
2509
2510
2511
2512
2513
2514
2515
2516
2517 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2518 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2519 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2520 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2521 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2522 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2523 <span class="entry_type_container">x</span>
2524
2525 <span class="entry_type_array">
2526 n
2527 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2528 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2529 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2530
2531
2532 </td> <!-- entry_type -->
2533
2534 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2535 <p>The set of auto-exposure antibanding modes that are
2536supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2537 </td>
2538
2539 <td class="entry_units">
2540 </td>
2541
2542 <td class="entry_range">
2543 </td>
2544
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2545 <td class="entry_tags">
2546 </td>
2547
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2548 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2549 <tr class="entries_header">
2550 <th class="th_details" colspan="5">Details</th>
2551 </tr>
2552 <tr class="entry_cont">
2553 <td class="entry_details" colspan="5">
2554 <p>Not all of the auto-exposure anti-banding modes may be
2555supported by a given camera device.<wbr/> This field lists the
2556valid anti-banding modes that the application may request
2557for this camera device; they must include AUTO.<wbr/></p>
2558 </td>
2559 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2560
2561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2562 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2563 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2564
2565
2566 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2567 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2568 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2569 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2570 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2571 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2572 <span class="entry_type_container">x</span>
2573
2574 <span class="entry_type_array">
2575 n
2576 </span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2577 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2578 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2579
2580
2581 </td> <!-- entry_type -->
2582
2583 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2584 <p>The set of auto-exposure modes that are supported by this
2585camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2586 </td>
2587
2588 <td class="entry_units">
2589 </td>
2590
2591 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2592 </td>
2593
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2594 <td class="entry_tags">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2595 <ul class="entry_tags">
2596 <li><a href="#tag_BC">BC</a></li>
2597 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2598 </td>
2599
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2600 </tr>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2601 <tr class="entries_header">
2602 <th class="th_details" colspan="5">Details</th>
2603 </tr>
2604 <tr class="entry_cont">
2605 <td class="entry_details" colspan="5">
2606 <p>Not all the auto-exposure modes may be supported by a
2607given camera device,<wbr/> especially if no flash unit is
2608available.<wbr/> This entry lists the valid modes for
2609<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> for this camera device.<wbr/></p>
2610<p>All camera devices support ON,<wbr/> and all camera devices with
2611flash units support ON_<wbr/>AUTO_<wbr/>FLASH and
2612ON_<wbr/>ALWAYS_<wbr/>FLASH.<wbr/></p>
2613<p>Full-capability camera devices always support OFF mode,<wbr/>
2614which enables application control of camera exposure time,<wbr/>
2615sensitivity,<wbr/> and frame duration.<wbr/></p>
2616 </td>
2617 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2618
2619
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2620 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2621 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2622
2623
2624 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2625 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2626 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2627 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2628 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2629 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2630 <span class="entry_type_container">x</span>
2631
2632 <span class="entry_type_array">
2633 2 x n
2634 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2635 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2636 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2637
2638
2639 </td> <!-- entry_type -->
2640
2641 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2642 <p>List of frame rate ranges supported by the
2643AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2644 </td>
2645
2646 <td class="entry_units">
2647 </td>
2648
2649 <td class="entry_range">
2650 </td>
2651
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2652 <td class="entry_tags">
2653 </td>
2654
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2655 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2656
2657
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2658 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2659 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2660
2661
2662 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2663 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2664 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2665 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2666 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2667 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2668 <span class="entry_type_container">x</span>
2669
2670 <span class="entry_type_array">
2671 2
2672 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2673 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2674
2675
2676 </td> <!-- entry_type -->
2677
2678 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2679 <p>Maximum and minimum exposure compensation
2680setting,<wbr/> in counts of
2681android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2682 </td>
2683
2684 <td class="entry_units">
2685 </td>
2686
2687 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2688 <p>At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2689size)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2690 </td>
2691
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2692 <td class="entry_tags">
2693 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2694 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2695 </ul>
2696 </td>
2697
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2698 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2699
2700
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2701 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2702 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2703
2704
2705 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2706 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2707 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2708 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2709 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2710 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2711
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2712 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2713
2714
2715 </td> <!-- entry_type -->
2716
2717 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2718 <p>Smallest step by which exposure compensation
2719can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2720 </td>
2721
2722 <td class="entry_units">
2723 </td>
2724
2725 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2726 <p>&lt;= 1/<wbr/>2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2727 </td>
2728
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2729 <td class="entry_tags">
2730 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2731 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2732 </ul>
2733 </td>
2734
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2735 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2736
2737
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2738 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2739 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2740
2741
2742 <tr class="entry" id="static_android.control.afAvailableModes">
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2743 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2744 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2745 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2746 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2747 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2748 <span class="entry_type_container">x</span>
2749
2750 <span class="entry_type_array">
2751 n
2752 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2753 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2754 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2755
2756
2757 </td> <!-- entry_type -->
2758
2759 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2760 <p>List of AF modes that can be
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2761selected with <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2762 </td>
2763
2764 <td class="entry_units">
2765 </td>
2766
2767 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2768 </td>
2769
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2770 <td class="entry_tags">
2771 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2772 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2773 </ul>
2774 </td>
2775
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2776 </tr>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]2777 <tr class="entries_header">
2778 <th class="th_details" colspan="5">Details</th>
2779 </tr>
2780 <tr class="entry_cont">
2781 <td class="entry_details" colspan="5">
2782 <p>Not all the auto-focus modes may be supported by a
2783given camera device.<wbr/> This entry lists the valid modes for
2784<a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a> for this camera device.<wbr/></p>
2785<p>All camera devices will support OFF mode,<wbr/> and all camera devices with
2786adjustable focuser units (<code><a href="#static_android.lens.info.minimumFocusDistance">android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance</a> &gt; 0</code>)
2787will support AUTO mode.<wbr/></p>
2788 </td>
2789 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2790
2791
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2792 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2793 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2794
2795
2796 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2797 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2798 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2799 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2800 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2801 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2802 <span class="entry_type_container">x</span>
2803
2804 <span class="entry_type_array">
2805 n
2806 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2807 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2808 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2809
2810
2811 </td> <!-- entry_type -->
2812
2813 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2814 <p>what subset of the full color effect enum
2815list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2816 </td>
2817
2818 <td class="entry_units">
2819 </td>
2820
2821 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2822 <p>OFF must be listed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2823 </td>
2824
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2825 <td class="entry_tags">
2826 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2827 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2828 </ul>
2829 </td>
2830
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2831 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2832
2833
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2834 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2835 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2836
2837
2838 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2839 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2840 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2841 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2842 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2843 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2844 <span class="entry_type_container">x</span>
2845
2846 <span class="entry_type_array">
2847 n
2848 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2849 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2850 <div class="entry_type_notes">list of enums 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]2851
2852
2853 </td> <!-- entry_type -->
2854
2855 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2856 <p>what subset of the scene mode enum list is
2857supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2858 </td>
2859
2860 <td class="entry_units">
2861 </td>
2862
2863 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2864 <p>SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2865detection is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2866 </td>
2867
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2868 <td class="entry_tags">
2869 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2870 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2871 </ul>
2872 </td>
2873
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2874 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2875
2876
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2877 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2878 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2879
2880
2881 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2882 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2883 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2884 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2885 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2886 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2887 <span class="entry_type_container">x</span>
2888
2889 <span class="entry_type_array">
2890 n
2891 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2892 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2893 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2894
2895
2896 </td> <!-- entry_type -->
2897
2898 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2899 <p>List of video stabilization modes that can
2900be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2901 </td>
2902
2903 <td class="entry_units">
2904 </td>
2905
2906 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2907 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2908 </td>
2909
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2910 <td class="entry_tags">
2911 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2912 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2913 </ul>
2914 </td>
2915
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2916 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2917
2918
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2919 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2920 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2921
2922
2923 <tr class="entry" id="static_android.control.awbAvailableModes">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]2924 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2925 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2926 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2927 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2928 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2929 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2930
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2931 <span class="entry_type_array">
2932 n
2933 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2934 <span class="entry_type_visibility"> [public]</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]2935 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2936
2937
2938 </td> <!-- entry_type -->
2939
2940 <td class="entry_description">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]2941 <p>The set of auto-white-balance modes (<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a>)
2942that are supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2943 </td>
2944
2945 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2946 </td>
2947
2948 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2949 </td>
2950
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2951 <td class="entry_tags">
2952 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2953 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2954 </ul>
2955 </td>
2956
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2957 </tr>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]2958 <tr class="entries_header">
2959 <th class="th_details" colspan="5">Details</th>
2960 </tr>
2961 <tr class="entry_cont">
2962 <td class="entry_details" colspan="5">
2963 <p>Not all the auto-white-balance modes may be supported by a
2964given camera device.<wbr/> This entry lists the valid modes for
2965<a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> for this camera device.<wbr/></p>
2966<p>All camera devices will support ON mode.<wbr/></p>
2967<p>Full-capability camera devices will always support OFF mode,<wbr/>
2968which enables application control of white balance,<wbr/> by using
2969<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a> and <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a>(<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> must be set to TRANSFORM_<wbr/>MATRIX).<wbr/></p>
2970 </td>
2971 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2972
2973
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2974 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2975 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2976
2977
2978 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2979 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2980 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2981 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2982 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2983 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2984
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2985 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2986
2987
2988 </td> <!-- entry_type -->
2989
2990 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2991 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
2992regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2993 </td>
2994
2995 <td class="entry_units">
2996 </td>
2997
2998 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]2999 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3000 </td>
3001
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3002 <td class="entry_tags">
3003 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3004 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3005 </ul>
3006 </td>
3007
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3008 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3009
3010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3011 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3012 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3013
3014
3015 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3016 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3017 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3018 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3019 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3020 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3021 <span class="entry_type_container">x</span>
3022
3023 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3024 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3025 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3026 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3027
3028
3029 </td> <!-- entry_type -->
3030
3031 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3032 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
3033each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3034 </td>
3035
3036 <td class="entry_units">
3037 </td>
3038
3039 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3040 <p>For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
3041awbMode,<wbr/> and afMode that the HAL wants to use for that
3042scene mode.<wbr/></p>
3043<p>For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
3044order of increasing index</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3045 </td>
3046
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3047 <td class="entry_tags">
3048 <ul class="entry_tags">
3049 <li><a href="#tag_BC">BC</a></li>
3050 </ul>
3051 </td>
3052
3053 </tr>
3054 <tr class="entries_header">
3055 <th class="th_details" colspan="5">Details</th>
3056 </tr>
3057 <tr class="entry_cont">
3058 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3059 <p>When a scene mode is enabled,<wbr/> the HAL is expected
3060to override aeMode,<wbr/> awbMode,<wbr/> and afMode with its
3061preferred settings for that scene mode.<wbr/></p>
3062<p>To simplify communication with old camera API applications,<wbr/>
3063the service wants this override list in the static metadata.<wbr/>
3064The order of this list matches that of availableSceneModes,<wbr/>
3065with 3 entires for each scene mode.<wbr/> The overrides listed
3066for SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
3067mode,<wbr/> the application-set aeMode,<wbr/> awbMode,<wbr/> and afMode are
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3068used 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]3069AUTO.<wbr/></p>
3070<p>It is recommended that for FACE_<wbr/>PRIORITY,<wbr/> the overrides
3071should be set to 0.<wbr/> As an example,<wbr/> if availableSceneModes is
3072{ FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT },<wbr/> then the service expects
3073this field to have 9 entries; for example { 0 ,<wbr/> 0,<wbr/> 0,<wbr/>
3074ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
3075INCANDESCENT,<wbr/> AUTO }</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3076 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3077 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3078
3079
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3080 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3081 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3082
3083
3084
3085 <!-- end of kind -->
3086 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3087 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3088
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3089 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3090 <tr>
3091 <th class="th_name">Property Name</th>
3092 <th class="th_type">Type</th>
3093 <th class="th_description">Description</th>
3094 <th class="th_units">Units</th>
3095 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3096 <th class="th_tags">Tags</th>
3097 </tr>
3098 </thead>
3099
3100 <tbody>
3101
3102
3103
3104
3105
3106
3107
3108
3109
3110
3111 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3112 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3113 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3114 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3115 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3116 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3117
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3118 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3119
3120
3121 </td> <!-- entry_type -->
3122
3123 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3124 <p>The ID sent with the latest
3125CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3126 </td>
3127
3128 <td class="entry_units">
3129 </td>
3130
3131 <td class="entry_range">
3132 </td>
3133
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3134 <td class="entry_tags">
3135 </td>
3136
3137 </tr>
3138 <tr class="entries_header">
3139 <th class="th_details" colspan="5">Details</th>
3140 </tr>
3141 <tr class="entry_cont">
3142 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3143 <p>Must be 0 if no
3144CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
3145by HAL.<wbr/> Always updated even if AE algorithm ignores the
3146trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3147 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3148 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3149
3150
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3151 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3152 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3153
3154
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3155 <tr class="entry" id="dynamic_android.control.aeMode">
3156 <td class="entry_name" rowspan="3">
3157 android.<wbr/>control.<wbr/>ae<wbr/>Mode
3158 </td>
3159 <td class="entry_type">
3160 <span class="entry_type_name entry_type_name_enum">byte</span>
3161
3162 <span class="entry_type_visibility"> [public]</span>
3163
3164 <ul class="entry_type_enum">
3165 <li>
3166 <span class="entry_type_enum_name">OFF</span>
3167 <span class="entry_type_enum_notes">
3168 The camera device's autoexposure routine is disabled;
3169 the application-selected android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
3170 android.<wbr/>sensor.<wbr/>sensitivity and
3171 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are used by the camera
3172 device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
3173 a flash unit for this camera device.<wbr/>
3174 </span>
3175 </li>
3176 <li>
3177 <span class="entry_type_enum_name">ON</span>
3178 <span class="entry_type_enum_notes">
3179 The camera device's autoexposure routine is active,<wbr/>
3180 with no flash control.<wbr/> The application's values for
3181 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
3182 android.<wbr/>sensor.<wbr/>sensitivity,<wbr/> and
3183 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are ignored.<wbr/> The
3184 application has control over the various
3185 android.<wbr/>flash.<wbr/>* fields.<wbr/>
3186 </span>
3187 </li>
3188 <li>
3189 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
3190 <span class="entry_type_enum_notes">
3191 Like ON,<wbr/> except that the camera device also controls
3192 the camera's flash unit,<wbr/> firing it in low-light
3193 conditions.<wbr/> The flash may be fired during a
3194 precapture sequence (triggered by
3195 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and may be fired
3196 for captures for which the
3197 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
3198 STILL_<wbr/>CAPTURE
3199 </span>
3200 </li>
3201 <li>
3202 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
3203 <span class="entry_type_enum_notes">
3204 Like ON,<wbr/> except that the camera device also controls
3205 the camera's flash unit,<wbr/> always firing it for still
3206 captures.<wbr/> The flash may be fired during a precapture
3207 sequence (triggered by
3208 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and will always
3209 be fired for captures for which the
3210 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
3211 STILL_<wbr/>CAPTURE
3212 </span>
3213 </li>
3214 <li>
3215 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
3216 <span class="entry_type_enum_notes">
3217 Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
3218 reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
3219 a red eye reduction flash will fire during the
3220 precapture sequence.<wbr/>
3221 </span>
3222 </li>
3223 </ul>
3224
3225 </td> <!-- entry_type -->
3226
3227 <td class="entry_description">
3228 <p>The desired mode for the camera device's
3229auto-exposure routine.<wbr/></p>
3230 </td>
3231
3232 <td class="entry_units">
3233 </td>
3234
3235 <td class="entry_range">
3236 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
3237 </td>
3238
3239 <td class="entry_tags">
3240 <ul class="entry_tags">
3241 <li><a href="#tag_BC">BC</a></li>
3242 </ul>
3243 </td>
3244
3245 </tr>
3246 <tr class="entries_header">
3247 <th class="th_details" colspan="5">Details</th>
3248 </tr>
3249 <tr class="entry_cont">
3250 <td class="entry_details" colspan="5">
3251 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
3252AUTO.<wbr/></p>
3253<p>When set to any of the ON modes,<wbr/> the camera device's
3254auto-exposure routine is enabled,<wbr/> overriding the
3255application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
3256and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3257<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3258<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
3259is selected,<wbr/> the camera device's flash unit controls are
3260also overridden.<wbr/></p>
3261<p>The FLASH modes are only available if the camera device
3262has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
3263<p>If flash TORCH mode is desired,<wbr/> this field must be set to
3264ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
3265<p>When set to any of the ON modes,<wbr/> the values chosen by the
3266camera device auto-exposure routine for the overridden
3267fields for a given capture will be available in its
3268CaptureResult.<wbr/></p>
3269 </td>
3270 </tr>
3271
3272
3273 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3274 <!-- end of entry -->
3275
3276
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3277 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3278 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3279 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3280 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3281 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3282 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3283 <span class="entry_type_container">x</span>
3284
3285 <span class="entry_type_array">
3286 5 x area_count
3287 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3288 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3289
3290
3291 </td> <!-- entry_type -->
3292
3293 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3294 <p>List of areas to use for
3295metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3296 </td>
3297
3298 <td class="entry_units">
3299 </td>
3300
3301 <td class="entry_range">
3302 </td>
3303
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3304 <td class="entry_tags">
3305 <ul class="entry_tags">
3306 <li><a href="#tag_BC">BC</a></li>
3307 </ul>
3308 </td>
3309
3310 </tr>
3311 <tr class="entries_header">
3312 <th class="th_details" colspan="5">Details</th>
3313 </tr>
3314 <tr class="entry_cont">
3315 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3316 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3317xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3318specified coordinates.<wbr/></p>
3319<p>The coordinate system is based on the active pixel array,<wbr/>
3320with (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]3321(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3322<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]3323bottom-right pixel in the active pixel array.<wbr/> The weight
3324should be nonnegative.<wbr/></p>
3325<p>If all regions have 0 weight,<wbr/> then no specific metering area
3326needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3327outside 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]3328should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3329used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3330 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3331 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3332
3333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3334 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3335 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3336
3337
3338 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3339 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3340 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3341 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3342 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3343 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3344
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3345 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3346
3347 <ul class="entry_type_enum">
3348 <li>
3349 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3350 <span class="entry_type_enum_notes">AE is off.<wbr/> When a camera device is opened,<wbr/> it starts in
3351 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3352 </li>
3353 <li>
3354 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3355 <span class="entry_type_enum_notes">AE doesn't yet have a good set of control values
3356 for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3357 </li>
3358 <li>
3359 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3360 <span class="entry_type_enum_notes">AE has a good set of control values for the
3361 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3362 </li>
3363 <li>
3364 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3365 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3366 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3367 </li>
3368 <li>
3369 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3370 <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]3371 needs to be fired for good quality still
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3372 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3373 </li>
3374 <li>
3375 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3376 <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]3377 (through the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3378 trigger_<wbr/>action(CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING)
3379 call),<wbr/> and is currently executing it.<wbr/> Once PRECAPTURE
3380 completes,<wbr/> AE will transition to CONVERGED or
3381 FLASH_<wbr/>REQUIRED as appropriate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3382 </li>
3383 </ul>
3384
3385 </td> <!-- entry_type -->
3386
3387 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3388 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3389 </td>
3390
3391 <td class="entry_units">
3392 </td>
3393
3394 <td class="entry_range">
3395 </td>
3396
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3397 <td class="entry_tags">
3398 </td>
3399
3400 </tr>
3401 <tr class="entries_header">
3402 <th class="th_details" colspan="5">Details</th>
3403 </tr>
3404 <tr class="entry_cont">
3405 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3406 <p>Whenever the AE algorithm state changes,<wbr/> a
3407MSG_<wbr/>AUTOEXPOSURE notification must be send if a
3408notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3409 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3410 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3411
3412
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3413 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3414 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3415
3416
3417 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3418 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3419 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3420 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3421 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3422 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3423
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3424 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3425
3426 <ul class="entry_type_enum">
3427 <li>
3428 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3429 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
3430 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
3431 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3432 </li>
3433 <li>
3434 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3435 <span class="entry_type_enum_notes">
3436 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3437
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3438 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
3439 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3440 the autofocus trigger action is called.<wbr/> When that trigger
3441 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3442 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3443
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3444 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3445 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3446 </li>
3447 <li>
3448 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3449 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
3450 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3451
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3452 When that trigger is activated,<wbr/> AF must transition to
3453 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3454 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3455 position to default,<wbr/> and sets the AF state to
3456 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3457 </li>
3458 <li>
3459 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3460 <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]3461 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3462 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3463
3464 The focusing behavior should be suitable for good quality
3465 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3466 movement and no overshoots.<wbr/> When the AF trigger is not
3467 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3468 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3469 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3470 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3471 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3472 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3473
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3474 Once cancel is received,<wbr/> the algorithm should transition
3475 back to INACTIVE and resume passive scan.<wbr/> Note that this
3476 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3477 ongoing PASSIVE_<wbr/>SCAN must immediately be
3478 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3479 </li>
3480 <li>
3481 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3482 <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]3483 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3484 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3485
3486 The focusing behavior should be suitable for still image
3487 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3488 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3489 algorithm should start in INACTIVE state,<wbr/> and then
3490 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3491 appropriate as it attempts to maintain focus.<wbr/> When the AF
3492 trigger is activated,<wbr/> the algorithm should finish its
3493 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3494 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3495 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3496
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3497 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3498 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3499 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3500 </li>
3501 <li>
3502 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3503 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
3504 trigger is ignored,<wbr/> AF state should always be
3505 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3506 </li>
3507 </ul>
3508
3509 </td> <!-- entry_type -->
3510
3511 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3512 <p>Whether AF is currently enabled,<wbr/> and what
3513mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3514 </td>
3515
3516 <td class="entry_units">
3517 </td>
3518
3519 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]3520 <p><a href="#static_android.control.afAvailableModes">android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3521 </td>
3522
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3523 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3524 <ul class="entry_tags">
3525 <li><a href="#tag_BC">BC</a></li>
3526 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3527 </td>
3528
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3529 </tr>
3530 <tr class="entries_header">
3531 <th class="th_details" colspan="5">Details</th>
3532 </tr>
3533 <tr class="entry_cont">
3534 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3535 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Zhijun Hef163fa92014-01-14 09:59:04 -0800[diff] [blame]3536<p>If the lens is controlled by the camera device auto-focus algorithm,<wbr/>
3537the camera device will report the current AF status in android.<wbr/>control.<wbr/>af<wbr/>State
3538in result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3539 </td>
3540 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3541
3542
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3543 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3544 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3545
3546
3547 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3548 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3549 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3550 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3551 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3552 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3553 <span class="entry_type_container">x</span>
3554
3555 <span class="entry_type_array">
3556 5 x area_count
3557 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3558 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3559
3560
3561 </td> <!-- entry_type -->
3562
3563 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3564 <p>List of areas to use for focus
3565estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3566 </td>
3567
3568 <td class="entry_units">
3569 </td>
3570
3571 <td class="entry_range">
3572 </td>
3573
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3574 <td class="entry_tags">
3575 <ul class="entry_tags">
3576 <li><a href="#tag_BC">BC</a></li>
3577 </ul>
3578 </td>
3579
3580 </tr>
3581 <tr class="entries_header">
3582 <th class="th_details" colspan="5">Details</th>
3583 </tr>
3584 <tr class="entry_cont">
3585 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3586 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3587xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3588specified coordinates.<wbr/></p>
3589<p>The coordinate system is based on the active pixel array,<wbr/>
3590with (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]3591(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3592<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]3593bottom-right pixel in the active pixel array.<wbr/> The weight
3594should be nonnegative.<wbr/></p>
3595<p>If all regions have 0 weight,<wbr/> then no specific focus area
3596needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3597outside 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]3598should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3599used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3600 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3601 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3602
3603
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3604 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3605 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3606
3607
3608 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3609 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3610 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3611 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3612 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3613 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3614
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3615 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3616
3617 <ul class="entry_type_enum">
3618 <li>
3619 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3620 <span class="entry_type_enum_notes">AF off or has not yet tried to scan/<wbr/>been asked
3621 to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3622 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3623 </li>
3624 <li>
3625 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3626 <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]3627 currently doing an AF scan initiated by a continuous
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3628 autofocus mode</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3629 </li>
3630 <li>
3631 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3632 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3633 believes it is in focus,<wbr/> but may restart scanning at
3634 any time.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3635 </li>
3636 <li>
3637 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3638 <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]3639 an AF scan because it was triggered by AF
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3640 trigger</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3641 </li>
3642 <li>
3643 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3644 <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]3645 believes it is focused correctly and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3646 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3647 </li>
3648 <li>
3649 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3650 <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]3651 failed to focus successfully and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3652 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3653 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3654 <li>
3655 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3656 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3657 passive scan without finding focus,<wbr/> and may restart
3658 scanning at any time.<wbr/></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3659 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3660 </ul>
3661
3662 </td> <!-- entry_type -->
3663
3664 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3665 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3666 </td>
3667
3668 <td class="entry_units">
3669 </td>
3670
3671 <td class="entry_range">
3672 </td>
3673
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3674 <td class="entry_tags">
3675 </td>
3676
3677 </tr>
3678 <tr class="entries_header">
3679 <th class="th_details" colspan="5">Details</th>
3680 </tr>
3681 <tr class="entry_cont">
3682 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3683 <p>Whenever the AF algorithm state changes,<wbr/> a
3684MSG_<wbr/>AUTOFOCUS notification must be send if a notification
3685callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3686 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3687 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3688
3689
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3690 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3691 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3692
3693
3694 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3695 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3696 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3697 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3698 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3699 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3700
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3701 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3702
3703
3704 </td> <!-- entry_type -->
3705
3706 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3707 <p>The ID sent with the latest
3708CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3709 </td>
3710
3711 <td class="entry_units">
3712 </td>
3713
3714 <td class="entry_range">
3715 </td>
3716
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3717 <td class="entry_tags">
3718 </td>
3719
3720 </tr>
3721 <tr class="entries_header">
3722 <th class="th_details" colspan="5">Details</th>
3723 </tr>
3724 <tr class="entry_cont">
3725 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3726 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
3727received yet by HAL.<wbr/> Always updated even if AF algorithm
3728ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3729 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3730 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3731
3732
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3733 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3734 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3735
3736
3737 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3738 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3739 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3740 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3741 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3742 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3743
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3744 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3745
3746 <ul class="entry_type_enum">
3747 <li>
3748 <span class="entry_type_enum_name">OFF</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]3749 <span class="entry_type_enum_notes">
3750 The camera device's auto white balance routine is disabled;
3751 the application-selected color transform matrix
3752 (android.<wbr/>color<wbr/>Correction.<wbr/>transform) and gains
3753 (android.<wbr/>color<wbr/>Correction.<wbr/>gains) are used by the camera
3754 device for manual white balance control.<wbr/>
3755 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3756 </li>
3757 <li>
3758 <span class="entry_type_enum_name">AUTO</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]3759 <span class="entry_type_enum_notes">
3760 The camera device's auto white balance routine is active;
3761 the application's values for android.<wbr/>color<wbr/>Correction.<wbr/>transform
3762 and android.<wbr/>color<wbr/>Correction.<wbr/>gains are ignored.<wbr/>
3763 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3764 </li>
3765 <li>
3766 <span class="entry_type_enum_name">INCANDESCENT</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]3767 <span class="entry_type_enum_notes">
3768 The camera device's auto white balance routine is disabled;
3769 the camera device uses incandescent light as the assumed scene
3770 illumination for white balance.<wbr/> While the exact white balance
3771 transforms are up to the camera device,<wbr/> they will approximately
3772 match the CIE standard illuminant A.<wbr/>
3773 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3774 </li>
3775 <li>
3776 <span class="entry_type_enum_name">FLUORESCENT</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]3777 <span class="entry_type_enum_notes">
3778 The camera device's auto white balance routine is disabled;
3779 the camera device uses fluorescent light as the assumed scene
3780 illumination for white balance.<wbr/> While the exact white balance
3781 transforms are up to the camera device,<wbr/> they will approximately
3782 match the CIE standard illuminant F2.<wbr/>
3783 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3784 </li>
3785 <li>
3786 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]3787 <span class="entry_type_enum_notes">
3788 The camera device's auto white balance routine is disabled;
3789 the camera device uses warm fluorescent light as the assumed scene
3790 illumination for white balance.<wbr/> While the exact white balance
3791 transforms are up to the camera device,<wbr/> they will approximately
3792 match the CIE standard illuminant F4.<wbr/>
3793 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3794 </li>
3795 <li>
3796 <span class="entry_type_enum_name">DAYLIGHT</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]3797 <span class="entry_type_enum_notes">
3798 The camera device's auto white balance routine is disabled;
3799 the camera device uses daylight light as the assumed scene
3800 illumination for white balance.<wbr/> While the exact white balance
3801 transforms are up to the camera device,<wbr/> they will approximately
3802 match the CIE standard illuminant D65.<wbr/>
3803 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3804 </li>
3805 <li>
3806 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]3807 <span class="entry_type_enum_notes">
3808 The camera device's auto white balance routine is disabled;
3809 the camera device uses cloudy daylight light as the assumed scene
3810 illumination for white balance.<wbr/>
3811 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3812 </li>
3813 <li>
3814 <span class="entry_type_enum_name">TWILIGHT</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]3815 <span class="entry_type_enum_notes">
3816 The camera device's auto white balance routine is disabled;
3817 the camera device uses twilight light as the assumed scene
3818 illumination for white balance.<wbr/>
3819 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3820 </li>
3821 <li>
3822 <span class="entry_type_enum_name">SHADE</span>
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]3823 <span class="entry_type_enum_notes">
3824 The camera device's auto white balance routine is disabled;
3825 the camera device uses shade light as the assumed scene
3826 illumination for white balance.<wbr/>
3827 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3828 </li>
3829 </ul>
3830
3831 </td> <!-- entry_type -->
3832
3833 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3834 <p>Whether AWB is currently setting the color
3835transform fields,<wbr/> and what its illumination target
3836is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3837 </td>
3838
3839 <td class="entry_units">
3840 </td>
3841
3842 <td class="entry_range">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]3843 <p><a href="#static_android.control.awbAvailableModes">android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3844 </td>
3845
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3846 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3847 <ul class="entry_tags">
3848 <li><a href="#tag_BC">BC</a></li>
3849 <li><a href="#tag_AWB">AWB</a></li>
3850 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3851 </td>
3852
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3853 </tr>
3854 <tr class="entries_header">
3855 <th class="th_details" colspan="5">Details</th>
3856 </tr>
3857 <tr class="entry_cont">
3858 <td class="entry_details" colspan="5">
Zhijun He7787f7f2014-01-14 16:30:31 -0800[diff] [blame^]3859 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is AUTO.<wbr/></p>
3860<p>When set to the ON mode,<wbr/> the camera device's auto white balance
3861routine is enabled,<wbr/> overriding the application's selected
3862<a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> and
3863<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
3864<p>When set to the OFF mode,<wbr/> the camera device's auto white balance
3865routine is disabled.<wbr/> The applicantion manually controls the white
3866balance by <a href="#controls_android.colorCorrection.transform">android.<wbr/>color<wbr/>Correction.<wbr/>transform</a>,<wbr/> android.<wbr/>color<wbr/>Correction.<wbr/>gains
3867and <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a>.<wbr/></p>
3868<p>When set to any other modes,<wbr/> the camera device's auto white balance
3869routine is disabled.<wbr/> The camera device uses each particular illumination
3870target for white balance adjustment.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3871 </td>
3872 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3873
3874
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3875 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3876 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3877
3878
3879 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3880 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3881 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3882 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3883 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3884 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3885 <span class="entry_type_container">x</span>
3886
3887 <span class="entry_type_array">
3888 5 x area_count
3889 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3890 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3891
3892
3893 </td> <!-- entry_type -->
3894
3895 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3896 <p>List of areas to use for illuminant
3897estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3898 </td>
3899
3900 <td class="entry_units">
3901 </td>
3902
3903 <td class="entry_range">
3904 </td>
3905
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3906 <td class="entry_tags">
3907 <ul class="entry_tags">
3908 <li><a href="#tag_BC">BC</a></li>
3909 </ul>
3910 </td>
3911
3912 </tr>
3913 <tr class="entries_header">
3914 <th class="th_details" colspan="5">Details</th>
3915 </tr>
3916 <tr class="entry_cont">
3917 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3918 <p>Only used in AUTO mode.<wbr/></p>
3919<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3920xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3921specified coordinates.<wbr/></p>
3922<p>The coordinate system is based on the active pixel array,<wbr/>
3923with (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]3924(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3925<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]3926bottom-right pixel in the active pixel array.<wbr/> The weight
3927should be nonnegative.<wbr/></p>
3928<p>If all regions have 0 weight,<wbr/> then no specific metering area
3929needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3930outside 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]3931should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3932used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3933 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3934 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3935
3936
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3937 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3938 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3939
3940
3941 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3942 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3943 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3944 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3945 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3946 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3947
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3948 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3949
3950 <ul class="entry_type_enum">
3951 <li>
3952 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3953 <span class="entry_type_enum_notes">AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
3954 starts in this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3955 </li>
3956 <li>
3957 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3958 <span class="entry_type_enum_notes">AWB doesn't yet have a good set of control
3959 values for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3960 </li>
3961 <li>
3962 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3963 <span class="entry_type_enum_notes">AWB has a good set of control values for the
3964 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3965 </li>
3966 <li>
3967 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3968 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3969 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3970 </li>
3971 </ul>
3972
3973 </td> <!-- entry_type -->
3974
3975 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3976 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3977 </td>
3978
3979 <td class="entry_units">
3980 </td>
3981
3982 <td class="entry_range">
3983 </td>
3984
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3985 <td class="entry_tags">
3986 </td>
3987
3988 </tr>
3989 <tr class="entries_header">
3990 <th class="th_details" colspan="5">Details</th>
3991 </tr>
3992 <tr class="entry_cont">
3993 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3994 <p>Whenever the AWB algorithm state changes,<wbr/> a
3995MSG_<wbr/>AUTOWHITEBALANCE notification must be send if a
3996notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3997 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3998 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3999
4000
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4001 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4002 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4003
4004
4005 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4006 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4007 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4008 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4009 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4010 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4011
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4012 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4013
4014 <ul class="entry_type_enum">
4015 <li>
4016 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4017 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
4018 routines are disabled,<wbr/> no other settings in
4019 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4020 </li>
4021 <li>
4022 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4023 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
4024 Manual control of capture parameters is disabled.<wbr/> All
4025 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
4026 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4027 </li>
4028 <li>
4029 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4030 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
4031 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4032 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4033 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
4034 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4035 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4036 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4037 </li>
4038 </ul>
4039
4040 </td> <!-- entry_type -->
4041
4042 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4043 <p>Overall mode of 3A control
4044routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4045 </td>
4046
4047 <td class="entry_units">
4048 </td>
4049
4050 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4051 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4052 </td>
4053
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4054 <td class="entry_tags">
4055 <ul class="entry_tags">
4056 <li><a href="#tag_BC">BC</a></li>
4057 </ul>
4058 </td>
4059
4060 </tr>
4061 <tr class="entries_header">
4062 <th class="th_details" colspan="5">Details</th>
4063 </tr>
4064 <tr class="entry_cont">
4065 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4066 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
4067by the HAL is disabled.<wbr/> The application must set the fields for
4068capture parameters itself.<wbr/></p>
4069<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4070android.<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]4071<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
4072android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
4073one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
4074as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4075<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]4076 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4077 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4078
4079
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4080 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4081 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4082
4083
4084
4085 <!-- end of kind -->
4086 </tbody>
4087
4088 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4089 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4090
4091
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4092 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4093
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4094 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4095 <tr>
4096 <th class="th_name">Property Name</th>
4097 <th class="th_type">Type</th>
4098 <th class="th_description">Description</th>
4099 <th class="th_units">Units</th>
4100 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4101 <th class="th_tags">Tags</th>
4102 </tr>
4103 </thead>
4104
4105 <tbody>
4106
4107
4108
4109
4110
4111
4112
4113
4114
4115
4116 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4117 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4118 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4119 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4120 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4121 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4122
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4123 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4124
4125 <ul class="entry_type_enum">
4126 <li>
4127 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4128 <span class="entry_type_enum_notes">Minimal or no slowdown of frame rate compared to
4129 Bayer RAW output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4130 </li>
4131 <li>
4132 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4133 <span class="entry_type_enum_notes">High-quality may reduce output frame
4134 rate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4135 </li>
4136 </ul>
4137
4138 </td> <!-- entry_type -->
4139
4140 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4141 <p>Controls the quality of the demosaicing
4142processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4143 </td>
4144
4145 <td class="entry_units">
4146 </td>
4147
4148 <td class="entry_range">
4149 </td>
4150
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4151 <td class="entry_tags">
4152 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4153 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4154 </ul>
4155 </td>
4156
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4157 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4158
4159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4160 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4161 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4162
4163
4164
4165 <!-- end of kind -->
4166 </tbody>
4167
4168 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4169 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4170
4171
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4172 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4173
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4174 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4175 <tr>
4176 <th class="th_name">Property Name</th>
4177 <th class="th_type">Type</th>
4178 <th class="th_description">Description</th>
4179 <th class="th_units">Units</th>
4180 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4181 <th class="th_tags">Tags</th>
4182 </tr>
4183 </thead>
4184
4185 <tbody>
4186
4187
4188
4189
4190
4191
4192
4193
4194
4195
4196 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4197 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4198 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4199 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4200 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4201 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4202
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4203 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4204
4205 <ul class="entry_type_enum">
4206 <li>
4207 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4208 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4209 </li>
4210 <li>
4211 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4212 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
4213 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4214 </li>
4215 <li>
4216 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4217 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4218 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4219 </li>
4220 </ul>
4221
4222 </td> <!-- entry_type -->
4223
4224 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4225 <p>Operation mode for edge
4226enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4227 </td>
4228
4229 <td class="entry_units">
4230 </td>
4231
4232 <td class="entry_range">
4233 </td>
4234
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4235 <td class="entry_tags">
4236 </td>
4237
4238 </tr>
4239 <tr class="entries_header">
4240 <th class="th_details" colspan="5">Details</th>
4241 </tr>
4242 <tr class="entry_cont">
4243 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4244 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4245enhancement will be applied by the HAL.<wbr/></p>
4246<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
4247will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
4248HAL should use the highest-quality enhancement algorithms,<wbr/>
4249even if it slows down capture rate.<wbr/> FAST means the HAL should
4250not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4251 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4252 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4253
4254
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4255 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4256 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4257
4258
4259 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4260 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4261 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4262 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4263 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4264 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4265
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4266 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4267
4268
4269 </td> <!-- entry_type -->
4270
4271 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4272 <p>Control the amount of edge enhancement
4273applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4274 </td>
4275
4276 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4277 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4278 </td>
4279
4280 <td class="entry_range">
4281 </td>
4282
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4283 <td class="entry_tags">
4284 </td>
4285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4286 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4287
4288
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4289 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4290 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4291
4292
4293
4294 <!-- end of kind -->
4295 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4296 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4297
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4298 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4299 <tr>
4300 <th class="th_name">Property Name</th>
4301 <th class="th_type">Type</th>
4302 <th class="th_description">Description</th>
4303 <th class="th_units">Units</th>
4304 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4305 <th class="th_tags">Tags</th>
4306 </tr>
4307 </thead>
4308
4309 <tbody>
4310
4311
4312
4313
4314
4315
4316
4317
4318
4319
4320 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4321 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4322 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4323 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4324 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4325 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4326
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4327 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4328
4329 <ul class="entry_type_enum">
4330 <li>
4331 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4332 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4333 </li>
4334 <li>
4335 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4336 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
4337 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4338 </li>
4339 <li>
4340 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4341 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4342 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4343 </li>
4344 </ul>
4345
4346 </td> <!-- entry_type -->
4347
4348 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4349 <p>Operation mode for edge
4350enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4351 </td>
4352
4353 <td class="entry_units">
4354 </td>
4355
4356 <td class="entry_range">
4357 </td>
4358
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4359 <td class="entry_tags">
4360 </td>
4361
4362 </tr>
4363 <tr class="entries_header">
4364 <th class="th_details" colspan="5">Details</th>
4365 </tr>
4366 <tr class="entry_cont">
4367 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4368 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4369enhancement will be applied by the HAL.<wbr/></p>
4370<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
4371will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
4372HAL should use the highest-quality enhancement algorithms,<wbr/>
4373even if it slows down capture rate.<wbr/> FAST means the HAL should
4374not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4375 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4376 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4377
4378
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4379 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4380 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4381
4382
4383
4384 <!-- end of kind -->
4385 </tbody>
4386
4387 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4388 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4389
4390
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4391 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4392
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4393 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4394 <tr>
4395 <th class="th_name">Property Name</th>
4396 <th class="th_type">Type</th>
4397 <th class="th_description">Description</th>
4398 <th class="th_units">Units</th>
4399 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4400 <th class="th_tags">Tags</th>
4401 </tr>
4402 </thead>
4403
4404 <tbody>
4405
4406
4407
4408
4409
4410
4411
4412
4413
4414
4415 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4416 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4417 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4418 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4419 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4420 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4421
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4422 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4423
4424
4425 </td> <!-- entry_type -->
4426
4427 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4428 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4429 </td>
4430
4431 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4432 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4433 </td>
4434
4435 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4436 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4437 </td>
4438
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4439 <td class="entry_tags">
4440 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4441 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4442 </ul>
4443 </td>
4444
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4445 </tr>
4446 <tr class="entries_header">
4447 <th class="th_details" colspan="5">Details</th>
4448 </tr>
4449 <tr class="entry_cont">
4450 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4451 <p>Power for snapshot may use a different scale than
4452for torch mode.<wbr/> Only one entry for torch mode will be
4453used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4454 </td>
4455 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4456
4457
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4458 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4459 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4460
4461
4462 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4463 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4464 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4465 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4466 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4467 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4468
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4469 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4470
4471
4472 </td> <!-- entry_type -->
4473
4474 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4475 <p>Firing time of flash relative to start of
4476exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4477 </td>
4478
4479 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4480 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4481 </td>
4482
4483 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4484 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4485 </td>
4486
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4487 <td class="entry_tags">
4488 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4489 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4490 </ul>
4491 </td>
4492
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4493 </tr>
4494 <tr class="entries_header">
4495 <th class="th_details" colspan="5">Details</th>
4496 </tr>
4497 <tr class="entry_cont">
4498 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4499 <p>Clamped to (0,<wbr/> exposure time - flash
4500duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4501 </td>
4502 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4503
4504
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4505 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4506 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4507
4508
4509 <tr class="entry" id="controls_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4510 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4511 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4512 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4513 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4514 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4515
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4516 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4517
4518 <ul class="entry_type_enum">
4519 <li>
4520 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4521 <span class="entry_type_enum_notes">Do not fire the flash for this
4522 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4523 </li>
4524 <li>
4525 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4526 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4527 for this capture based on firingPower,<wbr/>
4528 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4529 </li>
4530 <li>
4531 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4532 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4533 continuously on,<wbr/> power set by
4534 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4535 </li>
4536 </ul>
4537
4538 </td> <!-- entry_type -->
4539
4540 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4541 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4542 </td>
4543
4544 <td class="entry_units">
4545 </td>
4546
4547 <td class="entry_range">
4548 </td>
4549
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4550 <td class="entry_tags">
4551 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4552 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4553 </ul>
4554 </td>
4555
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4556 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4557
4558
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4559 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4560 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4561
4562
4563
4564 <!-- end of kind -->
4565 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4566 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4567
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4568 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4569 <tr>
4570 <th class="th_name">Property Name</th>
4571 <th class="th_type">Type</th>
4572 <th class="th_description">Description</th>
4573 <th class="th_units">Units</th>
4574 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4575 <th class="th_tags">Tags</th>
4576 </tr>
4577 </thead>
4578
4579 <tbody>
4580
4581
4582
4583
4584
4585
4586
4587
4588
4589
4590
4591
4592 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4593 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4594 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4595 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4596 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4597 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4598
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4599 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4600
4601
4602 </td> <!-- entry_type -->
4603
4604 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4605 <p>Whether this camera has a
4606flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4607 </td>
4608
4609 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4610 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4611 </td>
4612
4613 <td class="entry_range">
4614 </td>
4615
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4616 <td class="entry_tags">
4617 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4618 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4619 </ul>
4620 </td>
4621
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4622 </tr>
4623 <tr class="entries_header">
4624 <th class="th_details" colspan="5">Details</th>
4625 </tr>
4626 <tr class="entry_cont">
4627 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4628 <p>If no flash,<wbr/> none of the flash controls do
4629anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4630 </td>
4631 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4632
4633
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4634 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4635 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4636
4637
4638 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4639 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4640 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4641 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4642 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4643 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4644
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4645 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4646
4647
4648 </td> <!-- entry_type -->
4649
4650 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4651 <p>Time taken before flash can fire
4652again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4653 </td>
4654
4655 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4656 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4657 </td>
4658
4659 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4660 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4661 </td>
4662
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4663 <td class="entry_tags">
4664 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4665 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4666 </ul>
4667 </td>
4668
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4669 </tr>
4670 <tr class="entries_header">
4671 <th class="th_details" colspan="5">Details</th>
4672 </tr>
4673 <tr class="entry_cont">
4674 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4675 <p>1 second too long/<wbr/>too short for recharge? Should
4676this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4677 </td>
4678 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4679
4680
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4681 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4682 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4683
4684
4685
4686
4687
4688 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4689 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4690 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4691 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4692 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4693 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4694
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4695 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4696
4697
4698 </td> <!-- entry_type -->
4699
4700 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4701 <p>The x,<wbr/>y whitepoint of the
4702flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4703 </td>
4704
4705 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4706 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4707 </td>
4708
4709 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4710 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4711 </td>
4712
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4713 <td class="entry_tags">
4714 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4715 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4716 </ul>
4717 </td>
4718
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4719 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4720
4721
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4722 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4723 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4724
4725
4726 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4727 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4728 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4729 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4730 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4731 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4732
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4733 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4734
4735
4736 </td> <!-- entry_type -->
4737
4738 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4739 <p>Max energy output of the flash for a full
4740power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4741 </td>
4742
4743 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4744 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4745 </td>
4746
4747 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]4748 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4749 </td>
4750
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4751 <td class="entry_tags">
4752 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4753 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4754 </ul>
4755 </td>
4756
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4757 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4758
4759
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4760 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4761 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4762
4763
4764
4765 <!-- end of kind -->
4766 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4767 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4768
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4769 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4770 <tr>
4771 <th class="th_name">Property Name</th>
4772 <th class="th_type">Type</th>
4773 <th class="th_description">Description</th>
4774 <th class="th_units">Units</th>
4775 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4776 <th class="th_tags">Tags</th>
4777 </tr>
4778 </thead>
4779
4780 <tbody>
4781
4782
4783
4784
4785
4786
4787
4788
4789
4790
4791 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4792 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4793 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4794 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4795 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4796 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4797
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4798 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4799
4800
4801 </td> <!-- entry_type -->
4802
4803 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4804 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4805 </td>
4806
4807 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4808 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4809 </td>
4810
4811 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4812 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4813 </td>
4814
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4815 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4816 <ul class="entry_tags">
4817 <li><a href="#tag_V1">V1</a></li>
4818 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4819 </td>
4820
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4821 </tr>
4822 <tr class="entries_header">
4823 <th class="th_details" colspan="5">Details</th>
4824 </tr>
4825 <tr class="entry_cont">
4826 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4827 <p>Power for snapshot may use a different scale than
4828for torch mode.<wbr/> Only one entry for torch mode will be
4829used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4830 </td>
4831 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4832
4833
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4834 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4835 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4836
4837
4838 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4839 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4840 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4841 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4842 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4843 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4844
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4845 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4846
4847
4848 </td> <!-- entry_type -->
4849
4850 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4851 <p>Firing time of flash relative to start of
4852exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4853 </td>
4854
4855 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4856 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4857 </td>
4858
4859 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4860 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4861 </td>
4862
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4863 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4864 <ul class="entry_tags">
4865 <li><a href="#tag_V1">V1</a></li>
4866 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4867 </td>
4868
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4869 </tr>
4870 <tr class="entries_header">
4871 <th class="th_details" colspan="5">Details</th>
4872 </tr>
4873 <tr class="entry_cont">
4874 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4875 <p>Clamped to (0,<wbr/> exposure time - flash
4876duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4877 </td>
4878 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4879
4880
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4881 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4882 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4883
4884
4885 <tr class="entry" id="dynamic_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4886 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4887 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4888 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4889 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4890 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4891
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4892 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4893
4894 <ul class="entry_type_enum">
4895 <li>
4896 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4897 <span class="entry_type_enum_notes">Do not fire the flash for this
4898 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4899 </li>
4900 <li>
4901 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4902 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4903 for this capture based on firingPower,<wbr/>
4904 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4905 </li>
4906 <li>
4907 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4908 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4909 continuously on,<wbr/> power set by
4910 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4911 </li>
4912 </ul>
4913
4914 </td> <!-- entry_type -->
4915
4916 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4917 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4918 </td>
4919
4920 <td class="entry_units">
4921 </td>
4922
4923 <td class="entry_range">
4924 </td>
4925
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4926 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4927 <ul class="entry_tags">
4928 <li><a href="#tag_BC">BC</a></li>
4929 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4930 </td>
4931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4932 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4933
4934
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4935 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4936 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4937
4938
4939 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4940 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4941 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4942 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4943 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4944 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4945
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4946 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4947
4948 <ul class="entry_type_enum">
4949 <li>
4950 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4951 <span class="entry_type_enum_notes">No flash on camera</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4952 </li>
4953 <li>
4954 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4955 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4956 charging and cannot be fired</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4957 </li>
4958 <li>
4959 <span class="entry_type_enum_name">READY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4960 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4961 ready to fire</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4962 </li>
4963 <li>
4964 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4965 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash fired
4966 for this capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4967 </li>
4968 </ul>
4969
4970 </td> <!-- entry_type -->
4971
4972 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4973 <p>Current state of the flash
4974unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4975 </td>
4976
4977 <td class="entry_units">
4978 </td>
4979
4980 <td class="entry_range">
4981 </td>
4982
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4983 <td class="entry_tags">
4984 </td>
4985
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4986 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4987
4988
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4989 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4990 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4991
4992
4993
4994 <!-- end of kind -->
4995 </tbody>
4996
4997 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4998 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4999
5000
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5001 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5002
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5003 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5004 <tr>
5005 <th class="th_name">Property Name</th>
5006 <th class="th_type">Type</th>
5007 <th class="th_description">Description</th>
5008 <th class="th_units">Units</th>
5009 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5010 <th class="th_tags">Tags</th>
5011 </tr>
5012 </thead>
5013
5014 <tbody>
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5026 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5027 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5028 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5029 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5030 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5031
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5032 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5033
5034 <ul class="entry_type_enum">
5035 <li>
5036 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5037 <span class="entry_type_enum_notes">No geometric correction is
5038 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5039 </li>
5040 <li>
5041 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5042 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
5043 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5044 </li>
5045 <li>
5046 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5047 <span class="entry_type_enum_notes">Frame rate may be reduced by high
5048 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5049 </li>
5050 </ul>
5051
5052 </td> <!-- entry_type -->
5053
5054 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5055 <p>Operating mode of geometric
5056correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5057 </td>
5058
5059 <td class="entry_units">
5060 </td>
5061
5062 <td class="entry_range">
5063 </td>
5064
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5065 <td class="entry_tags">
5066 </td>
5067
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5068 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5069
5070
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5071 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5072 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5073
5074
5075 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5076 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5077 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5078 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5079 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5080 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5081
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5082 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5083
5084
5085 </td> <!-- entry_type -->
5086
5087 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5088 <p>Control the amount of shading correction
5089applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5090 </td>
5091
5092 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5093 unitless: 1-10; 10 is full shading
5094 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5095 </td>
5096
5097 <td class="entry_range">
5098 </td>
5099
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5100 <td class="entry_tags">
5101 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5102 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5103 </ul>
5104 </td>
5105
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5106 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5107
5108
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5109 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5110 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5111
5112
5113
5114 <!-- end of kind -->
5115 </tbody>
5116
5117 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5118 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5119
5120
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5121 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5122
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5123 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5124 <tr>
5125 <th class="th_name">Property Name</th>
5126 <th class="th_type">Type</th>
5127 <th class="th_description">Description</th>
5128 <th class="th_units">Units</th>
5129 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5130 <th class="th_tags">Tags</th>
5131 </tr>
5132 </thead>
5133
5134 <tbody>
5135
5136
5137
5138
5139
5140
5141
5142
5143
5144
5145 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5146 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5147 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5148 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5149 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5150 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5151
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5152 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5153
5154 <ul class="entry_type_enum">
5155 <li>
5156 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5157 <span class="entry_type_enum_notes">No hot pixel correction can be
5158 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5159 </li>
5160 <li>
5161 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5162 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
5163 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5164 </li>
5165 <li>
5166 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5167 <span class="entry_type_enum_notes">Frame rate may be reduced by high
5168 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5169 </li>
5170 </ul>
5171
5172 </td> <!-- entry_type -->
5173
5174 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5175 <p>Set operational mode for hot pixel
5176correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5177 </td>
5178
5179 <td class="entry_units">
5180 </td>
5181
5182 <td class="entry_range">
5183 </td>
5184
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5185 <td class="entry_tags">
5186 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5187 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5188 </ul>
5189 </td>
5190
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5191 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5192
5193
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5194 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5195 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5196
5197
5198
5199 <!-- end of kind -->
5200 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5201 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5202
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5203 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5204 <tr>
5205 <th class="th_name">Property Name</th>
5206 <th class="th_type">Type</th>
5207 <th class="th_description">Description</th>
5208 <th class="th_units">Units</th>
5209 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5210 <th class="th_tags">Tags</th>
5211 </tr>
5212 </thead>
5213
5214 <tbody>
5215
5216
5217
5218
5219
5220
5221
5222
5223
5224
5225
5226
5227 <tr class="entry" id="static_android.hotPixel.info.map">
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/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
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">int32</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 2 x n
5237 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5238 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5239 <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]5240
5241
5242 </td> <!-- entry_type -->
5243
5244 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5245 <p>Location of hot/<wbr/>defective pixels on
5246sensor</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">
5253 </td>
5254
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5255 <td class="entry_tags">
5256 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5257 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5258 </ul>
5259 </td>
5260
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5261 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5262
5263
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5264 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5265 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5266
5267
5268
5269
5270
5271
5272 <!-- end of kind -->
5273 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5274 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5275
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5276 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5277 <tr>
5278 <th class="th_name">Property Name</th>
5279 <th class="th_type">Type</th>
5280 <th class="th_description">Description</th>
5281 <th class="th_units">Units</th>
5282 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5283 <th class="th_tags">Tags</th>
5284 </tr>
5285 </thead>
5286
5287 <tbody>
5288
5289
5290
5291
5292
5293
5294
5295
5296
5297
5298 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5299 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5300 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5301 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5302 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5303 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5304
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5305 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5306
5307 <ul class="entry_type_enum">
5308 <li>
5309 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5310 <span class="entry_type_enum_notes">No hot pixel correction can be
5311 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5312 </li>
5313 <li>
5314 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5315 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
5316 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5317 </li>
5318 <li>
5319 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5320 <span class="entry_type_enum_notes">Frame rate may be reduced by high
5321 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5322 </li>
5323 </ul>
5324
5325 </td> <!-- entry_type -->
5326
5327 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5328 <p>Set operational mode for hot pixel
5329correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5330 </td>
5331
5332 <td class="entry_units">
5333 </td>
5334
5335 <td class="entry_range">
5336 </td>
5337
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5338 <td class="entry_tags">
5339 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5340 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5341 </ul>
5342 </td>
5343
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5344 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5345
5346
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5347 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5348 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5349
5350
5351
5352 <!-- end of kind -->
5353 </tbody>
5354
5355 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5356 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5357
5358
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5359 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5360
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5361 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5362 <tr>
5363 <th class="th_name">Property Name</th>
5364 <th class="th_type">Type</th>
5365 <th class="th_description">Description</th>
5366 <th class="th_units">Units</th>
5367 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5368 <th class="th_tags">Tags</th>
5369 </tr>
5370 </thead>
5371
5372 <tbody>
5373
5374
5375
5376
5377
5378
5379
5380
5381
5382
5383 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5384 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5385 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5386 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5387 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5388 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5389 <span class="entry_type_container">x</span>
5390
5391 <span class="entry_type_array">
5392 3
5393 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5394 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5395 <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]5396
5397
5398 </td> <!-- entry_type -->
5399
5400 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5401 <p>GPS coordinates to include in output JPEG
5402EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5403 </td>
5404
5405 <td class="entry_units">
5406 </td>
5407
5408 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5409 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5410 </td>
5411
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5412 <td class="entry_tags">
5413 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5414 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5415 </ul>
5416 </td>
5417
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5418 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5419
5420
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5421 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5422 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5423
5424
5425 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5426 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5427 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5428 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5429 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5430 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5431
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5432 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5433
5434
5435 </td> <!-- entry_type -->
5436
5437 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5438 <p>32 characters describing GPS algorithm to
5439include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5440 </td>
5441
5442 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5443 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5444 </td>
5445
5446 <td class="entry_range">
5447 </td>
5448
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5449 <td class="entry_tags">
5450 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5451 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5452 </ul>
5453 </td>
5454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5455 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5456
5457
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5458 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5459 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5460
5461
5462 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5463 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5464 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5465 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5466 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5467 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5468
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5469 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5470
5471
5472 </td> <!-- entry_type -->
5473
5474 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5475 <p>Time GPS fix was made to include in
5476EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5477 </td>
5478
5479 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5480 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5481 </td>
5482
5483 <td class="entry_range">
5484 </td>
5485
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5486 <td class="entry_tags">
5487 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5488 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5489 </ul>
5490 </td>
5491
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5492 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5493
5494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5495 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5496 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5497
5498
5499 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5500 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5501 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5502 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5503 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5504 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5505
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5506 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5507
5508
5509 </td> <!-- entry_type -->
5510
5511 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5512 <p>Orientation of JPEG image to
5513write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5514 </td>
5515
5516 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5517 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5518 </td>
5519
5520 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5521 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5522 </td>
5523
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5524 <td class="entry_tags">
5525 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5526 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5527 </ul>
5528 </td>
5529
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5530 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5531
5532
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5533 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5534 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5535
5536
5537 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5538 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5539 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5540 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5541 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5542 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5543
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5544 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5545
5546
5547 </td> <!-- entry_type -->
5548
5549 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5550 <p>Compression quality of the final JPEG
5551image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5552 </td>
5553
5554 <td class="entry_units">
5555 </td>
5556
5557 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5558 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5559 </td>
5560
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5561 <td class="entry_tags">
5562 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5563 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5564 </ul>
5565 </td>
5566
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5567 </tr>
5568 <tr class="entries_header">
5569 <th class="th_details" colspan="5">Details</th>
5570 </tr>
5571 <tr class="entry_cont">
5572 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5573 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5574 </td>
5575 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5576
5577
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5578 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5579 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5580
5581
5582 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5583 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5584 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5585 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5586 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5587 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5588
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5589 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5590
5591
5592 </td> <!-- entry_type -->
5593
5594 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5595 <p>Compression quality of JPEG
5596thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5597 </td>
5598
5599 <td class="entry_units">
5600 </td>
5601
5602 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5603 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5604 </td>
5605
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5606 <td class="entry_tags">
5607 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5608 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5609 </ul>
5610 </td>
5611
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5612 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5613
5614
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5615 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5616 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5617
5618
5619 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5620 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5621 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5622 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5623 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5624 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5625 <span class="entry_type_container">x</span>
5626
5627 <span class="entry_type_array">
5628 2
5629 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5630 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5631
5632
5633 </td> <!-- entry_type -->
5634
5635 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5636 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5637 </td>
5638
5639 <td class="entry_units">
5640 </td>
5641
5642 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5643 <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]5644 </td>
5645
5646 <td class="entry_tags">
5647 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5648 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5649 </ul>
5650 </td>
5651
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5652 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5653 <tr class="entries_header">
5654 <th class="th_details" colspan="5">Details</th>
5655 </tr>
5656 <tr class="entry_cont">
5657 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5658 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5659but the captured JPEG must still be a valid image.<wbr/></p>
5660<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5661the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5662 </td>
5663 </tr>
5664
5665
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5666 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5667 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5668
5669
5670
5671 <!-- end of kind -->
5672 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5673 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5674
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5675 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5676 <tr>
5677 <th class="th_name">Property Name</th>
5678 <th class="th_type">Type</th>
5679 <th class="th_description">Description</th>
5680 <th class="th_units">Units</th>
5681 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5682 <th class="th_tags">Tags</th>
5683 </tr>
5684 </thead>
5685
5686 <tbody>
5687
5688
5689
5690
5691
5692
5693
5694
5695
5696
5697 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5698 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5699 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5700 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5701 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5702 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5703 <span class="entry_type_container">x</span>
5704
5705 <span class="entry_type_array">
5706 2 x n
5707 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5708 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5709
5710
5711 </td> <!-- entry_type -->
5712
5713 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5714 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5715 </td>
5716
5717 <td class="entry_units">
5718 </td>
5719
5720 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5721 <p>Must include at least one valid resolution,<wbr/> plus
5722(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]5723 </td>
5724
5725 <td class="entry_tags">
5726 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5727 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5728 </ul>
5729 </td>
5730
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5731 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5732 <tr class="entries_header">
5733 <th class="th_details" colspan="5">Details</th>
5734 </tr>
5735 <tr class="entry_cont">
5736 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5737 <p>Below condiditions must be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5738<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5739<li>The sizes must be sorted by increasing pixel area (width x height).<wbr/>
5740If 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]5741<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]5742aspect 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]5743The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5744in a given size list.<wbr/></li>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5745<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]5746one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
5747and vice versa.<wbr/></li>
5748<li>All non (0,<wbr/> 0) sizes must have non-zero widths and heights.<wbr/></li>
5749</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5750 </td>
5751 </tr>
5752
5753
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5754 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5755 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5756
5757
5758 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5759 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5760 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5761 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5762 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5763 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5764
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5765 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5766
5767
5768 </td> <!-- entry_type -->
5769
5770 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5771 <p>Maximum size in bytes for the compressed
5772JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5773 </td>
5774
5775 <td class="entry_units">
5776 </td>
5777
5778 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5779 <p>Must be large enough to fit any JPEG produced by
5780the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5781 </td>
5782
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5783 <td class="entry_tags">
5784 </td>
5785
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5786 </tr>
5787 <tr class="entries_header">
5788 <th class="th_details" colspan="5">Details</th>
5789 </tr>
5790 <tr class="entry_cont">
5791 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5792 <p>This is used for sizing the gralloc buffers for
5793JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5794 </td>
5795 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5796
5797
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5798 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5799 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5800
5801
5802
5803 <!-- end of kind -->
5804 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5805 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5806
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5807 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5808 <tr>
5809 <th class="th_name">Property Name</th>
5810 <th class="th_type">Type</th>
5811 <th class="th_description">Description</th>
5812 <th class="th_units">Units</th>
5813 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5814 <th class="th_tags">Tags</th>
5815 </tr>
5816 </thead>
5817
5818 <tbody>
5819
5820
5821
5822
5823
5824
5825
5826
5827
5828
5829 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5830 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5831 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5832 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5833 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5834 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5835 <span class="entry_type_container">x</span>
5836
5837 <span class="entry_type_array">
5838 3
5839 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5840 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5841 <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]5842
5843
5844 </td> <!-- entry_type -->
5845
5846 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5847 <p>GPS coordinates to include in output JPEG
5848EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5849 </td>
5850
5851 <td class="entry_units">
5852 </td>
5853
5854 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5855 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5856 </td>
5857
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5858 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5859 <ul class="entry_tags">
5860 <li><a href="#tag_BC">BC</a></li>
5861 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5862 </td>
5863
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5864 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5865
5866
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5867 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5868 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5869
5870
5871 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5872 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5873 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5874 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5875 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5876 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5877
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5878 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5879
5880
5881 </td> <!-- entry_type -->
5882
5883 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5884 <p>32 characters describing GPS algorithm to
5885include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5886 </td>
5887
5888 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5889 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5890 </td>
5891
5892 <td class="entry_range">
5893 </td>
5894
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5895 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5896 <ul class="entry_tags">
5897 <li><a href="#tag_BC">BC</a></li>
5898 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5899 </td>
5900
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5901 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5902
5903
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5904 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5905 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5906
5907
5908 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5909 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5910 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5911 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5912 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5913 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5914
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5915 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5916
5917
5918 </td> <!-- entry_type -->
5919
5920 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5921 <p>Time GPS fix was made to include in
5922EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5923 </td>
5924
5925 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5926 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5927 </td>
5928
5929 <td class="entry_range">
5930 </td>
5931
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5932 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5933 <ul class="entry_tags">
5934 <li><a href="#tag_BC">BC</a></li>
5935 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5936 </td>
5937
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5938 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5939
5940
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5941 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5942 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5943
5944
5945 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5946 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5947 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5948 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5949 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5950 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5951
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5952 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5953
5954
5955 </td> <!-- entry_type -->
5956
5957 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5958 <p>Orientation of JPEG image to
5959write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5960 </td>
5961
5962 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5963 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5964 </td>
5965
5966 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5967 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5968 </td>
5969
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5970 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5971 <ul class="entry_tags">
5972 <li><a href="#tag_BC">BC</a></li>
5973 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5974 </td>
5975
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5976 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5977
5978
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5979 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5980 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5981
5982
5983 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5984 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5985 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5986 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5987 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5988 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5989
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5990 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5991
5992
5993 </td> <!-- entry_type -->
5994
5995 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5996 <p>Compression quality of the final JPEG
5997image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5998 </td>
5999
6000 <td class="entry_units">
6001 </td>
6002
6003 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6004 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6005 </td>
6006
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6007 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6008 <ul class="entry_tags">
6009 <li><a href="#tag_BC">BC</a></li>
6010 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6011 </td>
6012
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6013 </tr>
6014 <tr class="entries_header">
6015 <th class="th_details" colspan="5">Details</th>
6016 </tr>
6017 <tr class="entry_cont">
6018 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6019 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6020 </td>
6021 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6022
6023
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6024 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6025 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6026
6027
6028 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6029 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6030 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6031 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6032 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6033 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6034
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6035 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6036
6037
6038 </td> <!-- entry_type -->
6039
6040 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6041 <p>The size of the compressed JPEG image,<wbr/> in
6042bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6043 </td>
6044
6045 <td class="entry_units">
6046 </td>
6047
6048 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6049 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6050 </td>
6051
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6052 <td class="entry_tags">
6053 </td>
6054
6055 </tr>
6056 <tr class="entries_header">
6057 <th class="th_details" colspan="5">Details</th>
6058 </tr>
6059 <tr class="entry_cont">
6060 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6061 <p>If no JPEG output is produced for the request,<wbr/>
6062this must be 0.<wbr/></p>
6063<p>Otherwise,<wbr/> this describes the real size of the compressed
6064JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6065if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
6066has <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]6067the JPEG stream will be 1000000 bytes,<wbr/> of which the first
6068500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6069 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6070 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6071
6072
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6073 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6074 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6075
6076
6077 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6078 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6079 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6080 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6081 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6082 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6083
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6084 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6085
6086
6087 </td> <!-- entry_type -->
6088
6089 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6090 <p>Compression quality of JPEG
6091thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6092 </td>
6093
6094 <td class="entry_units">
6095 </td>
6096
6097 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6098 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6099 </td>
6100
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6101 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6102 <ul class="entry_tags">
6103 <li><a href="#tag_BC">BC</a></li>
6104 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6105 </td>
6106
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6107 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6108
6109
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6110 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6111 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6112
6113
6114 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6115 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6116 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6117 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6118 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6119 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6120 <span class="entry_type_container">x</span>
6121
6122 <span class="entry_type_array">
6123 2
6124 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6125 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6126
6127
6128 </td> <!-- entry_type -->
6129
6130 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6131 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6132 </td>
6133
6134 <td class="entry_units">
6135 </td>
6136
6137 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6138 <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]6139 </td>
6140
6141 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6142 <ul class="entry_tags">
6143 <li><a href="#tag_BC">BC</a></li>
6144 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6145 </td>
6146
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6147 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6148 <tr class="entries_header">
6149 <th class="th_details" colspan="5">Details</th>
6150 </tr>
6151 <tr class="entry_cont">
6152 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6153 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
6154but the captured JPEG must still be a valid image.<wbr/></p>
6155<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
6156the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6157 </td>
6158 </tr>
6159
6160
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6161 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6162 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6163
6164
6165
6166 <!-- end of kind -->
6167 </tbody>
6168
6169 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6170 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6171
6172
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6173 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6174
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6175 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6176 <tr>
6177 <th class="th_name">Property Name</th>
6178 <th class="th_type">Type</th>
6179 <th class="th_description">Description</th>
6180 <th class="th_units">Units</th>
6181 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6182 <th class="th_tags">Tags</th>
6183 </tr>
6184 </thead>
6185
6186 <tbody>
6187
6188
6189
6190
6191
6192
6193
6194
6195
6196
6197 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6198 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6199 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6200 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6201 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6202 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6203
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6204 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6205
6206
6207 </td> <!-- entry_type -->
6208
6209 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6210 <p>The ratio of lens focal length to the effective
6211aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6212 </td>
6213
6214 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6215 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6216 </td>
6217
6218 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6219 <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]6220 </td>
6221
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6222 <td class="entry_tags">
6223 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6224 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6225 </ul>
6226 </td>
6227
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6228 </tr>
6229 <tr class="entries_header">
6230 <th class="th_details" colspan="5">Details</th>
6231 </tr>
6232 <tr class="entry_cont">
6233 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6234 <p>This will only be supported on the camera devices that
6235have variable aperture lens.<wbr/> The aperture value can only be
6236one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
6237<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
6238this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
6239<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
6240to achieve manual exposure control.<wbr/></p>
6241<p>The requested aperture value may take several frames to reach the
6242requested value; the camera device will report the current (intermediate)
6243aperture size in capture result metadata while the aperture is changing.<wbr/></p>
6244<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
6245the ON modes,<wbr/> this will be overridden by the camera device
6246auto-exposure algorithm,<wbr/> the overridden values are then provided
6247back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6248 </td>
6249 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6250
6251
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6252 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6253 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6254
6255
6256 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6257 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6258 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6259 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6260 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6261 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6262
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6263 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6264
6265
6266 </td> <!-- entry_type -->
6267
6268 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6269 <p>State of lens neutral density
6270filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6271 </td>
6272
6273 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6274 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6275 </td>
6276
6277 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6278 <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]6279 </td>
6280
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6281 <td class="entry_tags">
6282 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6283 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6284 </ul>
6285 </td>
6286
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6287 </tr>
6288 <tr class="entries_header">
6289 <th class="th_details" colspan="5">Details</th>
6290 </tr>
6291 <tr class="entry_cont">
6292 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6293 <p>Will not be supported on most devices.<wbr/> Can only
6294pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6295 </td>
6296 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6297
6298
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6299 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6300 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6301
6302
6303 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6304 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6305 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6306 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6307 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6308 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6309
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6310 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6311
6312
6313 </td> <!-- entry_type -->
6314
6315 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6316 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6317 </td>
6318
6319 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6320 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6321 </td>
6322
6323 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6324 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6325 </td>
6326
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6327 <td class="entry_tags">
6328 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6329 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6330 </ul>
6331 </td>
6332
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6333 </tr>
6334 <tr class="entries_header">
6335 <th class="th_details" colspan="5">Details</th>
6336 </tr>
6337 <tr class="entry_cont">
6338 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6339 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6340 </td>
6341 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6342
6343
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6344 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6345 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6346
6347
6348 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6349 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6350 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6351 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6352 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6353 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6354
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6355 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6356
6357
6358 </td> <!-- entry_type -->
6359
6360 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6361 <p>Distance to plane of sharpest focus,<wbr/>
6362measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6363 </td>
6364
6365 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6366 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6367 </td>
6368
6369 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6370 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6371 </td>
6372
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6373 <td class="entry_tags">
6374 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6375 <li><a href="#tag_BC">BC</a></li>
6376 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6377 </ul>
6378 </td>
6379
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6380 </tr>
6381 <tr class="entries_header">
6382 <th class="th_details" colspan="5">Details</th>
6383 </tr>
6384 <tr class="entry_cont">
6385 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6386 <p>0 = infinity focus.<wbr/> Used value should be clamped
6387to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6388 </td>
6389 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6390
6391
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6392 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6393 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6394
6395
6396 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6397 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6398 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6399 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6400 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6401 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6402
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6403 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6404
6405 <ul class="entry_type_enum">
6406 <li>
6407 <span class="entry_type_enum_name">OFF</span>
6408 </li>
6409 <li>
6410 <span class="entry_type_enum_name">ON</span>
6411 <span class="entry_type_enum_optional">optional</span>
6412 </li>
6413 </ul>
6414
6415 </td> <!-- entry_type -->
6416
6417 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6418 <p>Whether optical image stabilization is
6419enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6420 </td>
6421
6422 <td class="entry_units">
6423 </td>
6424
6425 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6426 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6427 </td>
6428
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6429 <td class="entry_tags">
6430 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6431 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6432 </ul>
6433 </td>
6434
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6435 </tr>
6436 <tr class="entries_header">
6437 <th class="th_details" colspan="5">Details</th>
6438 </tr>
6439 <tr class="entry_cont">
6440 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6441 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6442 </td>
6443 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6444
6445
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6446 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6447 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6448
6449
6450
6451 <!-- end of kind -->
6452 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6453 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6454
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6455 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6456 <tr>
6457 <th class="th_name">Property Name</th>
6458 <th class="th_type">Type</th>
6459 <th class="th_description">Description</th>
6460 <th class="th_units">Units</th>
6461 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6462 <th class="th_tags">Tags</th>
6463 </tr>
6464 </thead>
6465
6466 <tbody>
6467
6468
6469
6470
6471
6472
6473
6474
6475
6476
6477
6478
6479 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6480 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6481 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6482 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6483 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6484 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6485 <span class="entry_type_container">x</span>
6486
6487 <span class="entry_type_array">
6488 n
6489 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6490 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6491
6492
6493 </td> <!-- entry_type -->
6494
6495 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6496 <p>List of supported aperture
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6497values.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6498 </td>
6499
6500 <td class="entry_units">
6501 </td>
6502
6503 <td class="entry_range">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6504 <p>one entry required,<wbr/> &amp;&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6505 </td>
6506
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6507 <td class="entry_tags">
6508 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6509 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6510 </ul>
6511 </td>
6512
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6513 </tr>
6514 <tr class="entries_header">
6515 <th class="th_details" colspan="5">Details</th>
6516 </tr>
6517 <tr class="entry_cont">
6518 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]6519 <p>If the camera device doesn't support variable apertures,<wbr/>
6520listed value will be the fixed aperture.<wbr/></p>
6521<p>If the camera device supports variable apertures,<wbr/> the aperture value
6522in this list will be sorted in ascending order.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6523 </td>
6524 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6525
6526
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6527 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6528 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6529
6530
6531 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6532 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6533 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6534 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6535 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6536 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6537 <span class="entry_type_container">x</span>
6538
6539 <span class="entry_type_array">
6540 n
6541 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6542 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6543
6544
6545 </td> <!-- entry_type -->
6546
6547 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6548 <p>List of supported ND filter
6549values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6550 </td>
6551
6552 <td class="entry_units">
6553 </td>
6554
6555 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6556 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6557 </td>
6558
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6559 <td class="entry_tags">
6560 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6561 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6562 </ul>
6563 </td>
6564
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6565 </tr>
6566 <tr class="entries_header">
6567 <th class="th_details" colspan="5">Details</th>
6568 </tr>
6569 <tr class="entry_cont">
6570 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6571 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6572lists the available exposure index values for dimming
6573(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6574light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6575 </td>
6576 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6577
6578
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6579 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6580 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6581
6582
6583 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6584 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6585 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6586 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6587 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6588 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6589 <span class="entry_type_container">x</span>
6590
6591 <span class="entry_type_array">
6592 n
6593 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6594 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6595 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6596
6597
6598 </td> <!-- entry_type -->
6599
6600 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6601 <p>If fitted with optical zoom,<wbr/> what focal
6602lengths are available.<wbr/> If not,<wbr/> the static focal
6603length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6604 </td>
6605
6606 <td class="entry_units">
6607 </td>
6608
6609 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6610 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6611 </td>
6612
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6613 <td class="entry_tags">
6614 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6615 <li><a href="#tag_BC">BC</a></li>
6616 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6617 </ul>
6618 </td>
6619
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6620 </tr>
6621 <tr class="entries_header">
6622 <th class="th_details" colspan="5">Details</th>
6623 </tr>
6624 <tr class="entry_cont">
6625 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6626 <p>If optical zoom not supported,<wbr/> only one value
6627should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6628 </td>
6629 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6630
6631
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6632 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6633 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6634
6635
6636 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6637 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6638 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6639 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6640 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6641 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6642 <span class="entry_type_container">x</span>
6643
6644 <span class="entry_type_array">
6645 n
6646 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6647 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6648 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6649
6650
6651 </td> <!-- entry_type -->
6652
6653 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6654 <p>List of supported optical image
6655stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6656 </td>
6657
6658 <td class="entry_units">
6659 </td>
6660
6661 <td class="entry_range">
6662 </td>
6663
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6664 <td class="entry_tags">
6665 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6666 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6667 </ul>
6668 </td>
6669
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6670 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6671
6672
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6673 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6674 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6675
6676
6677 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6678 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6679 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6680 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6681 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6682 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6683 <span class="entry_type_container">x</span>
6684
6685 <span class="entry_type_array">
6686 2 x 3 x n x m
6687 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6688 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6689 <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]6690
6691
6692 </td> <!-- entry_type -->
6693
6694 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6695 <p>A low-resolution map for correction of
6696geometric distortions and chromatic aberrations,<wbr/> per
6697color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6698 </td>
6699
6700 <td class="entry_units">
6701 </td>
6702
6703 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6704 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6705 </td>
6706
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6707 <td class="entry_tags">
6708 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6709 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6710 </ul>
6711 </td>
6712
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6713 </tr>
6714 <tr class="entries_header">
6715 <th class="th_details" colspan="5">Details</th>
6716 </tr>
6717 <tr class="entry_cont">
6718 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6719 <p>[DNG wants a function instead].<wbr/> What's easiest
6720for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
6721j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
6722j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
6723entry 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]6724 </td>
6725 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6726
6727
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6728 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6729 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6730
6731
6732 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6733 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6734 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6735 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6736 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6737 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6738 <span class="entry_type_container">x</span>
6739
6740 <span class="entry_type_array">
6741 2
6742 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6743 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6744 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6745
6746
6747 </td> <!-- entry_type -->
6748
6749 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6750 <p>Dimensions of geometric correction
6751map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6752 </td>
6753
6754 <td class="entry_units">
6755 </td>
6756
6757 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6758 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6759 </td>
6760
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6761 <td class="entry_tags">
6762 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6763 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6764 </ul>
6765 </td>
6766
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6767 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6768
6769
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6770 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6771 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6772
6773
6774 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6775 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6776 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6777 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6778 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6779 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6780
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6781 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6782
6783
6784 </td> <!-- entry_type -->
6785
6786 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6787 <p>Hyperfocal distance for this lens; set to
67880 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6789 </td>
6790
6791 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6792 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6793 </td>
6794
6795 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6796 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6797 </td>
6798
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6799 <td class="entry_tags">
6800 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6801 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6802 </ul>
6803 </td>
6804
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6805 </tr>
6806 <tr class="entries_header">
6807 <th class="th_details" colspan="5">Details</th>
6808 </tr>
6809 <tr class="entry_cont">
6810 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6811 <p>The hyperfocal distance is used for the old
6812API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6813 </td>
6814 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6815
6816
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6817 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6818 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6819
6820
6821 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6822 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6823 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6824 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6825 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6826 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6827
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6828 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6829
6830
6831 </td> <!-- entry_type -->
6832
6833 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6834 <p>Shortest distance from frontmost surface
6835of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6836 </td>
6837
6838 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6839 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6840 </td>
6841
6842 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6843 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6844 </td>
6845
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6846 <td class="entry_tags">
6847 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6848 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6849 </ul>
6850 </td>
6851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6852 </tr>
6853 <tr class="entries_header">
6854 <th class="th_details" colspan="5">Details</th>
6855 </tr>
6856 <tr class="entry_cont">
6857 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6858 <p>If the lens is fixed-focus,<wbr/> this should be
68590</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6860 </td>
6861 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6862
6863
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6864 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6865 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6866
6867
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6868 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6869 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6870 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6871 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6872 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6873 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6874 <span class="entry_type_container">x</span>
6875
6876 <span class="entry_type_array">
6877 2
6878 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6879 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6880 <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]6881
6882
6883 </td> <!-- entry_type -->
6884
6885 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6886 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6887 </td>
6888
6889 <td class="entry_units">
6890 </td>
6891
6892 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6893 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6894 </td>
6895
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6896 <td class="entry_tags">
6897 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6898 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6899 </ul>
6900 </td>
6901
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6902 </tr>
6903 <tr class="entries_header">
6904 <th class="th_details" colspan="5">Details</th>
6905 </tr>
6906 <tr class="entry_cont">
6907 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6908 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
6909must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6910 </td>
6911 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6912
6913
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6914 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6915 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6916
6917
6918
6919
6920
6921 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6922 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6923 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6924 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6925 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6926 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6927
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6928 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6929
6930 <ul class="entry_type_enum">
6931 <li>
6932 <span class="entry_type_enum_name">FRONT</span>
6933 </li>
6934 <li>
6935 <span class="entry_type_enum_name">BACK</span>
6936 </li>
6937 </ul>
6938
6939 </td> <!-- entry_type -->
6940
6941 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6942 <p>Direction the camera faces relative to
6943device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6944 </td>
6945
6946 <td class="entry_units">
6947 </td>
6948
6949 <td class="entry_range">
6950 </td>
6951
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6952 <td class="entry_tags">
6953 </td>
6954
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6955 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6956
6957
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6958 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6959 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6960
6961
6962 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6963 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6964 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6965 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6966 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6967 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6968 <span class="entry_type_container">x</span>
6969
6970 <span class="entry_type_array">
6971 2
6972 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6973 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6974 <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]6975
6976
6977 </td> <!-- entry_type -->
6978
6979 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6980 <p>Relative angle of camera optical axis to the
6981perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6982 </td>
6983
6984 <td class="entry_units">
6985 </td>
6986
6987 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6988 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6989 </td>
6990
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6991 <td class="entry_tags">
6992 <ul class="entry_tags">
6993 <li><a href="#tag_ADV">ADV</a></li>
6994 </ul>
6995 </td>
6996
6997 </tr>
6998 <tr class="entries_header">
6999 <th class="th_details" colspan="5">Details</th>
7000 </tr>
7001 <tr class="entry_cont">
7002 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7003 <p>Examples:</p>
7004<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7005is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7006<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7007device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7008<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
7009the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7010<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7011direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7012 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7013 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7014
7015
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7016 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7017 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7018
7019
7020 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7021 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7022 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7023 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7024 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7025 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7026 <span class="entry_type_container">x</span>
7027
7028 <span class="entry_type_array">
7029 3, location in mm, in the sensor coordinate
7030 system
7031 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7032 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7033
7034
7035 </td> <!-- entry_type -->
7036
7037 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7038 <p>Coordinates of camera optical axis on
7039device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7040 </td>
7041
7042 <td class="entry_units">
7043 </td>
7044
7045 <td class="entry_range">
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_V1">V1</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>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7055
7056
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7057 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7058 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7059
7060
7061
7062 <!-- end of kind -->
7063 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7064 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7065
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7066 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7067 <tr>
7068 <th class="th_name">Property Name</th>
7069 <th class="th_type">Type</th>
7070 <th class="th_description">Description</th>
7071 <th class="th_units">Units</th>
7072 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7073 <th class="th_tags">Tags</th>
7074 </tr>
7075 </thead>
7076
7077 <tbody>
7078
7079
7080
7081
7082
7083
7084
7085
7086
7087
7088 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7089 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7090 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7091 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7092 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7093 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7094
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7095 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7096
7097
7098 </td> <!-- entry_type -->
7099
7100 <td class="entry_description">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7101 <p>The ratio of lens focal length to the effective
7102aperture diameter.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7103 </td>
7104
7105 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7106 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7107 </td>
7108
7109 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7110 <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]7111 </td>
7112
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7113 <td class="entry_tags">
7114 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7115 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7116 </ul>
7117 </td>
7118
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7119 </tr>
7120 <tr class="entries_header">
7121 <th class="th_details" colspan="5">Details</th>
7122 </tr>
7123 <tr class="entry_cont">
7124 <td class="entry_details" colspan="5">
Zhijun He1b58d382014-01-10 10:22:53 -0800[diff] [blame]7125 <p>This will only be supported on the camera devices that
7126have variable aperture lens.<wbr/> The aperture value can only be
7127one of the values listed in <a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a>.<wbr/></p>
7128<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is OFF,<wbr/>
7129this can be set along with <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
7130<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
7131to achieve manual exposure control.<wbr/></p>
7132<p>The requested aperture value may take several frames to reach the
7133requested value; the camera device will report the current (intermediate)
7134aperture size in capture result metadata while the aperture is changing.<wbr/></p>
7135<p>When this is supported and <a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> is one of
7136the ON modes,<wbr/> this will be overridden by the camera device
7137auto-exposure algorithm,<wbr/> the overridden values are then provided
7138back to the user in the corresponding result.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7139 </td>
7140 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7141
7142
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7143 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7144 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7145
7146
7147 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7148 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7149 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7150 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7151 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7152 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7153
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7154 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7155
7156
7157 </td> <!-- entry_type -->
7158
7159 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7160 <p>State of lens neutral density
7161filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7162 </td>
7163
7164 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7165 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7166 </td>
7167
7168 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7169 <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]7170 </td>
7171
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7172 <td class="entry_tags">
7173 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7174 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7175 </ul>
7176 </td>
7177
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7178 </tr>
7179 <tr class="entries_header">
7180 <th class="th_details" colspan="5">Details</th>
7181 </tr>
7182 <tr class="entry_cont">
7183 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7184 <p>Will not be supported on most devices.<wbr/> Can only
7185pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7186 </td>
7187 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7188
7189
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7190 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7191 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7192
7193
7194 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7195 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7196 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7197 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7198 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7199 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7200
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7201 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7202
7203
7204 </td> <!-- entry_type -->
7205
7206 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7207 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7208 </td>
7209
7210 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7211 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7212 </td>
7213
7214 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7215 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7216 </td>
7217
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7218 <td class="entry_tags">
7219 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7220 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7221 </ul>
7222 </td>
7223
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7224 </tr>
7225 <tr class="entries_header">
7226 <th class="th_details" colspan="5">Details</th>
7227 </tr>
7228 <tr class="entry_cont">
7229 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7230 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7231 </td>
7232 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7233
7234
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7235 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7236 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7237
7238
7239 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7240 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7241 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7242 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7243 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7244 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7245
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7246 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7247
7248
7249 </td> <!-- entry_type -->
7250
7251 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7252 <p>Distance to plane of sharpest focus,<wbr/>
7253measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7254 </td>
7255
7256 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7257 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7258 </td>
7259
7260 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7261 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7262 </td>
7263
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7264 <td class="entry_tags">
7265 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7266 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7267 </ul>
7268 </td>
7269
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7270 </tr>
7271 <tr class="entries_header">
7272 <th class="th_details" colspan="5">Details</th>
7273 </tr>
7274 <tr class="entry_cont">
7275 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7276 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7277 </td>
7278 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7279
7280
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7281 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7282 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7283
7284
7285 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7286 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7287 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7288 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7289 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7290 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7291 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7292
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7293 <span class="entry_type_array">
7294 2
7295 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7296 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7297 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7298
7299
7300 </td> <!-- entry_type -->
7301
7302 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7303 <p>The range of scene distances that are in
7304sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7305 </td>
7306
7307 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7308 pair of focus distances in diopters: (near,<wbr/>
7309 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7310 </td>
7311
7312 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7313 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7314 </td>
7315
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7316 <td class="entry_tags">
7317 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7318 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7319 </ul>
7320 </td>
7321
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7322 </tr>
7323 <tr class="entries_header">
7324 <th class="th_details" colspan="5">Details</th>
7325 </tr>
7326 <tr class="entry_cont">
7327 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7328 <p>If variable focus not supported,<wbr/> can still report
7329fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7330 </td>
7331 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7332
7333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7334 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7335 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7336
7337
7338 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7339 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7340 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7341 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7342 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7343 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7344
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7345 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7346
7347 <ul class="entry_type_enum">
7348 <li>
7349 <span class="entry_type_enum_name">OFF</span>
7350 </li>
7351 <li>
7352 <span class="entry_type_enum_name">ON</span>
7353 <span class="entry_type_enum_optional">optional</span>
7354 </li>
7355 </ul>
7356
7357 </td> <!-- entry_type -->
7358
7359 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7360 <p>Whether optical image stabilization is
7361enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7362 </td>
7363
7364 <td class="entry_units">
7365 </td>
7366
7367 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7368 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7369 </td>
7370
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7371 <td class="entry_tags">
7372 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7373 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7374 </ul>
7375 </td>
7376
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7377 </tr>
7378 <tr class="entries_header">
7379 <th class="th_details" colspan="5">Details</th>
7380 </tr>
7381 <tr class="entry_cont">
7382 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7383 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7384 </td>
7385 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7386
7387
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7388 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7389 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7390
7391
7392 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7393 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7394 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7395 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7396 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7397 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7398
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7399 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7400
7401 <ul class="entry_type_enum">
7402 <li>
7403 <span class="entry_type_enum_name">STATIONARY</span>
7404 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7405 <li>
7406 <span class="entry_type_enum_name">MOVING</span>
7407 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7408 </ul>
7409
7410 </td> <!-- entry_type -->
7411
7412 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7413 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7414 </td>
7415
7416 <td class="entry_units">
7417 </td>
7418
7419 <td class="entry_range">
7420 </td>
7421
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7422 <td class="entry_tags">
7423 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7424 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7425 </ul>
7426 </td>
7427
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7428 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7429
7430
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7431 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7432 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7433
7434
7435
7436 <!-- end of kind -->
7437 </tbody>
7438
7439 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7440 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7441
7442
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7443 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7444
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7445 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7446 <tr>
7447 <th class="th_name">Property Name</th>
7448 <th class="th_type">Type</th>
7449 <th class="th_description">Description</th>
7450 <th class="th_units">Units</th>
7451 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7452 <th class="th_tags">Tags</th>
7453 </tr>
7454 </thead>
7455
7456 <tbody>
7457
7458
7459
7460
7461
7462
7463
7464
7465
7466
7467 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7468 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7469 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7470 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7471 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7472 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7473
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7474 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7475
7476 <ul class="entry_type_enum">
7477 <li>
7478 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7479 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7480 </li>
7481 <li>
7482 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7483 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7484 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7485 </li>
7486 <li>
7487 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7488 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7489 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7490 </li>
7491 </ul>
7492
7493 </td> <!-- entry_type -->
7494
7495 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7496 <p>Mode of operation for the noise reduction
7497algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7498 </td>
7499
7500 <td class="entry_units">
7501 </td>
7502
7503 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7504 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7505 </td>
7506
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7507 <td class="entry_tags">
7508 <ul class="entry_tags">
7509 <li><a href="#tag_V1">V1</a></li>
7510 </ul>
7511 </td>
7512
7513 </tr>
7514 <tr class="entries_header">
7515 <th class="th_details" colspan="5">Details</th>
7516 </tr>
7517 <tr class="entry_cont">
7518 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7519 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7520will be applied by the HAL.<wbr/></p>
7521<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7522will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7523should use the highest-quality noise filtering algorithms,<wbr/>
7524even if it slows down capture rate.<wbr/> FAST means the HAL should not
7525slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7526 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7527 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7528
7529
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7530 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7531 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7532
7533
7534 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7535 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7536 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7537 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7538 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7539 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7540
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7541 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7542
7543
7544 </td> <!-- entry_type -->
7545
7546 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7547 <p>Control the amount of noise reduction
7548applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7549 </td>
7550
7551 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7552 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7553 </td>
7554
7555 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7556 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7557 </td>
7558
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7559 <td class="entry_tags">
7560 </td>
7561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7562 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7563
7564
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7565 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7566 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7567
7568
7569
7570 <!-- end of kind -->
7571 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7572 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7573
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7574 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7575 <tr>
7576 <th class="th_name">Property Name</th>
7577 <th class="th_type">Type</th>
7578 <th class="th_description">Description</th>
7579 <th class="th_units">Units</th>
7580 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7581 <th class="th_tags">Tags</th>
7582 </tr>
7583 </thead>
7584
7585 <tbody>
7586
7587
7588
7589
7590
7591
7592
7593
7594
7595
7596 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7597 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7598 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7599 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7600 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7601 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7602
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7603 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7604
7605 <ul class="entry_type_enum">
7606 <li>
7607 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7608 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7609 </li>
7610 <li>
7611 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7612 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7613 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7614 </li>
7615 <li>
7616 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7617 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7618 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7619 </li>
7620 </ul>
7621
7622 </td> <!-- entry_type -->
7623
7624 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7625 <p>Mode of operation for the noise reduction
7626algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7627 </td>
7628
7629 <td class="entry_units">
7630 </td>
7631
7632 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7633 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7634 </td>
7635
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7636 <td class="entry_tags">
7637 <ul class="entry_tags">
7638 <li><a href="#tag_V1">V1</a></li>
7639 </ul>
7640 </td>
7641
7642 </tr>
7643 <tr class="entries_header">
7644 <th class="th_details" colspan="5">Details</th>
7645 </tr>
7646 <tr class="entry_cont">
7647 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7648 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7649will be applied by the HAL.<wbr/></p>
7650<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7651will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7652should use the highest-quality noise filtering algorithms,<wbr/>
7653even if it slows down capture rate.<wbr/> FAST means the HAL should not
7654slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7655 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7656 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7657
7658
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7659 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7660 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7661
7662
7663
7664 <!-- end of kind -->
7665 </tbody>
7666
7667 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7668 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7669
7670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7671 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7672
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7673 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7674 <tr>
7675 <th class="th_name">Property Name</th>
7676 <th class="th_type">Type</th>
7677 <th class="th_description">Description</th>
7678 <th class="th_units">Units</th>
7679 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7680 <th class="th_tags">Tags</th>
7681 </tr>
7682 </thead>
7683
7684 <tbody>
7685
7686
7687
7688
7689
7690
7691
7692
7693
7694
7695 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7696 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7697 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7698 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7699 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7700 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7701
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7702 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7703
7704
7705 </td> <!-- entry_type -->
7706
7707 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7708 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7709scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7710region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
7711and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7712 </td>
7713
7714 <td class="entry_units">
7715 </td>
7716
7717 <td class="entry_range">
7718 </td>
7719
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7720 <td class="entry_tags">
7721 </td>
7722
7723 </tr>
7724 <tr class="entries_header">
7725 <th class="th_details" colspan="5">Details</th>
7726 </tr>
7727 <tr class="entry_cont">
7728 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7729 <p>Normalized coordinates refer to those in the
7730(-1000,<wbr/>1000) range mentioned in the
7731android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7732<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7733sensor array-relative coordinates for all region data.<wbr/> Does
7734not need to be listed in static metadata.<wbr/> Support will be
7735removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7736 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7737 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7738
7739
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7740 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7741 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7742
7743
7744 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7745 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7746 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7747 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7748 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7749 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7750
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7751 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7752
7753
7754 </td> <!-- entry_type -->
7755
7756 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7757 <p>If set to 1,<wbr/> then the camera service always
7758switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
7759trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7760 </td>
7761
7762 <td class="entry_units">
7763 </td>
7764
7765 <td class="entry_range">
7766 </td>
7767
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7768 <td class="entry_tags">
7769 </td>
7770
7771 </tr>
7772 <tr class="entries_header">
7773 <th class="th_details" colspan="5">Details</th>
7774 </tr>
7775 <tr class="entry_cont">
7776 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7777 <p>HAL implementations should implement AF trigger
7778modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
7779CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
7780not need to be listed in static metadata.<wbr/> Support will be
7781removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7782 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7783 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7784
7785
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7786 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7787 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7788
7789
7790 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7791 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7792 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7793 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7794 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7795 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7796
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7797 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7798
7799
7800 </td> <!-- entry_type -->
7801
7802 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7803 <p>If set to 1,<wbr/> the camera service uses
7804CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
7805HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
7806shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7807 </td>
7808
7809 <td class="entry_units">
7810 </td>
7811
7812 <td class="entry_range">
7813 </td>
7814
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7815 <td class="entry_tags">
7816 </td>
7817
7818 </tr>
7819 <tr class="entries_header">
7820 <th class="th_details" colspan="5">Details</th>
7821 </tr>
7822 <tr class="entry_cont">
7823 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7824 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7825to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7826zero-shutter-lag,<wbr/> instead of relying on an explicit
7827format setting.<wbr/> Does not need to be listed in static
7828metadata.<wbr/> Support will be removed in future versions of
7829camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7830 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7831 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7832
7833
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7834 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7835 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7836
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7837
7838 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7839 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7840 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7841 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7842 <td class="entry_type">
7843 <span class="entry_type_name">byte</span>
7844
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7845 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7846
7847
7848 </td> <!-- entry_type -->
7849
7850 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7851 <p>If set to 1,<wbr/> the HAL will always split result
7852metadata for a single capture into multiple buffers,<wbr/>
7853returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7854 </td>
7855
7856 <td class="entry_units">
7857 </td>
7858
7859 <td class="entry_range">
7860 </td>
7861
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7862 <td class="entry_tags">
7863 </td>
7864
7865 </tr>
7866 <tr class="entries_header">
7867 <th class="th_details" colspan="5">Details</th>
7868 </tr>
7869 <tr class="entry_cont">
7870 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7871 <p>Does not need to be listed in static
7872metadata.<wbr/> Support for partial results will be reworked in
7873future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7874working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7875consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7876 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7877 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7878
7879
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7880 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7881 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7882
7883
7884
7885 <!-- end of kind -->
7886 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7887 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7888
7889 <thead class="entries_header">
7890 <tr>
7891 <th class="th_name">Property Name</th>
7892 <th class="th_type">Type</th>
7893 <th class="th_description">Description</th>
7894 <th class="th_units">Units</th>
7895 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7896 <th class="th_tags">Tags</th>
7897 </tr>
7898 </thead>
7899
7900 <tbody>
7901
7902
7903
7904
7905
7906
7907
7908
7909
7910
7911 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7912 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7913 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7914 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7915 <td class="entry_type">
7916 <span class="entry_type_name entry_type_name_enum">byte</span>
7917
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7918 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7919
7920 <ul class="entry_type_enum">
7921 <li>
7922 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7923 <span class="entry_type_enum_notes">The last or only metadata result buffer
7924 for this capture.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7925 </li>
7926 <li>
7927 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7928 <span class="entry_type_enum_notes">A partial buffer of result metadata for this
7929 capture.<wbr/> More result buffers for this capture will be sent
7930 by the HAL,<wbr/> the last of which will be marked
7931 FINAL.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7932 </li>
7933 </ul>
7934
7935 </td> <!-- entry_type -->
7936
7937 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7938 <p>Whether a result given to the framework is the
7939final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7940subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7941values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7942 </td>
7943
7944 <td class="entry_units">
7945 </td>
7946
7947 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7948 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7949 </td>
7950
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7951 <td class="entry_tags">
7952 </td>
7953
7954 </tr>
7955 <tr class="entries_header">
7956 <th class="th_details" colspan="5">Details</th>
7957 </tr>
7958 <tr class="entry_cont">
7959 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7960 <p>The entries in the result metadata buffers for a
7961single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7962FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7963requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
7964always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
7965before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
7966in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
7967capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
7968only 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]7969 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7970 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7971
7972
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7973 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7974 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7975
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7976
7977
7978 <!-- end of kind -->
7979 </tbody>
7980
7981 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7982 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7983
7984
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7985 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7986
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7987 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7988 <tr>
7989 <th class="th_name">Property Name</th>
7990 <th class="th_type">Type</th>
7991 <th class="th_description">Description</th>
7992 <th class="th_units">Units</th>
7993 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7994 <th class="th_tags">Tags</th>
7995 </tr>
7996 </thead>
7997
7998 <tbody>
7999
8000
8001
8002
8003
8004
8005
8006
8007
8008
8009 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8010 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8011 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8012 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8013 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8014 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8015
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8016 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8017
8018
8019 </td> <!-- entry_type -->
8020
8021 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8022 <p>A frame counter set by the framework.<wbr/> Must
8023be maintained unchanged in output frame.<wbr/> This value monotonically
8024increases with every new result (that is,<wbr/> each new result has a unique
8025frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8026 </td>
8027
8028 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8029 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8030 </td>
8031
8032 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8033 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8034 </td>
8035
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8036 <td class="entry_tags">
8037 </td>
8038
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8039 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8040
8041
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8042 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8043 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8044
8045
8046 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8047 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8048 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8049 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8050 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8051 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8052
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8053 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8054
8055
8056 </td> <!-- entry_type -->
8057
8058 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8059 <p>An application-specified ID for the current
8060request.<wbr/> Must be maintained unchanged in output
8061frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8062 </td>
8063
8064 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8065 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8066 </td>
8067
8068 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8069 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8070 </td>
8071
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8072 <td class="entry_tags">
8073 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8074 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8075 </ul>
8076 </td>
8077
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8078 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8079
8080
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8081 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8082 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8083
8084
8085 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8086 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8087 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8088 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8089 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8090 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8091 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8092
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8093 <span class="entry_type_array">
8094 n
8095 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8096 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8097
8098
8099 </td> <!-- entry_type -->
8100
8101 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8102 <p>List which camera reprocess stream is used
8103for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8104 </td>
8105
8106 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8107 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8108 </td>
8109
8110 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8111 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
8112reprocess stream ID.<wbr/></p>
8113<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
8114reprocess streams may be included in a single request; they
8115must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]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>
8125 <tr class="entries_header">
8126 <th class="th_details" colspan="5">Details</th>
8127 </tr>
8128 <tr class="entry_cont">
8129 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8130 <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]8131REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8132 </td>
8133 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8134
8135
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8136 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8137 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8138
8139
8140 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8141 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8142 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8143 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8144 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8145 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8146
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8147 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8148
8149 <ul class="entry_type_enum">
8150 <li>
8151 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8152 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
8153 for application-bound buffer data.<wbr/> If no
8154 application-bound streams exist,<wbr/> no frame should be
8155 placed in the output frame queue.<wbr/> If such streams
8156 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8157 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8158 information.<wbr/> Timestamp information should still be
8159 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8160 </li>
8161 <li>
8162 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8163 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8164 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8165 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8166 </li>
8167 </ul>
8168
8169 </td> <!-- entry_type -->
8170
8171 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8172 <p>How much metadata to produce on
8173output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8174 </td>
8175
8176 <td class="entry_units">
8177 </td>
8178
8179 <td class="entry_range">
8180 </td>
8181
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8182 <td class="entry_tags">
8183 </td>
8184
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8185 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8186
8187
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8188 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8189 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8190
8191
8192 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8193 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8194 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8195 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8196 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8197 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8198 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8199
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8200 <span class="entry_type_array">
8201 n
8202 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8203 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8204
8205
8206 </td> <!-- entry_type -->
8207
8208 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8209 <p>Lists which camera output streams image data
8210from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8211 </td>
8212
8213 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8214 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8215 </td>
8216
8217 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8218 <p>List must only include streams that have been
8219created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8220 </td>
8221
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8222 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8223 <ul class="entry_tags">
8224 <li><a href="#tag_HAL2">HAL2</a></li>
8225 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8226 </td>
8227
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8228 </tr>
8229 <tr class="entries_header">
8230 <th class="th_details" colspan="5">Details</th>
8231 </tr>
8232 <tr class="entry_cont">
8233 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8234 <p>If no output streams are listed,<wbr/> then the image
8235data should simply be discarded.<wbr/> The image data must
8236still be captured for metadata and statistics production,<wbr/>
8237and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8238 </td>
8239 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8240
8241
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8242 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8243 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8244
8245
8246 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8247 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8248 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8249 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8250 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8251 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8252
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8253 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8254
8255 <ul class="entry_type_enum">
8256 <li>
8257 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8258 <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]8259 and process it according to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8260 settings</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8261 </li>
8262 <li>
8263 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8264 <span class="entry_type_enum_notes">Process previously captured data; the
8265 android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
8266 source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
8267 needed for reprocessing with [RP]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8268 </li>
8269 </ul>
8270
8271 </td> <!-- entry_type -->
8272
8273 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8274 <p>The type of the request; either CAPTURE or
8275REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8276 </td>
8277
8278 <td class="entry_units">
8279 </td>
8280
8281 <td class="entry_range">
8282 </td>
8283
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8284 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8285 <ul class="entry_tags">
8286 <li><a href="#tag_HAL2">HAL2</a></li>
8287 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8288 </td>
8289
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8290 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8291
8292
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8293 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8294 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8295
8296
8297
8298 <!-- end of kind -->
8299 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8300 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8301
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8302 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8303 <tr>
8304 <th class="th_name">Property Name</th>
8305 <th class="th_type">Type</th>
8306 <th class="th_description">Description</th>
8307 <th class="th_units">Units</th>
8308 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8309 <th class="th_tags">Tags</th>
8310 </tr>
8311 </thead>
8312
8313 <tbody>
8314
8315
8316
8317
8318
8319
8320
8321
8322
8323
8324 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8325 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8326 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8327 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8328 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8329 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8330 <span class="entry_type_container">x</span>
8331
8332 <span class="entry_type_array">
8333 3
8334 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8335 <span class="entry_type_visibility"> [public]</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>How many output streams can be allocated at
8342the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8343 </td>
8344
8345 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8346 The number of raw sensor streams; the number of
8347 processed,<wbr/> uncompressed streams; and the number of
8348 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8349 </td>
8350
8351 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8352 <p>&gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8353for processed,<wbr/> uncompressed streams</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8354 </td>
8355
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8356 <td class="entry_tags">
8357 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8358 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8359 </ul>
8360 </td>
8361
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8362 </tr>
8363 <tr class="entries_header">
8364 <th class="th_details" colspan="5">Details</th>
8365 </tr>
8366 <tr class="entry_cont">
8367 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8368 <p>Video snapshot with preview callbacks requires 3
8369processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8370one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8371 </td>
8372 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8373
8374
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8375 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8376 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8377
8378
8379 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8380 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8381 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8382 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8383 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8384 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8385 <span class="entry_type_container">x</span>
8386
8387 <span class="entry_type_array">
8388 1
8389 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8390 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8391
8392
8393 </td> <!-- entry_type -->
8394
8395 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8396 <p>How many reprocessing streams of any type
8397can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8398 </td>
8399
8400 <td class="entry_units">
8401 </td>
8402
8403 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8404 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8405 </td>
8406
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8407 <td class="entry_tags">
8408 </td>
8409
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8410 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8411
8412
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8413 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8414 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8415
8416
8417
8418 <!-- end of kind -->
8419 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8420 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8421
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8422 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8423 <tr>
8424 <th class="th_name">Property Name</th>
8425 <th class="th_type">Type</th>
8426 <th class="th_description">Description</th>
8427 <th class="th_units">Units</th>
8428 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8429 <th class="th_tags">Tags</th>
8430 </tr>
8431 </thead>
8432
8433 <tbody>
8434
8435
8436
8437
8438
8439
8440
8441
8442
8443
8444 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8445 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8446 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8447 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8448 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8449 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8450
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8451 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8452
8453
8454 </td> <!-- entry_type -->
8455
8456 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8457 <p>A frame counter set by the framework.<wbr/> This value monotonically
8458increases with every new result (that is,<wbr/> each new result has a unique
8459frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8460 </td>
8461
8462 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8463 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8464 </td>
8465
8466 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8467 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8468 </td>
8469
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8470 <td class="entry_tags">
8471 </td>
8472
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8473 </tr>
8474 <tr class="entries_header">
8475 <th class="th_details" colspan="5">Details</th>
8476 </tr>
8477 <tr class="entry_cont">
8478 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8479 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8480 </td>
8481 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8482
8483
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8484 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8485 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8486
8487
8488 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8489 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8490 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8491 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8492 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8493 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8494
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8495 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8496
8497
8498 </td> <!-- entry_type -->
8499
8500 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8501 <p>An application-specified ID for the current
8502request.<wbr/> Must be maintained unchanged in output
8503frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8504 </td>
8505
8506 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8507 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8508 </td>
8509
8510 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8511 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8512 </td>
8513
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8514 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8515 <ul class="entry_tags">
8516 <li><a href="#tag_V1">V1</a></li>
8517 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8518 </td>
8519
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8520 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8521
8522
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8523 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8524 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8525
8526
8527 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8528 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8529 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8530 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8531 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8532 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8533
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8534 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8535
8536 <ul class="entry_type_enum">
8537 <li>
8538 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8539 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
8540 for application-bound buffer data.<wbr/> If no
8541 application-bound streams exist,<wbr/> no frame should be
8542 placed in the output frame queue.<wbr/> If such streams
8543 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8544 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8545 information.<wbr/> Timestamp information should still be
8546 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8547 </li>
8548 <li>
8549 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8550 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8551 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8552 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8553 </li>
8554 </ul>
8555
8556 </td> <!-- entry_type -->
8557
8558 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8559 <p>How much metadata to produce on
8560output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8561 </td>
8562
8563 <td class="entry_units">
8564 </td>
8565
8566 <td class="entry_range">
8567 </td>
8568
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8569 <td class="entry_tags">
8570 </td>
8571
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8572 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8573
8574
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8575 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8576 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8577
8578
8579 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8580 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8581 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8582 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8583 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8584 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8585 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8586
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8587 <span class="entry_type_array">
8588 n
8589 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8590 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8591
8592
8593 </td> <!-- entry_type -->
8594
8595 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8596 <p>Lists which camera output streams image data
8597from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8598 </td>
8599
8600 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8601 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8602 </td>
8603
8604 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8605 <p>List must only include streams that have been
8606created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8607 </td>
8608
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8609 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8610 <ul class="entry_tags">
8611 <li><a href="#tag_HAL2">HAL2</a></li>
8612 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8613 </td>
8614
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8615 </tr>
8616 <tr class="entries_header">
8617 <th class="th_details" colspan="5">Details</th>
8618 </tr>
8619 <tr class="entry_cont">
8620 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8621 <p>If no output streams are listed,<wbr/> then the image
8622data should simply be discarded.<wbr/> The image data must
8623still be captured for metadata and statistics production,<wbr/>
8624and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8625 </td>
8626 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8627
8628
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8629 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8630 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8631
8632
8633
8634 <!-- end of kind -->
8635 </tbody>
8636
8637 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8638 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8639
8640
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8641 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8642
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8643 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8644 <tr>
8645 <th class="th_name">Property Name</th>
8646 <th class="th_type">Type</th>
8647 <th class="th_description">Description</th>
8648 <th class="th_units">Units</th>
8649 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8650 <th class="th_tags">Tags</th>
8651 </tr>
8652 </thead>
8653
8654 <tbody>
8655
8656
8657
8658
8659
8660
8661
8662
8663
8664
8665 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8666 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8667 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8668 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8669 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8670 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8671 <span class="entry_type_container">x</span>
8672
8673 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8674 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8675 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8676 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8677
8678
8679 </td> <!-- entry_type -->
8680
8681 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8682 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8683<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8684(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8685output.<wbr/> Each stream must use this rectangle to produce its
8686output,<wbr/> cropping to a smaller region if necessary to
8687maintain the stream's aspect ratio.<wbr/></p>
8688<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8689 </td>
8690
8691 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8692 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8693 in pixels; (0,<wbr/>0) is top-left corner of
8694 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8695 </td>
8696
8697 <td class="entry_range">
8698 </td>
8699
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8700 <td class="entry_tags">
8701 <ul class="entry_tags">
8702 <li><a href="#tag_BC">BC</a></li>
8703 </ul>
8704 </td>
8705
8706 </tr>
8707 <tr class="entries_header">
8708 <th class="th_details" colspan="5">Details</th>
8709 </tr>
8710 <tr class="entry_cont">
8711 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8712 <p>Any additional per-stream cropping must be done to
8713maximize the final pixel area of the stream.<wbr/></p>
8714<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8715ratio,<wbr/> then 4:3 streams should use the exact crop
8716region.<wbr/> 16:9 streams should further crop vertically
8717(letterbox).<wbr/></p>
8718<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8719outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8720streams should match exactly.<wbr/> These additional crops must
8721be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8722<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8723times,<wbr/> no matter what the relative aspect ratios of the
8724crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8725corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8726larger than active pixel array.<wbr/> Width and height may be
8727rounded to nearest larger supportable width,<wbr/> especially
8728for raw output,<wbr/> where only a few fixed scales may be
8729possible.<wbr/> The width and height of the crop region cannot
8730be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8731android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8732activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8733respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8734 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8735 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8736
8737
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8738 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8739 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8740
8741
8742
8743 <!-- end of kind -->
8744 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8745 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8746
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8747 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8748 <tr>
8749 <th class="th_name">Property Name</th>
8750 <th class="th_type">Type</th>
8751 <th class="th_description">Description</th>
8752 <th class="th_units">Units</th>
8753 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8754 <th class="th_tags">Tags</th>
8755 </tr>
8756 </thead>
8757
8758 <tbody>
8759
8760
8761
8762
8763
8764
8765
8766
8767
8768
8769 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8770 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8771 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8772 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8773 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8774 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8775 <span class="entry_type_container">x</span>
8776
8777 <span class="entry_type_array">
8778 n
8779 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]8780 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8781 <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]8782
8783 <ul class="entry_type_enum">
8784 <li>
8785 <span class="entry_type_enum_name">RAW_SENSOR</span>
8786 <span class="entry_type_enum_value">0x20</span>
8787 </li>
8788 <li>
8789 <span class="entry_type_enum_name">YV12</span>
8790 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8791 <span class="entry_type_enum_notes">YCrCb 4:2:0 Planar</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8792 </li>
8793 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8794 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8795 <span class="entry_type_enum_value">0x11</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8796 <span class="entry_type_enum_notes">NV21</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8797 </li>
8798 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8799 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
8800 <span class="entry_type_enum_value">0x22</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8801 <span class="entry_type_enum_notes">Hal Implementation Defined</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8802 </li>
8803 <li>
8804 <span class="entry_type_enum_name">YCbCr_420_888</span>
8805 <span class="entry_type_enum_value">0x23</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8806 <span class="entry_type_enum_notes">Flexible YUV420 Format</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8807 </li>
8808 <li>
8809 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8810 <span class="entry_type_enum_value">0x21</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8811 <span class="entry_type_enum_notes">JPEG</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8812 </li>
8813 </ul>
8814
8815 </td> <!-- entry_type -->
8816
8817 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8818 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8819 </td>
8820
8821 <td class="entry_units">
8822 </td>
8823
8824 <td class="entry_range">
8825 </td>
8826
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8827 <td class="entry_tags">
8828 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8829 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8830 </ul>
8831 </td>
8832
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8833 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8834
8835
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8836 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8837 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8838
8839
8840 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8841 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8842 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8843 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8844 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8845 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8846 <span class="entry_type_container">x</span>
8847
8848 <span class="entry_type_array">
8849 n
8850 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8851 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8852
8853
8854 </td> <!-- entry_type -->
8855
8856 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8857 <p>The minimum frame duration that is supported
8858for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8859correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8860stream is active and captured in a burst,<wbr/> with all
8861processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8862 </td>
8863
8864 <td class="entry_units">
8865 </td>
8866
8867 <td class="entry_range">
8868 </td>
8869
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8870 <td class="entry_tags">
8871 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8872 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8873 </ul>
8874 </td>
8875
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8876 </tr>
8877 <tr class="entries_header">
8878 <th class="th_details" colspan="5">Details</th>
8879 </tr>
8880 <tr class="entry_cont">
8881 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8882 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8883frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8884durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8885 </td>
8886 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8887
8888
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8889 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8890 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8891
8892
8893 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8894 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8895 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8896 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8897 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8898 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8899 <span class="entry_type_container">x</span>
8900
8901 <span class="entry_type_array">
8902 n x 2
8903 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8904 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8905
8906
8907 </td> <!-- entry_type -->
8908
8909 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8910 <p>The resolutions available for output from
8911the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8912 </td>
8913
8914 <td class="entry_units">
8915 </td>
8916
8917 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8918 <p>Must include: - sensor maximum resolution Should
8919include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8920 </td>
8921
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8922 <td class="entry_tags">
8923 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8924 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8925 </ul>
8926 </td>
8927
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8928 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8929
8930
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8931 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8932 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8933
8934
8935 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8936 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8937 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8938 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8939 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8940 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8941
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8942 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8943
8944
8945 </td> <!-- entry_type -->
8946
8947 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8948 <p>The maximum ratio between active area width
8949and crop region width,<wbr/> or between active area height and
8950crop region height,<wbr/> if the crop region height is larger
8951than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8952 </td>
8953
8954 <td class="entry_units">
8955 </td>
8956
8957 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8958 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8959 </td>
8960
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8961 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8962 <ul class="entry_tags">
8963 <li><a href="#tag_BC">BC</a></li>
8964 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8965 </td>
8966
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8967 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8968
8969
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8970 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8971 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8972
8973
8974 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8975 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8976 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8977 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8978 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8979 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8980 <span class="entry_type_container">x</span>
8981
8982 <span class="entry_type_array">
8983 n
8984 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8985 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8986
8987
8988 </td> <!-- entry_type -->
8989
8990 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8991 <p>The minimum frame duration that is supported
8992for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8993correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8994stream is active,<wbr/> with all processing set to
8995FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8996 </td>
8997
8998 <td class="entry_units">
8999 </td>
9000
9001 <td class="entry_range">
9002 </td>
9003
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9004 <td class="entry_tags">
9005 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9006 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9007 </ul>
9008 </td>
9009
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9010 </tr>
9011 <tr class="entries_header">
9012 <th class="th_details" colspan="5">Details</th>
9013 </tr>
9014 <tr class="entry_cont">
9015 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9016 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9017frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9018durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9019 </td>
9020 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9021
9022
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9023 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9024 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9025
9026
9027 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9028 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9029 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9030 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9031 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9032 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9033 <span class="entry_type_container">x</span>
9034
9035 <span class="entry_type_array">
9036 n x 2
9037 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9038 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9039
9040
9041 </td> <!-- entry_type -->
9042
9043 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9044 <p>The resolutions available for use with
9045processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
9046platform opaque YUV/<wbr/>RGB streams to the GPU or video
9047encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9048 </td>
9049
9050 <td class="entry_units">
9051 </td>
9052
9053 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9054 <p>Must include: - sensor maximum resolution -
9055standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
9056resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9057 </td>
9058
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9059 <td class="entry_tags">
9060 <ul class="entry_tags">
9061 <li><a href="#tag_BC">BC</a></li>
9062 </ul>
9063 </td>
9064
9065 </tr>
9066 <tr class="entries_header">
9067 <th class="th_details" colspan="5">Details</th>
9068 </tr>
9069 <tr class="entry_cont">
9070 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9071 <p>The actual supported resolution list may be limited by
9072consumer end points for different use cases.<wbr/> For example,<wbr/> for
9073recording use case,<wbr/> the largest supported resolution may be
9074limited by max supported size from encoder,<wbr/> for preview use
9075case,<wbr/> the largest supported resolution may be limited by max
9076resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9077 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9078 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9079
9080
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9081 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9082 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9083
9084
9085 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9086 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9087 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9088 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9089 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9090 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9091 <span class="entry_type_container">x</span>
9092
9093 <span class="entry_type_array">
9094 n
9095 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9096 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9097
9098
9099 </td> <!-- entry_type -->
9100
9101 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9102 <p>The minimum frame duration that is supported
9103for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9104correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9105is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9106 </td>
9107
9108 <td class="entry_units">
9109 </td>
9110
9111 <td class="entry_range">
9112 </td>
9113
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9114 <td class="entry_tags">
9115 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9116 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9117 </ul>
9118 </td>
9119
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9120 </tr>
9121 <tr class="entries_header">
9122 <th class="th_details" colspan="5">Details</th>
9123 </tr>
9124 <tr class="entry_cont">
9125 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9126 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9127frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9128durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9129 </td>
9130 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9131
9132
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9133 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9134 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9135
9136
9137 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9138 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9139 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9140 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9141 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9142 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9143 <span class="entry_type_container">x</span>
9144
9145 <span class="entry_type_array">
9146 n x 2
9147 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9148 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9149
9150
9151 </td> <!-- entry_type -->
9152
9153 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9154 <p>The resolutions available for use with raw
9155sensor output streams,<wbr/> listed as width,<wbr/>
9156height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9157 </td>
9158
9159 <td class="entry_units">
9160 </td>
9161
9162 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9163 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9164 </td>
9165
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9166 <td class="entry_tags">
9167 </td>
9168
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9169 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9170
9171
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9172 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9173 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9174
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9175
9176
9177 <!-- end of kind -->
9178 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9179 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9180
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9181 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9182 <tr>
9183 <th class="th_name">Property Name</th>
9184 <th class="th_type">Type</th>
9185 <th class="th_description">Description</th>
9186 <th class="th_units">Units</th>
9187 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9188 <th class="th_tags">Tags</th>
9189 </tr>
9190 </thead>
9191
9192 <tbody>
9193
9194
9195
9196
9197
9198
9199
9200
9201
9202
9203 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9204 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9205 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9206 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9207 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9208 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9209 <span class="entry_type_container">x</span>
9210
9211 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9212 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9213 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9214 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9215
9216
9217 </td> <!-- entry_type -->
9218
9219 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9220 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9221<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9222(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9223output.<wbr/> Each stream must use this rectangle to produce its
9224output,<wbr/> cropping to a smaller region if necessary to
9225maintain the stream's aspect ratio.<wbr/></p>
9226<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9227 </td>
9228
9229 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9230 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9231 in pixels; (0,<wbr/>0) is top-left corner of
9232 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9233 </td>
9234
9235 <td class="entry_range">
9236 </td>
9237
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9238 <td class="entry_tags">
9239 <ul class="entry_tags">
9240 <li><a href="#tag_BC">BC</a></li>
9241 </ul>
9242 </td>
9243
9244 </tr>
9245 <tr class="entries_header">
9246 <th class="th_details" colspan="5">Details</th>
9247 </tr>
9248 <tr class="entry_cont">
9249 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9250 <p>Any additional per-stream cropping must be done to
9251maximize the final pixel area of the stream.<wbr/></p>
9252<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9253ratio,<wbr/> then 4:3 streams should use the exact crop
9254region.<wbr/> 16:9 streams should further crop vertically
9255(letterbox).<wbr/></p>
9256<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9257outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9258streams should match exactly.<wbr/> These additional crops must
9259be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9260<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9261times,<wbr/> no matter what the relative aspect ratios of the
9262crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9263corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9264larger than active pixel array.<wbr/> Width and height may be
9265rounded to nearest larger supportable width,<wbr/> especially
9266for raw output,<wbr/> where only a few fixed scales may be
9267possible.<wbr/> The width and height of the crop region cannot
9268be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9269android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9270activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9271respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9272 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9273 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9274
9275
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9276 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9277 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9278
9279
9280
9281 <!-- end of kind -->
9282 </tbody>
9283
9284 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9285 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9286
9287
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9288 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9289
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9290 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9291 <tr>
9292 <th class="th_name">Property Name</th>
9293 <th class="th_type">Type</th>
9294 <th class="th_description">Description</th>
9295 <th class="th_units">Units</th>
9296 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9297 <th class="th_tags">Tags</th>
9298 </tr>
9299 </thead>
9300
9301 <tbody>
9302
9303
9304
9305
9306
9307
9308
9309
9310
9311
9312 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9313 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9314 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9315 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9316 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9317 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9318
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9319 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9320
9321
9322 </td> <!-- entry_type -->
9323
9324 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9325 <p>Duration each pixel is exposed to
9326light.<wbr/></p>
9327<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
9328duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9329 </td>
9330
9331 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9332 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9333 </td>
9334
9335 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9336 <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]9337 </td>
9338
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9339 <td class="entry_tags">
9340 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9341 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9342 </ul>
9343 </td>
9344
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9345 </tr>
9346 <tr class="entries_header">
9347 <th class="th_details" colspan="5">Details</th>
9348 </tr>
9349 <tr class="entry_cont">
9350 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9351 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9352 </td>
9353 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9354
9355
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9356 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9357 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9358
9359
9360 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9361 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9362 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9363 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9364 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9365 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9366
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9367 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9368
9369
9370 </td> <!-- entry_type -->
9371
9372 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9373 <p>Duration from start of frame exposure to
9374start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9375 </td>
9376
9377 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9378 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9379 </td>
9380
9381 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9382 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9383android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9384 </td>
9385
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9386 <td class="entry_tags">
9387 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9388 <li><a href="#tag_V1">V1</a></li>
9389 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9390 </ul>
9391 </td>
9392
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9393 </tr>
9394 <tr class="entries_header">
9395 <th class="th_details" colspan="5">Details</th>
9396 </tr>
9397 <tr class="entry_cont">
9398 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9399 <p>Exposure time has priority,<wbr/> so duration is set to
9400max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9401 </td>
9402 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9403
9404
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9405 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9406 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9407
9408
9409 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9410 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9411 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9412 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9413 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9414 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9415
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9416 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9417
9418
9419 </td> <!-- entry_type -->
9420
9421 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9422 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9423implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9424below 'maximum analog sensitivity'.<wbr/></p>
9425<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9426gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9427 </td>
9428
9429 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9430 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9431 </td>
9432
9433 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9434 <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]9435 </td>
9436
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9437 <td class="entry_tags">
9438 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9439 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9440 </ul>
9441 </td>
9442
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9443 </tr>
9444 <tr class="entries_header">
9445 <th class="th_details" colspan="5">Details</th>
9446 </tr>
9447 <tr class="entry_cont">
9448 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9449 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9450 </td>
9451 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9452
9453
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9454 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9455 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9456
9457
9458
9459 <!-- end of kind -->
9460 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9461 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9462
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9463 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9464 <tr>
9465 <th class="th_name">Property Name</th>
9466 <th class="th_type">Type</th>
9467 <th class="th_description">Description</th>
9468 <th class="th_units">Units</th>
9469 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9470 <th class="th_tags">Tags</th>
9471 </tr>
9472 </thead>
9473
9474 <tbody>
9475
9476
9477
9478
9479
9480
9481
9482
9483
9484
9485
9486
9487 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9488 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9489 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9490 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9491 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9492 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9493 <span class="entry_type_container">x</span>
9494
9495 <span class="entry_type_array">
9496 4
9497 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9498 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9499 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9500
9501
9502 </td> <!-- entry_type -->
9503
9504 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9505 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9506active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9507pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9508 </td>
9509
9510 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9511 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9512 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9513 </td>
9514
9515 <td class="entry_range">
9516 </td>
9517
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9518 <td class="entry_tags">
9519 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9520 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9521 </ul>
9522 </td>
9523
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9524 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9525
9526
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9527 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9528 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9529
9530
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9531 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9532 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9533 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9534 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9535 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9536 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9537 <span class="entry_type_container">x</span>
9538
9539 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9540 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9541 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9542 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9543 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9544
9545
9546 </td> <!-- entry_type -->
9547
9548 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9549 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9550 </td>
9551
9552 <td class="entry_units">
9553 </td>
9554
9555 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9556 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9557 </td>
9558
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9559 <td class="entry_tags">
9560 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9561 <li><a href="#tag_BC">BC</a></li>
9562 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9563 </ul>
9564 </td>
9565
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9566 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9567
9568
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9569 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9570 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9571
9572
9573 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9574 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9575 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9576 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9577 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9578 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9579
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9580 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9581
9582 <ul class="entry_type_enum">
9583 <li>
9584 <span class="entry_type_enum_name">RGGB</span>
9585 </li>
9586 <li>
9587 <span class="entry_type_enum_name">GRBG</span>
9588 </li>
9589 <li>
9590 <span class="entry_type_enum_name">GBRG</span>
9591 </li>
9592 <li>
9593 <span class="entry_type_enum_name">BGGR</span>
9594 </li>
9595 <li>
9596 <span class="entry_type_enum_name">RGB</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9597 <span class="entry_type_enum_notes">Sensor is not Bayer; output has 3 16-bit
9598 values for each pixel,<wbr/> instead of just 1 16-bit value
9599 per pixel.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9600 </li>
9601 </ul>
9602
9603 </td> <!-- entry_type -->
9604
9605 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9606 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9607represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9608the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9609 </td>
9610
9611 <td class="entry_units">
9612 </td>
9613
9614 <td class="entry_range">
9615 </td>
9616
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9617 <td class="entry_tags">
9618 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9619 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9620 </ul>
9621 </td>
9622
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9623 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9624
9625
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9626 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9627 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9628
9629
9630 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9631 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9632 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9633 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9634 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9635 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9636 <span class="entry_type_container">x</span>
9637
9638 <span class="entry_type_array">
9639 2
9640 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9641 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9642 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9643
9644
9645 </td> <!-- entry_type -->
9646
9647 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9648 <p>Range of valid exposure
9649times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9650 </td>
9651
9652 <td class="entry_units">
9653 </td>
9654
9655 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9656 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
9657sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9658 </td>
9659
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9660 <td class="entry_tags">
9661 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9662 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9663 </ul>
9664 </td>
9665
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9666 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9667
9668
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9669 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9670 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9671
9672
9673 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9674 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9675 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9676 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9677 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9678 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9679
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9680 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9681
9682
9683 </td> <!-- entry_type -->
9684
9685 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9686 <p>Maximum possible frame duration (minimum frame
9687rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9688 </td>
9689
9690 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9691 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9692 </td>
9693
9694 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9695 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9696 </td>
9697
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9698 <td class="entry_tags">
9699 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9700 <li><a href="#tag_BC">BC</a></li>
9701 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9702 </ul>
9703 </td>
9704
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9705 </tr>
9706 <tr class="entries_header">
9707 <th class="th_details" colspan="5">Details</th>
9708 </tr>
9709 <tr class="entry_cont">
9710 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9711 <p>Minimum duration is a function of resolution,<wbr/>
9712processing settings.<wbr/> See
9713android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
9714android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9715<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]9716 </td>
9717 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9718
9719
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9720 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9721 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9722
9723
9724 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9725 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9726 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9727 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9728 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9729 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9730 <span class="entry_type_container">x</span>
9731
9732 <span class="entry_type_array">
9733 2
9734 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]9735 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9736 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9737
9738
9739 </td> <!-- entry_type -->
9740
9741 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9742 <p>The physical dimensions of the full pixel
9743array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9744 </td>
9745
9746 <td class="entry_units">
9747 </td>
9748
9749 <td class="entry_range">
9750 </td>
9751
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9752 <td class="entry_tags">
9753 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9754 <li><a href="#tag_V1">V1</a></li>
9755 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9756 </ul>
9757 </td>
9758
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9759 </tr>
9760 <tr class="entries_header">
9761 <th class="th_details" colspan="5">Details</th>
9762 </tr>
9763 <tr class="entry_cont">
9764 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9765 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9766 </td>
9767 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9768
9769
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9770 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9771 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9772
9773
9774 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9775 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9776 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9777 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9778 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9779 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9780 <span class="entry_type_container">x</span>
9781
9782 <span class="entry_type_array">
9783 2
9784 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9785 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9786
9787
9788 </td> <!-- entry_type -->
9789
9790 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9791 <p>Dimensions of full pixel array,<wbr/> possibly
9792including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9793 </td>
9794
9795 <td class="entry_units">
9796 </td>
9797
9798 <td class="entry_range">
9799 </td>
9800
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9801 <td class="entry_tags">
9802 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9803 <li><a href="#tag_DNG">DNG</a></li>
9804 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9805 </ul>
9806 </td>
9807
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9808 </tr>
9809 <tr class="entries_header">
9810 <th class="th_details" colspan="5">Details</th>
9811 </tr>
9812 <tr class="entry_cont">
9813 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9814 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9815match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9816android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9817 </td>
9818 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9819
9820
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9821 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9822 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9823
9824
9825 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9826 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9827 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9828 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9829 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9830 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9831
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9832 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9833
9834
9835 </td> <!-- entry_type -->
9836
9837 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9838 <p>Maximum raw value output by
9839sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9840 </td>
9841
9842 <td class="entry_units">
9843 </td>
9844
9845 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9846 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9847 </td>
9848
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9849 <td class="entry_tags">
9850 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9851 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9852 </ul>
9853 </td>
9854
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9855 </tr>
9856 <tr class="entries_header">
9857 <th class="th_details" colspan="5">Details</th>
9858 </tr>
9859 <tr class="entry_cont">
9860 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9861 <p>Defines sensor bit depth (10-14 bits is
9862expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9863 </td>
9864 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9865
9866
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9867 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9868 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9869
9870
9871
9872
9873
9874 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9875 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9876 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9877 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9878 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9879 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9880
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9881 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9882
9883
9884 </td> <!-- entry_type -->
9885
9886 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9887 <p>Gain factor from electrons to raw units when
9888ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9889 </td>
9890
9891 <td class="entry_units">
9892 </td>
9893
9894 <td class="entry_range">
9895 </td>
9896
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9897 <td class="entry_tags">
9898 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9899 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9900 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9901 </ul>
9902 </td>
9903
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9904 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9905
9906
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9907 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9908 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9909
9910
9911 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9912 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9913 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9914 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9915 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9916 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9917 <span class="entry_type_container">x</span>
9918
9919 <span class="entry_type_array">
9920 4
9921 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9922 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9923 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9924
9925
9926 </td> <!-- entry_type -->
9927
9928 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9929 <p>A fixed black level offset for each of the
9930Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9931 </td>
9932
9933 <td class="entry_units">
9934 </td>
9935
9936 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9937 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9938 </td>
9939
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9940 <td class="entry_tags">
9941 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9942 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9943 </ul>
9944 </td>
9945
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9946 </tr>
9947 <tr class="entries_header">
9948 <th class="th_details" colspan="5">Details</th>
9949 </tr>
9950 <tr class="entry_cont">
9951 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9952 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
9953tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9954 </td>
9955 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9956
9957
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9958 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9959 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9960
9961
9962 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9963 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9964 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9965 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9966 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9967 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9968 <span class="entry_type_container">x</span>
9969
9970 <span class="entry_type_array">
9971 9
9972 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9973 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9974 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9975
9976
9977 </td> <!-- entry_type -->
9978
9979 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9980 <p>Per-device calibration on top of color space
9981transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9982 </td>
9983
9984 <td class="entry_units">
9985 </td>
9986
9987 <td class="entry_range">
9988 </td>
9989
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9990 <td class="entry_tags">
9991 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9992 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9993 </ul>
9994 </td>
9995
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9996 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9997
9998
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9999 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10000 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10001
10002
10003 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10004 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10005 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10006 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10007 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10008 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10009 <span class="entry_type_container">x</span>
10010
10011 <span class="entry_type_array">
10012 9
10013 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10014 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10015 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10016
10017
10018 </td> <!-- entry_type -->
10019
10020 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10021 <p>Per-device calibration on top of color space
10022transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10023 </td>
10024
10025 <td class="entry_units">
10026 </td>
10027
10028 <td class="entry_range">
10029 </td>
10030
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10031 <td class="entry_tags">
10032 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10033 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10034 </ul>
10035 </td>
10036
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10037 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10038
10039
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10040 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10041 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10042
10043
10044 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10045 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10046 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10047 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10048 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10049 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10050 <span class="entry_type_container">x</span>
10051
10052 <span class="entry_type_array">
10053 9
10054 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10055 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10056 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10057
10058
10059 </td> <!-- entry_type -->
10060
10061 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10062 <p>Linear mapping from XYZ (D50) color space to
10063reference linear sensor color,<wbr/> for first reference
10064illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10065 </td>
10066
10067 <td class="entry_units">
10068 </td>
10069
10070 <td class="entry_range">
10071 </td>
10072
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10073 <td class="entry_tags">
10074 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10075 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10076 </ul>
10077 </td>
10078
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10079 </tr>
10080 <tr class="entries_header">
10081 <th class="th_details" colspan="5">Details</th>
10082 </tr>
10083 <tr class="entry_cont">
10084 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10085 <p>Use as follows XYZ = inv(transform) * clip( (raw -
10086black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
10087At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10088 </td>
10089 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10090
10091
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10092 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10093 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10094
10095
10096 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10097 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10098 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10099 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10100 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10101 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10102 <span class="entry_type_container">x</span>
10103
10104 <span class="entry_type_array">
10105 9
10106 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10107 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10108 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10109
10110
10111 </td> <!-- entry_type -->
10112
10113 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10114 <p>Linear mapping from XYZ (D50) color space to
10115reference linear sensor color,<wbr/> for second reference
10116illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10117 </td>
10118
10119 <td class="entry_units">
10120 </td>
10121
10122 <td class="entry_range">
10123 </td>
10124
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10125 <td class="entry_tags">
10126 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10127 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10128 </ul>
10129 </td>
10130
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10131 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10132
10133
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10134 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10135 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10136
10137
10138 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10139 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10140 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10141 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10142 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10143 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10144 <span class="entry_type_container">x</span>
10145
10146 <span class="entry_type_array">
10147 9
10148 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10149 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10150 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10151
10152
10153 </td> <!-- entry_type -->
10154
10155 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10156 <p>Used by DNG for better WB
10157adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10158 </td>
10159
10160 <td class="entry_units">
10161 </td>
10162
10163 <td class="entry_range">
10164 </td>
10165
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10166 <td class="entry_tags">
10167 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10168 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10169 </ul>
10170 </td>
10171
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10172 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10173
10174
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10175 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10176 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10177
10178
10179 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10180 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10181 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10182 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10183 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10184 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10185 <span class="entry_type_container">x</span>
10186
10187 <span class="entry_type_array">
10188 9
10189 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10190 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10191 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10192
10193
10194 </td> <!-- entry_type -->
10195
10196 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10197 <p>Used by DNG for better WB
10198adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10199 </td>
10200
10201 <td class="entry_units">
10202 </td>
10203
10204 <td class="entry_range">
10205 </td>
10206
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10207 <td class="entry_tags">
10208 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10209 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10210 </ul>
10211 </td>
10212
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10213 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10214
10215
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10216 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10217 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10218
10219
10220 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10221 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10222 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10223 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10224 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10225 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10226
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10227 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10228
10229
10230 </td> <!-- entry_type -->
10231
10232 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10233 <p>Maximum sensitivity that is implemented
10234purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10235 </td>
10236
10237 <td class="entry_units">
10238 </td>
10239
10240 <td class="entry_range">
10241 </td>
10242
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10243 <td class="entry_tags">
10244 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10245 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10246 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10247 </ul>
10248 </td>
10249
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10250 </tr>
10251 <tr class="entries_header">
10252 <th class="th_details" colspan="5">Details</th>
10253 </tr>
10254 <tr class="entry_cont">
10255 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10256 <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]10257equal to this,<wbr/> all applied gain must be analog.<wbr/> For
10258values above this,<wbr/> it can be a mix of analog and
10259digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10260 </td>
10261 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10262
10263
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10264 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10265 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10266
10267
10268 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10269 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10270 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10271 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10272 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10273 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10274 <span class="entry_type_container">x</span>
10275
10276 <span class="entry_type_array">
10277 2
10278 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10279 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10280 <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]10281
10282
10283 </td> <!-- entry_type -->
10284
10285 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10286 <p>Estimation of sensor noise
10287characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10288 </td>
10289
10290 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10291 var(raw pixel value) = electrons * (baseGainFactor
10292 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
10293 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10294 </td>
10295
10296 <td class="entry_range">
10297 </td>
10298
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10299 <td class="entry_tags">
10300 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10301 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10302 </ul>
10303 </td>
10304
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10305 </tr>
10306 <tr class="entries_header">
10307 <th class="th_details" colspan="5">Details</th>
10308 </tr>
10309 <tr class="entry_cont">
10310 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10311 <p>A represents sensor read noise before analog
10312amplification; B represents noise from A/<wbr/>D conversion and
10313other circuits after amplification.<wbr/> Both noise sources
10314are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
10315across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10316 </td>
10317 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10318
10319
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10320 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10321 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10322
10323
10324 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10325 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10326 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10327 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10328 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10329 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10330
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10331 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10332
10333
10334 </td> <!-- entry_type -->
10335
10336 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10337 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10338image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10339screen in its native orientation.<wbr/> Also defines the
10340direction of rolling shutter readout,<wbr/> which is from top
10341to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10342 </td>
10343
10344 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10345 degrees clockwise rotation,<wbr/> only multiples of
10346 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10347 </td>
10348
10349 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10350 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10351 </td>
10352
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10353 <td class="entry_tags">
10354 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10355 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10356 </ul>
10357 </td>
10358
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10359 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10360
10361
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10362 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10363 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10364
10365
10366 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10367 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10368 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10369 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10370 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10371 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10372
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10373 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10374
10375 <ul class="entry_type_enum">
10376 <li>
10377 <span class="entry_type_enum_name">DAYLIGHT</span>
10378 <span class="entry_type_enum_value">1</span>
10379 </li>
10380 <li>
10381 <span class="entry_type_enum_name">FLUORESCENT</span>
10382 <span class="entry_type_enum_value">2</span>
10383 </li>
10384 <li>
10385 <span class="entry_type_enum_name">TUNGSTEN</span>
10386 <span class="entry_type_enum_value">3</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10387 <span class="entry_type_enum_notes">Incandescent light</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10388 </li>
10389 <li>
10390 <span class="entry_type_enum_name">FLASH</span>
10391 <span class="entry_type_enum_value">4</span>
10392 </li>
10393 <li>
10394 <span class="entry_type_enum_name">FINE_WEATHER</span>
10395 <span class="entry_type_enum_value">9</span>
10396 </li>
10397 <li>
10398 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10399 <span class="entry_type_enum_value">10</span>
10400 </li>
10401 <li>
10402 <span class="entry_type_enum_name">SHADE</span>
10403 <span class="entry_type_enum_value">11</span>
10404 </li>
10405 <li>
10406 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10407 <span class="entry_type_enum_value">12</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10408 <span class="entry_type_enum_notes">D 5700 - 7100K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10409 </li>
10410 <li>
10411 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10412 <span class="entry_type_enum_value">13</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10413 <span class="entry_type_enum_notes">N 4600 - 5400K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10414 </li>
10415 <li>
10416 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10417 <span class="entry_type_enum_value">14</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10418 <span class="entry_type_enum_notes">W 3900 - 4500K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10419 </li>
10420 <li>
10421 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10422 <span class="entry_type_enum_value">15</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10423 <span class="entry_type_enum_notes">WW 3200 - 3700K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10424 </li>
10425 <li>
10426 <span class="entry_type_enum_name">STANDARD_A</span>
10427 <span class="entry_type_enum_value">17</span>
10428 </li>
10429 <li>
10430 <span class="entry_type_enum_name">STANDARD_B</span>
10431 <span class="entry_type_enum_value">18</span>
10432 </li>
10433 <li>
10434 <span class="entry_type_enum_name">STANDARD_C</span>
10435 <span class="entry_type_enum_value">19</span>
10436 </li>
10437 <li>
10438 <span class="entry_type_enum_name">D55</span>
10439 <span class="entry_type_enum_value">20</span>
10440 </li>
10441 <li>
10442 <span class="entry_type_enum_name">D65</span>
10443 <span class="entry_type_enum_value">21</span>
10444 </li>
10445 <li>
10446 <span class="entry_type_enum_name">D75</span>
10447 <span class="entry_type_enum_value">22</span>
10448 </li>
10449 <li>
10450 <span class="entry_type_enum_name">D50</span>
10451 <span class="entry_type_enum_value">23</span>
10452 </li>
10453 <li>
10454 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10455 <span class="entry_type_enum_value">24</span>
10456 </li>
10457 </ul>
10458
10459 </td> <!-- entry_type -->
10460
10461 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10462 <p>Light source used to define transform
104631</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10464 </td>
10465
10466 <td class="entry_units">
10467 </td>
10468
10469 <td class="entry_range">
10470 </td>
10471
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10472 <td class="entry_tags">
10473 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10474 <li><a href="#tag_DNG">DNG</a></li>
10475 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10476 </ul>
10477 </td>
10478
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10479 </tr>
10480 <tr class="entries_header">
10481 <th class="th_details" colspan="5">Details</th>
10482 </tr>
10483 <tr class="entry_cont">
10484 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10485 <p>[EXIF LightSource tag] Must all these be
10486supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10487 </td>
10488 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10489
10490
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10491 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10492 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10493
10494
10495 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10496 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10497 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10498 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10499 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10500 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10501
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10502 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10503
10504
10505 </td> <!-- entry_type -->
10506
10507 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10508 <p>Light source used to define transform
105092</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10510 </td>
10511
10512 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10513 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10514 </td>
10515
10516 <td class="entry_range">
10517 </td>
10518
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10519 <td class="entry_tags">
10520 </td>
10521
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10522 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10523
10524
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10525 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10526 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10527
10528
10529
10530 <!-- end of kind -->
10531 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10532 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10533
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10534 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10535 <tr>
10536 <th class="th_name">Property Name</th>
10537 <th class="th_type">Type</th>
10538 <th class="th_description">Description</th>
10539 <th class="th_units">Units</th>
10540 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10541 <th class="th_tags">Tags</th>
10542 </tr>
10543 </thead>
10544
10545 <tbody>
10546
10547
10548
10549
10550
10551
10552
10553
10554
10555
10556 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10557 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10558 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10559 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10560 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10561 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10562
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10563 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10564
10565
10566 </td> <!-- entry_type -->
10567
10568 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10569 <p>Duration each pixel is exposed to
10570light.<wbr/></p>
10571<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
10572duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10573 </td>
10574
10575 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10576 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10577 </td>
10578
10579 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10580 <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]10581 </td>
10582
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10583 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10584 <ul class="entry_tags">
10585 <li><a href="#tag_V1">V1</a></li>
10586 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10587 </td>
10588
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10589 </tr>
10590 <tr class="entries_header">
10591 <th class="th_details" colspan="5">Details</th>
10592 </tr>
10593 <tr class="entry_cont">
10594 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10595 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10596 </td>
10597 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10598
10599
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10600 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10601 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10602
10603
10604 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10605 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10606 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10607 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10608 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10609 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10610
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10611 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10612
10613
10614 </td> <!-- entry_type -->
10615
10616 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10617 <p>Duration from start of frame exposure to
10618start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10619 </td>
10620
10621 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10622 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10623 </td>
10624
10625 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10626 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
10627android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10628 </td>
10629
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10630 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10631 <ul class="entry_tags">
10632 <li><a href="#tag_V1">V1</a></li>
10633 <li><a href="#tag_BC">BC</a></li>
10634 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10635 </td>
10636
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10637 </tr>
10638 <tr class="entries_header">
10639 <th class="th_details" colspan="5">Details</th>
10640 </tr>
10641 <tr class="entry_cont">
10642 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10643 <p>Exposure time has priority,<wbr/> so duration is set to
10644max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10645 </td>
10646 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10647
10648
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10649 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10650 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10651
10652
10653 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10654 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10655 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10656 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10657 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10658 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10659
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10660 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10661
10662
10663 </td> <!-- entry_type -->
10664
10665 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10666 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10667implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10668below 'maximum analog sensitivity'.<wbr/></p>
10669<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10670gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10671 </td>
10672
10673 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10674 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10675 </td>
10676
10677 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10678 <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]10679 </td>
10680
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10681 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10682 <ul class="entry_tags">
10683 <li><a href="#tag_V1">V1</a></li>
10684 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10685 </td>
10686
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10687 </tr>
10688 <tr class="entries_header">
10689 <th class="th_details" colspan="5">Details</th>
10690 </tr>
10691 <tr class="entry_cont">
10692 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10693 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10694 </td>
10695 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10696
10697
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10698 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10699 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10700
10701
10702 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10703 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10704 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10705 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10706 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10707 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10708
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10709 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10710
10711
10712 </td> <!-- entry_type -->
10713
10714 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10715 <p>Time at start of exposure of first
10716row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10717 </td>
10718
10719 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10720 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10721 </td>
10722
10723 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10724 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10725 </td>
10726
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10727 <td class="entry_tags">
10728 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10729 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10730 </ul>
10731 </td>
10732
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10733 </tr>
10734 <tr class="entries_header">
10735 <th class="th_details" colspan="5">Details</th>
10736 </tr>
10737 <tr class="entry_cont">
10738 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10739 <p>Monotonic,<wbr/> should be synced to other timestamps in
10740system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10741 </td>
10742 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10743
10744
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10745 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10746 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10747
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10748
10749 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10750 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10751 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10752 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10753 <td class="entry_type">
10754 <span class="entry_type_name">float</span>
10755
10756 <span class="entry_type_visibility"> [public]</span>
10757
10758
10759 </td> <!-- entry_type -->
10760
10761 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10762 <p>The temperature of the sensor,<wbr/> sampled at the time
10763exposure began for this frame.<wbr/></p>
10764<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
10765somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10766 </td>
10767
10768 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10769 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10770 </td>
10771
10772 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10773 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10774 </td>
10775
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10776 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10777 <ul class="entry_tags">
10778 <li><a href="#tag_FULL">FULL</a></li>
10779 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10780 </td>
10781
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10782 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10783
10784
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10785 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10786 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10787
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10788
10789
10790 <!-- end of kind -->
10791 </tbody>
10792
10793 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10794 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10795
10796
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10797 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10798
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10799 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10800 <tr>
10801 <th class="th_name">Property Name</th>
10802 <th class="th_type">Type</th>
10803 <th class="th_description">Description</th>
10804 <th class="th_units">Units</th>
10805 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10806 <th class="th_tags">Tags</th>
10807 </tr>
10808 </thead>
10809
10810 <tbody>
10811
10812
10813
10814
10815
10816
10817
10818
10819
10820
10821 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10822 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10823 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10824 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10825 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10826 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10827
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10828 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10829
10830 <ul class="entry_type_enum">
10831 <li>
10832 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10833 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10834 </li>
10835 <li>
10836 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10837 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10838 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10839 </li>
10840 <li>
10841 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10842 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10843 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10844 </li>
10845 </ul>
10846
10847 </td> <!-- entry_type -->
10848
10849 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10850 <p>Quality of lens shading correction applied
10851to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10852 </td>
10853
10854 <td class="entry_units">
10855 </td>
10856
10857 <td class="entry_range">
10858 </td>
10859
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10860 <td class="entry_tags">
10861 </td>
10862
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10863 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10864
10865
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10866 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10867 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10868
10869
10870 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10871 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10872 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10873 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10874 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10875 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10876
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10877 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10878
10879
10880 </td> <!-- entry_type -->
10881
10882 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10883 <p>Control the amount of shading correction
10884applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10885 </td>
10886
10887 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10888 unitless: 1-10; 10 is full shading
10889 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10890 </td>
10891
10892 <td class="entry_range">
10893 </td>
10894
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10895 <td class="entry_tags">
10896 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10897 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10898 </ul>
10899 </td>
10900
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10901 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10902
10903
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10904 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10905 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10906
10907
10908
10909 <!-- end of kind -->
10910 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10911 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10912
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10913 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10914 <tr>
10915 <th class="th_name">Property Name</th>
10916 <th class="th_type">Type</th>
10917 <th class="th_description">Description</th>
10918 <th class="th_units">Units</th>
10919 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10920 <th class="th_tags">Tags</th>
10921 </tr>
10922 </thead>
10923
10924 <tbody>
10925
10926
10927
10928
10929
10930
10931
10932
10933
10934
10935 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10936 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10937 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10938 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10939 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10940 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10941
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10942 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10943
10944 <ul class="entry_type_enum">
10945 <li>
10946 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10947 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10948 </li>
10949 <li>
10950 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10951 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10952 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10953 </li>
10954 <li>
10955 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10956 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10957 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10958 </li>
10959 </ul>
10960
10961 </td> <!-- entry_type -->
10962
10963 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10964 <p>Quality of lens shading correction applied
10965to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10966 </td>
10967
10968 <td class="entry_units">
10969 </td>
10970
10971 <td class="entry_range">
10972 </td>
10973
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10974 <td class="entry_tags">
10975 </td>
10976
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10977 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10978
10979
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10980 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10981 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10982
10983
10984
10985 <!-- end of kind -->
10986 </tbody>
10987
10988 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10989 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10990
10991
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10992 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10993
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10994 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10995 <tr>
10996 <th class="th_name">Property Name</th>
10997 <th class="th_type">Type</th>
10998 <th class="th_description">Description</th>
10999 <th class="th_units">Units</th>
11000 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11001 <th class="th_tags">Tags</th>
11002 </tr>
11003 </thead>
11004
11005 <tbody>
11006
11007
11008
11009
11010
11011
11012
11013
11014
11015
11016 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11017 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11018 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11019 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11020 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11021 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11022
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11023 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11024
11025 <ul class="entry_type_enum">
11026 <li>
11027 <span class="entry_type_enum_name">OFF</span>
11028 </li>
11029 <li>
11030 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11031 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
11032 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11033 </li>
11034 <li>
11035 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11036 <span class="entry_type_enum_notes">Optional Return all face
11037 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11038 </li>
11039 </ul>
11040
11041 </td> <!-- entry_type -->
11042
11043 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11044 <p>State of the face detector
11045unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11046 </td>
11047
11048 <td class="entry_units">
11049 </td>
11050
11051 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11052 <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]11053 </td>
11054
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11055 <td class="entry_tags">
11056 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11057 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11058 </ul>
11059 </td>
11060
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11061 </tr>
11062 <tr class="entries_header">
11063 <th class="th_details" colspan="5">Details</th>
11064 </tr>
11065 <tr class="entry_cont">
11066 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11067 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11068should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11069fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11070<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]11071 </td>
11072 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11073
11074
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11075 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11076 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11077
11078
11079 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11080 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11081 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11082 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11083 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11084 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11085
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11086 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11087
11088 <ul class="entry_type_enum">
11089 <li>
11090 <span class="entry_type_enum_name">OFF</span>
11091 </li>
11092 <li>
11093 <span class="entry_type_enum_name">ON</span>
11094 </li>
11095 </ul>
11096
11097 </td> <!-- entry_type -->
11098
11099 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11100 <p>Operating mode for histogram
11101generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11102 </td>
11103
11104 <td class="entry_units">
11105 </td>
11106
11107 <td class="entry_range">
11108 </td>
11109
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11110 <td class="entry_tags">
11111 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11112 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11113 </ul>
11114 </td>
11115
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11116 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11117
11118
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11119 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11120 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11121
11122
11123 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11124 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11125 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11126 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11127 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11128 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11129
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11130 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11131
11132 <ul class="entry_type_enum">
11133 <li>
11134 <span class="entry_type_enum_name">OFF</span>
11135 </li>
11136 <li>
11137 <span class="entry_type_enum_name">ON</span>
11138 </li>
11139 </ul>
11140
11141 </td> <!-- entry_type -->
11142
11143 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11144 <p>Operating mode for sharpness map
11145generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11146 </td>
11147
11148 <td class="entry_units">
11149 </td>
11150
11151 <td class="entry_range">
11152 </td>
11153
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11154 <td class="entry_tags">
11155 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11156 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11157 </ul>
11158 </td>
11159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11160 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11161
11162
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11163 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11164 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11165
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11166
11167 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11168 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11169 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11170 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11171 <td class="entry_type">
11172 <span class="entry_type_name entry_type_name_enum">byte</span>
11173
11174 <span class="entry_type_visibility"> [public]</span>
11175
11176 <ul class="entry_type_enum">
11177 <li>
11178 <span class="entry_type_enum_name">OFF</span>
11179 </li>
11180 <li>
11181 <span class="entry_type_enum_name">ON</span>
11182 </li>
11183 </ul>
11184
11185 </td> <!-- entry_type -->
11186
11187 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11188 <p>Whether the HAL needs to output the lens
11189shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11190 </td>
11191
11192 <td class="entry_units">
11193 </td>
11194
11195 <td class="entry_range">
11196 </td>
11197
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11198 <td class="entry_tags">
11199 </td>
11200
11201 </tr>
11202 <tr class="entries_header">
11203 <th class="th_details" colspan="5">Details</th>
11204 </tr>
11205 <tr class="entry_cont">
11206 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11207 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11208<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]11209the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11210 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11211 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11212
11213
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11214 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11215 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11216
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11217
11218
11219 <!-- end of kind -->
11220 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11221 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11222
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11223 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11224 <tr>
11225 <th class="th_name">Property Name</th>
11226 <th class="th_type">Type</th>
11227 <th class="th_description">Description</th>
11228 <th class="th_units">Units</th>
11229 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11230 <th class="th_tags">Tags</th>
11231 </tr>
11232 </thead>
11233
11234 <tbody>
11235
11236
11237
11238
11239
11240
11241
11242
11243
11244
11245
11246
11247 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11248 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11249 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11250 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11251 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11252 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11253 <span class="entry_type_container">x</span>
11254
11255 <span class="entry_type_array">
11256 n
11257 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11258 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11259 <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]11260
11261
11262 </td> <!-- entry_type -->
11263
11264 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11265 <p>Which face detection modes are available,<wbr/>
11266if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11267 </td>
11268
11269 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11270 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11271 OFF
11272 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11273 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11274 </td>
11275
11276 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11277 </td>
11278
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11279 <td class="entry_tags">
11280 </td>
11281
11282 </tr>
11283 <tr class="entries_header">
11284 <th class="th_details" colspan="5">Details</th>
11285 </tr>
11286 <tr class="entry_cont">
11287 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11288 <p>OFF means face detection is disabled,<wbr/> it must
11289be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11290<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11291<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
11292<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]11293<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11294<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
11295<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]11296 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11297 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11298
11299
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11300 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11301 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11302
11303
11304 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11305 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11306 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11307 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11308 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11309 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11310
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11311 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11312
11313
11314 </td> <!-- entry_type -->
11315
11316 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11317 <p>Number of histogram buckets
11318supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11319 </td>
11320
11321 <td class="entry_units">
11322 </td>
11323
11324 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11325 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11326 </td>
11327
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11328 <td class="entry_tags">
11329 </td>
11330
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11331 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11332
11333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11334 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11335 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11336
11337
11338 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11339 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11340 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11341 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11342 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11343 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11344
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11345 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11346
11347
11348 </td> <!-- entry_type -->
11349
11350 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11351 <p>Maximum number of simultaneously detectable
11352faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11353 </td>
11354
11355 <td class="entry_units">
11356 </td>
11357
11358 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11359 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11360modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11361 </td>
11362
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11363 <td class="entry_tags">
11364 </td>
11365
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11366 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11367
11368
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11369 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11370 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11371
11372
11373 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11374 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11375 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11376 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11377 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11378 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11379
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11380 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11381
11382
11383 </td> <!-- entry_type -->
11384
11385 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11386 <p>Maximum value possible for a histogram
11387bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11388 </td>
11389
11390 <td class="entry_units">
11391 </td>
11392
11393 <td class="entry_range">
11394 </td>
11395
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11396 <td class="entry_tags">
11397 </td>
11398
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11399 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11400
11401
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11402 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11403 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11404
11405
11406 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11407 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11408 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11409 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11410 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11411 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11412
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11413 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11414
11415
11416 </td> <!-- entry_type -->
11417
11418 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11419 <p>Maximum value possible for a sharpness map
11420region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11421 </td>
11422
11423 <td class="entry_units">
11424 </td>
11425
11426 <td class="entry_range">
11427 </td>
11428
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11429 <td class="entry_tags">
11430 </td>
11431
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11432 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11433
11434
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11435 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11436 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11437
11438
11439 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11440 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11441 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11442 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11443 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11444 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11445 <span class="entry_type_container">x</span>
11446
11447 <span class="entry_type_array">
11448 2
11449 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11450 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11451 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11452
11453
11454 </td> <!-- entry_type -->
11455
11456 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11457 <p>Dimensions of the sharpness
11458map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11459 </td>
11460
11461 <td class="entry_units">
11462 </td>
11463
11464 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11465 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11466 </td>
11467
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11468 <td class="entry_tags">
11469 </td>
11470
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11471 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11472
11473
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11474 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11475 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11476
11477
11478
11479
11480
11481
11482 <!-- end of kind -->
11483 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11484 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11485
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11486 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11487 <tr>
11488 <th class="th_name">Property Name</th>
11489 <th class="th_type">Type</th>
11490 <th class="th_description">Description</th>
11491 <th class="th_units">Units</th>
11492 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11493 <th class="th_tags">Tags</th>
11494 </tr>
11495 </thead>
11496
11497 <tbody>
11498
11499
11500
11501
11502
11503
11504
11505
11506
11507
11508 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11509 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11510 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11511 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11512 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11513 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11514
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11515 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11516
11517 <ul class="entry_type_enum">
11518 <li>
11519 <span class="entry_type_enum_name">OFF</span>
11520 </li>
11521 <li>
11522 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11523 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
11524 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11525 </li>
11526 <li>
11527 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11528 <span class="entry_type_enum_notes">Optional Return all face
11529 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11530 </li>
11531 </ul>
11532
11533 </td> <!-- entry_type -->
11534
11535 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11536 <p>State of the face detector
11537unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11538 </td>
11539
11540 <td class="entry_units">
11541 </td>
11542
11543 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11544 <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]11545 </td>
11546
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11547 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11548 <ul class="entry_tags">
11549 <li><a href="#tag_BC">BC</a></li>
11550 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11551 </td>
11552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11553 </tr>
11554 <tr class="entries_header">
11555 <th class="th_details" colspan="5">Details</th>
11556 </tr>
11557 <tr class="entry_cont">
11558 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11559 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11560should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11561fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11562<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]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.faceIds">
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/>Ids
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">int32</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 unique IDs for detected
11589faces</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">
11596 </td>
11597
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11598 <td class="entry_tags">
11599 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11600 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11601 </ul>
11602 </td>
11603
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11604 </tr>
11605 <tr class="entries_header">
11606 <th class="th_details" colspan="5">Details</th>
11607 </tr>
11608 <tr class="entry_cont">
11609 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11610 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11611 </td>
11612 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11613
11614
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11615 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11616 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11617
11618
11619 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11620 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11621 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11622 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11623 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11624 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11625 <span class="entry_type_container">x</span>
11626
11627 <span class="entry_type_array">
11628 n x 6
11629 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11630 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11631 <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]11632
11633
11634 </td> <!-- entry_type -->
11635
11636 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11637 <p>List of landmarks for detected
11638faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11639 </td>
11640
11641 <td class="entry_units">
11642 </td>
11643
11644 <td class="entry_range">
11645 </td>
11646
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11647 <td class="entry_tags">
11648 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11649 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11650 </ul>
11651 </td>
11652
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11653 </tr>
11654 <tr class="entries_header">
11655 <th class="th_details" colspan="5">Details</th>
11656 </tr>
11657 <tr class="entry_cont">
11658 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11659 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11660 </td>
11661 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11662
11663
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11664 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11665 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11666
11667
11668 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11669 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11670 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11671 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11672 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11673 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11674 <span class="entry_type_container">x</span>
11675
11676 <span class="entry_type_array">
11677 n x 4
11678 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11679 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11680 <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]11681
11682
11683 </td> <!-- entry_type -->
11684
11685 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11686 <p>List of the bounding rectangles for detected
11687faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11688 </td>
11689
11690 <td class="entry_units">
11691 </td>
11692
11693 <td class="entry_range">
11694 </td>
11695
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11696 <td class="entry_tags">
11697 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11698 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11699 </ul>
11700 </td>
11701
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11702 </tr>
11703 <tr class="entries_header">
11704 <th class="th_details" colspan="5">Details</th>
11705 </tr>
11706 <tr class="entry_cont">
11707 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11708 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11709 </td>
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.faceScores">
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/>face<wbr/>Scores
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">byte</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
11727 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11728 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11729
11730
11731 </td> <!-- entry_type -->
11732
11733 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11734 <p>List of the face confidence scores for
11735detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11736 </td>
11737
11738 <td class="entry_units">
11739 </td>
11740
11741 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11742 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]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_BC">BC</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>Only available if faceDetectMode != OFF.<wbr/> The value should be
11758meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></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.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11768 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11769 android.<wbr/>statistics.<wbr/>histogram
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">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11773 <span class="entry_type_container">x</span>
11774
11775 <span class="entry_type_array">
11776 n x 3
11777 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11778 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11779 <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]11780
11781
11782 </td> <!-- entry_type -->
11783
11784 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11785 <p>A 3-channel histogram based on the raw
11786sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11787 </td>
11788
11789 <td class="entry_units">
11790 </td>
11791
11792 <td class="entry_range">
11793 </td>
11794
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11795 <td class="entry_tags">
11796 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11797 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11798 </ul>
11799 </td>
11800
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11801 </tr>
11802 <tr class="entries_header">
11803 <th class="th_details" colspan="5">Details</th>
11804 </tr>
11805 <tr class="entry_cont">
11806 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11807 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11808(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]11809(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
11810supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11811 </td>
11812 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11813
11814
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11815 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11816 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11817
11818
11819 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11820 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11821 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11822 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11823 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11824 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11825
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11826 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11827
11828 <ul class="entry_type_enum">
11829 <li>
11830 <span class="entry_type_enum_name">OFF</span>
11831 </li>
11832 <li>
11833 <span class="entry_type_enum_name">ON</span>
11834 </li>
11835 </ul>
11836
11837 </td> <!-- entry_type -->
11838
11839 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11840 <p>Operating mode for histogram
11841generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11842 </td>
11843
11844 <td class="entry_units">
11845 </td>
11846
11847 <td class="entry_range">
11848 </td>
11849
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11850 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11851 <ul class="entry_tags">
11852 <li><a href="#tag_V1">V1</a></li>
11853 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11854 </td>
11855
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11856 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11857
11858
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11859 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11860 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11861
11862
11863 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11864 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11865 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11866 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11867 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11868 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11869 <span class="entry_type_container">x</span>
11870
11871 <span class="entry_type_array">
11872 n x m x 3
11873 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11874 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11875 <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]11876
11877
11878 </td> <!-- entry_type -->
11879
11880 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11881 <p>A 3-channel sharpness map,<wbr/> based on the raw
11882sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11883 </td>
11884
11885 <td class="entry_units">
11886 </td>
11887
11888 <td class="entry_range">
11889 </td>
11890
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11891 <td class="entry_tags">
11892 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11893 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11894 </ul>
11895 </td>
11896
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11897 </tr>
11898 <tr class="entries_header">
11899 <th class="th_details" colspan="5">Details</th>
11900 </tr>
11901 <tr class="entry_cont">
11902 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11903 <p>If only a monochrome sharpness map is supported,<wbr/>
11904all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11905 </td>
11906 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11907
11908
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11909 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11910 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11911
11912
11913 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11914 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11915 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11916 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11917 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11918 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11919
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11920 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11921
11922 <ul class="entry_type_enum">
11923 <li>
11924 <span class="entry_type_enum_name">OFF</span>
11925 </li>
11926 <li>
11927 <span class="entry_type_enum_name">ON</span>
11928 </li>
11929 </ul>
11930
11931 </td> <!-- entry_type -->
11932
11933 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11934 <p>Operating mode for sharpness map
11935generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11936 </td>
11937
11938 <td class="entry_units">
11939 </td>
11940
11941 <td class="entry_range">
11942 </td>
11943
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11944 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11945 <ul class="entry_tags">
11946 <li><a href="#tag_V1">V1</a></li>
11947 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11948 </td>
11949
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11950 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11951
11952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11953 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11954 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11955
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11956
11957 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11958 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11959 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11960 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11961 <td class="entry_type">
11962 <span class="entry_type_name">float</span>
11963 <span class="entry_type_container">x</span>
11964
11965 <span class="entry_type_array">
11966 4 x n x m
11967 </span>
11968 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11969 <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]11970
11971
11972 </td> <!-- entry_type -->
11973
11974 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11975 <p>The shading map is a low-resolution floating-point map
11976that lists the coefficients used to correct for vignetting,<wbr/> for each
11977Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11978 </td>
11979
11980 <td class="entry_units">
11981 </td>
11982
11983 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11984 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11985 </td>
11986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11987 <td class="entry_tags">
11988 </td>
11989
11990 </tr>
11991 <tr class="entries_header">
11992 <th class="th_details" colspan="5">Details</th>
11993 </tr>
11994 <tr class="entry_cont">
11995 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11996 <p>The least shaded section of the image should have a gain factor
11997of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11998<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]11999must take into account the colorCorrection settings.<wbr/></p>
12000<p>The shading map is for the entire active pixel array,<wbr/> and is not
12001affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]12002entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12003pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
12004map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
12005(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
12006pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
12007The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
12008<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
12009channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
12010The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12011is 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]12012<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
12013and must be smaller than 64x64.<wbr/></p>
12014<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12015<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
12016<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]12017[ 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/>
12018 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/>
12019 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/>
12020 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/>
12021 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/>
12022 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]12023</code></pre>
12024<p>The low-resolution scaling map images for each channel are
12025(displayed using nearest-neighbor interpolation):</p>
12026<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
12027<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
12028<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
12029<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]12030<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]12031image 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]12032<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]12033 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12034 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12035
12036
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12037 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12038 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12039
12040
12041 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12042 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12043 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12044 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12045 <td class="entry_type">
12046 <span class="entry_type_name">float</span>
12047 <span class="entry_type_container">x</span>
12048
12049 <span class="entry_type_array">
12050 4
12051 </span>
12052 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12053 <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]12054
12055
12056 </td> <!-- entry_type -->
12057
12058 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12059 <p>The best-fit color channel gains calculated
12060by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12061 </td>
12062
12063 <td class="entry_units">
12064 </td>
12065
12066 <td class="entry_range">
12067 </td>
12068
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12069 <td class="entry_tags">
12070 </td>
12071
12072 </tr>
12073 <tr class="entries_header">
12074 <th class="th_details" colspan="5">Details</th>
12075 </tr>
12076 <tr class="entry_cont">
12077 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12078 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12079since statistics processing on data from a new frame
12080typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12081applied to that frame.<wbr/></p>
12082<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12083see <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]12084<p>This value should always be calculated by the AWB block,<wbr/>
12085regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12086 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12087 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12088
12089
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12090 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12091 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12092
12093
12094 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12095 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12096 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12097 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12098 <td class="entry_type">
12099 <span class="entry_type_name">rational</span>
12100 <span class="entry_type_container">x</span>
12101
12102 <span class="entry_type_array">
12103 3 x 3
12104 </span>
12105 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12106 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12107
12108
12109 </td> <!-- entry_type -->
12110
12111 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12112 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12113calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12114output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12115 </td>
12116
12117 <td class="entry_units">
12118 </td>
12119
12120 <td class="entry_range">
12121 </td>
12122
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12123 <td class="entry_tags">
12124 </td>
12125
12126 </tr>
12127 <tr class="entries_header">
12128 <th class="th_details" colspan="5">Details</th>
12129 </tr>
12130 <tr class="entry_cont">
12131 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12132 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12133statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12134for the next frame.<wbr/> These are the values the HAL believes
12135are the best fit for the current output frame.<wbr/> This may
12136be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12137statistics processing on data from a new frame typically
12138completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12139that frame.<wbr/></p>
12140<p>These estimates must be provided for all frames,<wbr/> even if
12141capture settings and color transforms are set by the application.<wbr/></p>
12142<p>This value should always be calculated by the AWB block,<wbr/>
12143regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12144 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12145 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12146
12147
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12148 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12149 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12150
12151
12152 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12153 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12154 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12155 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12156 <td class="entry_type">
12157 <span class="entry_type_name entry_type_name_enum">byte</span>
12158
12159 <span class="entry_type_visibility"> [public]</span>
12160
12161 <ul class="entry_type_enum">
12162 <li>
12163 <span class="entry_type_enum_name">NONE</span>
12164 </li>
12165 <li>
12166 <span class="entry_type_enum_name">50HZ</span>
12167 </li>
12168 <li>
12169 <span class="entry_type_enum_name">60HZ</span>
12170 </li>
12171 </ul>
12172
12173 </td> <!-- entry_type -->
12174
12175 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12176 <p>The HAL estimated scene illumination lighting
12177frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12178 </td>
12179
12180 <td class="entry_units">
12181 </td>
12182
12183 <td class="entry_range">
12184 </td>
12185
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12186 <td class="entry_tags">
12187 </td>
12188
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12189 </tr>
12190 <tr class="entries_header">
12191 <th class="th_details" colspan="5">Details</th>
12192 </tr>
12193 <tr class="entry_cont">
12194 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12195 <p>Report NONE if there doesn't appear to be flickering
12196illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12197 </td>
12198 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12199
12200
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12201 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12202 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12203
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12204
12205
12206 <!-- end of kind -->
12207 </tbody>
12208
12209 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12210 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12211
12212
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12213 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12214
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12215 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12216 <tr>
12217 <th class="th_name">Property Name</th>
12218 <th class="th_type">Type</th>
12219 <th class="th_description">Description</th>
12220 <th class="th_units">Units</th>
12221 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12222 <th class="th_tags">Tags</th>
12223 </tr>
12224 </thead>
12225
12226 <tbody>
12227
12228
12229
12230
12231
12232
12233
12234
12235
12236
12237 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12238 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12239 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12240 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12241 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12242 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12243 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12244
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12245 <span class="entry_type_array">
12246 n x 2
12247 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12248 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12249 <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]12250
12251
12252 </td> <!-- entry_type -->
12253
12254 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12255 <p>Table mapping blue input values to output
12256values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12257 </td>
12258
12259 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12260 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12261 </td>
12262
12263 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12264 <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]12265 </td>
12266
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12267 <td class="entry_tags">
12268 </td>
12269
12270 </tr>
12271 <tr class="entries_header">
12272 <th class="th_details" colspan="5">Details</th>
12273 </tr>
12274 <tr class="entry_cont">
12275 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12276 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12277channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12278<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]12279 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12280 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12281
12282
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12283 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12284 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12285
12286
12287 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12288 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12289 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12290 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12291 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12292 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12293 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12294
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12295 <span class="entry_type_array">
12296 n x 2
12297 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12298 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12299 <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]12300
12301
12302 </td> <!-- entry_type -->
12303
12304 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12305 <p>Table mapping green input values to output
12306values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12307 </td>
12308
12309 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12310 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12311 </td>
12312
12313 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12314 <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]12315 </td>
12316
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12317 <td class="entry_tags">
12318 </td>
12319
12320 </tr>
12321 <tr class="entries_header">
12322 <th class="th_details" colspan="5">Details</th>
12323 </tr>
12324 <tr class="entry_cont">
12325 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12326 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12327channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12328<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]12329 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12330 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12331
12332
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12333 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12334 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12335
12336
12337 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12338 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12339 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12340 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12341 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12342 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12343 <span class="entry_type_container">x</span>
12344
12345 <span class="entry_type_array">
12346 n x 2
12347 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12348 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12349 <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]12350
12351
12352 </td> <!-- entry_type -->
12353
12354 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12355 <p>Table mapping red input values to output
12356values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12357 </td>
12358
12359 <td class="entry_units">
12360 </td>
12361
12362 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12363 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12364 </td>
12365
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12366 <td class="entry_tags">
12367 <ul class="entry_tags">
12368 <li><a href="#tag_DNG">DNG</a></li>
12369 </ul>
12370 </td>
12371
12372 </tr>
12373 <tr class="entries_header">
12374 <th class="th_details" colspan="5">Details</th>
12375 </tr>
12376 <tr class="entry_cont">
12377 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12378 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12379channel,<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]12380<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12381the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12382are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12383between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12384<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12385defined points.<wbr/> The points will be listed in increasing
12386order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
123870.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12388for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
123890.<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]12390 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12391 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12392
12393
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12394 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12395 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12396
12397
12398 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12399 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12400 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12401 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12402 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12403 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12404
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12405 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12406
12407 <ul class="entry_type_enum">
12408 <li>
12409 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12410 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12411 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12412 </li>
12413 <li>
12414 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12415 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12416 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12417 </li>
12418 <li>
12419 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12420 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12421 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12422 </li>
12423 </ul>
12424
12425 </td> <!-- entry_type -->
12426
12427 <td class="entry_description">
12428 </td>
12429
12430 <td class="entry_units">
12431 </td>
12432
12433 <td class="entry_range">
12434 </td>
12435
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12436 <td class="entry_tags">
12437 </td>
12438
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12439 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12440
12441
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12442 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12443 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12444
12445
12446
12447 <!-- end of kind -->
12448 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12449 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12450
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12451 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12452 <tr>
12453 <th class="th_name">Property Name</th>
12454 <th class="th_type">Type</th>
12455 <th class="th_description">Description</th>
12456 <th class="th_units">Units</th>
12457 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12458 <th class="th_tags">Tags</th>
12459 </tr>
12460 </thead>
12461
12462 <tbody>
12463
12464
12465
12466
12467
12468
12469
12470
12471
12472
12473 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12474 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12475 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12476 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12477 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12478 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12479
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12480 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12481
12482
12483 </td> <!-- entry_type -->
12484
12485 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12486 <p>Maximum number of supported points in the
12487tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12488 </td>
12489
12490 <td class="entry_units">
12491 </td>
12492
12493 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]12494 <p>&gt;= 128</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12495 </td>
12496
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12497 <td class="entry_tags">
12498 </td>
12499
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12500 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12501
12502
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12503 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12504 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12505
12506
12507
12508 <!-- end of kind -->
12509 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12510 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12511
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12512 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12513 <tr>
12514 <th class="th_name">Property Name</th>
12515 <th class="th_type">Type</th>
12516 <th class="th_description">Description</th>
12517 <th class="th_units">Units</th>
12518 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12519 <th class="th_tags">Tags</th>
12520 </tr>
12521 </thead>
12522
12523 <tbody>
12524
12525
12526
12527
12528
12529
12530
12531
12532
12533
12534 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12535 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12536 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12537 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12538 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12539 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12540 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12541
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12542 <span class="entry_type_array">
12543 n x 2
12544 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12545 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12546 <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]12547
12548
12549 </td> <!-- entry_type -->
12550
12551 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12552 <p>Table mapping blue input values to output
12553values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12554 </td>
12555
12556 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12557 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12558 </td>
12559
12560 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12561 <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]12562 </td>
12563
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12564 <td class="entry_tags">
12565 </td>
12566
12567 </tr>
12568 <tr class="entries_header">
12569 <th class="th_details" colspan="5">Details</th>
12570 </tr>
12571 <tr class="entry_cont">
12572 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12573 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12574channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12575<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]12576 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12577 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12578
12579
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12580 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12581 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12582
12583
12584 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12585 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12586 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12587 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12588 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12589 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12590 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12591
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12592 <span class="entry_type_array">
12593 n x 2
12594 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12595 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12596 <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]12597
12598
12599 </td> <!-- entry_type -->
12600
12601 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12602 <p>Table mapping green input values to output
12603values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12604 </td>
12605
12606 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12607 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12608 </td>
12609
12610 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12611 <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]12612 </td>
12613
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12614 <td class="entry_tags">
12615 </td>
12616
12617 </tr>
12618 <tr class="entries_header">
12619 <th class="th_details" colspan="5">Details</th>
12620 </tr>
12621 <tr class="entry_cont">
12622 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12623 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12624channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12625<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]12626 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12627 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12628
12629
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12630 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12631 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12632
12633
12634 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12635 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12636 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12637 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12638 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12639 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12640 <span class="entry_type_container">x</span>
12641
12642 <span class="entry_type_array">
12643 n x 2
12644 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12645 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12646 <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]12647
12648
12649 </td> <!-- entry_type -->
12650
12651 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12652 <p>Table mapping red input values to output
12653values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12654 </td>
12655
12656 <td class="entry_units">
12657 </td>
12658
12659 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12660 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12661 </td>
12662
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12663 <td class="entry_tags">
12664 <ul class="entry_tags">
12665 <li><a href="#tag_DNG">DNG</a></li>
12666 </ul>
12667 </td>
12668
12669 </tr>
12670 <tr class="entries_header">
12671 <th class="th_details" colspan="5">Details</th>
12672 </tr>
12673 <tr class="entry_cont">
12674 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12675 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12676channel,<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]12677<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12678the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12679are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12680between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12681<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12682defined points.<wbr/> The points will be listed in increasing
12683order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
126840.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12685for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
126860.<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]12687 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12688 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12689
12690
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12691 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12692 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12693
12694
12695 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12696 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12697 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12698 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12699 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12700 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12701
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12702 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12703
12704 <ul class="entry_type_enum">
12705 <li>
12706 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12707 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12708 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12709 </li>
12710 <li>
12711 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12712 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12713 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12714 </li>
12715 <li>
12716 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12717 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12718 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12719 </li>
12720 </ul>
12721
12722 </td> <!-- entry_type -->
12723
12724 <td class="entry_description">
12725 </td>
12726
12727 <td class="entry_units">
12728 </td>
12729
12730 <td class="entry_range">
12731 </td>
12732
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12733 <td class="entry_tags">
12734 </td>
12735
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12736 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12737
12738
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12739 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12740 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12741
12742
12743
12744 <!-- end of kind -->
12745 </tbody>
12746
12747 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12748 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12749
12750
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12751 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12752
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12753 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12754 <tr>
12755 <th class="th_name">Property Name</th>
12756 <th class="th_type">Type</th>
12757 <th class="th_description">Description</th>
12758 <th class="th_units">Units</th>
12759 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12760 <th class="th_tags">Tags</th>
12761 </tr>
12762 </thead>
12763
12764 <tbody>
12765
12766
12767
12768
12769
12770
12771
12772
12773
12774
12775 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12776 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12777 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12778 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12779 <td class="entry_type">
12780 <span class="entry_type_name entry_type_name_enum">byte</span>
12781
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12782 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12783
12784 <ul class="entry_type_enum">
12785 <li>
12786 <span class="entry_type_enum_name">OFF</span>
12787 </li>
12788 <li>
12789 <span class="entry_type_enum_name">ON</span>
12790 </li>
12791 </ul>
12792
12793 </td> <!-- entry_type -->
12794
12795 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12796 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12797that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12798Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12799disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12800any untrusted applications.<wbr/></p>
12801<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12802transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12803data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12804<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]12805doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12806 </td>
12807
12808 <td class="entry_units">
12809 </td>
12810
12811 <td class="entry_range">
12812 </td>
12813
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12814 <td class="entry_tags">
12815 </td>
12816
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12817 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12818
12819
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12820 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12821 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12822
12823
12824
12825 <!-- end of kind -->
12826 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12827 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12828
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12829 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12830 <tr>
12831 <th class="th_name">Property Name</th>
12832 <th class="th_type">Type</th>
12833 <th class="th_description">Description</th>
12834 <th class="th_units">Units</th>
12835 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12836 <th class="th_tags">Tags</th>
12837 </tr>
12838 </thead>
12839
12840 <tbody>
12841
12842
12843
12844
12845
12846
12847
12848
12849
12850
12851 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12852 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12853 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12854 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12855 <td class="entry_type">
12856 <span class="entry_type_name entry_type_name_enum">byte</span>
12857
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12858 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12859
12860 <ul class="entry_type_enum">
12861 <li>
12862 <span class="entry_type_enum_name">OFF</span>
12863 </li>
12864 <li>
12865 <span class="entry_type_enum_name">ON</span>
12866 </li>
12867 </ul>
12868
12869 </td> <!-- entry_type -->
12870
12871 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12872 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12873that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12874Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12875disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12876any untrusted applications.<wbr/></p>
12877<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12878transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12879data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12880<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]12881doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12882 </td>
12883
12884 <td class="entry_units">
12885 </td>
12886
12887 <td class="entry_range">
12888 </td>
12889
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12890 <td class="entry_tags">
12891 </td>
12892
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12893 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12894
12895
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12896 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12897 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12898
12899
12900
12901 <!-- end of kind -->
12902 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12903 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12904
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12905 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12906 <tr>
12907 <th class="th_name">Property Name</th>
12908 <th class="th_type">Type</th>
12909 <th class="th_description">Description</th>
12910 <th class="th_units">Units</th>
12911 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12912 <th class="th_tags">Tags</th>
12913 </tr>
12914 </thead>
12915
12916 <tbody>
12917
12918
12919
12920
12921
12922
12923
12924
12925
12926
12927 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12928 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12929 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12930 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12931 <td class="entry_type">
12932 <span class="entry_type_name entry_type_name_enum">byte</span>
12933 <span class="entry_type_container">x</span>
12934
12935 <span class="entry_type_array">
12936 n
12937 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12938 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12939
12940 <ul class="entry_type_enum">
12941 <li>
12942 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12943 <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]12944 </li>
12945 </ul>
12946
12947 </td> <!-- entry_type -->
12948
12949 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12950 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12951 </td>
12952
12953 <td class="entry_units">
12954 </td>
12955
12956 <td class="entry_range">
12957 </td>
12958
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12959 <td class="entry_tags">
12960 </td>
12961
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12962 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12963
12964
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12965 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12966 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12967
12968
12969
12970 <!-- end of kind -->
12971 </tbody>
12972
12973 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12974 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12975
12976
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12977 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12978
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12979 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12980 <tr>
12981 <th class="th_name">Property Name</th>
12982 <th class="th_type">Type</th>
12983 <th class="th_description">Description</th>
12984 <th class="th_units">Units</th>
12985 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12986 <th class="th_tags">Tags</th>
12987 </tr>
12988 </thead>
12989
12990 <tbody>
12991
12992
12993
12994
12995
12996
12997
12998
12999
13000
13001 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13002 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13003 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13004 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13005 <td class="entry_type">
13006 <span class="entry_type_name entry_type_name_enum">byte</span>
13007
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]13008 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13009
13010 <ul class="entry_type_enum">
13011 <li>
13012 <span class="entry_type_enum_name">LIMITED</span>
13013 </li>
13014 <li>
13015 <span class="entry_type_enum_name">FULL</span>
13016 </li>
13017 </ul>
13018
13019 </td> <!-- entry_type -->
13020
13021 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13022 <p>The camera 3 HAL device can implement one of two possible
13023operational modes; limited and full.<wbr/> Full support is
13024expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13025hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13026camera HAL device v1 implementation,<wbr/> and is expected from
13027older or inexpensive devices.<wbr/> Full is a strict superset of
13028limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
13029<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]13030 </td>
13031
13032 <td class="entry_units">
13033 </td>
13034
13035 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13036 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13037 </td>
13038
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13039 <td class="entry_tags">
13040 </td>
13041
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13042 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13043
13044
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13045 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13046 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]13047
13048
13049
13050 <!-- end of kind -->
13051 </tbody>
13052
13053 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13054 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13055
13056
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13057 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13058
13059 <thead class="entries_header">
13060 <tr>
13061 <th class="th_name">Property Name</th>
13062 <th class="th_type">Type</th>
13063 <th class="th_description">Description</th>
13064 <th class="th_units">Units</th>
13065 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13066 <th class="th_tags">Tags</th>
13067 </tr>
13068 </thead>
13069
13070 <tbody>
13071
13072
13073
13074
13075
13076
13077
13078
13079
13080
13081 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13082 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13083 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13084 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13085 <td class="entry_type">
13086 <span class="entry_type_name entry_type_name_enum">byte</span>
13087
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13088 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13089
13090 <ul class="entry_type_enum">
13091 <li>
13092 <span class="entry_type_enum_name">OFF</span>
13093 </li>
13094 <li>
13095 <span class="entry_type_enum_name">ON</span>
13096 </li>
13097 </ul>
13098
13099 </td> <!-- entry_type -->
13100
13101 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13102 <p>Whether black-level compensation is locked
13103to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13104 </td>
13105
13106 <td class="entry_units">
13107 </td>
13108
13109 <td class="entry_range">
13110 </td>
13111
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13112 <td class="entry_tags">
13113 <ul class="entry_tags">
13114 <li><a href="#tag_HAL2">HAL2</a></li>
13115 </ul>
13116 </td>
13117
13118 </tr>
13119 <tr class="entries_header">
13120 <th class="th_details" colspan="5">Details</th>
13121 </tr>
13122 <tr class="entry_cont">
13123 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13124 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13125compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13126OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13127<p>Since changes to certain capture parameters (such as
13128exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13129compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13130the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13131metadata.<wbr/></p>
13132<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13133<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13134<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13135<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13136<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13137<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13138<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13139<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13140</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13141<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13142device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13143result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13144<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13145<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
13146<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13147<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
13148<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
13149<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
13150<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]13151</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13152<p>This indicates to the application that on frame 4,<wbr/> black
13153levels were reset due to exposure value changes,<wbr/> and pixel
13154values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13155<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13156possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13157other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13158or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13159 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13160 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13161
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13162 <tr class="entries_header">
13163 <th class="th_details" colspan="5">HAL Implementation Details</th>
13164 </tr>
13165 <tr class="entry_cont">
13166 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13167 <p>If for some reason black level locking is no longer possible
13168(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13169black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13170override this request (and it must report 'OFF' when this
13171does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13172possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13173 </td>
13174 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13175
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13176 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13177 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13178
13179
13180
13181 <!-- end of kind -->
13182 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13183 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13184
13185 <thead class="entries_header">
13186 <tr>
13187 <th class="th_name">Property Name</th>
13188 <th class="th_type">Type</th>
13189 <th class="th_description">Description</th>
13190 <th class="th_units">Units</th>
13191 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13192 <th class="th_tags">Tags</th>
13193 </tr>
13194 </thead>
13195
13196 <tbody>
13197
13198
13199
13200
13201
13202
13203
13204
13205
13206
13207 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13208 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13209 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13210 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13211 <td class="entry_type">
13212 <span class="entry_type_name entry_type_name_enum">byte</span>
13213
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13214 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13215
13216 <ul class="entry_type_enum">
13217 <li>
13218 <span class="entry_type_enum_name">OFF</span>
13219 </li>
13220 <li>
13221 <span class="entry_type_enum_name">ON</span>
13222 </li>
13223 </ul>
13224
13225 </td> <!-- entry_type -->
13226
13227 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13228 <p>Whether black-level compensation is locked
13229to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13230 </td>
13231
13232 <td class="entry_units">
13233 </td>
13234
13235 <td class="entry_range">
13236 </td>
13237
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13238 <td class="entry_tags">
13239 <ul class="entry_tags">
13240 <li><a href="#tag_HAL2">HAL2</a></li>
13241 </ul>
13242 </td>
13243
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13244 </tr>
13245 <tr class="entries_header">
13246 <th class="th_details" colspan="5">Details</th>
13247 </tr>
13248 <tr class="entry_cont">
13249 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13250 <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]13251ON 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]13252a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13253perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13254 </td>
13255 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13256
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13257 <tr class="entries_header">
13258 <th class="th_details" colspan="5">HAL Implementation Details</th>
13259 </tr>
13260 <tr class="entry_cont">
13261 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13262 <p>If for some reason black level locking is no longer possible
13263(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13264black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13265override this request (and it must report 'OFF' when this
13266does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13267possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13268 </td>
13269 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13270
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13271 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13272 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13273
13274
13275
13276 <!-- end of kind -->
13277 </tbody>
13278
13279 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13280<!-- </namespace> -->
13281 </table>
13282
13283 <div class="tags" id="tag_index">
13284 <h2>Tags</h2>
13285 <ul>
13286 <li id="tag_AWB">AWB -
13287 Needed for auto white balance
13288
13289 <ul class="tags_entries">
13290 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13291 </ul>
13292 </li> <!-- tag_AWB -->
13293 <li id="tag_BC">BC -
13294 Needed for backwards compatibility with old Java API
13295
13296 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]13297 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13298 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
13299 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
13300 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
13301 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
13302 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13303 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13304 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
13305 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13306 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13307 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
13308 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13309 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
13310 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
13311 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
13312 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
13313 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
13314 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]13315 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13316 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
13317 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
13318 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
13319 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
13320 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
13321 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
13322 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
13323 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
13324 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
13325 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
13326 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
13327 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
13328 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
13329 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
13330 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
13331 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
13332 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
13333 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
13334 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
13335 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13336 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13337 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
13338 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
13339 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
13340 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
13341 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
13342 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
13343 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]13344 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13345 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
13346 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
13347 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13348 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13349 <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]13350 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13351 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13352 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13353 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
13354 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
13355 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
13356 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
13357 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
13358 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
13359 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
13360 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
13361 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
13362 </ul>
13363 </li> <!-- tag_BC -->
13364 <li id="tag_V1">V1 -
13365 New features for first camera 2 release (API1)
13366
13367 <ul class="tags_entries">
13368 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13369 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13370 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13371 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13372 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13373 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13374 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13375 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13376 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13377 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13378 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13379 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13380 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13381 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13382 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13383 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13384 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13385 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13386 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13387 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13388 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13389 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13390 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13391 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13392 <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]13393 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13394 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13395 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13396 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13397 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13398 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13399 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13400 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13401 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13402 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13403 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13404 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13405 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13406 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13407 </ul>
13408 </li> <!-- tag_V1 -->
13409 <li id="tag_ADV">ADV - None
13410 <ul class="tags_entries">
13411 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13412 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13413 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13414 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13415 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13416 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13417 </ul>
13418 </li> <!-- tag_ADV -->
13419 <li id="tag_DNG">DNG -
13420 Needed for DNG file support
13421
13422 <ul class="tags_entries">
13423 <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]13424 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13425 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13426 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13427 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13428 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13429 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13430 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13431 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13432 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13433 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13434 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13435 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13436 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13437 </ul>
13438 </li> <!-- tag_DNG -->
13439 <li id="tag_EXIF">EXIF - None
13440 <ul class="tags_entries">
13441 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13442 </ul>
13443 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13444 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13445 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13446
13447 <ul class="tags_entries">
13448 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13449 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13450 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13451 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13452 </ul>
13453 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13454 <li id="tag_FULL">FULL -
13455 Entry is required for full hardware level devices, and optional for other hardware levels
13456
13457 <ul class="tags_entries">
13458 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13459 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13460 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13461 </ul>
13462 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13463 </ul>
13464 </div>
13465
13466 [ <a href="#">top</a> ]
13467
13468</body>
13469</html>