Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / 52e095585b5aa6ea654b35612436a5a104f2900d / . / camera / docs / docs.html
blob: b0724eeae2a9d4501d6952186115ddb1fc563182 [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 }
31 .entries_header { background-color: #dddddd; text-align: center}
32
33 /* toc style */
34 .toc_section_header { font-size:1.3em; }
35 .toc_kind_header { font-size:1.2em; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]36
37 /* table column sizes */
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]38 table { border-collapse:collapse; table-layout: fixed; width: 100%; word-wrap: break-word }
39 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]40 .th_name { width: 20% }
41 .th_units { width: 10% }
42 .th_tags { width: 5% }
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]43 .th_notes { width: 25% }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]44 .th_type { width: 20% }
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]45 .th_description { width: 20% }
46 .th_range { width: 10% }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]47 td { font-size: 0.9em; }
48
49 /* hide the first thead, we need it there only to enforce column sizes */
50 .thead_dummy { visibility: hidden; }
51
52 /* Entry flair */
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]53 .entry_name { color: #333333; padding-left:1.0em; font-size:1.1em; font-family: monospace; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]54
55 /* Entry type flair */
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]56 .entry_type_name { font-size:1.1em; color: #669900; font-weight: bold;}
57 .entry_type_name_enum:after { color: #669900; font-weight: bold; content:" (enum)" }
58 .entry_type_visibility { font-weight: bolder; padding-left:1em}
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]59 .entry_type_enum_name { font-family: monospace; font-weight: bolder; }
60 .entry_type_enum_notes:before { content:" - " }
61 .entry_type_enum_value:before { content:" = " }
62 .entry_type_enum_value { font-family: monospace; }
63 .entry ul { margin: 0 0 0 0; list-style-position: inside; padding-left: 0.5em; }
64 .entry ul li { padding: 0 0 0 0; margin: 0 0 0 0;}
65
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]66 /* Entry visibility flair */
67
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]68 /* Entry tags flair */
69 .entry_tags ul { list-style-type: none; }
70
71
72 /* TODO: generate abbr element for each tag link? */
73 /* TODO for each x.y.z try to link it to the entry */
74
75 </style>
76
77 <style>
78
79 {
80 /* broken...
81 supposedly there is a bug in chrome that it lays out tables before
82 it knows its being printed, so the page-break-* styles are ignored
83 */
84 tr { page-break-after: always; page-break-inside: avoid; }
85 }
86
87 </style>
88</head>
89
90
91
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]92<body>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]93 <h1>Android Camera HAL3.0 Properties</h1>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]94
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]95
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]96 <h2>Table of Contents</h2>
97 <ul class="toc">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]98 <li><a href="#tag_index" class="toc_section_header">Tags</a></li>
99 <li>
100 <span class="toc_section_header"><a href="#section_colorCorrection">colorCorrection</a></span>
101 <ul class="toc_section">
102 <li>
103 <span class="toc_kind_header">controls</span>
104 <ul class="toc_section">
105 <li><a href="#controls_android.colorCorrection.mode">android.colorCorrection.mode</a></li>
106 <li><a href="#controls_android.colorCorrection.transform">android.colorCorrection.transform</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]107 <li><a href="#controls_android.colorCorrection.gains">android.colorCorrection.gains</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]108 </ul>
109 </li>
110 <li>
111 <span class="toc_kind_header">dynamic</span>
112 <ul class="toc_section">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]113 <li><a href="#dynamic_android.colorCorrection.transform">android.colorCorrection.transform</a></li>
114 <li><a href="#dynamic_android.colorCorrection.gains">android.colorCorrection.gains</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]115 </ul>
116 </li>
117 </ul> <!-- toc_section -->
118 </li>
119 <li>
120 <span class="toc_section_header"><a href="#section_control">control</a></span>
121 <ul class="toc_section">
122 <li>
123 <span class="toc_kind_header">controls</span>
124 <ul class="toc_section">
125 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a></li>
126 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a></li>
127 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a></li>
128 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a></li>
129 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a></li>
130 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a></li>
131 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a></li>
132 <li><a href="#controls_android.control.afMode">android.control.afMode</a></li>
133 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a></li>
134 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a></li>
135 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a></li>
136 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a></li>
137 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a></li>
138 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a></li>
139 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a></li>
140 <li><a href="#controls_android.control.mode">android.control.mode</a></li>
141 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a></li>
142 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a></li>
143 </ul>
144 </li>
145 <li>
146 <span class="toc_kind_header">static</span>
147 <ul class="toc_section">
148 <li><a href="#static_android.control.aeAvailableAntibandingModes">android.control.aeAvailableAntibandingModes</a></li>
149 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a></li>
150 <li><a href="#static_android.control.aeAvailableTargetFpsRanges">android.control.aeAvailableTargetFpsRanges</a></li>
151 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a></li>
152 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a></li>
153 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a></li>
154 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a></li>
155 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a></li>
156 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a></li>
157 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a></li>
158 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a></li>
159 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a></li>
160 </ul>
161 </li>
162 <li>
163 <span class="toc_kind_header">dynamic</span>
164 <ul class="toc_section">
165 <li><a href="#dynamic_android.control.aePrecaptureId">android.control.aePrecaptureId</a></li>
166 <li><a href="#dynamic_android.control.aeRegions">android.control.aeRegions</a></li>
167 <li><a href="#dynamic_android.control.aeState">android.control.aeState</a></li>
168 <li><a href="#dynamic_android.control.afMode">android.control.afMode</a></li>
169 <li><a href="#dynamic_android.control.afRegions">android.control.afRegions</a></li>
170 <li><a href="#dynamic_android.control.afState">android.control.afState</a></li>
171 <li><a href="#dynamic_android.control.afTriggerId">android.control.afTriggerId</a></li>
172 <li><a href="#dynamic_android.control.awbMode">android.control.awbMode</a></li>
173 <li><a href="#dynamic_android.control.awbRegions">android.control.awbRegions</a></li>
174 <li><a href="#dynamic_android.control.awbState">android.control.awbState</a></li>
175 <li><a href="#dynamic_android.control.mode">android.control.mode</a></li>
176 </ul>
177 </li>
178 </ul> <!-- toc_section -->
179 </li>
180 <li>
181 <span class="toc_section_header"><a href="#section_demosaic">demosaic</a></span>
182 <ul class="toc_section">
183 <li>
184 <span class="toc_kind_header">controls</span>
185 <ul class="toc_section">
186 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a></li>
187 </ul>
188 </li>
189 </ul> <!-- toc_section -->
190 </li>
191 <li>
192 <span class="toc_section_header"><a href="#section_edge">edge</a></span>
193 <ul class="toc_section">
194 <li>
195 <span class="toc_kind_header">controls</span>
196 <ul class="toc_section">
197 <li><a href="#controls_android.edge.mode">android.edge.mode</a></li>
198 <li><a href="#controls_android.edge.strength">android.edge.strength</a></li>
199 </ul>
200 </li>
201 <li>
202 <span class="toc_kind_header">dynamic</span>
203 <ul class="toc_section">
204 <li><a href="#dynamic_android.edge.mode">android.edge.mode</a></li>
205 </ul>
206 </li>
207 </ul> <!-- toc_section -->
208 </li>
209 <li>
210 <span class="toc_section_header"><a href="#section_flash">flash</a></span>
211 <ul class="toc_section">
212 <li>
213 <span class="toc_kind_header">controls</span>
214 <ul class="toc_section">
215 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a></li>
216 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a></li>
217 <li><a href="#controls_android.flash.mode">android.flash.mode</a></li>
218 </ul>
219 </li>
220 <li>
221 <span class="toc_kind_header">static</span>
222 <ul class="toc_section">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]223
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]224 <li><a href="#static_android.flash.info.available">android.flash.info.available</a></li>
225 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]226
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]227 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a></li>
228 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a></li>
229 </ul>
230 </li>
231 <li>
232 <span class="toc_kind_header">dynamic</span>
233 <ul class="toc_section">
234 <li><a href="#dynamic_android.flash.firingPower">android.flash.firingPower</a></li>
235 <li><a href="#dynamic_android.flash.firingTime">android.flash.firingTime</a></li>
236 <li><a href="#dynamic_android.flash.mode">android.flash.mode</a></li>
237 <li><a href="#dynamic_android.flash.state">android.flash.state</a></li>
238 </ul>
239 </li>
240 </ul> <!-- toc_section -->
241 </li>
242 <li>
243 <span class="toc_section_header"><a href="#section_geometric">geometric</a></span>
244 <ul class="toc_section">
245 <li>
246 <span class="toc_kind_header">controls</span>
247 <ul class="toc_section">
248 <li><a href="#controls_android.geometric.mode">android.geometric.mode</a></li>
249 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a></li>
250 </ul>
251 </li>
252 </ul> <!-- toc_section -->
253 </li>
254 <li>
255 <span class="toc_section_header"><a href="#section_hotPixel">hotPixel</a></span>
256 <ul class="toc_section">
257 <li>
258 <span class="toc_kind_header">controls</span>
259 <ul class="toc_section">
260 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a></li>
261 </ul>
262 </li>
263 <li>
264 <span class="toc_kind_header">static</span>
265 <ul class="toc_section">
266
267 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a></li>
268
269 </ul>
270 </li>
271 <li>
272 <span class="toc_kind_header">dynamic</span>
273 <ul class="toc_section">
274 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a></li>
275 </ul>
276 </li>
277 </ul> <!-- toc_section -->
278 </li>
279 <li>
280 <span class="toc_section_header"><a href="#section_jpeg">jpeg</a></span>
281 <ul class="toc_section">
282 <li>
283 <span class="toc_kind_header">controls</span>
284 <ul class="toc_section">
285 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
286 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
287 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
288 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a></li>
289 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a></li>
290 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
291 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
292 </ul>
293 </li>
294 <li>
295 <span class="toc_kind_header">static</span>
296 <ul class="toc_section">
297 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a></li>
298 <li><a href="#static_android.jpeg.maxSize">android.jpeg.maxSize</a></li>
299 </ul>
300 </li>
301 <li>
302 <span class="toc_kind_header">dynamic</span>
303 <ul class="toc_section">
304 <li><a href="#dynamic_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
305 <li><a href="#dynamic_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
306 <li><a href="#dynamic_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
307 <li><a href="#dynamic_android.jpeg.orientation">android.jpeg.orientation</a></li>
308 <li><a href="#dynamic_android.jpeg.quality">android.jpeg.quality</a></li>
309 <li><a href="#dynamic_android.jpeg.size">android.jpeg.size</a></li>
310 <li><a href="#dynamic_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
311 <li><a href="#dynamic_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
312 </ul>
313 </li>
314 </ul> <!-- toc_section -->
315 </li>
316 <li>
317 <span class="toc_section_header"><a href="#section_lens">lens</a></span>
318 <ul class="toc_section">
319 <li>
320 <span class="toc_kind_header">controls</span>
321 <ul class="toc_section">
322 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a></li>
323 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a></li>
324 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a></li>
325 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a></li>
326 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
327 </ul>
328 </li>
329 <li>
330 <span class="toc_kind_header">static</span>
331 <ul class="toc_section">
332
333 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a></li>
334 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a></li>
335 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a></li>
336 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a></li>
337 <li><a href="#static_android.lens.info.geometricCorrectionMap">android.lens.info.geometricCorrectionMap</a></li>
338 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a></li>
339 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a></li>
340 <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]341 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a></li>
342
343 <li><a href="#static_android.lens.facing">android.lens.facing</a></li>
344 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a></li>
345 <li><a href="#static_android.lens.position">android.lens.position</a></li>
346 </ul>
347 </li>
348 <li>
349 <span class="toc_kind_header">dynamic</span>
350 <ul class="toc_section">
351 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a></li>
352 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a></li>
353 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a></li>
354 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a></li>
355 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a></li>
356 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
357 <li><a href="#dynamic_android.lens.state">android.lens.state</a></li>
358 </ul>
359 </li>
360 </ul> <!-- toc_section -->
361 </li>
362 <li>
363 <span class="toc_section_header"><a href="#section_noiseReduction">noiseReduction</a></span>
364 <ul class="toc_section">
365 <li>
366 <span class="toc_kind_header">controls</span>
367 <ul class="toc_section">
368 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
369 <li><a href="#controls_android.noiseReduction.strength">android.noiseReduction.strength</a></li>
370 </ul>
371 </li>
372 <li>
373 <span class="toc_kind_header">dynamic</span>
374 <ul class="toc_section">
375 <li><a href="#dynamic_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
376 </ul>
377 </li>
378 </ul> <!-- toc_section -->
379 </li>
380 <li>
381 <span class="toc_section_header"><a href="#section_quirks">quirks</a></span>
382 <ul class="toc_section">
383 <li>
384 <span class="toc_kind_header">static</span>
385 <ul class="toc_section">
386 <li><a href="#static_android.quirks.meteringCropRegion">android.quirks.meteringCropRegion</a></li>
387 <li><a href="#static_android.quirks.triggerAfWithAuto">android.quirks.triggerAfWithAuto</a></li>
388 <li><a href="#static_android.quirks.useZslFormat">android.quirks.useZslFormat</a></li>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]389 <li><a href="#static_android.quirks.usePartialResult">android.quirks.usePartialResult</a></li>
390 </ul>
391 </li>
392 <li>
393 <span class="toc_kind_header">dynamic</span>
394 <ul class="toc_section">
395 <li><a href="#dynamic_android.quirks.partialResult">android.quirks.partialResult</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]396 </ul>
397 </li>
398 </ul> <!-- toc_section -->
399 </li>
400 <li>
401 <span class="toc_section_header"><a href="#section_request">request</a></span>
402 <ul class="toc_section">
403 <li>
404 <span class="toc_kind_header">controls</span>
405 <ul class="toc_section">
406 <li><a href="#controls_android.request.frameCount">android.request.frameCount</a></li>
407 <li><a href="#controls_android.request.id">android.request.id</a></li>
408 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a></li>
409 <li><a href="#controls_android.request.metadataMode">android.request.metadataMode</a></li>
410 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a></li>
411 <li><a href="#controls_android.request.type">android.request.type</a></li>
412 </ul>
413 </li>
414 <li>
415 <span class="toc_kind_header">static</span>
416 <ul class="toc_section">
417 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a></li>
418 <li><a href="#static_android.request.maxNumReprocessStreams">android.request.maxNumReprocessStreams</a></li>
419 </ul>
420 </li>
421 <li>
422 <span class="toc_kind_header">dynamic</span>
423 <ul class="toc_section">
424 <li><a href="#dynamic_android.request.frameCount">android.request.frameCount</a></li>
425 <li><a href="#dynamic_android.request.id">android.request.id</a></li>
426 <li><a href="#dynamic_android.request.metadataMode">android.request.metadataMode</a></li>
427 <li><a href="#dynamic_android.request.outputStreams">android.request.outputStreams</a></li>
428 </ul>
429 </li>
430 </ul> <!-- toc_section -->
431 </li>
432 <li>
433 <span class="toc_section_header"><a href="#section_scaler">scaler</a></span>
434 <ul class="toc_section">
435 <li>
436 <span class="toc_kind_header">controls</span>
437 <ul class="toc_section">
438 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
439 </ul>
440 </li>
441 <li>
442 <span class="toc_kind_header">static</span>
443 <ul class="toc_section">
444 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a></li>
445 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a></li>
446 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a></li>
447 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a></li>
448 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a></li>
449 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a></li>
450 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a></li>
451 <li><a href="#static_android.scaler.availableRawSizes">android.scaler.availableRawSizes</a></li>
452 </ul>
453 </li>
454 <li>
455 <span class="toc_kind_header">dynamic</span>
456 <ul class="toc_section">
457 <li><a href="#dynamic_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
458 </ul>
459 </li>
460 </ul> <!-- toc_section -->
461 </li>
462 <li>
463 <span class="toc_section_header"><a href="#section_sensor">sensor</a></span>
464 <ul class="toc_section">
465 <li>
466 <span class="toc_kind_header">controls</span>
467 <ul class="toc_section">
468 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
469 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
470 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
471 </ul>
472 </li>
473 <li>
474 <span class="toc_kind_header">static</span>
475 <ul class="toc_section">
476
477 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]478 <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]479 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a></li>
480 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a></li>
481 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a></li>
482 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a></li>
483 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a></li>
484 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a></li>
485
486 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a></li>
487 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a></li>
488 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a></li>
489 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a></li>
490 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a></li>
491 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a></li>
492 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a></li>
493 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a></li>
494 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a></li>
495 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a></li>
496 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a></li>
497 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a></li>
498 <li><a href="#static_android.sensor.referenceIlluminant2">android.sensor.referenceIlluminant2</a></li>
499 </ul>
500 </li>
501 <li>
502 <span class="toc_kind_header">dynamic</span>
503 <ul class="toc_section">
504 <li><a href="#dynamic_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
505 <li><a href="#dynamic_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
506 <li><a href="#dynamic_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
507 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a></li>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]508 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]509 </ul>
510 </li>
511 </ul> <!-- toc_section -->
512 </li>
513 <li>
514 <span class="toc_section_header"><a href="#section_shading">shading</a></span>
515 <ul class="toc_section">
516 <li>
517 <span class="toc_kind_header">controls</span>
518 <ul class="toc_section">
519 <li><a href="#controls_android.shading.mode">android.shading.mode</a></li>
520 <li><a href="#controls_android.shading.strength">android.shading.strength</a></li>
521 </ul>
522 </li>
523 <li>
524 <span class="toc_kind_header">dynamic</span>
525 <ul class="toc_section">
526 <li><a href="#dynamic_android.shading.mode">android.shading.mode</a></li>
527 </ul>
528 </li>
529 </ul> <!-- toc_section -->
530 </li>
531 <li>
532 <span class="toc_section_header"><a href="#section_statistics">statistics</a></span>
533 <ul class="toc_section">
534 <li>
535 <span class="toc_kind_header">controls</span>
536 <ul class="toc_section">
537 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
538 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
539 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]540 <li><a href="#controls_android.statistics.lensShadingMapMode">android.statistics.lensShadingMapMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]541 </ul>
542 </li>
543 <li>
544 <span class="toc_kind_header">static</span>
545 <ul class="toc_section">
546
547 <li><a href="#static_android.statistics.info.availableFaceDetectModes">android.statistics.info.availableFaceDetectModes</a></li>
548 <li><a href="#static_android.statistics.info.histogramBucketCount">android.statistics.info.histogramBucketCount</a></li>
549 <li><a href="#static_android.statistics.info.maxFaceCount">android.statistics.info.maxFaceCount</a></li>
550 <li><a href="#static_android.statistics.info.maxHistogramCount">android.statistics.info.maxHistogramCount</a></li>
551 <li><a href="#static_android.statistics.info.maxSharpnessMapValue">android.statistics.info.maxSharpnessMapValue</a></li>
552 <li><a href="#static_android.statistics.info.sharpnessMapSize">android.statistics.info.sharpnessMapSize</a></li>
553
554 </ul>
555 </li>
556 <li>
557 <span class="toc_kind_header">dynamic</span>
558 <ul class="toc_section">
559 <li><a href="#dynamic_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
560 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a></li>
561 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a></li>
562 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a></li>
563 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a></li>
564 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a></li>
565 <li><a href="#dynamic_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
566 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a></li>
567 <li><a href="#dynamic_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]568 <li><a href="#dynamic_android.statistics.lensShadingMap">android.statistics.lensShadingMap</a></li>
569 <li><a href="#dynamic_android.statistics.predictedColorGains">android.statistics.predictedColorGains</a></li>
570 <li><a href="#dynamic_android.statistics.predictedColorTransform">android.statistics.predictedColorTransform</a></li>
571 <li><a href="#dynamic_android.statistics.sceneFlicker">android.statistics.sceneFlicker</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]572 </ul>
573 </li>
574 </ul> <!-- toc_section -->
575 </li>
576 <li>
577 <span class="toc_section_header"><a href="#section_tonemap">tonemap</a></span>
578 <ul class="toc_section">
579 <li>
580 <span class="toc_kind_header">controls</span>
581 <ul class="toc_section">
582 <li><a href="#controls_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
583 <li><a href="#controls_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
584 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
585 <li><a href="#controls_android.tonemap.mode">android.tonemap.mode</a></li>
586 </ul>
587 </li>
588 <li>
589 <span class="toc_kind_header">static</span>
590 <ul class="toc_section">
591 <li><a href="#static_android.tonemap.maxCurvePoints">android.tonemap.maxCurvePoints</a></li>
592 </ul>
593 </li>
594 <li>
595 <span class="toc_kind_header">dynamic</span>
596 <ul class="toc_section">
597 <li><a href="#dynamic_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
598 <li><a href="#dynamic_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
599 <li><a href="#dynamic_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
600 <li><a href="#dynamic_android.tonemap.mode">android.tonemap.mode</a></li>
601 </ul>
602 </li>
603 </ul> <!-- toc_section -->
604 </li>
605 <li>
606 <span class="toc_section_header"><a href="#section_led">led</a></span>
607 <ul class="toc_section">
608 <li>
609 <span class="toc_kind_header">controls</span>
610 <ul class="toc_section">
611 <li><a href="#controls_android.led.transmit">android.led.transmit</a></li>
612 </ul>
613 </li>
614 <li>
615 <span class="toc_kind_header">dynamic</span>
616 <ul class="toc_section">
617 <li><a href="#dynamic_android.led.transmit">android.led.transmit</a></li>
618 </ul>
619 </li>
620 <li>
621 <span class="toc_kind_header">static</span>
622 <ul class="toc_section">
623 <li><a href="#static_android.led.availableLeds">android.led.availableLeds</a></li>
624 </ul>
625 </li>
626 </ul> <!-- toc_section -->
627 </li>
628 <li>
629 <span class="toc_section_header"><a href="#section_info">info</a></span>
630 <ul class="toc_section">
631 <li>
632 <span class="toc_kind_header">static</span>
633 <ul class="toc_section">
634 <li><a href="#static_android.info.supportedHardwareLevel">android.info.supportedHardwareLevel</a></li>
635 </ul>
636 </li>
637 </ul> <!-- toc_section -->
638 </li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]639 <li>
640 <span class="toc_section_header"><a href="#section_blackLevel">blackLevel</a></span>
641 <ul class="toc_section">
642 <li>
643 <span class="toc_kind_header">controls</span>
644 <ul class="toc_section">
645 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a></li>
646 </ul>
647 </li>
648 <li>
649 <span class="toc_kind_header">dynamic</span>
650 <ul class="toc_section">
651 <li><a href="#dynamic_android.blackLevel.lock">android.blackLevel.lock</a></li>
652 </ul>
653 </li>
654 </ul> <!-- toc_section -->
655 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]656 </ul>
657
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]658
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]659 <h1>Properties</h1>
660 <table class="properties">
661
662 <thead class="thead_dummy">
663 <tr>
664 <th class="th_name">Property Name</th>
665 <th class="th_type">Type</th>
666 <th class="th_description">Description</th>
667 <th class="th_units">Units</th>
668 <th class="th_range">Range</th>
669 <th class="th_notes">Notes</th>
670 <th class="th_tags">Tags</th>
671 </tr>
672 </thead> <!-- so that the first occurrence of thead is not
673 above the first occurrence of tr -->
674<!-- <namespace name="android"> -->
675 <tr><td colspan="7" id="section_colorCorrection" class="section">colorCorrection</td></tr>
676
677
678 <tr><td colspan="7" class="kind">controls</td></tr>
679
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]680 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]681 <tr>
682 <th class="th_name">Property Name</th>
683 <th class="th_type">Type</th>
684 <th class="th_description">Description</th>
685 <th class="th_units">Units</th>
686 <th class="th_range">Range</th>
687 <th class="th_notes">Notes</th>
688 <th class="th_tags">Tags</th>
689 </tr>
690 </thead>
691
692 <tbody>
693
694
695
696
697
698
699
700
701
702
703 <tr class="entry" id="controls_android.colorCorrection.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]704 <td class="entry_name"><html><body><p>android.colorCorrection.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]705 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]706 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]707
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]708 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]709
710 <ul class="entry_type_enum">
711 <li>
712 <span class="entry_type_enum_name">TRANSFORM_MATRIX</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]713 <span class="entry_type_enum_notes"><html><body><p>Use the android.colorCorrection.transform matrix
714 and android.colorCorrection.gains to do color conversion<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]715 </li>
716 <li>
717 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]718 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
719 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]720 </li>
721 <li>
722 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]723 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
724 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]725 </li>
726 </ul>
727
728 </td> <!-- entry_type -->
729
730 <td class="entry_description">
731 </td>
732
733 <td class="entry_units">
734 </td>
735
736 <td class="entry_range">
737 </td>
738
739 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]740 <html><body><p>When android.control.awbMode is not OFF, TRANSFORM_MATRIX
741should be ignored.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]742 </td>
743
744 <td class="entry_tags">
745 </td>
746
747 </tr> <!-- end of entry -->
748
749
750 <tr class="entry" id="controls_android.colorCorrection.transform">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]751 <td class="entry_name"><html><body><p>android.colorCorrection.transform<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]752 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]753 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]754 <span class="entry_type_container">x</span>
755
756 <span class="entry_type_array">
757 3 x 3
758 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]759 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]760 <div class="entry_type_notes"><html><body><p>3x3 rational matrix in row-major order<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]761
762
763 </td> <!-- entry_type -->
764
765 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]766 <html><body><p>A color transform matrix to use to transform
767from sensor RGB color space to output linear sRGB color space<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]768 </td>
769
770 <td class="entry_units">
771 </td>
772
773 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]774 <html><body><p>Output values are expected to be in the range
775 (0,1)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]776 </td>
777
778 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]779 <html><body><p>This matrix is either set by HAL when the request
780android.colorCorrection.mode is not TRANSFORM_MATRIX, or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]781directly by the application in the request when the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]782android.colorCorrection.mode is TRANSFORM_MATRIX.</p>
783<p>In the latter case, the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]784for precision issues; the final rounded matrix should be
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]785reported back in this matrix result metadata.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]786 </td>
787
788 <td class="entry_tags">
789 </td>
790
791 </tr> <!-- end of entry -->
792
793
794 <tr class="entry" id="controls_android.colorCorrection.gains">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]795 <td class="entry_name"><html><body><p>android.colorCorrection.gains<wbr></wbr></p></body></html></td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]796 <td class="entry_type">
797 <span class="entry_type_name">float</span>
798 <span class="entry_type_container">x</span>
799
800 <span class="entry_type_array">
801 4
802 </span>
803 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]804 <div class="entry_type_notes"><html><body><p>A 1D array of floats for 4 color channel gains<wbr></wbr></p></body></html></div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]805
806
807 </td> <!-- entry_type -->
808
809 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]810 <html><body><p>Gains applying to Bayer color channels for
811white-balance<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]812 </td>
813
814 <td class="entry_units">
815 </td>
816
817 <td class="entry_range">
818 </td>
819
820 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]821 <html><body><p>The 4-channel white-balance gains are defined in
822the order of [R G_even G_odd B], where G_even is the gain
823for green pixels on even rows of the output, and G_odd
824is the gain for greenpixels on the odd rows. if a HAL
825does not support a separate gain for even/odd green channels,
826it should use the G_even value,and write G_odd equal to
827G_even in the output result metadata.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]828<p>This array is either set by HAL when the request
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]829android.colorCorrection.mode is not TRANSFORM_MATRIX, or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]830directly by the application in the request when the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]831android.colorCorrection.mode is TRANSFORM_MATRIX.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]832<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]833the current frame.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]834 </td>
835
836 <td class="entry_tags">
837 </td>
838
839 </tr> <!-- end of entry -->
840
841
842
843 <!-- end of kind -->
844 </tbody>
845 <tr><td colspan="7" class="kind">dynamic</td></tr>
846
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]847 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]848 <tr>
849 <th class="th_name">Property Name</th>
850 <th class="th_type">Type</th>
851 <th class="th_description">Description</th>
852 <th class="th_units">Units</th>
853 <th class="th_range">Range</th>
854 <th class="th_notes">Notes</th>
855 <th class="th_tags">Tags</th>
856 </tr>
857 </thead>
858
859 <tbody>
860
861
862
863
864
865
866
867
868
869
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]870 <tr class="entry" id="dynamic_android.colorCorrection.transform">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]871 <td class="entry_name"><html><body><p>android.colorCorrection.transform<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]872 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]873 <span class="entry_type_name">rational</span>
874 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]875
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]876 <span class="entry_type_array">
877 3 x 3
878 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]879 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]880 <div class="entry_type_notes"><html><body><p>3x3 rational matrix in row-major order<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]881
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]882
883 </td> <!-- entry_type -->
884
885 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]886 <html><body><p>A color transform matrix to use to transform
887from sensor RGB color space to output linear sRGB color space<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]888 </td>
889
890 <td class="entry_units">
891 </td>
892
893 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]894 <html><body><p>Output values are expected to be in the range
895 (0,1)<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]896 </td>
897
898 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]899 <html><body><p>This matrix is either set by HAL when the request
900android.colorCorrection.mode is not TRANSFORM_MATRIX, or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]901directly by the application in the request when the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]902android.colorCorrection.mode is TRANSFORM_MATRIX.</p>
903<p>In the latter case, the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]904for precision issues; the final rounded matrix should be
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]905reported back in this matrix result metadata.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]906 </td>
907
908 <td class="entry_tags">
909 </td>
910
911 </tr> <!-- end of entry -->
912
913
914 <tr class="entry" id="dynamic_android.colorCorrection.gains">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]915 <td class="entry_name"><html><body><p>android.colorCorrection.gains<wbr></wbr></p></body></html></td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]916 <td class="entry_type">
917 <span class="entry_type_name">float</span>
918 <span class="entry_type_container">x</span>
919
920 <span class="entry_type_array">
921 4
922 </span>
923 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]924 <div class="entry_type_notes"><html><body><p>A 1D array of floats for 4 color channel gains<wbr></wbr></p></body></html></div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]925
926
927 </td> <!-- entry_type -->
928
929 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]930 <html><body><p>Gains applying to Bayer color channels for
931white-balance<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]932 </td>
933
934 <td class="entry_units">
935 </td>
936
937 <td class="entry_range">
938 </td>
939
940 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]941 <html><body><p>The 4-channel white-balance gains are defined in
942the order of [R G_even G_odd B], where G_even is the gain
943for green pixels on even rows of the output, and G_odd
944is the gain for greenpixels on the odd rows. if a HAL
945does not support a separate gain for even/odd green channels,
946it should use the G_even value,and write G_odd equal to
947G_even in the output result metadata.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]948<p>This array is either set by HAL when the request
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]949android.colorCorrection.mode is not TRANSFORM_MATRIX, or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]950directly by the application in the request when the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]951android.colorCorrection.mode is TRANSFORM_MATRIX.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]952<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]953the current frame.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]954 </td>
955
956 <td class="entry_tags">
957 </td>
958
959 </tr> <!-- end of entry -->
960
961
962
963 <!-- end of kind -->
964 </tbody>
965
966 <!-- end of section -->
967 <tr><td colspan="7" id="section_control" class="section">control</td></tr>
968
969
970 <tr><td colspan="7" class="kind">controls</td></tr>
971
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]972 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]973 <tr>
974 <th class="th_name">Property Name</th>
975 <th class="th_type">Type</th>
976 <th class="th_description">Description</th>
977 <th class="th_units">Units</th>
978 <th class="th_range">Range</th>
979 <th class="th_notes">Notes</th>
980 <th class="th_tags">Tags</th>
981 </tr>
982 </thead>
983
984 <tbody>
985
986
987
988
989
990
991
992
993
994
995 <tr class="entry" id="controls_android.control.aeAntibandingMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]996 <td class="entry_name"><html><body><p>android.control.aeAntibandingMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]997 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]998 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]999
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1000 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1001
1002 <ul class="entry_type_enum">
1003 <li>
1004 <span class="entry_type_enum_name">OFF</span>
1005 </li>
1006 <li>
1007 <span class="entry_type_enum_name">50HZ</span>
1008 </li>
1009 <li>
1010 <span class="entry_type_enum_name">60HZ</span>
1011 </li>
1012 <li>
1013 <span class="entry_type_enum_name">AUTO</span>
1014 </li>
1015 </ul>
1016
1017 </td> <!-- entry_type -->
1018
1019 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1020 <html><body><p>Enum for controlling
1021antibanding<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1022 </td>
1023
1024 <td class="entry_units">
1025 </td>
1026
1027 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1028 <html><body><p>android.control.aeAvailableAntibandingModes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1029 </td>
1030
1031 <td class="entry_notes">
1032 </td>
1033
1034 <td class="entry_tags">
1035 </td>
1036
1037 </tr> <!-- end of entry -->
1038
1039
1040 <tr class="entry" id="controls_android.control.aeExposureCompensation">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1041 <td class="entry_name"><html><body><p>android.control.aeExposureCompensation<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1042 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1043 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1044
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1045 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1046
1047
1048 </td> <!-- entry_type -->
1049
1050 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1051 <html><body><p>Adjustment to AE target image
1052brightness<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1053 </td>
1054
1055 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1056 <html><body><p>count of positive/negative EV steps<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1057 </td>
1058
1059 <td class="entry_range">
1060 </td>
1061
1062 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1063 <html><body><p>For example, if EV step is 0.333, '6' will mean an
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1064exposure compensation of +2 EV; -3 will mean an exposure
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1065compensation of -1<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1066 </td>
1067
1068 <td class="entry_tags">
1069 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1070 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1071 </ul>
1072 </td>
1073
1074 </tr> <!-- end of entry -->
1075
1076
1077 <tr class="entry" id="controls_android.control.aeLock">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1078 <td class="entry_name"><html><body><p>android.control.aeLock<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1079 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1080 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1081
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1082 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1083
1084 <ul class="entry_type_enum">
1085 <li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1086 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1087 <span class="entry_type_enum_notes"><html><body><p>Autoexposure lock is disabled; the AE algorithm
1088 is free to update its parameters.<wbr></wbr></p></body></html></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1089 </li>
1090 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1091 <span class="entry_type_enum_name">ON</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1092 <span class="entry_type_enum_notes"><html><body><p>Autoexposure lock is enabled; the AE algorithm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1093 must not update the exposure and sensitivity parameters
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1094 while the lock is active<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1095 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1096 </ul>
1097
1098 </td> <!-- entry_type -->
1099
1100 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1101 <html><body><p>Whether AE is currently locked to its latest
1102calculated values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1103 </td>
1104
1105 <td class="entry_units">
1106 </td>
1107
1108 <td class="entry_range">
1109 </td>
1110
1111 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1112 <html><body><p>Note that even when AE is locked, the flash may be
1113fired if the AE mode is ON_AUTO_FLASH / ON_ALWAYS_FLASH /
1114ON_AUTO_FLASH_REDEYE.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1115 </td>
1116
1117 <td class="entry_tags">
1118 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1119 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1120 </ul>
1121 </td>
1122
1123 </tr> <!-- end of entry -->
1124
1125
1126 <tr class="entry" id="controls_android.control.aeMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1127 <td class="entry_name"><html><body><p>android.control.aeMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1128 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1129 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1130
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1131 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1132
1133 <ul class="entry_type_enum">
1134 <li>
1135 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1136 <span class="entry_type_enum_notes"><html><body><p>Autoexposure is disabled; sensor.exposureTime,
1137 sensor.sensitivity and sensor.frameDuration are used<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1138 </li>
1139 <li>
1140 <span class="entry_type_enum_name">ON</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1141 <span class="entry_type_enum_notes"><html><body><p>Autoexposure is active, no flash
1142 control<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1143 </li>
1144 <li>
1145 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1146 <span class="entry_type_enum_notes"><html><body><p>If autoexposure is active and flash exists, auto
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1147 flash control; flash may be fired when precapture
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1148 trigger is activated, and for captures for which
1149 captureIntent = STILL_CAPTURE<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1150 </li>
1151 <li>
1152 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1153 <span class="entry_type_enum_notes"><html><body><p>If autoexposure is active and flash exists, auto
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1154 flash control for precapture trigger and always flash
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1155 when captureIntent = STILL_CAPTURE<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1156 </li>
1157 <li>
1158 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1159 <span class="entry_type_enum_notes"><html><body><p>Optional. Automatic red eye reduction with flash.
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1160 If deemed necessary, red eye reduction sequence should
1161 fire when precapture trigger is activated, and final
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1162 flash should fire when captureIntent =
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1163 STILL_CAPTURE<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1164 </li>
1165 </ul>
1166
1167 </td> <!-- entry_type -->
1168
1169 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1170 <html><body><p>Whether AE is currently updating the sensor
1171exposure and sensitivity fields<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1172 </td>
1173
1174 <td class="entry_units">
1175 </td>
1176
1177 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1178 <html><body><p>android.control.aeAvailableModes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1179 </td>
1180
1181 <td class="entry_notes">
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1182 <html><body><p>Only effective if android.control.mode = AUTO.</p>
1183<p>If auto-exposure is active, HAL auto-focus routine is enabled,
1184then HAL auto-exposure routine overrides the control variables
1185that relate to auto-exposure routine, and these override values
1186are then available in the result metadata for that capture.</p>
1187<p>For example, if auto-exposure is enabled in a request, the HAL should
1188overwrite the exposure, gain, and frame duration fields (and potentially
1189the flash fields, depending on AE mode) of the request. The overridden
1190values are then provided back to the user in the corresponding result.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1191 </td>
1192
1193 <td class="entry_tags">
1194 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1195 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1196 </ul>
1197 </td>
1198
1199 </tr> <!-- end of entry -->
1200
1201
1202 <tr class="entry" id="controls_android.control.aeRegions">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1203 <td class="entry_name"><html><body><p>android.control.aeRegions<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1204 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1205 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1206 <span class="entry_type_container">x</span>
1207
1208 <span class="entry_type_array">
1209 5 x area_count
1210 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1211 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1212
1213
1214 </td> <!-- entry_type -->
1215
1216 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1217 <html><body><p>List of areas to use for
1218metering<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1219 </td>
1220
1221 <td class="entry_units">
1222 </td>
1223
1224 <td class="entry_range">
1225 </td>
1226
1227 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1228 <html><body><p>Each area is a rectangle plus weight: xmin, ymin,
1229xmax, ymax, weight. The rectangle is defined inclusive of the
1230specified coordinates.</p>
1231<p>The coordinate system is based on the active pixel array,
1232with (0,0) being the top-left pixel in the active pixel array, and
1233(android.sensor.info.activeArraySize.width - 1,
1234android.sensor.info.activeArraySize.height - 1) being the
1235bottom-right pixel in the active pixel array. The weight
1236should be nonnegative.</p>
1237<p>If all regions have 0 weight, then no specific metering area
1238needs to be used by the HAL. If the metering region is
1239outside the current android.scaler.cropRegion, the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1240should ignore the sections outside the region and output the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1241used sections in the frame metadata<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1242 </td>
1243
1244 <td class="entry_tags">
1245 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1246 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1247 </ul>
1248 </td>
1249
1250 </tr> <!-- end of entry -->
1251
1252
1253 <tr class="entry" id="controls_android.control.aeTargetFpsRange">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1254 <td class="entry_name"><html><body><p>android.control.aeTargetFpsRange<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1255 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1256 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1257 <span class="entry_type_container">x</span>
1258
1259 <span class="entry_type_array">
1260 2
1261 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1262 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1263
1264
1265 </td> <!-- entry_type -->
1266
1267 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1268 <html><body><p>Range over which fps can be adjusted to
1269maintain exposure<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1270 </td>
1271
1272 <td class="entry_units">
1273 </td>
1274
1275 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1276 <html><body><p>android.control.aeAvailableTargetFpsRanges<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1277 </td>
1278
1279 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1280 <html><body><p>Only constrains AE algorithm, not manual control
1281of android.sensor.exposureTime<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1282 </td>
1283
1284 <td class="entry_tags">
1285 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1286 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1287 </ul>
1288 </td>
1289
1290 </tr> <!-- end of entry -->
1291
1292
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1293 <tr class="entry" id="controls_android.control.aePrecaptureTrigger">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1294 <td class="entry_name"><html><body><p>android.control.aePrecaptureTrigger<wbr></wbr></p></body></html></td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1295 <td class="entry_type">
1296 <span class="entry_type_name entry_type_name_enum">byte</span>
1297
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1298 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1299
1300 <ul class="entry_type_enum">
1301 <li>
1302 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1303 <span class="entry_type_enum_notes"><html><body><p>The trigger is idle.<wbr></wbr></p></body></html></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1304 </li>
1305 <li>
1306 <span class="entry_type_enum_name">START</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1307 <span class="entry_type_enum_notes"><html><body><p>The precapture metering sequence
1308 must be started. The exact effect of the precapture
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1309 trigger depends on the current AE mode and
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1310 state.<wbr></wbr></p></body></html></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1311 </li>
1312 </ul>
1313
1314 </td> <!-- entry_type -->
1315
1316 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1317 <html><body><p>Whether the HAL must trigger precapture
1318metering.<wbr></wbr></p></body></html>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1319 </td>
1320
1321 <td class="entry_units">
1322 </td>
1323
1324 <td class="entry_range">
1325 </td>
1326
1327 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1328 <html><body><p>This entry is normally set to IDLE, or is not
1329included at all in the request settings. When included and
1330set to START, the HAL must trigger the autoexposure
1331precapture metering sequence.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1332<p>The effect of AE precapture trigger depends on the current
1333AE mode and state; see the camera HAL device v3 header for
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1334details.<wbr></wbr></p></body></html>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1335 </td>
1336
1337 <td class="entry_tags">
1338 <ul class="entry_tags">
1339 <li><a href="#tag_BC">BC</a></li>
1340 </ul>
1341 </td>
1342
1343 </tr> <!-- end of entry -->
1344
1345
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1346 <tr class="entry" id="controls_android.control.afMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1347 <td class="entry_name"><html><body><p>android.control.afMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1348 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1349 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1350
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1351 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1352
1353 <ul class="entry_type_enum">
1354 <li>
1355 <span class="entry_type_enum_name">OFF</span>
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1356 <span class="entry_type_enum_notes"><html><body><p>The auto-focus routine does not control the lens;
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1357 android.lens.focusDistance is controlled by the
1358 application<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1359 </li>
1360 <li>
1361 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1362 <span class="entry_type_enum_notes"><html><body><p>If lens is not fixed focus.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1363
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1364 Use android.lens.info.minimumFocusDistance to determine if lens
1365 is fixed-focus. In this mode, the lens does not move unless
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1366 the autofocus trigger action is called. When that trigger
1367 is activated, AF must transition to ACTIVE_SCAN, then to
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1368 the outcome of the scan (FOCUSED or NOT_FOCUSED).
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1369
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1370 Triggering AF_CANCEL resets the lens position to default,
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1371 and sets the AF state to INACTIVE.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1372 </li>
1373 <li>
1374 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1375 <span class="entry_type_enum_notes"><html><body><p>In this mode, the lens does not move unless the
1376 autofocus trigger action is called.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1377
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1378 When that trigger is activated, AF must transition to
1379 ACTIVE_SCAN, then to the outcome of the scan (FOCUSED or
1380 NOT_FOCUSED). Triggering cancel AF resets the lens
1381 position to default, and sets the AF state to
1382 INACTIVE.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1383 </li>
1384 <li>
1385 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1386 <span class="entry_type_enum_notes"><html><body><p>In this mode, the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1387 position continually to attempt to provide a
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1388 constantly-in-focus image stream.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1389
1390 The focusing behavior should be suitable for good quality
1391 video recording; typically this means slower focus
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1392 movement and no overshoots. When the AF trigger is not
1393 involved, the AF algorithm should start in INACTIVE state,
1394 and then transition into PASSIVE_SCAN and PASSIVE_FOCUSED
1395 states as appropriate. When the AF trigger is activated,
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1396 the algorithm should immediately transition into
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1397 AF_FOCUSED or AF_NOT_FOCUSED as appropriate, and lock the
1398 lens position until a cancel AF trigger is received.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1399
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1400 Once cancel is received, the algorithm should transition
1401 back to INACTIVE and resume passive scan. Note that this
1402 behavior is not identical to CONTINUOUS_PICTURE, since an
1403 ongoing PASSIVE_SCAN must immediately be
1404 canceled.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1405 </li>
1406 <li>
1407 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1408 <span class="entry_type_enum_notes"><html><body><p>In this mode, the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1409 position continually to attempt to provide a
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1410 constantly-in-focus image stream.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1411
1412 The focusing behavior should be suitable for still image
1413 capture; typically this means focusing as fast as
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1414 possible. When the AF trigger is not involved, the AF
1415 algorithm should start in INACTIVE state, and then
1416 transition into PASSIVE_SCAN and PASSIVE_FOCUSED states as
1417 appropriate as it attempts to maintain focus. When the AF
1418 trigger is activated, the algorithm should finish its
1419 PASSIVE_SCAN if active, and then transition into
1420 AF_FOCUSED or AF_NOT_FOCUSED as appropriate, and lock the
1421 lens position until a cancel AF trigger is received.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1422
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1423 When the AF cancel trigger is activated, the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1424 should transition back to INACTIVE and then act as if it
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1425 has just been started.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1426 </li>
1427 <li>
1428 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1429 <span class="entry_type_enum_notes"><html><body><p>Extended depth of field (digital focus). AF
1430 trigger is ignored, AF state should always be
1431 INACTIVE.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1432 </li>
1433 </ul>
1434
1435 </td> <!-- entry_type -->
1436
1437 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1438 <html><body><p>Whether AF is currently enabled, and what
1439mode it is set to<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1440 </td>
1441
1442 <td class="entry_units">
1443 </td>
1444
1445 <td class="entry_range">
1446 </td>
1447
1448 <td class="entry_notes">
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1449 <html><body><p>Only effective if android.control.mode = AUTO.</p>
1450<p>If lens is controlled by HAL auto-focus algorithm, the HAL should
1451report the current AF status in android.control.afState in
1452result metadata.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1453 </td>
1454
1455 <td class="entry_tags">
1456 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1457 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1458 </ul>
1459 </td>
1460
1461 </tr> <!-- end of entry -->
1462
1463
1464 <tr class="entry" id="controls_android.control.afRegions">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1465 <td class="entry_name"><html><body><p>android.control.afRegions<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1466 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1467 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1468 <span class="entry_type_container">x</span>
1469
1470 <span class="entry_type_array">
1471 5 x area_count
1472 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1473 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1474
1475
1476 </td> <!-- entry_type -->
1477
1478 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1479 <html><body><p>List of areas to use for focus
1480estimation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1481 </td>
1482
1483 <td class="entry_units">
1484 </td>
1485
1486 <td class="entry_range">
1487 </td>
1488
1489 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1490 <html><body><p>Each area is a rectangle plus weight: xmin, ymin,
1491xmax, ymax, weight. The rectangle is defined inclusive of the
1492specified coordinates.</p>
1493<p>The coordinate system is based on the active pixel array,
1494with (0,0) being the top-left pixel in the active pixel array, and
1495(android.sensor.info.activeArraySize.width - 1,
1496android.sensor.info.activeArraySize.height - 1) being the
1497bottom-right pixel in the active pixel array. The weight
1498should be nonnegative.</p>
1499<p>If all regions have 0 weight, then no specific focus area
1500needs to be used by the HAL. If the focusing region is
1501outside the current android.scaler.cropRegion, the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1502should ignore the sections outside the region and output the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1503used sections in the frame metadata<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1504 </td>
1505
1506 <td class="entry_tags">
1507 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1508 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1509 </ul>
1510 </td>
1511
1512 </tr> <!-- end of entry -->
1513
1514
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1515 <tr class="entry" id="controls_android.control.afTrigger">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1516 <td class="entry_name"><html><body><p>android.control.afTrigger<wbr></wbr></p></body></html></td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1517 <td class="entry_type">
1518 <span class="entry_type_name entry_type_name_enum">byte</span>
1519
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1520 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1521
1522 <ul class="entry_type_enum">
1523 <li>
1524 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1525 <span class="entry_type_enum_notes"><html><body><p>The trigger is idle.<wbr></wbr></p></body></html></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1526 </li>
1527 <li>
1528 <span class="entry_type_enum_name">START</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1529 <span class="entry_type_enum_notes"><html><body><p>Autofocus must trigger now.<wbr></wbr></p></body></html></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1530 </li>
1531 <li>
1532 <span class="entry_type_enum_name">CANCEL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1533 <span class="entry_type_enum_notes"><html><body><p>Autofocus must return to initial
1534 state, and cancel any active trigger.<wbr></wbr></p></body></html></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1535 </li>
1536 </ul>
1537
1538 </td> <!-- entry_type -->
1539
1540 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1541 <html><body><p>Whether the HAL must trigger autofocus.<wbr></wbr></p></body></html>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1542 </td>
1543
1544 <td class="entry_units">
1545 </td>
1546
1547 <td class="entry_range">
1548 </td>
1549
1550 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1551 <html><body><p>This entry is normally set to IDLE, or is not
1552included at all in the request settings.</p>
1553<p>When included and set to START, the HAL must trigger the
1554autofocus algorithm. The effect of AF trigger depends on the
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1555current AF mode and state; see the camera HAL device v3
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1556header for details. When set to CANCEL, the HAL must cancel
1557any active trigger, and return to initial AF state.<wbr></wbr></p></body></html>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1558 </td>
1559
1560 <td class="entry_tags">
1561 <ul class="entry_tags">
1562 <li><a href="#tag_BC">BC</a></li>
1563 </ul>
1564 </td>
1565
1566 </tr> <!-- end of entry -->
1567
1568
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1569 <tr class="entry" id="controls_android.control.awbLock">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1570 <td class="entry_name"><html><body><p>android.control.awbLock<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1571 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1572 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1573
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1574 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1575
1576 <ul class="entry_type_enum">
1577 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1578 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1579 <span class="entry_type_enum_notes"><html><body><p>Auto-whitebalance lock is disabled; the AWB
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1580 algorithm is free to update its parameters if in AUTO
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1581 mode.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1582 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1583 <li>
1584 <span class="entry_type_enum_name">ON</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1585 <span class="entry_type_enum_notes"><html><body><p>Auto-whitebalance lock is enabled; the AWB
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1586 algorithm must not update the exposure and sensitivity
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1587 parameters while the lock is active<wbr></wbr></p></body></html></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1588 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1589 </ul>
1590
1591 </td> <!-- entry_type -->
1592
1593 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1594 <html><body><p>Whether AWB is currently locked to its
1595latest calculated values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1596 </td>
1597
1598 <td class="entry_units">
1599 </td>
1600
1601 <td class="entry_range">
1602 </td>
1603
1604 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1605 <html><body><p>Note that AWB lock is only meaningful for AUTO
1606mode; in other modes, AWB is already fixed to a specific
1607setting<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1608 </td>
1609
1610 <td class="entry_tags">
1611 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1612 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1613 </ul>
1614 </td>
1615
1616 </tr> <!-- end of entry -->
1617
1618
1619 <tr class="entry" id="controls_android.control.awbMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1620 <td class="entry_name"><html><body><p>android.control.awbMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1621 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1622 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1623
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1624 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1625
1626 <ul class="entry_type_enum">
1627 <li>
1628 <span class="entry_type_enum_name">OFF</span>
1629 </li>
1630 <li>
1631 <span class="entry_type_enum_name">AUTO</span>
1632 </li>
1633 <li>
1634 <span class="entry_type_enum_name">INCANDESCENT</span>
1635 </li>
1636 <li>
1637 <span class="entry_type_enum_name">FLUORESCENT</span>
1638 </li>
1639 <li>
1640 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
1641 </li>
1642 <li>
1643 <span class="entry_type_enum_name">DAYLIGHT</span>
1644 </li>
1645 <li>
1646 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
1647 </li>
1648 <li>
1649 <span class="entry_type_enum_name">TWILIGHT</span>
1650 </li>
1651 <li>
1652 <span class="entry_type_enum_name">SHADE</span>
1653 </li>
1654 </ul>
1655
1656 </td> <!-- entry_type -->
1657
1658 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1659 <html><body><p>Whether AWB is currently setting the color
1660transform fields, and what its illumination target
1661is<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1662 </td>
1663
1664 <td class="entry_units">
1665 </td>
1666
1667 <td class="entry_range">
1668 </td>
1669
1670 <td class="entry_notes">
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1671 <html><body><p>[BC - AWB lock,AWB modes]</p>
1672<p>Only effective if android.control.mode = AUTO.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1673 </td>
1674
1675 <td class="entry_tags">
1676 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1677 <li><a href="#tag_BC">BC</a></li>
1678 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1679 </ul>
1680 </td>
1681
1682 </tr> <!-- end of entry -->
1683
1684
1685 <tr class="entry" id="controls_android.control.awbRegions">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1686 <td class="entry_name"><html><body><p>android.control.awbRegions<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1687 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1688 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1689 <span class="entry_type_container">x</span>
1690
1691 <span class="entry_type_array">
1692 5 x area_count
1693 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1694 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1695
1696
1697 </td> <!-- entry_type -->
1698
1699 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1700 <html><body><p>List of areas to use for illuminant
1701estimation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1702 </td>
1703
1704 <td class="entry_units">
1705 </td>
1706
1707 <td class="entry_range">
1708 </td>
1709
1710 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1711 <html><body><p>Only used in AUTO mode.</p>
1712<p>Each area is a rectangle plus weight: xmin, ymin,
1713xmax, ymax, weight. The rectangle is defined inclusive of the
1714specified coordinates.</p>
1715<p>The coordinate system is based on the active pixel array,
1716with (0,0) being the top-left pixel in the active pixel array, and
1717(android.sensor.info.activeArraySize.width - 1,
1718android.sensor.info.activeArraySize.height - 1) being the
1719bottom-right pixel in the active pixel array. The weight
1720should be nonnegative.</p>
1721<p>If all regions have 0 weight, then no specific metering area
1722needs to be used by the HAL. If the metering region is
1723outside the current android.scaler.cropRegion, the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1724should ignore the sections outside the region and output the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1725used sections in the frame metadata<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1726 </td>
1727
1728 <td class="entry_tags">
1729 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1730 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1731 </ul>
1732 </td>
1733
1734 </tr> <!-- end of entry -->
1735
1736
1737 <tr class="entry" id="controls_android.control.captureIntent">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1738 <td class="entry_name"><html><body><p>android.control.captureIntent<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1739 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1740 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1741
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1742 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1743
1744 <ul class="entry_type_enum">
1745 <li>
1746 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1747 <span class="entry_type_enum_notes"><html><body><p>This request doesn't fall into the other
1748 categories. Default to preview-like
1749 behavior.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1750 </li>
1751 <li>
1752 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1753 <span class="entry_type_enum_notes"><html><body><p>This request is for a preview-like usecase. The
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1754 precapture trigger may be used to start off a metering
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1755 w/flash sequence<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1756 </li>
1757 <li>
1758 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1759 <span class="entry_type_enum_notes"><html><body><p>This request is for a still capture-type
1760 usecase.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1761 </li>
1762 <li>
1763 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1764 <span class="entry_type_enum_notes"><html><body><p>This request is for a video recording
1765 usecase.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1766 </li>
1767 <li>
1768 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1769 <span class="entry_type_enum_notes"><html><body><p>This request is for a video snapshot (still
1770 image while recording video) usecase<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1771 </li>
1772 <li>
1773 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1774 <span class="entry_type_enum_notes"><html><body><p>This request is for a ZSL usecase; the
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1775 application will stream full-resolution images and
1776 reprocess one or several later for a final
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1777 capture<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1778 </li>
1779 </ul>
1780
1781 </td> <!-- entry_type -->
1782
1783 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1784 <html><body><p>Information to 3A routines about the purpose
1785of this capture, to help decide optimal 3A
1786strategy<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1787 </td>
1788
1789 <td class="entry_units">
1790 </td>
1791
1792 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1793 <html><body><p>all must be supported<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1794 </td>
1795
1796 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1797 <html><body><p>Only used if android.control.mode != OFF.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1798 </td>
1799
1800 <td class="entry_tags">
1801 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1802 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1803 </ul>
1804 </td>
1805
1806 </tr> <!-- end of entry -->
1807
1808
1809 <tr class="entry" id="controls_android.control.effectMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1810 <td class="entry_name"><html><body><p>android.control.effectMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1811 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1812 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1813
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1814 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1815
1816 <ul class="entry_type_enum">
1817 <li>
1818 <span class="entry_type_enum_name">OFF</span>
1819 </li>
1820 <li>
1821 <span class="entry_type_enum_name">MONO</span>
1822 <span class="entry_type_enum_optional">optional</span>
1823 </li>
1824 <li>
1825 <span class="entry_type_enum_name">NEGATIVE</span>
1826 <span class="entry_type_enum_optional">optional</span>
1827 </li>
1828 <li>
1829 <span class="entry_type_enum_name">SOLARIZE</span>
1830 <span class="entry_type_enum_optional">optional</span>
1831 </li>
1832 <li>
1833 <span class="entry_type_enum_name">SEPIA</span>
1834 <span class="entry_type_enum_optional">optional</span>
1835 </li>
1836 <li>
1837 <span class="entry_type_enum_name">POSTERIZE</span>
1838 <span class="entry_type_enum_optional">optional</span>
1839 </li>
1840 <li>
1841 <span class="entry_type_enum_name">WHITEBOARD</span>
1842 <span class="entry_type_enum_optional">optional</span>
1843 </li>
1844 <li>
1845 <span class="entry_type_enum_name">BLACKBOARD</span>
1846 <span class="entry_type_enum_optional">optional</span>
1847 </li>
1848 <li>
1849 <span class="entry_type_enum_name">AQUA</span>
1850 <span class="entry_type_enum_optional">optional</span>
1851 </li>
1852 </ul>
1853
1854 </td> <!-- entry_type -->
1855
1856 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1857 <html><body><p>Whether any special color effect is in use.
1858Only used if android.control.mode != OFF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1859 </td>
1860
1861 <td class="entry_units">
1862 </td>
1863
1864 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1865 <html><body><p>android.control.availableEffects<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1866 </td>
1867
1868 <td class="entry_notes">
1869 </td>
1870
1871 <td class="entry_tags">
1872 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1873 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1874 </ul>
1875 </td>
1876
1877 </tr> <!-- end of entry -->
1878
1879
1880 <tr class="entry" id="controls_android.control.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1881 <td class="entry_name"><html><body><p>android.control.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1882 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1883 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1884
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1885 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1886
1887 <ul class="entry_type_enum">
1888 <li>
1889 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1890 <span class="entry_type_enum_notes"><html><body><p>Full application control of pipeline. All 3A
1891 routines are disabled, no other settings in
1892 android.control.* have any effect<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1893 </li>
1894 <li>
1895 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1896 <span class="entry_type_enum_notes"><html><body><p>Use settings for each individual 3A routine.
1897 Manual control of capture parameters is disabled. All
1898 controls in android.control.* besides sceneMode take
1899 effect<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1900 </li>
1901 <li>
1902 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1903 <span class="entry_type_enum_notes"><html><body><p>Use specific scene mode. Enabling this disables
1904 control.aeMode, control.awbMode and control.afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1905 controls; the HAL must ignore those settings while
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1906 USE_SCENE_MODE is active (except for FACE_PRIORITY
1907 scene mode). Other control entries are still active.
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1908 This setting can only be used if availableSceneModes !=
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1909 UNSUPPORTED<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1910 </li>
1911 </ul>
1912
1913 </td> <!-- entry_type -->
1914
1915 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1916 <html><body><p>Overall mode of 3A control
1917routines<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1918 </td>
1919
1920 <td class="entry_units">
1921 </td>
1922
1923 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1924 <html><body><p>all must be supported<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1925 </td>
1926
1927 <td class="entry_notes">
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]1928 <html><body><p>High-level 3A control. When set to OFF, all 3A control
1929by the HAL is disabled. The application must set the fields for
1930capture parameters itself.</p>
1931<p>When set to AUTO, the individual algorithm controls in
1932android.control.* are in effect, such as android.control.afMode.</p>
1933<p>When set to USE_SCENE_MODE, the individual controls in
1934android.control.* are mostly disabled, and the HAL implements
1935one of the scene mode settings (such as ACTION, SUNSET, or PARTY)
1936as it wishes. The HAL scene mode 3A settings are provided by
1937android.control.sceneModeOverrides.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1938 </td>
1939
1940 <td class="entry_tags">
1941 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1942 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1943 </ul>
1944 </td>
1945
1946 </tr> <!-- end of entry -->
1947
1948
1949 <tr class="entry" id="controls_android.control.sceneMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1950 <td class="entry_name"><html><body><p>android.control.sceneMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1951 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1952 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1953
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1954 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1955
1956 <ul class="entry_type_enum">
1957 <li>
1958 <span class="entry_type_enum_name">UNSUPPORTED</span>
1959 <span class="entry_type_enum_value">0</span>
1960 </li>
1961 <li>
1962 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1963 <span class="entry_type_enum_notes"><html><body><p>if face detection support exists Use face
1964 detection data to drive 3A routines. If face detection
1965 statistics are disabled, should still operate correctly
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1966 (but not return face detection statistics to the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1967 framework).
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1968
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1969 Unlike the other scene modes, aeMode, awbMode, and afMode
1970 remain active when FACE_PRIORITY is set. This is due to
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1971 compatibility concerns with the old camera
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]1972 API<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1973 </li>
1974 <li>
1975 <span class="entry_type_enum_name">ACTION</span>
1976 <span class="entry_type_enum_optional">optional</span>
1977 </li>
1978 <li>
1979 <span class="entry_type_enum_name">PORTRAIT</span>
1980 <span class="entry_type_enum_optional">optional</span>
1981 </li>
1982 <li>
1983 <span class="entry_type_enum_name">LANDSCAPE</span>
1984 <span class="entry_type_enum_optional">optional</span>
1985 </li>
1986 <li>
1987 <span class="entry_type_enum_name">NIGHT</span>
1988 <span class="entry_type_enum_optional">optional</span>
1989 </li>
1990 <li>
1991 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
1992 <span class="entry_type_enum_optional">optional</span>
1993 </li>
1994 <li>
1995 <span class="entry_type_enum_name">THEATRE</span>
1996 <span class="entry_type_enum_optional">optional</span>
1997 </li>
1998 <li>
1999 <span class="entry_type_enum_name">BEACH</span>
2000 <span class="entry_type_enum_optional">optional</span>
2001 </li>
2002 <li>
2003 <span class="entry_type_enum_name">SNOW</span>
2004 <span class="entry_type_enum_optional">optional</span>
2005 </li>
2006 <li>
2007 <span class="entry_type_enum_name">SUNSET</span>
2008 <span class="entry_type_enum_optional">optional</span>
2009 </li>
2010 <li>
2011 <span class="entry_type_enum_name">STEADYPHOTO</span>
2012 <span class="entry_type_enum_optional">optional</span>
2013 </li>
2014 <li>
2015 <span class="entry_type_enum_name">FIREWORKS</span>
2016 <span class="entry_type_enum_optional">optional</span>
2017 </li>
2018 <li>
2019 <span class="entry_type_enum_name">SPORTS</span>
2020 <span class="entry_type_enum_optional">optional</span>
2021 </li>
2022 <li>
2023 <span class="entry_type_enum_name">PARTY</span>
2024 <span class="entry_type_enum_optional">optional</span>
2025 </li>
2026 <li>
2027 <span class="entry_type_enum_name">CANDLELIGHT</span>
2028 <span class="entry_type_enum_optional">optional</span>
2029 </li>
2030 <li>
2031 <span class="entry_type_enum_name">BARCODE</span>
2032 <span class="entry_type_enum_optional">optional</span>
2033 </li>
2034 </ul>
2035
2036 </td> <!-- entry_type -->
2037
2038 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2039 <html><body><p>Which scene mode is active when
2040android.control.mode = SCENE_MODE<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2041 </td>
2042
2043 <td class="entry_units">
2044 </td>
2045
2046 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2047 <html><body><p>android.control.availableSceneModes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2048 </td>
2049
2050 <td class="entry_notes">
2051 </td>
2052
2053 <td class="entry_tags">
2054 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2055 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2056 </ul>
2057 </td>
2058
2059 </tr> <!-- end of entry -->
2060
2061
2062 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2063 <td class="entry_name"><html><body><p>android.control.videoStabilizationMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2064 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2065 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2066
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2067 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2068
2069 <ul class="entry_type_enum">
2070 <li>
2071 <span class="entry_type_enum_name">OFF</span>
2072 </li>
2073 <li>
2074 <span class="entry_type_enum_name">ON</span>
2075 </li>
2076 </ul>
2077
2078 </td> <!-- entry_type -->
2079
2080 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2081 <html><body><p>Whether video stabilization is
2082active<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2083 </td>
2084
2085 <td class="entry_units">
2086 </td>
2087
2088 <td class="entry_range">
2089 </td>
2090
2091 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2092 <html><body><p>If enabled, video stabilization can modify the
2093android.scaler.cropRegion to keep the video stream
2094stabilized<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2095 </td>
2096
2097 <td class="entry_tags">
2098 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2099 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2100 </ul>
2101 </td>
2102
2103 </tr> <!-- end of entry -->
2104
2105
2106
2107 <!-- end of kind -->
2108 </tbody>
2109 <tr><td colspan="7" class="kind">static</td></tr>
2110
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2111 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2112 <tr>
2113 <th class="th_name">Property Name</th>
2114 <th class="th_type">Type</th>
2115 <th class="th_description">Description</th>
2116 <th class="th_units">Units</th>
2117 <th class="th_range">Range</th>
2118 <th class="th_notes">Notes</th>
2119 <th class="th_tags">Tags</th>
2120 </tr>
2121 </thead>
2122
2123 <tbody>
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2135 <td class="entry_name"><html><body><p>android.control.aeAvailableAntibandingModes<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2136 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2137 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2138 <span class="entry_type_container">x</span>
2139
2140 <span class="entry_type_array">
2141 n
2142 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2143 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2144 <div class="entry_type_notes"><html><body><p>list of enums<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2145
2146
2147 </td> <!-- entry_type -->
2148
2149 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2150 <html><body><p>Which set of antibanding modes are
2151supported<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2152 </td>
2153
2154 <td class="entry_units">
2155 </td>
2156
2157 <td class="entry_range">
2158 </td>
2159
2160 <td class="entry_notes">
2161 </td>
2162
2163 <td class="entry_tags">
2164 </td>
2165
2166 </tr> <!-- end of entry -->
2167
2168
2169 <tr class="entry" id="static_android.control.aeAvailableModes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2170 <td class="entry_name"><html><body><p>android.control.aeAvailableModes<wbr></wbr></p></body></html></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">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2173 <span class="entry_type_container">x</span>
2174
2175 <span class="entry_type_array">
2176 n
2177 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2178 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2179 <div class="entry_type_notes"><html><body><p>list of enums<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2180
2181
2182 </td> <!-- entry_type -->
2183
2184 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2185 <html><body><p>Which subset of AE modes is
2186supported<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2187 </td>
2188
2189 <td class="entry_units">
2190 </td>
2191
2192 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2193 <html><body><p>OFF, ON must be supported.
2194 ON_AUTO_FLASH/ON_ALWAYS_FLASH must be supported if flash
2195 unit is available<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2196 </td>
2197
2198 <td class="entry_notes">
2199 </td>
2200
2201 <td class="entry_tags">
2202 </td>
2203
2204 </tr> <!-- end of entry -->
2205
2206
2207 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2208 <td class="entry_name"><html><body><p>android.control.aeAvailableTargetFpsRanges<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2209 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2210 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2211 <span class="entry_type_container">x</span>
2212
2213 <span class="entry_type_array">
2214 2 x n
2215 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2216 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2217 <div class="entry_type_notes"><html><body><p>list of pairs of frame rates<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2218
2219
2220 </td> <!-- entry_type -->
2221
2222 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2223 <html><body><p>List of frame rate ranges supported by the
2224AE algorithm/hardware<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2225 </td>
2226
2227 <td class="entry_units">
2228 </td>
2229
2230 <td class="entry_range">
2231 </td>
2232
2233 <td class="entry_notes">
2234 </td>
2235
2236 <td class="entry_tags">
2237 </td>
2238
2239 </tr> <!-- end of entry -->
2240
2241
2242 <tr class="entry" id="static_android.control.aeCompensationRange">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2243 <td class="entry_name"><html><body><p>android.control.aeCompensationRange<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2244 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2245 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2246 <span class="entry_type_container">x</span>
2247
2248 <span class="entry_type_array">
2249 2
2250 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2251 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2252
2253
2254 </td> <!-- entry_type -->
2255
2256 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2257 <html><body><p>Maximum and minimum exposure compensation
2258setting, in counts of
2259android.control.aeCompensationStepSize<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2260 </td>
2261
2262 <td class="entry_units">
2263 </td>
2264
2265 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2266 <html><body><p>At least (-2,2)/(exp compensation step
2267 size)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2268 </td>
2269
2270 <td class="entry_notes">
2271 </td>
2272
2273 <td class="entry_tags">
2274 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2275 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2276 </ul>
2277 </td>
2278
2279 </tr> <!-- end of entry -->
2280
2281
2282 <tr class="entry" id="static_android.control.aeCompensationStep">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2283 <td class="entry_name"><html><body><p>android.control.aeCompensationStep<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2284 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2285 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2286
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2287 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2288
2289
2290 </td> <!-- entry_type -->
2291
2292 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2293 <html><body><p>Smallest step by which exposure compensation
2294can be changed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2295 </td>
2296
2297 <td class="entry_units">
2298 </td>
2299
2300 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2301
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2302 </td>
2303
2304 <td class="entry_notes">
2305 </td>
2306
2307 <td class="entry_tags">
2308 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2309 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2310 </ul>
2311 </td>
2312
2313 </tr> <!-- end of entry -->
2314
2315
2316 <tr class="entry" id="static_android.control.afAvailableModes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2317 <td class="entry_name"><html><body><p>android.control.afAvailableModes<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2318 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2319 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2320 <span class="entry_type_container">x</span>
2321
2322 <span class="entry_type_array">
2323 n
2324 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2325 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2326 <div class="entry_type_notes"><html><body><p>List of enums<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2327
2328
2329 </td> <!-- entry_type -->
2330
2331 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2332 <html><body><p>List of AF modes that can be
2333selected<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2334 </td>
2335
2336 <td class="entry_units">
2337 </td>
2338
2339 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2340 <html><body><p>OFF must be included. AUTO must be supported if
2341 lens allows for changing focus<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2342 </td>
2343
2344 <td class="entry_notes">
2345 </td>
2346
2347 <td class="entry_tags">
2348 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2349 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2350 </ul>
2351 </td>
2352
2353 </tr> <!-- end of entry -->
2354
2355
2356 <tr class="entry" id="static_android.control.availableEffects">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2357 <td class="entry_name"><html><body><p>android.control.availableEffects<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2358 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2359 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2360 <span class="entry_type_container">x</span>
2361
2362 <span class="entry_type_array">
2363 n
2364 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2365 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2366 <div class="entry_type_notes"><html><body><p>list of enums<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2367
2368
2369 </td> <!-- entry_type -->
2370
2371 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2372 <html><body><p>what subset of the full color effect enum
2373list is supported<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2374 </td>
2375
2376 <td class="entry_units">
2377 </td>
2378
2379 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2380 <html><body><p>OFF must be listed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2381 </td>
2382
2383 <td class="entry_notes">
2384 </td>
2385
2386 <td class="entry_tags">
2387 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2388 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2389 </ul>
2390 </td>
2391
2392 </tr> <!-- end of entry -->
2393
2394
2395 <tr class="entry" id="static_android.control.availableSceneModes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2396 <td class="entry_name"><html><body><p>android.control.availableSceneModes<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2397 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2398 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2399 <span class="entry_type_container">x</span>
2400
2401 <span class="entry_type_array">
2402 n
2403 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2404 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2405 <div class="entry_type_notes"><html><body><p>list of enums from android.control.sceneMode, plus UNSUPPORTED to indicate no scene modes are supported<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2406
2407
2408 </td> <!-- entry_type -->
2409
2410 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2411 <html><body><p>what subset of the scene mode enum list is
2412supported.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2413 </td>
2414
2415 <td class="entry_units">
2416 </td>
2417
2418 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2419 <html><body><p>SCENE_MODE_FACE_PRIORITY must be supported if face
2420 detection is supported<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2421 </td>
2422
2423 <td class="entry_notes">
2424 </td>
2425
2426 <td class="entry_tags">
2427 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2428 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2429 </ul>
2430 </td>
2431
2432 </tr> <!-- end of entry -->
2433
2434
2435 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2436 <td class="entry_name"><html><body><p>android.control.availableVideoStabilizationModes<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2437 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2438 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2439 <span class="entry_type_container">x</span>
2440
2441 <span class="entry_type_array">
2442 n
2443 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2444 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2445 <div class="entry_type_notes"><html><body><p>List of enums.<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2446
2447
2448 </td> <!-- entry_type -->
2449
2450 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2451 <html><body><p>List of video stabilization modes that can
2452be supported<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2453 </td>
2454
2455 <td class="entry_units">
2456 </td>
2457
2458 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2459 <html><body><p>OFF must be included<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2460 </td>
2461
2462 <td class="entry_notes">
2463 </td>
2464
2465 <td class="entry_tags">
2466 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2467 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2468 </ul>
2469 </td>
2470
2471 </tr> <!-- end of entry -->
2472
2473
2474 <tr class="entry" id="static_android.control.awbAvailableModes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2475 <td class="entry_name"><html><body><p>android.control.awbAvailableModes<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2476 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2477 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2478 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2479
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2480 <span class="entry_type_array">
2481 n
2482 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2483 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2484 <div class="entry_type_notes"><html><body><p>List of enums (android.control.awbMode)<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2485
2486
2487 </td> <!-- entry_type -->
2488
2489 <td class="entry_description">
2490 </td>
2491
2492 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2493 </td>
2494
2495 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2496 <html><body><p>OFF, AUTO must be included<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2497 </td>
2498
2499 <td class="entry_notes">
2500 </td>
2501
2502 <td class="entry_tags">
2503 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2504 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2505 </ul>
2506 </td>
2507
2508 </tr> <!-- end of entry -->
2509
2510
2511 <tr class="entry" id="static_android.control.maxRegions">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2512 <td class="entry_name"><html><body><p>android.control.maxRegions<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2513 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2514 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2515
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2516 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2517
2518
2519 </td> <!-- entry_type -->
2520
2521 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2522 <html><body><p>For AE, AWB, and AF, how many individual
2523regions can be listed for metering?<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2524 </td>
2525
2526 <td class="entry_units">
2527 </td>
2528
2529 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2530 <html><body><p>&gt;= 1<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2531 </td>
2532
2533 <td class="entry_notes">
2534 </td>
2535
2536 <td class="entry_tags">
2537 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2538 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2539 </ul>
2540 </td>
2541
2542 </tr> <!-- end of entry -->
2543
2544
2545 <tr class="entry" id="static_android.control.sceneModeOverrides">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2546 <td class="entry_name"><html><body><p>android.control.sceneModeOverrides<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2547 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2548 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2549 <span class="entry_type_container">x</span>
2550
2551 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2552 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2553 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2554 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2555
2556
2557 </td> <!-- entry_type -->
2558
2559 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2560 <html><body><p>List of AE, AWB, and AF modes to use for
2561each available scene mode<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2562 </td>
2563
2564 <td class="entry_units">
2565 </td>
2566
2567 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2568 <html><body><p>For each listed scene mode, lists the aeMode,
2569 awbMode, and afMode that the HAL wants to use for that
2570 scene mode.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2571
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2572 For each entry, the order is {aeMode, awbMode, afMode} in
2573 order of increasing index<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2574 </td>
2575
2576 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2577 <html><body><p>When a scene mode is enabled, the HAL is expected
2578to override aeMode, awbMode, and afMode with its
2579preferred settings for that scene mode.</p>
2580<p>To simplify communication with old camera API applications,
2581the service wants this override list in the static metadata.
2582The order of this list matches that of availableSceneModes,
2583with 3 entires for each scene mode. The overrides listed
2584for SCENE_MODE_FACE_PRIORITY are ignored, since for that
2585mode, the application-set aeMode, awbMode, and afMode are
2586used instead, like they are when android.control.mode is
2587AUTO.</p>
2588<p>It is recommended that for FACE_PRIORITY, the overrides
2589should be set to 0. As an example, if availableSceneModes is
2590{ FACE_PRIORITY, ACTION, NIGHT }, then the service expects
2591this field to have 9 entries; for example { 0 , 0, 0,
2592ON_AUTO_FLASH, AUTO, CONTINUOUS_PICTURE, ON_AUTO_FLASH,
2593INCANDESCENT, AUTO }<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2594 </td>
2595
2596 <td class="entry_tags">
2597 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2598 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2599 </ul>
2600 </td>
2601
2602 </tr> <!-- end of entry -->
2603
2604
2605
2606 <!-- end of kind -->
2607 </tbody>
2608 <tr><td colspan="7" class="kind">dynamic</td></tr>
2609
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2610 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2611 <tr>
2612 <th class="th_name">Property Name</th>
2613 <th class="th_type">Type</th>
2614 <th class="th_description">Description</th>
2615 <th class="th_units">Units</th>
2616 <th class="th_range">Range</th>
2617 <th class="th_notes">Notes</th>
2618 <th class="th_tags">Tags</th>
2619 </tr>
2620 </thead>
2621
2622 <tbody>
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2634 <td class="entry_name"><html><body><p>android.control.aePrecaptureId<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2635 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2636 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2637
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2638 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2639
2640
2641 </td> <!-- entry_type -->
2642
2643 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2644 <html><body><p>The ID sent with the latest
2645CAMERA2_TRIGGER_PRECAPTURE_METERING call<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2646 </td>
2647
2648 <td class="entry_units">
2649 </td>
2650
2651 <td class="entry_range">
2652 </td>
2653
2654 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2655 <html><body><p>Must be 0 if no
2656CAMERA2_TRIGGER_PRECAPTURE_METERING trigger received yet
2657by HAL. Always updated even if AE algorithm ignores the
2658trigger<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2659 </td>
2660
2661 <td class="entry_tags">
2662 </td>
2663
2664 </tr> <!-- end of entry -->
2665
2666
2667 <tr class="entry" id="dynamic_android.control.aeRegions">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2668 <td class="entry_name"><html><body><p>android.control.aeRegions<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2669 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2670 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2671 <span class="entry_type_container">x</span>
2672
2673 <span class="entry_type_array">
2674 5 x area_count
2675 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2676 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2677
2678
2679 </td> <!-- entry_type -->
2680
2681 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2682 <html><body><p>List of areas to use for
2683metering<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2684 </td>
2685
2686 <td class="entry_units">
2687 </td>
2688
2689 <td class="entry_range">
2690 </td>
2691
2692 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2693 <html><body><p>Each area is a rectangle plus weight: xmin, ymin,
2694xmax, ymax, weight. The rectangle is defined inclusive of the
2695specified coordinates.</p>
2696<p>The coordinate system is based on the active pixel array,
2697with (0,0) being the top-left pixel in the active pixel array, and
2698(android.sensor.info.activeArraySize.width - 1,
2699android.sensor.info.activeArraySize.height - 1) being the
2700bottom-right pixel in the active pixel array. The weight
2701should be nonnegative.</p>
2702<p>If all regions have 0 weight, then no specific metering area
2703needs to be used by the HAL. If the metering region is
2704outside the current android.scaler.cropRegion, the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]2705should ignore the sections outside the region and output the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2706used sections in the frame metadata<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2707 </td>
2708
2709 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2710 <ul class="entry_tags">
2711 <li><a href="#tag_BC">BC</a></li>
2712 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2713 </td>
2714
2715 </tr> <!-- end of entry -->
2716
2717
2718 <tr class="entry" id="dynamic_android.control.aeState">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2719 <td class="entry_name"><html><body><p>android.control.aeState<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2720 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2721 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2722
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2723 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2724
2725 <ul class="entry_type_enum">
2726 <li>
2727 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2728 <span class="entry_type_enum_notes"><html><body><p>AE is off. When a camera device is opened, it starts in
2729 this state.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2730 </li>
2731 <li>
2732 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2733 <span class="entry_type_enum_notes"><html><body><p>AE doesn't yet have a good set of control values
2734 for the current scene<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2735 </li>
2736 <li>
2737 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2738 <span class="entry_type_enum_notes"><html><body><p>AE has a good set of control values for the
2739 current scene<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2740 </li>
2741 <li>
2742 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2743 <span class="entry_type_enum_notes"><html><body><p>AE has been locked (aeMode =
2744 LOCKED)<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2745 </li>
2746 <li>
2747 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2748 <span class="entry_type_enum_notes"><html><body><p>AE has a good set of control values, but flash
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2749 needs to be fired for good quality still
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2750 capture<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2751 </li>
2752 <li>
2753 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2754 <span class="entry_type_enum_notes"><html><body><p>AE has been asked to do a precapture sequence
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2755 (through the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2756 trigger_action(CAMERA2_TRIGGER_PRECAPTURE_METERING)
2757 call), and is currently executing it. Once PRECAPTURE
2758 completes, AE will transition to CONVERGED or
2759 FLASH_REQUIRED as appropriate<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2760 </li>
2761 </ul>
2762
2763 </td> <!-- entry_type -->
2764
2765 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2766 <html><body><p>Current state of AE algorithm<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2767 </td>
2768
2769 <td class="entry_units">
2770 </td>
2771
2772 <td class="entry_range">
2773 </td>
2774
2775 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2776 <html><body><p>Whenever the AE algorithm state changes, a
2777MSG_AUTOEXPOSURE notification must be send if a
2778notification callback is registered.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2779 </td>
2780
2781 <td class="entry_tags">
2782 </td>
2783
2784 </tr> <!-- end of entry -->
2785
2786
2787 <tr class="entry" id="dynamic_android.control.afMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2788 <td class="entry_name"><html><body><p>android.control.afMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2789 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2790 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2791
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2792 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2793
2794 <ul class="entry_type_enum">
2795 <li>
2796 <span class="entry_type_enum_name">OFF</span>
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]2797 <span class="entry_type_enum_notes"><html><body><p>The auto-focus routine does not control the lens;
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2798 android.lens.focusDistance is controlled by the
2799 application<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2800 </li>
2801 <li>
2802 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2803 <span class="entry_type_enum_notes"><html><body><p>If lens is not fixed focus.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2804
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]2805 Use android.lens.info.minimumFocusDistance to determine if lens
2806 is fixed-focus. In this mode, the lens does not move unless
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2807 the autofocus trigger action is called. When that trigger
2808 is activated, AF must transition to ACTIVE_SCAN, then to
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]2809 the outcome of the scan (FOCUSED or NOT_FOCUSED).
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2810
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]2811 Triggering AF_CANCEL resets the lens position to default,
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2812 and sets the AF state to INACTIVE.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2813 </li>
2814 <li>
2815 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2816 <span class="entry_type_enum_notes"><html><body><p>In this mode, the lens does not move unless the
2817 autofocus trigger action is called.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2818
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2819 When that trigger is activated, AF must transition to
2820 ACTIVE_SCAN, then to the outcome of the scan (FOCUSED or
2821 NOT_FOCUSED). Triggering cancel AF resets the lens
2822 position to default, and sets the AF state to
2823 INACTIVE.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2824 </li>
2825 <li>
2826 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2827 <span class="entry_type_enum_notes"><html><body><p>In this mode, the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2828 position continually to attempt to provide a
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2829 constantly-in-focus image stream.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2830
2831 The focusing behavior should be suitable for good quality
2832 video recording; typically this means slower focus
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2833 movement and no overshoots. When the AF trigger is not
2834 involved, the AF algorithm should start in INACTIVE state,
2835 and then transition into PASSIVE_SCAN and PASSIVE_FOCUSED
2836 states as appropriate. When the AF trigger is activated,
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2837 the algorithm should immediately transition into
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2838 AF_FOCUSED or AF_NOT_FOCUSED as appropriate, and lock the
2839 lens position until a cancel AF trigger is received.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2840
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2841 Once cancel is received, the algorithm should transition
2842 back to INACTIVE and resume passive scan. Note that this
2843 behavior is not identical to CONTINUOUS_PICTURE, since an
2844 ongoing PASSIVE_SCAN must immediately be
2845 canceled.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2846 </li>
2847 <li>
2848 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2849 <span class="entry_type_enum_notes"><html><body><p>In this mode, the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2850 position continually to attempt to provide a
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2851 constantly-in-focus image stream.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2852
2853 The focusing behavior should be suitable for still image
2854 capture; typically this means focusing as fast as
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2855 possible. When the AF trigger is not involved, the AF
2856 algorithm should start in INACTIVE state, and then
2857 transition into PASSIVE_SCAN and PASSIVE_FOCUSED states as
2858 appropriate as it attempts to maintain focus. When the AF
2859 trigger is activated, the algorithm should finish its
2860 PASSIVE_SCAN if active, and then transition into
2861 AF_FOCUSED or AF_NOT_FOCUSED as appropriate, and lock the
2862 lens position until a cancel AF trigger is received.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2863
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2864 When the AF cancel trigger is activated, the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2865 should transition back to INACTIVE and then act as if it
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2866 has just been started.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2867 </li>
2868 <li>
2869 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2870 <span class="entry_type_enum_notes"><html><body><p>Extended depth of field (digital focus). AF
2871 trigger is ignored, AF state should always be
2872 INACTIVE.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2873 </li>
2874 </ul>
2875
2876 </td> <!-- entry_type -->
2877
2878 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2879 <html><body><p>Whether AF is currently enabled, and what
2880mode it is set to<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2881 </td>
2882
2883 <td class="entry_units">
2884 </td>
2885
2886 <td class="entry_range">
2887 </td>
2888
2889 <td class="entry_notes">
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]2890 <html><body><p>Only effective if android.control.mode = AUTO.</p>
2891<p>If lens is controlled by HAL auto-focus algorithm, the HAL should
2892report the current AF status in android.control.afState in
2893result metadata.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2894 </td>
2895
2896 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2897 <ul class="entry_tags">
2898 <li><a href="#tag_BC">BC</a></li>
2899 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2900 </td>
2901
2902 </tr> <!-- end of entry -->
2903
2904
2905 <tr class="entry" id="dynamic_android.control.afRegions">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2906 <td class="entry_name"><html><body><p>android.control.afRegions<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2907 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2908 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2909 <span class="entry_type_container">x</span>
2910
2911 <span class="entry_type_array">
2912 5 x area_count
2913 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2914 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2915
2916
2917 </td> <!-- entry_type -->
2918
2919 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2920 <html><body><p>List of areas to use for focus
2921estimation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2922 </td>
2923
2924 <td class="entry_units">
2925 </td>
2926
2927 <td class="entry_range">
2928 </td>
2929
2930 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2931 <html><body><p>Each area is a rectangle plus weight: xmin, ymin,
2932xmax, ymax, weight. The rectangle is defined inclusive of the
2933specified coordinates.</p>
2934<p>The coordinate system is based on the active pixel array,
2935with (0,0) being the top-left pixel in the active pixel array, and
2936(android.sensor.info.activeArraySize.width - 1,
2937android.sensor.info.activeArraySize.height - 1) being the
2938bottom-right pixel in the active pixel array. The weight
2939should be nonnegative.</p>
2940<p>If all regions have 0 weight, then no specific focus area
2941needs to be used by the HAL. If the focusing region is
2942outside the current android.scaler.cropRegion, the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]2943should ignore the sections outside the region and output the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2944used sections in the frame metadata<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2945 </td>
2946
2947 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2948 <ul class="entry_tags">
2949 <li><a href="#tag_BC">BC</a></li>
2950 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2951 </td>
2952
2953 </tr> <!-- end of entry -->
2954
2955
2956 <tr class="entry" id="dynamic_android.control.afState">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2957 <td class="entry_name"><html><body><p>android.control.afState<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2958 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2959 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2960
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2961 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2962
2963 <ul class="entry_type_enum">
2964 <li>
2965 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2966 <span class="entry_type_enum_notes"><html><body><p>AF off or has not yet tried to scan/been asked
2967 to scan. When a camera device is opened, it starts in
2968 this state.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2969 </li>
2970 <li>
2971 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2972 <span class="entry_type_enum_notes"><html><body><p>if CONTINUOUS_* modes are supported. AF is
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2973 currently doing an AF scan initiated by a continuous
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2974 autofocus mode<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2975 </li>
2976 <li>
2977 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2978 <span class="entry_type_enum_notes"><html><body><p>if CONTINUOUS_* modes are supported. AF currently
2979 believes it is in focus, but may restart scanning at
2980 any time.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2981 </li>
2982 <li>
2983 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2984 <span class="entry_type_enum_notes"><html><body><p>if AUTO or MACRO modes are supported. AF is doing
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2985 an AF scan because it was triggered by AF
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2986 trigger<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2987 </li>
2988 <li>
2989 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2990 <span class="entry_type_enum_notes"><html><body><p>if any AF mode besides OFF is supported. AF
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2991 believes it is focused correctly and is
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2992 locked<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2993 </li>
2994 <li>
2995 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2996 <span class="entry_type_enum_notes"><html><body><p>if any AF mode besides OFF is supported. AF has
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2997 failed to focus successfully and is
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]2998 locked<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2999 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3000 <li>
3001 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3002 <span class="entry_type_enum_notes"><html><body><p>if CONTINUOUS_* modes are supported. AF finished a
3003 passive scan without finding focus, and may restart
3004 scanning at any time.<wbr></wbr></p></body></html></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3005 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3006 </ul>
3007
3008 </td> <!-- entry_type -->
3009
3010 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3011 <html><body><p>Current state of AF algorithm<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3012 </td>
3013
3014 <td class="entry_units">
3015 </td>
3016
3017 <td class="entry_range">
3018 </td>
3019
3020 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3021 <html><body><p>Whenever the AF algorithm state changes, a
3022MSG_AUTOFOCUS notification must be send if a notification
3023callback is registered.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3024 </td>
3025
3026 <td class="entry_tags">
3027 </td>
3028
3029 </tr> <!-- end of entry -->
3030
3031
3032 <tr class="entry" id="dynamic_android.control.afTriggerId">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3033 <td class="entry_name"><html><body><p>android.control.afTriggerId<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3034 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3035 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3036
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3037 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3038
3039
3040 </td> <!-- entry_type -->
3041
3042 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3043 <html><body><p>The ID sent with the latest
3044CAMERA2_TRIGGER_AUTOFOCUS call<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3045 </td>
3046
3047 <td class="entry_units">
3048 </td>
3049
3050 <td class="entry_range">
3051 </td>
3052
3053 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3054 <html><body><p>Must be 0 if no CAMERA2_TRIGGER_AUTOFOCUS trigger
3055received yet by HAL. Always updated even if AF algorithm
3056ignores the trigger<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3057 </td>
3058
3059 <td class="entry_tags">
3060 </td>
3061
3062 </tr> <!-- end of entry -->
3063
3064
3065 <tr class="entry" id="dynamic_android.control.awbMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3066 <td class="entry_name"><html><body><p>android.control.awbMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3067 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3068 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3069
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3070 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3071
3072 <ul class="entry_type_enum">
3073 <li>
3074 <span class="entry_type_enum_name">OFF</span>
3075 </li>
3076 <li>
3077 <span class="entry_type_enum_name">AUTO</span>
3078 </li>
3079 <li>
3080 <span class="entry_type_enum_name">INCANDESCENT</span>
3081 </li>
3082 <li>
3083 <span class="entry_type_enum_name">FLUORESCENT</span>
3084 </li>
3085 <li>
3086 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
3087 </li>
3088 <li>
3089 <span class="entry_type_enum_name">DAYLIGHT</span>
3090 </li>
3091 <li>
3092 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
3093 </li>
3094 <li>
3095 <span class="entry_type_enum_name">TWILIGHT</span>
3096 </li>
3097 <li>
3098 <span class="entry_type_enum_name">SHADE</span>
3099 </li>
3100 </ul>
3101
3102 </td> <!-- entry_type -->
3103
3104 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3105 <html><body><p>Whether AWB is currently setting the color
3106transform fields, and what its illumination target
3107is<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3108 </td>
3109
3110 <td class="entry_units">
3111 </td>
3112
3113 <td class="entry_range">
3114 </td>
3115
3116 <td class="entry_notes">
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]3117 <html><body><p>[BC - AWB lock,AWB modes]</p>
3118<p>Only effective if android.control.mode = AUTO.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3119 </td>
3120
3121 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3122 <ul class="entry_tags">
3123 <li><a href="#tag_BC">BC</a></li>
3124 <li><a href="#tag_AWB">AWB</a></li>
3125 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3126 </td>
3127
3128 </tr> <!-- end of entry -->
3129
3130
3131 <tr class="entry" id="dynamic_android.control.awbRegions">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3132 <td class="entry_name"><html><body><p>android.control.awbRegions<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3133 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3134 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3135 <span class="entry_type_container">x</span>
3136
3137 <span class="entry_type_array">
3138 5 x area_count
3139 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3140 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3141
3142
3143 </td> <!-- entry_type -->
3144
3145 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3146 <html><body><p>List of areas to use for illuminant
3147estimation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3148 </td>
3149
3150 <td class="entry_units">
3151 </td>
3152
3153 <td class="entry_range">
3154 </td>
3155
3156 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3157 <html><body><p>Only used in AUTO mode.</p>
3158<p>Each area is a rectangle plus weight: xmin, ymin,
3159xmax, ymax, weight. The rectangle is defined inclusive of the
3160specified coordinates.</p>
3161<p>The coordinate system is based on the active pixel array,
3162with (0,0) being the top-left pixel in the active pixel array, and
3163(android.sensor.info.activeArraySize.width - 1,
3164android.sensor.info.activeArraySize.height - 1) being the
3165bottom-right pixel in the active pixel array. The weight
3166should be nonnegative.</p>
3167<p>If all regions have 0 weight, then no specific metering area
3168needs to be used by the HAL. If the metering region is
3169outside the current android.scaler.cropRegion, the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]3170should ignore the sections outside the region and output the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3171used sections in the frame metadata<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3172 </td>
3173
3174 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3175 <ul class="entry_tags">
3176 <li><a href="#tag_BC">BC</a></li>
3177 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3178 </td>
3179
3180 </tr> <!-- end of entry -->
3181
3182
3183 <tr class="entry" id="dynamic_android.control.awbState">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3184 <td class="entry_name"><html><body><p>android.control.awbState<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3185 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3186 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3187
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3188 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3189
3190 <ul class="entry_type_enum">
3191 <li>
3192 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3193 <span class="entry_type_enum_notes"><html><body><p>AWB is not in auto mode. When a camera device is opened, it
3194 starts in this state.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3195 </li>
3196 <li>
3197 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3198 <span class="entry_type_enum_notes"><html><body><p>AWB doesn't yet have a good set of control
3199 values for the current scene<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3200 </li>
3201 <li>
3202 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3203 <span class="entry_type_enum_notes"><html><body><p>AWB has a good set of control values for the
3204 current scene<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3205 </li>
3206 <li>
3207 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3208 <span class="entry_type_enum_notes"><html><body><p>AE has been locked (aeMode =
3209 LOCKED)<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3210 </li>
3211 </ul>
3212
3213 </td> <!-- entry_type -->
3214
3215 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3216 <html><body><p>Current state of AWB algorithm<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3217 </td>
3218
3219 <td class="entry_units">
3220 </td>
3221
3222 <td class="entry_range">
3223 </td>
3224
3225 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3226 <html><body><p>Whenever the AWB algorithm state changes, a
3227MSG_AUTOWHITEBALANCE notification must be send if a
3228notification callback is registered.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3229 </td>
3230
3231 <td class="entry_tags">
3232 </td>
3233
3234 </tr> <!-- end of entry -->
3235
3236
3237 <tr class="entry" id="dynamic_android.control.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3238 <td class="entry_name"><html><body><p>android.control.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3239 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3240 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3241
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3242 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3243
3244 <ul class="entry_type_enum">
3245 <li>
3246 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3247 <span class="entry_type_enum_notes"><html><body><p>Full application control of pipeline. All 3A
3248 routines are disabled, no other settings in
3249 android.control.* have any effect<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3250 </li>
3251 <li>
3252 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3253 <span class="entry_type_enum_notes"><html><body><p>Use settings for each individual 3A routine.
3254 Manual control of capture parameters is disabled. All
3255 controls in android.control.* besides sceneMode take
3256 effect<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3257 </li>
3258 <li>
3259 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3260 <span class="entry_type_enum_notes"><html><body><p>Use specific scene mode. Enabling this disables
3261 control.aeMode, control.awbMode and control.afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3262 controls; the HAL must ignore those settings while
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3263 USE_SCENE_MODE is active (except for FACE_PRIORITY
3264 scene mode). Other control entries are still active.
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3265 This setting can only be used if availableSceneModes !=
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3266 UNSUPPORTED<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3267 </li>
3268 </ul>
3269
3270 </td> <!-- entry_type -->
3271
3272 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3273 <html><body><p>Overall mode of 3A control
3274routines<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3275 </td>
3276
3277 <td class="entry_units">
3278 </td>
3279
3280 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3281 <html><body><p>all must be supported<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3282 </td>
3283
3284 <td class="entry_notes">
Zhijun Hef5529232013-12-13 17:48:53 -0800[diff] [blame]3285 <html><body><p>High-level 3A control. When set to OFF, all 3A control
3286by the HAL is disabled. The application must set the fields for
3287capture parameters itself.</p>
3288<p>When set to AUTO, the individual algorithm controls in
3289android.control.* are in effect, such as android.control.afMode.</p>
3290<p>When set to USE_SCENE_MODE, the individual controls in
3291android.control.* are mostly disabled, and the HAL implements
3292one of the scene mode settings (such as ACTION, SUNSET, or PARTY)
3293as it wishes. The HAL scene mode 3A settings are provided by
3294android.control.sceneModeOverrides.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3295 </td>
3296
3297 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3298 <ul class="entry_tags">
3299 <li><a href="#tag_BC">BC</a></li>
3300 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3301 </td>
3302
3303 </tr> <!-- end of entry -->
3304
3305
3306
3307 <!-- end of kind -->
3308 </tbody>
3309
3310 <!-- end of section -->
3311 <tr><td colspan="7" id="section_demosaic" class="section">demosaic</td></tr>
3312
3313
3314 <tr><td colspan="7" class="kind">controls</td></tr>
3315
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3316 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3317 <tr>
3318 <th class="th_name">Property Name</th>
3319 <th class="th_type">Type</th>
3320 <th class="th_description">Description</th>
3321 <th class="th_units">Units</th>
3322 <th class="th_range">Range</th>
3323 <th class="th_notes">Notes</th>
3324 <th class="th_tags">Tags</th>
3325 </tr>
3326 </thead>
3327
3328 <tbody>
3329
3330
3331
3332
3333
3334
3335
3336
3337
3338
3339 <tr class="entry" id="controls_android.demosaic.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3340 <td class="entry_name"><html><body><p>android.demosaic.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3341 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3342 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3343
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3344 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3345
3346 <ul class="entry_type_enum">
3347 <li>
3348 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3349 <span class="entry_type_enum_notes"><html><body><p>Minimal or no slowdown of frame rate compared to
3350 Bayer RAW output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3351 </li>
3352 <li>
3353 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3354 <span class="entry_type_enum_notes"><html><body><p>High-quality may reduce output frame
3355 rate<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3356 </li>
3357 </ul>
3358
3359 </td> <!-- entry_type -->
3360
3361 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3362 <html><body><p>Controls the quality of the demosaicing
3363processing<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3364 </td>
3365
3366 <td class="entry_units">
3367 </td>
3368
3369 <td class="entry_range">
3370 </td>
3371
3372 <td class="entry_notes">
3373 </td>
3374
3375 <td class="entry_tags">
3376 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3377 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3378 </ul>
3379 </td>
3380
3381 </tr> <!-- end of entry -->
3382
3383
3384
3385 <!-- end of kind -->
3386 </tbody>
3387
3388 <!-- end of section -->
3389 <tr><td colspan="7" id="section_edge" class="section">edge</td></tr>
3390
3391
3392 <tr><td colspan="7" class="kind">controls</td></tr>
3393
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3394 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3395 <tr>
3396 <th class="th_name">Property Name</th>
3397 <th class="th_type">Type</th>
3398 <th class="th_description">Description</th>
3399 <th class="th_units">Units</th>
3400 <th class="th_range">Range</th>
3401 <th class="th_notes">Notes</th>
3402 <th class="th_tags">Tags</th>
3403 </tr>
3404 </thead>
3405
3406 <tbody>
3407
3408
3409
3410
3411
3412
3413
3414
3415
3416
3417 <tr class="entry" id="controls_android.edge.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3418 <td class="entry_name"><html><body><p>android.edge.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3419 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3420 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3421
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3422 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3423
3424 <ul class="entry_type_enum">
3425 <li>
3426 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3427 <span class="entry_type_enum_notes"><html><body><p>No edge enhancement is applied<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3428 </li>
3429 <li>
3430 <span class="entry_type_enum_name">FAST</span>
Zhijun Heb1c5bab2013-12-16 15:08:14 -0800[diff] [blame]3431 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to sensor
3432 output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3433 </li>
3434 <li>
3435 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3436 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
3437 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3438 </li>
3439 </ul>
3440
3441 </td> <!-- entry_type -->
3442
3443 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3444 <html><body><p>Operation mode for edge
3445enhancement<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3446 </td>
3447
3448 <td class="entry_units">
3449 </td>
3450
3451 <td class="entry_range">
3452 </td>
3453
3454 <td class="entry_notes">
Zhijun Heb1c5bab2013-12-16 15:08:14 -0800[diff] [blame]3455 <html><body><p>Edge/sharpness/detail enhancement. OFF means no
3456enhancement will be applied by the HAL.</p>
3457<p>FAST/HIGH_QUALITY both mean HAL-determined enhancement
3458will be applied. HIGH_QUALITY mode indicates that the
3459HAL should use the highest-quality enhancement algorithms,
3460even if it slows down capture rate. FAST means the HAL should
3461not slow down capture rate when applying edge enhancement.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3462 </td>
3463
3464 <td class="entry_tags">
3465 </td>
3466
3467 </tr> <!-- end of entry -->
3468
3469
3470 <tr class="entry" id="controls_android.edge.strength">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3471 <td class="entry_name"><html><body><p>android.edge.strength<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3472 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3473 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3474
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3475 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3476
3477
3478 </td> <!-- entry_type -->
3479
3480 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3481 <html><body><p>Control the amount of edge enhancement
3482applied to the images<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3483 </td>
3484
3485 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3486 <html><body><p>1-10; 10 is maximum sharpening<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3487 </td>
3488
3489 <td class="entry_range">
3490 </td>
3491
3492 <td class="entry_notes">
3493 </td>
3494
3495 <td class="entry_tags">
3496 </td>
3497
3498 </tr> <!-- end of entry -->
3499
3500
3501
3502 <!-- end of kind -->
3503 </tbody>
3504 <tr><td colspan="7" class="kind">dynamic</td></tr>
3505
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3506 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3507 <tr>
3508 <th class="th_name">Property Name</th>
3509 <th class="th_type">Type</th>
3510 <th class="th_description">Description</th>
3511 <th class="th_units">Units</th>
3512 <th class="th_range">Range</th>
3513 <th class="th_notes">Notes</th>
3514 <th class="th_tags">Tags</th>
3515 </tr>
3516 </thead>
3517
3518 <tbody>
3519
3520
3521
3522
3523
3524
3525
3526
3527
3528
3529 <tr class="entry" id="dynamic_android.edge.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3530 <td class="entry_name"><html><body><p>android.edge.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3531 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3532 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3533
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3534 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3535
3536 <ul class="entry_type_enum">
3537 <li>
3538 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3539 <span class="entry_type_enum_notes"><html><body><p>No edge enhancement is applied<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3540 </li>
3541 <li>
3542 <span class="entry_type_enum_name">FAST</span>
Zhijun Heb1c5bab2013-12-16 15:08:14 -0800[diff] [blame]3543 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to sensor
3544 output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3545 </li>
3546 <li>
3547 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3548 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
3549 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3550 </li>
3551 </ul>
3552
3553 </td> <!-- entry_type -->
3554
3555 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3556 <html><body><p>Operation mode for edge
3557enhancement<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3558 </td>
3559
3560 <td class="entry_units">
3561 </td>
3562
3563 <td class="entry_range">
3564 </td>
3565
3566 <td class="entry_notes">
Zhijun Heb1c5bab2013-12-16 15:08:14 -0800[diff] [blame]3567 <html><body><p>Edge/sharpness/detail enhancement. OFF means no
3568enhancement will be applied by the HAL.</p>
3569<p>FAST/HIGH_QUALITY both mean HAL-determined enhancement
3570will be applied. HIGH_QUALITY mode indicates that the
3571HAL should use the highest-quality enhancement algorithms,
3572even if it slows down capture rate. FAST means the HAL should
3573not slow down capture rate when applying edge enhancement.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3574 </td>
3575
3576 <td class="entry_tags">
3577 </td>
3578
3579 </tr> <!-- end of entry -->
3580
3581
3582
3583 <!-- end of kind -->
3584 </tbody>
3585
3586 <!-- end of section -->
3587 <tr><td colspan="7" id="section_flash" class="section">flash</td></tr>
3588
3589
3590 <tr><td colspan="7" class="kind">controls</td></tr>
3591
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3592 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3593 <tr>
3594 <th class="th_name">Property Name</th>
3595 <th class="th_type">Type</th>
3596 <th class="th_description">Description</th>
3597 <th class="th_units">Units</th>
3598 <th class="th_range">Range</th>
3599 <th class="th_notes">Notes</th>
3600 <th class="th_tags">Tags</th>
3601 </tr>
3602 </thead>
3603
3604 <tbody>
3605
3606
3607
3608
3609
3610
3611
3612
3613
3614
3615 <tr class="entry" id="controls_android.flash.firingPower">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3616 <td class="entry_name"><html><body><p>android.flash.firingPower<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3617 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3618 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3619
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3620 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3621
3622
3623 </td> <!-- entry_type -->
3624
3625 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3626 <html><body><p>Power for flash firing/torch<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3627 </td>
3628
3629 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3630 <html><body><p>10 is max power; 0 is no flash. Linear<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3631 </td>
3632
3633 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3634 <html><body><p>0 - 10<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3635 </td>
3636
3637 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3638 <html><body><p>Power for snapshot may use a different scale than
3639for torch mode. Only one entry for torch mode will be
3640used<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3641 </td>
3642
3643 <td class="entry_tags">
3644 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3645 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3646 </ul>
3647 </td>
3648
3649 </tr> <!-- end of entry -->
3650
3651
3652 <tr class="entry" id="controls_android.flash.firingTime">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3653 <td class="entry_name"><html><body><p>android.flash.firingTime<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3654 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3655 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3656
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3657 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3658
3659
3660 </td> <!-- entry_type -->
3661
3662 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3663 <html><body><p>Firing time of flash relative to start of
3664exposure<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3665 </td>
3666
3667 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3668 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3669 </td>
3670
3671 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3672 <html><body><p>0-(exposure time-flash duration)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3673 </td>
3674
3675 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3676 <html><body><p>Clamped to (0, exposure time - flash
3677duration).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3678 </td>
3679
3680 <td class="entry_tags">
3681 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3682 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3683 </ul>
3684 </td>
3685
3686 </tr> <!-- end of entry -->
3687
3688
3689 <tr class="entry" id="controls_android.flash.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3690 <td class="entry_name"><html><body><p>android.flash.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3691 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3692 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3693
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3694 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3695
3696 <ul class="entry_type_enum">
3697 <li>
3698 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3699 <span class="entry_type_enum_notes"><html><body><p>Do not fire the flash for this
3700 capture<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3701 </li>
3702 <li>
3703 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3704 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Fire flash
3705 for this capture based on firingPower,
3706 firingTime.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3707 </li>
3708 <li>
3709 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3710 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Flash
3711 continuously on, power set by
3712 firingPower<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3713 </li>
3714 </ul>
3715
3716 </td> <!-- entry_type -->
3717
3718 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3719 <html><body><p>Select flash operation mode<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3720 </td>
3721
3722 <td class="entry_units">
3723 </td>
3724
3725 <td class="entry_range">
3726 </td>
3727
3728 <td class="entry_notes">
3729 </td>
3730
3731 <td class="entry_tags">
3732 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3733 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3734 </ul>
3735 </td>
3736
3737 </tr> <!-- end of entry -->
3738
3739
3740
3741 <!-- end of kind -->
3742 </tbody>
3743 <tr><td colspan="7" class="kind">static</td></tr>
3744
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3745 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3746 <tr>
3747 <th class="th_name">Property Name</th>
3748 <th class="th_type">Type</th>
3749 <th class="th_description">Description</th>
3750 <th class="th_units">Units</th>
3751 <th class="th_range">Range</th>
3752 <th class="th_notes">Notes</th>
3753 <th class="th_tags">Tags</th>
3754 </tr>
3755 </thead>
3756
3757 <tbody>
3758
3759
3760
3761
3762
3763
3764
3765
3766
3767
3768
3769
3770 <tr class="entry" id="static_android.flash.info.available">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3771 <td class="entry_name"><html><body><p>android.flash.info.available<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3772 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3773 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3774
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3775 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3776
3777
3778 </td> <!-- entry_type -->
3779
3780 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3781 <html><body><p>Whether this camera has a
3782flash<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3783 </td>
3784
3785 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3786 <html><body><p>boolean (0 = false, otherwise true)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3787 </td>
3788
3789 <td class="entry_range">
3790 </td>
3791
3792 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3793 <html><body><p>If no flash, none of the flash controls do
3794anything. All other metadata should return 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3795 </td>
3796
3797 <td class="entry_tags">
3798 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3799 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3800 </ul>
3801 </td>
3802
3803 </tr> <!-- end of entry -->
3804
3805
3806 <tr class="entry" id="static_android.flash.info.chargeDuration">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3807 <td class="entry_name"><html><body><p>android.flash.info.chargeDuration<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3808 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3809 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3810
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3811 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3812
3813
3814 </td> <!-- entry_type -->
3815
3816 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3817 <html><body><p>Time taken before flash can fire
3818again<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3819 </td>
3820
3821 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3822 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3823 </td>
3824
3825 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3826 <html><body><p>0-1e9<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3827 </td>
3828
3829 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3830 <html><body><p>1 second too long/too short for recharge? Should
3831this be power-dependent?<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3832 </td>
3833
3834 <td class="entry_tags">
3835 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3836 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3837 </ul>
3838 </td>
3839
3840 </tr> <!-- end of entry -->
3841
3842
3843
3844
3845
3846 <tr class="entry" id="static_android.flash.colorTemperature">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3847 <td class="entry_name"><html><body><p>android.flash.colorTemperature<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3848 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3849 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3850
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3851 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3852
3853
3854 </td> <!-- entry_type -->
3855
3856 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3857 <html><body><p>The x,y whitepoint of the
3858flash<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3859 </td>
3860
3861 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3862 <html><body><p>pair of floats<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3863 </td>
3864
3865 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3866 <html><body><p>0-1 for both<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3867 </td>
3868
3869 <td class="entry_notes">
3870 </td>
3871
3872 <td class="entry_tags">
3873 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3874 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3875 </ul>
3876 </td>
3877
3878 </tr> <!-- end of entry -->
3879
3880
3881 <tr class="entry" id="static_android.flash.maxEnergy">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3882 <td class="entry_name"><html><body><p>android.flash.maxEnergy<wbr></wbr></p></body></html></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">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3885
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3886 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3887
3888
3889 </td> <!-- entry_type -->
3890
3891 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3892 <html><body><p>Max energy output of the flash for a full
3893power single flash<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3894 </td>
3895
3896 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3897 <html><body><p>lumen-seconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3898 </td>
3899
3900 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3901 <html><body><p>&gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3902 </td>
3903
3904 <td class="entry_notes">
3905 </td>
3906
3907 <td class="entry_tags">
3908 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3909 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3910 </ul>
3911 </td>
3912
3913 </tr> <!-- end of entry -->
3914
3915
3916
3917 <!-- end of kind -->
3918 </tbody>
3919 <tr><td colspan="7" class="kind">dynamic</td></tr>
3920
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3921 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3922 <tr>
3923 <th class="th_name">Property Name</th>
3924 <th class="th_type">Type</th>
3925 <th class="th_description">Description</th>
3926 <th class="th_units">Units</th>
3927 <th class="th_range">Range</th>
3928 <th class="th_notes">Notes</th>
3929 <th class="th_tags">Tags</th>
3930 </tr>
3931 </thead>
3932
3933 <tbody>
3934
3935
3936
3937
3938
3939
3940
3941
3942
3943
3944 <tr class="entry" id="dynamic_android.flash.firingPower">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3945 <td class="entry_name"><html><body><p>android.flash.firingPower<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3946 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3947 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3948
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3949 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3950
3951
3952 </td> <!-- entry_type -->
3953
3954 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3955 <html><body><p>Power for flash firing/torch<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3956 </td>
3957
3958 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3959 <html><body><p>10 is max power; 0 is no flash. Linear<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3960 </td>
3961
3962 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3963 <html><body><p>0 - 10<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3964 </td>
3965
3966 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3967 <html><body><p>Power for snapshot may use a different scale than
3968for torch mode. Only one entry for torch mode will be
3969used<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3970 </td>
3971
3972 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3973 <ul class="entry_tags">
3974 <li><a href="#tag_V1">V1</a></li>
3975 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3976 </td>
3977
3978 </tr> <!-- end of entry -->
3979
3980
3981 <tr class="entry" id="dynamic_android.flash.firingTime">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3982 <td class="entry_name"><html><body><p>android.flash.firingTime<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3983 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3984 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3985
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3986 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3987
3988
3989 </td> <!-- entry_type -->
3990
3991 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3992 <html><body><p>Firing time of flash relative to start of
3993exposure<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3994 </td>
3995
3996 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3997 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3998 </td>
3999
4000 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4001 <html><body><p>0-(exposure time-flash duration)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4002 </td>
4003
4004 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4005 <html><body><p>Clamped to (0, exposure time - flash
4006duration).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4007 </td>
4008
4009 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4010 <ul class="entry_tags">
4011 <li><a href="#tag_V1">V1</a></li>
4012 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4013 </td>
4014
4015 </tr> <!-- end of entry -->
4016
4017
4018 <tr class="entry" id="dynamic_android.flash.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4019 <td class="entry_name"><html><body><p>android.flash.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4020 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4021 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4022
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4023 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4024
4025 <ul class="entry_type_enum">
4026 <li>
4027 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4028 <span class="entry_type_enum_notes"><html><body><p>Do not fire the flash for this
4029 capture<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4030 </li>
4031 <li>
4032 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4033 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Fire flash
4034 for this capture based on firingPower,
4035 firingTime.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4036 </li>
4037 <li>
4038 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4039 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Flash
4040 continuously on, power set by
4041 firingPower<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4042 </li>
4043 </ul>
4044
4045 </td> <!-- entry_type -->
4046
4047 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4048 <html><body><p>Select flash operation mode<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4049 </td>
4050
4051 <td class="entry_units">
4052 </td>
4053
4054 <td class="entry_range">
4055 </td>
4056
4057 <td class="entry_notes">
4058 </td>
4059
4060 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4061 <ul class="entry_tags">
4062 <li><a href="#tag_BC">BC</a></li>
4063 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4064 </td>
4065
4066 </tr> <!-- end of entry -->
4067
4068
4069 <tr class="entry" id="dynamic_android.flash.state">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4070 <td class="entry_name"><html><body><p>android.flash.state<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4071 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4072 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4073
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4074 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4075
4076 <ul class="entry_type_enum">
4077 <li>
4078 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4079 <span class="entry_type_enum_notes"><html><body><p>No flash on camera<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4080 </li>
4081 <li>
4082 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4083 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Flash is
4084 charging and cannot be fired<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4085 </li>
4086 <li>
4087 <span class="entry_type_enum_name">READY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4088 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Flash is
4089 ready to fire<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4090 </li>
4091 <li>
4092 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4093 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Flash fired
4094 for this capture<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4095 </li>
4096 </ul>
4097
4098 </td> <!-- entry_type -->
4099
4100 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4101 <html><body><p>Current state of the flash
4102unit<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4103 </td>
4104
4105 <td class="entry_units">
4106 </td>
4107
4108 <td class="entry_range">
4109 </td>
4110
4111 <td class="entry_notes">
4112 </td>
4113
4114 <td class="entry_tags">
4115 </td>
4116
4117 </tr> <!-- end of entry -->
4118
4119
4120
4121 <!-- end of kind -->
4122 </tbody>
4123
4124 <!-- end of section -->
4125 <tr><td colspan="7" id="section_geometric" class="section">geometric</td></tr>
4126
4127
4128 <tr><td colspan="7" class="kind">controls</td></tr>
4129
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4130 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4131 <tr>
4132 <th class="th_name">Property Name</th>
4133 <th class="th_type">Type</th>
4134 <th class="th_description">Description</th>
4135 <th class="th_units">Units</th>
4136 <th class="th_range">Range</th>
4137 <th class="th_notes">Notes</th>
4138 <th class="th_tags">Tags</th>
4139 </tr>
4140 </thead>
4141
4142 <tbody>
4143
4144
4145
4146
4147
4148
4149
4150
4151
4152
4153 <tr class="entry" id="controls_android.geometric.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4154 <td class="entry_name"><html><body><p>android.geometric.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4155 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4156 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4157
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4158 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4159
4160 <ul class="entry_type_enum">
4161 <li>
4162 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4163 <span class="entry_type_enum_notes"><html><body><p>No geometric correction is
4164 applied<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4165 </li>
4166 <li>
4167 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4168 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
4169 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4170 </li>
4171 <li>
4172 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4173 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
4174 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4175 </li>
4176 </ul>
4177
4178 </td> <!-- entry_type -->
4179
4180 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4181 <html><body><p>Operating mode of geometric
4182correction<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4183 </td>
4184
4185 <td class="entry_units">
4186 </td>
4187
4188 <td class="entry_range">
4189 </td>
4190
4191 <td class="entry_notes">
4192 </td>
4193
4194 <td class="entry_tags">
4195 </td>
4196
4197 </tr> <!-- end of entry -->
4198
4199
4200 <tr class="entry" id="controls_android.geometric.strength">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4201 <td class="entry_name"><html><body><p>android.geometric.strength<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4202 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4203 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4204
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4205 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4206
4207
4208 </td> <!-- entry_type -->
4209
4210 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4211 <html><body><p>Control the amount of shading correction
4212applied to the images<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4213 </td>
4214
4215 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4216 <html><body><p>unitless: 1-10; 10 is full shading
4217 compensation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4218 </td>
4219
4220 <td class="entry_range">
4221 </td>
4222
4223 <td class="entry_notes">
4224 </td>
4225
4226 <td class="entry_tags">
4227 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4228 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4229 </ul>
4230 </td>
4231
4232 </tr> <!-- end of entry -->
4233
4234
4235
4236 <!-- end of kind -->
4237 </tbody>
4238
4239 <!-- end of section -->
4240 <tr><td colspan="7" id="section_hotPixel" class="section">hotPixel</td></tr>
4241
4242
4243 <tr><td colspan="7" class="kind">controls</td></tr>
4244
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4245 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4246 <tr>
4247 <th class="th_name">Property Name</th>
4248 <th class="th_type">Type</th>
4249 <th class="th_description">Description</th>
4250 <th class="th_units">Units</th>
4251 <th class="th_range">Range</th>
4252 <th class="th_notes">Notes</th>
4253 <th class="th_tags">Tags</th>
4254 </tr>
4255 </thead>
4256
4257 <tbody>
4258
4259
4260
4261
4262
4263
4264
4265
4266
4267
4268 <tr class="entry" id="controls_android.hotPixel.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4269 <td class="entry_name"><html><body><p>android.hotPixel.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4270 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4271 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4272
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4273 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4274
4275 <ul class="entry_type_enum">
4276 <li>
4277 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4278 <span class="entry_type_enum_notes"><html><body><p>No hot pixel correction can be
4279 applied<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4280 </li>
4281 <li>
4282 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4283 <span class="entry_type_enum_notes"><html><body><p>Frame rate must not be reduced compared to raw
4284 Bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4285 </li>
4286 <li>
4287 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4288 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
4289 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4290 </li>
4291 </ul>
4292
4293 </td> <!-- entry_type -->
4294
4295 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4296 <html><body><p>Set operational mode for hot pixel
4297correction<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4298 </td>
4299
4300 <td class="entry_units">
4301 </td>
4302
4303 <td class="entry_range">
4304 </td>
4305
4306 <td class="entry_notes">
4307 </td>
4308
4309 <td class="entry_tags">
4310 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4311 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4312 </ul>
4313 </td>
4314
4315 </tr> <!-- end of entry -->
4316
4317
4318
4319 <!-- end of kind -->
4320 </tbody>
4321 <tr><td colspan="7" class="kind">static</td></tr>
4322
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4323 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4324 <tr>
4325 <th class="th_name">Property Name</th>
4326 <th class="th_type">Type</th>
4327 <th class="th_description">Description</th>
4328 <th class="th_units">Units</th>
4329 <th class="th_range">Range</th>
4330 <th class="th_notes">Notes</th>
4331 <th class="th_tags">Tags</th>
4332 </tr>
4333 </thead>
4334
4335 <tbody>
4336
4337
4338
4339
4340
4341
4342
4343
4344
4345
4346
4347
4348 <tr class="entry" id="static_android.hotPixel.info.map">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4349 <td class="entry_name"><html><body><p>android.hotPixel.info.map<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4350 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4351 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4352 <span class="entry_type_container">x</span>
4353
4354 <span class="entry_type_array">
4355 2 x n
4356 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4357 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4358 <div class="entry_type_notes"><html><body><p>list of coordinates based on android.sensor.pixelArraySize<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4359
4360
4361 </td> <!-- entry_type -->
4362
4363 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4364 <html><body><p>Location of hot/defective pixels on
4365sensor<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4366 </td>
4367
4368 <td class="entry_units">
4369 </td>
4370
4371 <td class="entry_range">
4372 </td>
4373
4374 <td class="entry_notes">
4375 </td>
4376
4377 <td class="entry_tags">
4378 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4379 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4380 </ul>
4381 </td>
4382
4383 </tr> <!-- end of entry -->
4384
4385
4386
4387
4388
4389
4390 <!-- end of kind -->
4391 </tbody>
4392 <tr><td colspan="7" class="kind">dynamic</td></tr>
4393
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4394 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4395 <tr>
4396 <th class="th_name">Property Name</th>
4397 <th class="th_type">Type</th>
4398 <th class="th_description">Description</th>
4399 <th class="th_units">Units</th>
4400 <th class="th_range">Range</th>
4401 <th class="th_notes">Notes</th>
4402 <th class="th_tags">Tags</th>
4403 </tr>
4404 </thead>
4405
4406 <tbody>
4407
4408
4409
4410
4411
4412
4413
4414
4415
4416
4417 <tr class="entry" id="dynamic_android.hotPixel.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4418 <td class="entry_name"><html><body><p>android.hotPixel.mode<wbr></wbr></p></body></html></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 entry_type_name_enum">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 <ul class="entry_type_enum">
4425 <li>
4426 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4427 <span class="entry_type_enum_notes"><html><body><p>No hot pixel correction can be
4428 applied<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4429 </li>
4430 <li>
4431 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4432 <span class="entry_type_enum_notes"><html><body><p>Frame rate must not be reduced compared to raw
4433 Bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4434 </li>
4435 <li>
4436 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4437 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
4438 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4439 </li>
4440 </ul>
4441
4442 </td> <!-- entry_type -->
4443
4444 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4445 <html><body><p>Set operational mode for hot pixel
4446correction<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4447 </td>
4448
4449 <td class="entry_units">
4450 </td>
4451
4452 <td class="entry_range">
4453 </td>
4454
4455 <td class="entry_notes">
4456 </td>
4457
4458 <td class="entry_tags">
4459 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4460 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4461 </ul>
4462 </td>
4463
4464 </tr> <!-- end of entry -->
4465
4466
4467
4468 <!-- end of kind -->
4469 </tbody>
4470
4471 <!-- end of section -->
4472 <tr><td colspan="7" id="section_jpeg" class="section">jpeg</td></tr>
4473
4474
4475 <tr><td colspan="7" class="kind">controls</td></tr>
4476
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4477 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4478 <tr>
4479 <th class="th_name">Property Name</th>
4480 <th class="th_type">Type</th>
4481 <th class="th_description">Description</th>
4482 <th class="th_units">Units</th>
4483 <th class="th_range">Range</th>
4484 <th class="th_notes">Notes</th>
4485 <th class="th_tags">Tags</th>
4486 </tr>
4487 </thead>
4488
4489 <tbody>
4490
4491
4492
4493
4494
4495
4496
4497
4498
4499
4500 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4501 <td class="entry_name"><html><body><p>android.jpeg.gpsCoordinates<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4502 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4503 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4504 <span class="entry_type_container">x</span>
4505
4506 <span class="entry_type_array">
4507 3
4508 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4509 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4510 <div class="entry_type_notes"><html><body><p>latitude, longitude, altitude. First two in degrees, the third in meters<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4511
4512
4513 </td> <!-- entry_type -->
4514
4515 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4516 <html><body><p>GPS coordinates to include in output JPEG
4517EXIF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4518 </td>
4519
4520 <td class="entry_units">
4521 </td>
4522
4523 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4524 <html><body><p>(-180 - 180], [-90,90], [-inf, inf]<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4525 </td>
4526
4527 <td class="entry_notes">
4528 </td>
4529
4530 <td class="entry_tags">
4531 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4532 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4533 </ul>
4534 </td>
4535
4536 </tr> <!-- end of entry -->
4537
4538
4539 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4540 <td class="entry_name"><html><body><p>android.jpeg.gpsProcessingMethod<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4541 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4542 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4543
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]4544 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4545
4546
4547 </td> <!-- entry_type -->
4548
4549 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4550 <html><body><p>32 characters describing GPS algorithm to
4551include in EXIF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4552 </td>
4553
4554 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4555 <html><body><p>UTF-8 null-terminated string<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4556 </td>
4557
4558 <td class="entry_range">
4559 </td>
4560
4561 <td class="entry_notes">
4562 </td>
4563
4564 <td class="entry_tags">
4565 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4566 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4567 </ul>
4568 </td>
4569
4570 </tr> <!-- end of entry -->
4571
4572
4573 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4574 <td class="entry_name"><html><body><p>android.jpeg.gpsTimestamp<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4575 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4576 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4577
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4578 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4579
4580
4581 </td> <!-- entry_type -->
4582
4583 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4584 <html><body><p>Time GPS fix was made to include in
4585EXIF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4586 </td>
4587
4588 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4589 <html><body><p>UTC in seconds since January 1, 1970<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4590 </td>
4591
4592 <td class="entry_range">
4593 </td>
4594
4595 <td class="entry_notes">
4596 </td>
4597
4598 <td class="entry_tags">
4599 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4600 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4601 </ul>
4602 </td>
4603
4604 </tr> <!-- end of entry -->
4605
4606
4607 <tr class="entry" id="controls_android.jpeg.orientation">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4608 <td class="entry_name"><html><body><p>android.jpeg.orientation<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4609 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4610 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4611
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4612 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4613
4614
4615 </td> <!-- entry_type -->
4616
4617 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4618 <html><body><p>Orientation of JPEG image to
4619write<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4620 </td>
4621
4622 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4623 <html><body><p>Degrees in multiples of 90<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4624 </td>
4625
4626 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4627 <html><body><p>0, 90, 180, 270<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4628 </td>
4629
4630 <td class="entry_notes">
4631 </td>
4632
4633 <td class="entry_tags">
4634 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4635 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4636 </ul>
4637 </td>
4638
4639 </tr> <!-- end of entry -->
4640
4641
4642 <tr class="entry" id="controls_android.jpeg.quality">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4643 <td class="entry_name"><html><body><p>android.jpeg.quality<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4644 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4645 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4646
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4647 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4648
4649
4650 </td> <!-- entry_type -->
4651
4652 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4653 <html><body><p>Compression quality of the final JPEG
4654image<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4655 </td>
4656
4657 <td class="entry_units">
4658 </td>
4659
4660 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4661 <html><body><p>1-100; larger is higher quality<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4662 </td>
4663
4664 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4665 <html><body><p>85-95 is typical usage range<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4666 </td>
4667
4668 <td class="entry_tags">
4669 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4670 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4671 </ul>
4672 </td>
4673
4674 </tr> <!-- end of entry -->
4675
4676
4677 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4678 <td class="entry_name"><html><body><p>android.jpeg.thumbnailQuality<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4679 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4680 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4681
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4682 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4683
4684
4685 </td> <!-- entry_type -->
4686
4687 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4688 <html><body><p>Compression quality of JPEG
4689thumbnail<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4690 </td>
4691
4692 <td class="entry_units">
4693 </td>
4694
4695 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4696 <html><body><p>1-100; larger is higher quality<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4697 </td>
4698
4699 <td class="entry_notes">
4700 </td>
4701
4702 <td class="entry_tags">
4703 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4704 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4705 </ul>
4706 </td>
4707
4708 </tr> <!-- end of entry -->
4709
4710
4711 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4712 <td class="entry_name"><html><body><p>android.jpeg.thumbnailSize<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4713 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4714 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4715 <span class="entry_type_container">x</span>
4716
4717 <span class="entry_type_array">
4718 2
4719 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]4720 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4721
4722
4723 </td> <!-- entry_type -->
4724
4725 <td class="entry_description">
Zhijun He52e09552013-12-11 17:03:24 -0800[diff] [blame^]4726 <html><body><p>Resolution of embedded JPEG thumbnail<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4727 </td>
4728
4729 <td class="entry_units">
4730 </td>
4731
4732 <td class="entry_range">
Zhijun He52e09552013-12-11 17:03:24 -0800[diff] [blame^]4733 <html><body><p>Size must be one of the size from android.jpeg.availableThumbnailSizes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4734 </td>
4735
4736 <td class="entry_notes">
Zhijun He52e09552013-12-11 17:03:24 -0800[diff] [blame^]4737 <html><body><p>When set to (0, 0) value, the JPEG EXIF must not contain thumbnail,
4738but the captured JPEG must still be a valid image.</p>
4739<p>When a jpeg image capture is issued, the thumbnail size selected should have
4740the same aspect ratio as the jpeg image.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4741 </td>
4742
4743 <td class="entry_tags">
4744 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4745 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4746 </ul>
4747 </td>
4748
4749 </tr> <!-- end of entry -->
4750
4751
4752
4753 <!-- end of kind -->
4754 </tbody>
4755 <tr><td colspan="7" class="kind">static</td></tr>
4756
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4757 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4758 <tr>
4759 <th class="th_name">Property Name</th>
4760 <th class="th_type">Type</th>
4761 <th class="th_description">Description</th>
4762 <th class="th_units">Units</th>
4763 <th class="th_range">Range</th>
4764 <th class="th_notes">Notes</th>
4765 <th class="th_tags">Tags</th>
4766 </tr>
4767 </thead>
4768
4769 <tbody>
4770
4771
4772
4773
4774
4775
4776
4777
4778
4779
4780 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4781 <td class="entry_name"><html><body><p>android.jpeg.availableThumbnailSizes<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4782 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4783 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4784 <span class="entry_type_container">x</span>
4785
4786 <span class="entry_type_array">
4787 2 x n
4788 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]4789 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4790
4791
4792 </td> <!-- entry_type -->
4793
4794 <td class="entry_description">
Zhijun He52e09552013-12-11 17:03:24 -0800[diff] [blame^]4795 <html><body><p>Supported resolutions for the JPEG thumbnail<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4796 </td>
4797
4798 <td class="entry_units">
4799 </td>
4800
4801 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4802 <html><body><p>Must include at least one valid resolution, plus
Zhijun He52e09552013-12-11 17:03:24 -0800[diff] [blame^]4803 (0,0) for no thumbnail generation, and each size must be distinct.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4804 </td>
4805
4806 <td class="entry_notes">
Zhijun He52e09552013-12-11 17:03:24 -0800[diff] [blame^]4807 <html><body><p>Below condiditions must be satisfied for this size list:</p>
4808<ul>
4809<li>The sizes must be sorted by increasing pixel area (width x height).
4810If several resolutions have the same area, they must be sorted by increasing width.</li>
4811<li>The aspect ratio of the largest thumbnail size must be same as the
4812aspect ratio of largest size in android.scaler.availableJpegSizes.
4813The largest size is defined as the size that has the largest pixel area
4814in a given size list.</li>
4815<li>Each size in android.scaler.availableJpegSizes must have at least
4816one corresponding size that has the same aspect ratio in availableThumbnailSizes,
4817and vice versa.</li>
4818<li>All non (0, 0) sizes must have non-zero widths and heights.</li>
4819<wbr></wbr></ul></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4820 </td>
4821
4822 <td class="entry_tags">
4823 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4824 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4825 </ul>
4826 </td>
4827
4828 </tr> <!-- end of entry -->
4829
4830
4831 <tr class="entry" id="static_android.jpeg.maxSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4832 <td class="entry_name"><html><body><p>android.jpeg.maxSize<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4833 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4834 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4835
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4836 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4837
4838
4839 </td> <!-- entry_type -->
4840
4841 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4842 <html><body><p>Maximum size in bytes for the compressed
4843JPEG buffer<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4844 </td>
4845
4846 <td class="entry_units">
4847 </td>
4848
4849 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4850 <html><body><p>Must be large enough to fit any JPEG produced by
4851 the camera<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4852 </td>
4853
4854 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4855 <html><body><p>This is used for sizing the gralloc buffers for
4856JPEG<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4857 </td>
4858
4859 <td class="entry_tags">
4860 </td>
4861
4862 </tr> <!-- end of entry -->
4863
4864
4865
4866 <!-- end of kind -->
4867 </tbody>
4868 <tr><td colspan="7" class="kind">dynamic</td></tr>
4869
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4870 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4871 <tr>
4872 <th class="th_name">Property Name</th>
4873 <th class="th_type">Type</th>
4874 <th class="th_description">Description</th>
4875 <th class="th_units">Units</th>
4876 <th class="th_range">Range</th>
4877 <th class="th_notes">Notes</th>
4878 <th class="th_tags">Tags</th>
4879 </tr>
4880 </thead>
4881
4882 <tbody>
4883
4884
4885
4886
4887
4888
4889
4890
4891
4892
4893 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4894 <td class="entry_name"><html><body><p>android.jpeg.gpsCoordinates<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4895 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4896 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4897 <span class="entry_type_container">x</span>
4898
4899 <span class="entry_type_array">
4900 3
4901 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4902 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4903 <div class="entry_type_notes"><html><body><p>latitude, longitude, altitude. First two in degrees, the third in meters<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4904
4905
4906 </td> <!-- entry_type -->
4907
4908 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4909 <html><body><p>GPS coordinates to include in output JPEG
4910EXIF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4911 </td>
4912
4913 <td class="entry_units">
4914 </td>
4915
4916 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4917 <html><body><p>(-180 - 180], [-90,90], [-inf, inf]<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4918 </td>
4919
4920 <td class="entry_notes">
4921 </td>
4922
4923 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4924 <ul class="entry_tags">
4925 <li><a href="#tag_BC">BC</a></li>
4926 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4927 </td>
4928
4929 </tr> <!-- end of entry -->
4930
4931
4932 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4933 <td class="entry_name"><html><body><p>android.jpeg.gpsProcessingMethod<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4934 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4935 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4936
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]4937 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4938
4939
4940 </td> <!-- entry_type -->
4941
4942 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4943 <html><body><p>32 characters describing GPS algorithm to
4944include in EXIF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4945 </td>
4946
4947 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4948 <html><body><p>UTF-8 null-terminated string<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4949 </td>
4950
4951 <td class="entry_range">
4952 </td>
4953
4954 <td class="entry_notes">
4955 </td>
4956
4957 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4958 <ul class="entry_tags">
4959 <li><a href="#tag_BC">BC</a></li>
4960 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4961 </td>
4962
4963 </tr> <!-- end of entry -->
4964
4965
4966 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4967 <td class="entry_name"><html><body><p>android.jpeg.gpsTimestamp<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4968 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4969 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4970
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4971 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4972
4973
4974 </td> <!-- entry_type -->
4975
4976 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4977 <html><body><p>Time GPS fix was made to include in
4978EXIF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4979 </td>
4980
4981 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4982 <html><body><p>UTC in seconds since January 1, 1970<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4983 </td>
4984
4985 <td class="entry_range">
4986 </td>
4987
4988 <td class="entry_notes">
4989 </td>
4990
4991 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4992 <ul class="entry_tags">
4993 <li><a href="#tag_BC">BC</a></li>
4994 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4995 </td>
4996
4997 </tr> <!-- end of entry -->
4998
4999
5000 <tr class="entry" id="dynamic_android.jpeg.orientation">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5001 <td class="entry_name"><html><body><p>android.jpeg.orientation<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5002 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5003 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5004
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5005 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5006
5007
5008 </td> <!-- entry_type -->
5009
5010 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5011 <html><body><p>Orientation of JPEG image to
5012write<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5013 </td>
5014
5015 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5016 <html><body><p>Degrees in multiples of 90<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5017 </td>
5018
5019 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5020 <html><body><p>0, 90, 180, 270<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5021 </td>
5022
5023 <td class="entry_notes">
5024 </td>
5025
5026 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5027 <ul class="entry_tags">
5028 <li><a href="#tag_BC">BC</a></li>
5029 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5030 </td>
5031
5032 </tr> <!-- end of entry -->
5033
5034
5035 <tr class="entry" id="dynamic_android.jpeg.quality">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5036 <td class="entry_name"><html><body><p>android.jpeg.quality<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5037 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5038 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5039
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5040 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5041
5042
5043 </td> <!-- entry_type -->
5044
5045 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5046 <html><body><p>Compression quality of the final JPEG
5047image<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5048 </td>
5049
5050 <td class="entry_units">
5051 </td>
5052
5053 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5054 <html><body><p>1-100; larger is higher quality<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5055 </td>
5056
5057 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5058 <html><body><p>85-95 is typical usage range<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5059 </td>
5060
5061 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5062 <ul class="entry_tags">
5063 <li><a href="#tag_BC">BC</a></li>
5064 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5065 </td>
5066
5067 </tr> <!-- end of entry -->
5068
5069
5070 <tr class="entry" id="dynamic_android.jpeg.size">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5071 <td class="entry_name"><html><body><p>android.jpeg.size<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5072 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5073 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5074
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5075 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5076
5077
5078 </td> <!-- entry_type -->
5079
5080 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5081 <html><body><p>The size of the compressed JPEG image, in
5082bytes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5083 </td>
5084
5085 <td class="entry_units">
5086 </td>
5087
5088 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5089 <html><body><p>&gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5090 </td>
5091
5092 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5093 <html><body><p>If no JPEG output is produced for the request,
5094this must be 0.</p>
5095<p>Otherwise, this describes the real size of the compressed
5096JPEG image placed in the output stream. More specifically,
5097if android.jpeg.maxSize = 1000000, and a specific capture
5098has android.jpeg.size = 500000, then the output buffer from
5099the JPEG stream will be 1000000 bytes, of which the first
5100500000 make up the real data.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5101 </td>
5102
5103 <td class="entry_tags">
5104 </td>
5105
5106 </tr> <!-- end of entry -->
5107
5108
5109 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5110 <td class="entry_name"><html><body><p>android.jpeg.thumbnailQuality<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5111 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5112 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5113
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5114 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5115
5116
5117 </td> <!-- entry_type -->
5118
5119 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5120 <html><body><p>Compression quality of JPEG
5121thumbnail<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5122 </td>
5123
5124 <td class="entry_units">
5125 </td>
5126
5127 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5128 <html><body><p>1-100; larger is higher quality<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5129 </td>
5130
5131 <td class="entry_notes">
5132 </td>
5133
5134 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5135 <ul class="entry_tags">
5136 <li><a href="#tag_BC">BC</a></li>
5137 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5138 </td>
5139
5140 </tr> <!-- end of entry -->
5141
5142
5143 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5144 <td class="entry_name"><html><body><p>android.jpeg.thumbnailSize<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5145 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5146 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5147 <span class="entry_type_container">x</span>
5148
5149 <span class="entry_type_array">
5150 2
5151 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5152 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5153
5154
5155 </td> <!-- entry_type -->
5156
5157 <td class="entry_description">
Zhijun He52e09552013-12-11 17:03:24 -0800[diff] [blame^]5158 <html><body><p>Resolution of embedded JPEG thumbnail<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5159 </td>
5160
5161 <td class="entry_units">
5162 </td>
5163
5164 <td class="entry_range">
Zhijun He52e09552013-12-11 17:03:24 -0800[diff] [blame^]5165 <html><body><p>Size must be one of the size from android.jpeg.availableThumbnailSizes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5166 </td>
5167
5168 <td class="entry_notes">
Zhijun He52e09552013-12-11 17:03:24 -0800[diff] [blame^]5169 <html><body><p>When set to (0, 0) value, the JPEG EXIF must not contain thumbnail,
5170but the captured JPEG must still be a valid image.</p>
5171<p>When a jpeg image capture is issued, the thumbnail size selected should have
5172the same aspect ratio as the jpeg image.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5173 </td>
5174
5175 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5176 <ul class="entry_tags">
5177 <li><a href="#tag_BC">BC</a></li>
5178 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5179 </td>
5180
5181 </tr> <!-- end of entry -->
5182
5183
5184
5185 <!-- end of kind -->
5186 </tbody>
5187
5188 <!-- end of section -->
5189 <tr><td colspan="7" id="section_lens" class="section">lens</td></tr>
5190
5191
5192 <tr><td colspan="7" class="kind">controls</td></tr>
5193
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5194 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5195 <tr>
5196 <th class="th_name">Property Name</th>
5197 <th class="th_type">Type</th>
5198 <th class="th_description">Description</th>
5199 <th class="th_units">Units</th>
5200 <th class="th_range">Range</th>
5201 <th class="th_notes">Notes</th>
5202 <th class="th_tags">Tags</th>
5203 </tr>
5204 </thead>
5205
5206 <tbody>
5207
5208
5209
5210
5211
5212
5213
5214
5215
5216
5217 <tr class="entry" id="controls_android.lens.aperture">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5218 <td class="entry_name"><html><body><p>android.lens.aperture<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5219 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5220 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5221
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5222 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5223
5224
5225 </td> <!-- entry_type -->
5226
5227 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5228 <html><body><p>Size of the lens aperture<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5229 </td>
5230
5231 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5232 <html><body><p>f-number (f/NNN)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5233 </td>
5234
5235 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5236 <html><body><p>android.lens.info.availableApertures<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5237 </td>
5238
5239 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5240 <html><body><p>Will not be supported on most devices. Can only
5241pick from supported list<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5242 </td>
5243
5244 <td class="entry_tags">
5245 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5246 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5247 </ul>
5248 </td>
5249
5250 </tr> <!-- end of entry -->
5251
5252
5253 <tr class="entry" id="controls_android.lens.filterDensity">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5254 <td class="entry_name"><html><body><p>android.lens.filterDensity<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5255 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5256 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5257
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5258 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5259
5260
5261 </td> <!-- entry_type -->
5262
5263 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5264 <html><body><p>State of lens neutral density
5265filter(s)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5266 </td>
5267
5268 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5269 <html><body><p>number of stops of filtering<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5270 </td>
5271
5272 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5273 <html><body><p>android.lens.info.availableFilterDensities<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5274 </td>
5275
5276 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5277 <html><body><p>Will not be supported on most devices. Can only
5278pick from supported list<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5279 </td>
5280
5281 <td class="entry_tags">
5282 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5283 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5284 </ul>
5285 </td>
5286
5287 </tr> <!-- end of entry -->
5288
5289
5290 <tr class="entry" id="controls_android.lens.focalLength">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5291 <td class="entry_name"><html><body><p>android.lens.focalLength<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5292 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5293 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5294
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5295 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5296
5297
5298 </td> <!-- entry_type -->
5299
5300 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5301 <html><body><p>Lens optical zoom setting<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5302 </td>
5303
5304 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5305 <html><body><p>focal length in mm<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5306 </td>
5307
5308 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5309 <html><body><p>&gt; 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5310 </td>
5311
5312 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5313 <html><body><p>Will not be supported on most devices.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5314 </td>
5315
5316 <td class="entry_tags">
5317 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5318 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5319 </ul>
5320 </td>
5321
5322 </tr> <!-- end of entry -->
5323
5324
5325 <tr class="entry" id="controls_android.lens.focusDistance">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5326 <td class="entry_name"><html><body><p>android.lens.focusDistance<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5327 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5328 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5329
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5330 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5331
5332
5333 </td> <!-- entry_type -->
5334
5335 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5336 <html><body><p>Distance to plane of sharpest focus,
5337measured from frontmost surface of the lens<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5338 </td>
5339
5340 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5341 <html><body><p>diopters (1/m)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5342 </td>
5343
5344 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5345 <html><body><p>&gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5346 </td>
5347
5348 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5349 <html><body><p>0 = infinity focus. Used value should be clamped
5350to (0,minimum focus distance)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5351 </td>
5352
5353 <td class="entry_tags">
5354 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5355 <li><a href="#tag_BC">BC</a></li>
5356 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5357 </ul>
5358 </td>
5359
5360 </tr> <!-- end of entry -->
5361
5362
5363 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5364 <td class="entry_name"><html><body><p>android.lens.opticalStabilizationMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5365 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5366 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5367
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5368 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5369
5370 <ul class="entry_type_enum">
5371 <li>
5372 <span class="entry_type_enum_name">OFF</span>
5373 </li>
5374 <li>
5375 <span class="entry_type_enum_name">ON</span>
5376 <span class="entry_type_enum_optional">optional</span>
5377 </li>
5378 </ul>
5379
5380 </td> <!-- entry_type -->
5381
5382 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5383 <html><body><p>Whether optical image stabilization is
5384enabled.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5385 </td>
5386
5387 <td class="entry_units">
5388 </td>
5389
5390 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5391 <html><body><p>android.lens.availableOpticalStabilization<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5392 </td>
5393
5394 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5395 <html><body><p>Will not be supported on most devices.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5396 </td>
5397
5398 <td class="entry_tags">
5399 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5400 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5401 </ul>
5402 </td>
5403
5404 </tr> <!-- end of entry -->
5405
5406
5407
5408 <!-- end of kind -->
5409 </tbody>
5410 <tr><td colspan="7" class="kind">static</td></tr>
5411
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5412 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5413 <tr>
5414 <th class="th_name">Property Name</th>
5415 <th class="th_type">Type</th>
5416 <th class="th_description">Description</th>
5417 <th class="th_units">Units</th>
5418 <th class="th_range">Range</th>
5419 <th class="th_notes">Notes</th>
5420 <th class="th_tags">Tags</th>
5421 </tr>
5422 </thead>
5423
5424 <tbody>
5425
5426
5427
5428
5429
5430
5431
5432
5433
5434
5435
5436
5437 <tr class="entry" id="static_android.lens.info.availableApertures">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5438 <td class="entry_name"><html><body><p>android.lens.info.availableApertures<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5439 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5440 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5441 <span class="entry_type_container">x</span>
5442
5443 <span class="entry_type_array">
5444 n
5445 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5446 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5447
5448
5449 </td> <!-- entry_type -->
5450
5451 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5452 <html><body><p>List of supported aperture
5453values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5454 </td>
5455
5456 <td class="entry_units">
5457 </td>
5458
5459 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5460 <html><body><p>one entry required, &gt; 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5461 </td>
5462
5463 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5464 <html><body><p>If variable aperture not available, only setting
5465should be for the fixed aperture<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5466 </td>
5467
5468 <td class="entry_tags">
5469 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5470 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5471 </ul>
5472 </td>
5473
5474 </tr> <!-- end of entry -->
5475
5476
5477 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5478 <td class="entry_name"><html><body><p>android.lens.info.availableFilterDensities<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5479 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5480 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5481 <span class="entry_type_container">x</span>
5482
5483 <span class="entry_type_array">
5484 n
5485 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5486 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5487
5488
5489 </td> <!-- entry_type -->
5490
5491 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5492 <html><body><p>List of supported ND filter
5493values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5494 </td>
5495
5496 <td class="entry_units">
5497 </td>
5498
5499 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5500 <html><body><p>one entry required, &gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5501 </td>
5502
5503 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5504 <html><body><p>If not available, only setting is 0. Otherwise,
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]5505lists the available exposure index values for dimming
5506(2 would mean the filter is set to reduce incoming
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5507light by two stops)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5508 </td>
5509
5510 <td class="entry_tags">
5511 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5512 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5513 </ul>
5514 </td>
5515
5516 </tr> <!-- end of entry -->
5517
5518
5519 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5520 <td class="entry_name"><html><body><p>android.lens.info.availableFocalLengths<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5521 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5522 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5523 <span class="entry_type_container">x</span>
5524
5525 <span class="entry_type_array">
5526 n
5527 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5528 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5529 <div class="entry_type_notes"><html><body><p>the list of available focal lengths<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5530
5531
5532 </td> <!-- entry_type -->
5533
5534 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5535 <html><body><p>If fitted with optical zoom, what focal
5536lengths are available. If not, the static focal
5537length<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5538 </td>
5539
5540 <td class="entry_units">
5541 </td>
5542
5543 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5544 <html><body><p>&gt; 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5545 </td>
5546
5547 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5548 <html><body><p>If optical zoom not supported, only one value
5549should be reported<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5550 </td>
5551
5552 <td class="entry_tags">
5553 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5554 <li><a href="#tag_BC">BC</a></li>
5555 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5556 </ul>
5557 </td>
5558
5559 </tr> <!-- end of entry -->
5560
5561
5562 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5563 <td class="entry_name"><html><body><p>android.lens.info.availableOpticalStabilization<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5564 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5565 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5566 <span class="entry_type_container">x</span>
5567
5568 <span class="entry_type_array">
5569 n
5570 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5571 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5572 <div class="entry_type_notes"><html><body><p>list of enums<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5573
5574
5575 </td> <!-- entry_type -->
5576
5577 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5578 <html><body><p>List of supported optical image
5579stabilization modes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5580 </td>
5581
5582 <td class="entry_units">
5583 </td>
5584
5585 <td class="entry_range">
5586 </td>
5587
5588 <td class="entry_notes">
5589 </td>
5590
5591 <td class="entry_tags">
5592 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5593 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5594 </ul>
5595 </td>
5596
5597 </tr> <!-- end of entry -->
5598
5599
5600 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5601 <td class="entry_name"><html><body><p>android.lens.info.geometricCorrectionMap<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5602 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5603 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5604 <span class="entry_type_container">x</span>
5605
5606 <span class="entry_type_array">
5607 2 x 3 x n x m
5608 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5609 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5610 <div class="entry_type_notes"><html><body><p>2D array of destination coordinate pairs for uniform grid points in source image, per color channel. Size in the range of 2x3x40x30<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5611
5612
5613 </td> <!-- entry_type -->
5614
5615 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5616 <html><body><p>A low-resolution map for correction of
5617geometric distortions and chromatic aberrations, per
5618color channel<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5619 </td>
5620
5621 <td class="entry_units">
5622 </td>
5623
5624 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5625 <html><body><p>N, M &gt;= 2<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5626 </td>
5627
5628 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5629 <html><body><p>[DNG wants a function instead]. What's easiest
5630for implementers? With an array size (M, N), entry (i,
5631j) provides the destination for pixel (i/(M-1) * width,
5632j/(N-1) * height). Data is row-major, with each array
5633entry being ( (X, Y)_r, (X, Y)_g, (X, Y)_b ) )<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5634 </td>
5635
5636 <td class="entry_tags">
5637 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5638 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5639 </ul>
5640 </td>
5641
5642 </tr> <!-- end of entry -->
5643
5644
5645 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5646 <td class="entry_name"><html><body><p>android.lens.info.geometricCorrectionMapSize<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5647 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5648 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5649 <span class="entry_type_container">x</span>
5650
5651 <span class="entry_type_array">
5652 2
5653 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5654 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5655 <div class="entry_type_notes"><html><body><p>width and height of geometric correction map<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5656
5657
5658 </td> <!-- entry_type -->
5659
5660 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5661 <html><body><p>Dimensions of geometric correction
5662map<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5663 </td>
5664
5665 <td class="entry_units">
5666 </td>
5667
5668 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5669 <html><body><p>Both values &gt;= 2<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5670 </td>
5671
5672 <td class="entry_notes">
5673 </td>
5674
5675 <td class="entry_tags">
5676 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5677 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5678 </ul>
5679 </td>
5680
5681 </tr> <!-- end of entry -->
5682
5683
5684 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5685 <td class="entry_name"><html><body><p>android.lens.info.hyperfocalDistance<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5686 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5687 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5688
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5689 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5690
5691
5692 </td> <!-- entry_type -->
5693
5694 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5695 <html><body><p>Hyperfocal distance for this lens; set to
56960 if fixed focus<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5697 </td>
5698
5699 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5700 <html><body><p>diopters<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5701 </td>
5702
5703 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5704 <html><body><p>&gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5705 </td>
5706
5707 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5708 <html><body><p>The hyperfocal distance is used for the old
5709API's 'fixed' setting<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5710 </td>
5711
5712 <td class="entry_tags">
5713 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5714 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5715 </ul>
5716 </td>
5717
5718 </tr> <!-- end of entry -->
5719
5720
5721 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5722 <td class="entry_name"><html><body><p>android.lens.info.minimumFocusDistance<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5723 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5724 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5725
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5726 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5727
5728
5729 </td> <!-- entry_type -->
5730
5731 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5732 <html><body><p>Shortest distance from frontmost surface
5733of the lens that can be focused correctly<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5734 </td>
5735
5736 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5737 <html><body><p>diopters<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5738 </td>
5739
5740 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5741 <html><body><p>&gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5742 </td>
5743
5744 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5745 <html><body><p>If the lens is fixed-focus, this should be
57460<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5747 </td>
5748
5749 <td class="entry_tags">
5750 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5751 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5752 </ul>
5753 </td>
5754
5755 </tr> <!-- end of entry -->
5756
5757
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5758 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5759 <td class="entry_name"><html><body><p>android.lens.info.shadingMapSize<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5760 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5761 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5762 <span class="entry_type_container">x</span>
5763
5764 <span class="entry_type_array">
5765 2
5766 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5767 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5768 <div class="entry_type_notes"><html><body><p>width and height of lens shading map provided by the HAL. (N x M)<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5769
5770
5771 </td> <!-- entry_type -->
5772
5773 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5774 <html><body><p>Dimensions of lens shading map.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5775 </td>
5776
5777 <td class="entry_units">
5778 </td>
5779
5780 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5781 <html><body><p>Both values &gt;= 1<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5782 </td>
5783
5784 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5785 <html><body><p>The map should be on the order of 30-40 rows and columns, and
5786must be smaller than 64x64.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5787 </td>
5788
5789 <td class="entry_tags">
5790 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5791 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5792 </ul>
5793 </td>
5794
5795 </tr> <!-- end of entry -->
5796
5797
5798
5799
5800
5801 <tr class="entry" id="static_android.lens.facing">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5802 <td class="entry_name"><html><body><p>android.lens.facing<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5803 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5804 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5805
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5806 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5807
5808 <ul class="entry_type_enum">
5809 <li>
5810 <span class="entry_type_enum_name">FRONT</span>
5811 </li>
5812 <li>
5813 <span class="entry_type_enum_name">BACK</span>
5814 </li>
5815 </ul>
5816
5817 </td> <!-- entry_type -->
5818
5819 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5820 <html><body><p>Direction the camera faces relative to
5821device screen<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5822 </td>
5823
5824 <td class="entry_units">
5825 </td>
5826
5827 <td class="entry_range">
5828 </td>
5829
5830 <td class="entry_notes">
5831 </td>
5832
5833 <td class="entry_tags">
5834 </td>
5835
5836 </tr> <!-- end of entry -->
5837
5838
5839 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5840 <td class="entry_name"><html><body><p>android.lens.opticalAxisAngle<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5841 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5842 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5843 <span class="entry_type_container">x</span>
5844
5845 <span class="entry_type_array">
5846 2
5847 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5848 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5849 <div class="entry_type_notes"><html><body><p>degrees. First defines the angle of separation between the perpendicular to the screen and the camera optical axis. The second then defines the clockwise rotation of the optical axis from native device up.<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5850
5851
5852 </td> <!-- entry_type -->
5853
5854 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5855 <html><body><p>Relative angle of camera optical axis to the
5856perpendicular axis from the display<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5857 </td>
5858
5859 <td class="entry_units">
5860 </td>
5861
5862 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5863 <html><body><p>[0-90) for first angle, [0-360) for second<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5864 </td>
5865
5866 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5867 <html><body><p>Examples:</p>
5868<p>(0,0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]5869is perpendicular to the display surface;</p>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5870<p>(45,0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]5871device is held upright;</p>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5872<p>(45,90) means the camera points 45 degrees to the right when
5873the device is held upright.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]5874<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5875direction<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5876 </td>
5877
5878 <td class="entry_tags">
5879 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5880 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5881 </ul>
5882 </td>
5883
5884 </tr> <!-- end of entry -->
5885
5886
5887 <tr class="entry" id="static_android.lens.position">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5888 <td class="entry_name"><html><body><p>android.lens.position<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5889 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5890 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5891 <span class="entry_type_container">x</span>
5892
5893 <span class="entry_type_array">
5894 3, location in mm, in the sensor coordinate
5895 system
5896 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5897 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5898
5899
5900 </td> <!-- entry_type -->
5901
5902 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5903 <html><body><p>Coordinates of camera optical axis on
5904device<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5905 </td>
5906
5907 <td class="entry_units">
5908 </td>
5909
5910 <td class="entry_range">
5911 </td>
5912
5913 <td class="entry_notes">
5914 </td>
5915
5916 <td class="entry_tags">
5917 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5918 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5919 </ul>
5920 </td>
5921
5922 </tr> <!-- end of entry -->
5923
5924
5925
5926 <!-- end of kind -->
5927 </tbody>
5928 <tr><td colspan="7" class="kind">dynamic</td></tr>
5929
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5930 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5931 <tr>
5932 <th class="th_name">Property Name</th>
5933 <th class="th_type">Type</th>
5934 <th class="th_description">Description</th>
5935 <th class="th_units">Units</th>
5936 <th class="th_range">Range</th>
5937 <th class="th_notes">Notes</th>
5938 <th class="th_tags">Tags</th>
5939 </tr>
5940 </thead>
5941
5942 <tbody>
5943
5944
5945
5946
5947
5948
5949
5950
5951
5952
5953 <tr class="entry" id="dynamic_android.lens.aperture">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5954 <td class="entry_name"><html><body><p>android.lens.aperture<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5955 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5956 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5957
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5958 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5959
5960
5961 </td> <!-- entry_type -->
5962
5963 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5964 <html><body><p>Size of the lens aperture<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5965 </td>
5966
5967 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5968 <html><body><p>f-number (f/NNN)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5969 </td>
5970
5971 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5972 <html><body><p>android.lens.info.availableApertures<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5973 </td>
5974
5975 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5976 <html><body><p>Will not be supported on most devices. Can only
5977pick from supported list<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5978 </td>
5979
5980 <td class="entry_tags">
5981 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5982 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5983 </ul>
5984 </td>
5985
5986 </tr> <!-- end of entry -->
5987
5988
5989 <tr class="entry" id="dynamic_android.lens.filterDensity">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5990 <td class="entry_name"><html><body><p>android.lens.filterDensity<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5991 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5992 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5993
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5994 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5995
5996
5997 </td> <!-- entry_type -->
5998
5999 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6000 <html><body><p>State of lens neutral density
6001filter(s)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6002 </td>
6003
6004 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6005 <html><body><p>number of stops of filtering<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6006 </td>
6007
6008 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6009 <html><body><p>android.lens.info.availableFilterDensities<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6010 </td>
6011
6012 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6013 <html><body><p>Will not be supported on most devices. Can only
6014pick from supported list<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6015 </td>
6016
6017 <td class="entry_tags">
6018 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6019 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6020 </ul>
6021 </td>
6022
6023 </tr> <!-- end of entry -->
6024
6025
6026 <tr class="entry" id="dynamic_android.lens.focalLength">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6027 <td class="entry_name"><html><body><p>android.lens.focalLength<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6028 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6029 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6030
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6031 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6032
6033
6034 </td> <!-- entry_type -->
6035
6036 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6037 <html><body><p>Lens optical zoom setting<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6038 </td>
6039
6040 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6041 <html><body><p>focal length in mm<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6042 </td>
6043
6044 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6045 <html><body><p>&gt; 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6046 </td>
6047
6048 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6049 <html><body><p>Will not be supported on most devices.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6050 </td>
6051
6052 <td class="entry_tags">
6053 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6054 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6055 </ul>
6056 </td>
6057
6058 </tr> <!-- end of entry -->
6059
6060
6061 <tr class="entry" id="dynamic_android.lens.focusDistance">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6062 <td class="entry_name"><html><body><p>android.lens.focusDistance<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6063 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6064 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6065
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6066 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6067
6068
6069 </td> <!-- entry_type -->
6070
6071 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6072 <html><body><p>Distance to plane of sharpest focus,
6073measured from frontmost surface of the lens<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6074 </td>
6075
6076 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6077 <html><body><p>diopters (1/m)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6078 </td>
6079
6080 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6081 <html><body><p>&gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6082 </td>
6083
6084 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6085 <html><body><p>Should be zero for fixed-focus cameras<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6086 </td>
6087
6088 <td class="entry_tags">
6089 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6090 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6091 </ul>
6092 </td>
6093
6094 </tr> <!-- end of entry -->
6095
6096
6097 <tr class="entry" id="dynamic_android.lens.focusRange">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6098 <td class="entry_name"><html><body><p>android.lens.focusRange<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6099 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6100 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]6101 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6102
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]6103 <span class="entry_type_array">
6104 2
6105 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6106 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6107 <div class="entry_type_notes"><html><body><p>Range of scene distances that are in focus<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6108
6109
6110 </td> <!-- entry_type -->
6111
6112 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6113 <html><body><p>The range of scene distances that are in
6114sharp focus (depth of field)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6115 </td>
6116
6117 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6118 <html><body><p>pair of focus distances in diopters: (near,
6119 far)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6120 </td>
6121
6122 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6123 <html><body><p>&gt;=0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6124 </td>
6125
6126 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6127 <html><body><p>If variable focus not supported, can still report
6128fixed depth of field range<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6129 </td>
6130
6131 <td class="entry_tags">
6132 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6133 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6134 </ul>
6135 </td>
6136
6137 </tr> <!-- end of entry -->
6138
6139
6140 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6141 <td class="entry_name"><html><body><p>android.lens.opticalStabilizationMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6142 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6143 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6144
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6145 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6146
6147 <ul class="entry_type_enum">
6148 <li>
6149 <span class="entry_type_enum_name">OFF</span>
6150 </li>
6151 <li>
6152 <span class="entry_type_enum_name">ON</span>
6153 <span class="entry_type_enum_optional">optional</span>
6154 </li>
6155 </ul>
6156
6157 </td> <!-- entry_type -->
6158
6159 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6160 <html><body><p>Whether optical image stabilization is
6161enabled.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6162 </td>
6163
6164 <td class="entry_units">
6165 </td>
6166
6167 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6168 <html><body><p>android.lens.availableOpticalStabilization<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6169 </td>
6170
6171 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6172 <html><body><p>Will not be supported on most devices.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6173 </td>
6174
6175 <td class="entry_tags">
6176 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6177 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6178 </ul>
6179 </td>
6180
6181 </tr> <!-- end of entry -->
6182
6183
6184 <tr class="entry" id="dynamic_android.lens.state">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6185 <td class="entry_name"><html><body><p>android.lens.state<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6186 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6187 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6188
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6189 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6190
6191 <ul class="entry_type_enum">
6192 <li>
6193 <span class="entry_type_enum_name">STATIONARY</span>
6194 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]6195 <li>
6196 <span class="entry_type_enum_name">MOVING</span>
6197 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6198 </ul>
6199
6200 </td> <!-- entry_type -->
6201
6202 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6203 <html><body><p>Current lens status<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6204 </td>
6205
6206 <td class="entry_units">
6207 </td>
6208
6209 <td class="entry_range">
6210 </td>
6211
6212 <td class="entry_notes">
6213 </td>
6214
6215 <td class="entry_tags">
6216 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6217 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6218 </ul>
6219 </td>
6220
6221 </tr> <!-- end of entry -->
6222
6223
6224
6225 <!-- end of kind -->
6226 </tbody>
6227
6228 <!-- end of section -->
6229 <tr><td colspan="7" id="section_noiseReduction" class="section">noiseReduction</td></tr>
6230
6231
6232 <tr><td colspan="7" class="kind">controls</td></tr>
6233
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6234 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6235 <tr>
6236 <th class="th_name">Property Name</th>
6237 <th class="th_type">Type</th>
6238 <th class="th_description">Description</th>
6239 <th class="th_units">Units</th>
6240 <th class="th_range">Range</th>
6241 <th class="th_notes">Notes</th>
6242 <th class="th_tags">Tags</th>
6243 </tr>
6244 </thead>
6245
6246 <tbody>
6247
6248
6249
6250
6251
6252
6253
6254
6255
6256
6257 <tr class="entry" id="controls_android.noiseReduction.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6258 <td class="entry_name"><html><body><p>android.noiseReduction.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6259 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6260 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6261
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6262 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6263
6264 <ul class="entry_type_enum">
6265 <li>
6266 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6267 <span class="entry_type_enum_notes"><html><body><p>No noise reduction is applied<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6268 </li>
6269 <li>
6270 <span class="entry_type_enum_name">FAST</span>
Zhijun Heb1c5bab2013-12-16 15:08:14 -0800[diff] [blame]6271 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to sensor
6272 output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6273 </li>
6274 <li>
6275 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6276 <span class="entry_type_enum_notes"><html><body><p>May slow down frame rate to provide highest
6277 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6278 </li>
6279 </ul>
6280
6281 </td> <!-- entry_type -->
6282
6283 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6284 <html><body><p>Mode of operation for the noise reduction
6285algorithm<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6286 </td>
6287
6288 <td class="entry_units">
6289 </td>
6290
6291 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6292 <html><body><p>android.noiseReduction.availableModes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6293 </td>
6294
6295 <td class="entry_notes">
Zhijun Heb1c5bab2013-12-16 15:08:14 -0800[diff] [blame]6296 <html><body><p>Noise filtering control. OFF means no noise reduction
6297will be applied by the HAL.</p>
6298<p>FAST/HIGH_QUALITY both mean HAL-determined noise filtering
6299will be applied. HIGH_QUALITY mode indicates that the HAL
6300should use the highest-quality noise filtering algorithms,
6301even if it slows down capture rate. FAST means the HAL should not
6302slow down capture rate when applying noise filtering.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6303 </td>
6304
6305 <td class="entry_tags">
6306 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6307 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6308 </ul>
6309 </td>
6310
6311 </tr> <!-- end of entry -->
6312
6313
6314 <tr class="entry" id="controls_android.noiseReduction.strength">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6315 <td class="entry_name"><html><body><p>android.noiseReduction.strength<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6316 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6317 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6318
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6319 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6320
6321
6322 </td> <!-- entry_type -->
6323
6324 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6325 <html><body><p>Control the amount of noise reduction
6326applied to the images<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6327 </td>
6328
6329 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6330 <html><body><p>1-10; 10 is max noise reduction<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6331 </td>
6332
6333 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6334 <html><body><p>1 - 10<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6335 </td>
6336
6337 <td class="entry_notes">
6338 </td>
6339
6340 <td class="entry_tags">
6341 </td>
6342
6343 </tr> <!-- end of entry -->
6344
6345
6346
6347 <!-- end of kind -->
6348 </tbody>
6349 <tr><td colspan="7" class="kind">dynamic</td></tr>
6350
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6351 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6352 <tr>
6353 <th class="th_name">Property Name</th>
6354 <th class="th_type">Type</th>
6355 <th class="th_description">Description</th>
6356 <th class="th_units">Units</th>
6357 <th class="th_range">Range</th>
6358 <th class="th_notes">Notes</th>
6359 <th class="th_tags">Tags</th>
6360 </tr>
6361 </thead>
6362
6363 <tbody>
6364
6365
6366
6367
6368
6369
6370
6371
6372
6373
6374 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6375 <td class="entry_name"><html><body><p>android.noiseReduction.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6376 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6377 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6378
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6379 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6380
6381 <ul class="entry_type_enum">
6382 <li>
6383 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6384 <span class="entry_type_enum_notes"><html><body><p>No noise reduction is applied<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6385 </li>
6386 <li>
6387 <span class="entry_type_enum_name">FAST</span>
Zhijun Heb1c5bab2013-12-16 15:08:14 -0800[diff] [blame]6388 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to sensor
6389 output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6390 </li>
6391 <li>
6392 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6393 <span class="entry_type_enum_notes"><html><body><p>May slow down frame rate to provide highest
6394 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6395 </li>
6396 </ul>
6397
6398 </td> <!-- entry_type -->
6399
6400 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6401 <html><body><p>Mode of operation for the noise reduction
6402algorithm<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6403 </td>
6404
6405 <td class="entry_units">
6406 </td>
6407
6408 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6409 <html><body><p>android.noiseReduction.availableModes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6410 </td>
6411
6412 <td class="entry_notes">
Zhijun Heb1c5bab2013-12-16 15:08:14 -0800[diff] [blame]6413 <html><body><p>Noise filtering control. OFF means no noise reduction
6414will be applied by the HAL.</p>
6415<p>FAST/HIGH_QUALITY both mean HAL-determined noise filtering
6416will be applied. HIGH_QUALITY mode indicates that the HAL
6417should use the highest-quality noise filtering algorithms,
6418even if it slows down capture rate. FAST means the HAL should not
6419slow down capture rate when applying noise filtering.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6420 </td>
6421
6422 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6423 <ul class="entry_tags">
6424 <li><a href="#tag_V1">V1</a></li>
6425 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6426 </td>
6427
6428 </tr> <!-- end of entry -->
6429
6430
6431
6432 <!-- end of kind -->
6433 </tbody>
6434
6435 <!-- end of section -->
6436 <tr><td colspan="7" id="section_quirks" class="section">quirks</td></tr>
6437
6438
6439 <tr><td colspan="7" class="kind">static</td></tr>
6440
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6441 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6442 <tr>
6443 <th class="th_name">Property Name</th>
6444 <th class="th_type">Type</th>
6445 <th class="th_description">Description</th>
6446 <th class="th_units">Units</th>
6447 <th class="th_range">Range</th>
6448 <th class="th_notes">Notes</th>
6449 <th class="th_tags">Tags</th>
6450 </tr>
6451 </thead>
6452
6453 <tbody>
6454
6455
6456
6457
6458
6459
6460
6461
6462
6463
6464 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6465 <td class="entry_name"><html><body><p>android.quirks.meteringCropRegion<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6466 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6467 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6468
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6469 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6470
6471
6472 </td> <!-- entry_type -->
6473
6474 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6475 <html><body><p>If set to 1, the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6476scale 'normalized' coordinates with respect to the crop
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6477region. This applies to metering input (a{e,f,wb}Region
6478and output (face rectangles).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6479 </td>
6480
6481 <td class="entry_units">
6482 </td>
6483
6484 <td class="entry_range">
6485 </td>
6486
6487 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6488 <html><body><p>Normalized coordinates refer to those in the
6489(-1000,1000) range mentioned in the
6490android.hardware.Camera API.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6491<p>HAL implementations should instead always use and emit
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6492sensor array-relative coordinates for all region data. Does
6493not need to be listed in static metadata. Support will be
6494removed in future versions of camera service.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6495 </td>
6496
6497 <td class="entry_tags">
6498 </td>
6499
6500 </tr> <!-- end of entry -->
6501
6502
6503 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6504 <td class="entry_name"><html><body><p>android.quirks.triggerAfWithAuto<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6505 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6506 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6507
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6508 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6509
6510
6511 </td> <!-- entry_type -->
6512
6513 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6514 <html><body><p>If set to 1, then the camera service always
6515switches to FOCUS_MODE_AUTO before issuing a AF
6516trigger.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6517 </td>
6518
6519 <td class="entry_units">
6520 </td>
6521
6522 <td class="entry_range">
6523 </td>
6524
6525 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6526 <html><body><p>HAL implementations should implement AF trigger
6527modes for AUTO, MACRO, CONTINUOUS_FOCUS, and
6528CONTINUOUS_PICTURE modes instead of using this flag. Does
6529not need to be listed in static metadata. Support will be
6530removed in future versions of camera service<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6531 </td>
6532
6533 <td class="entry_tags">
6534 </td>
6535
6536 </tr> <!-- end of entry -->
6537
6538
6539 <tr class="entry" id="static_android.quirks.useZslFormat">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6540 <td class="entry_name"><html><body><p>android.quirks.useZslFormat<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6541 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6542 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6543
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6544 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6545
6546
6547 </td> <!-- entry_type -->
6548
6549 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6550 <html><body><p>If set to 1, the camera service uses
6551CAMERA2_PIXEL_FORMAT_ZSL instead of
6552HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED for the zero
6553shutter lag stream<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6554 </td>
6555
6556 <td class="entry_units">
6557 </td>
6558
6559 <td class="entry_range">
6560 </td>
6561
6562 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6563 <html><body><p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6564to determine that a stream will be used for
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6565zero-shutter-lag, instead of relying on an explicit
6566format setting. Does not need to be listed in static
6567metadata. Support will be removed in future versions of
6568camera service.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6569 </td>
6570
6571 <td class="entry_tags">
6572 </td>
6573
6574 </tr> <!-- end of entry -->
6575
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6576
6577 <tr class="entry" id="static_android.quirks.usePartialResult">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6578 <td class="entry_name"><html><body><p>android.quirks.usePartialResult<wbr></wbr></p></body></html></td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6579 <td class="entry_type">
6580 <span class="entry_type_name">byte</span>
6581
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]6582 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6583
6584
6585 </td> <!-- entry_type -->
6586
6587 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6588 <html><body><p>If set to 1, the HAL will always split result
6589metadata for a single capture into multiple buffers,
6590returned using multiple process_capture_result calls.<wbr></wbr></p></body></html>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6591 </td>
6592
6593 <td class="entry_units">
6594 </td>
6595
6596 <td class="entry_range">
6597 </td>
6598
6599 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6600 <html><body><p>Does not need to be listed in static
6601metadata. Support for partial results will be reworked in
6602future versions of camera service. This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6603working at that point; DO NOT USE without careful
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6604consideration of future support.<wbr></wbr></p></body></html>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6605 </td>
6606
6607 <td class="entry_tags">
6608 </td>
6609
6610 </tr> <!-- end of entry -->
6611
6612
6613
6614 <!-- end of kind -->
6615 </tbody>
6616 <tr><td colspan="7" class="kind">dynamic</td></tr>
6617
6618 <thead class="entries_header">
6619 <tr>
6620 <th class="th_name">Property Name</th>
6621 <th class="th_type">Type</th>
6622 <th class="th_description">Description</th>
6623 <th class="th_units">Units</th>
6624 <th class="th_range">Range</th>
6625 <th class="th_notes">Notes</th>
6626 <th class="th_tags">Tags</th>
6627 </tr>
6628 </thead>
6629
6630 <tbody>
6631
6632
6633
6634
6635
6636
6637
6638
6639
6640
6641 <tr class="entry" id="dynamic_android.quirks.partialResult">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6642 <td class="entry_name"><html><body><p>android.quirks.partialResult<wbr></wbr></p></body></html></td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6643 <td class="entry_type">
6644 <span class="entry_type_name entry_type_name_enum">byte</span>
6645
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]6646 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6647
6648 <ul class="entry_type_enum">
6649 <li>
6650 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6651 <span class="entry_type_enum_notes"><html><body><p>The last or only metadata result buffer
6652 for this capture.<wbr></wbr></p></body></html></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6653 </li>
6654 <li>
6655 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6656 <span class="entry_type_enum_notes"><html><body><p>A partial buffer of result metadata for this
6657 capture. More result buffers for this capture will be sent
6658 by the HAL, the last of which will be marked
6659 FINAL.<wbr></wbr></p></body></html></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6660 </li>
6661 </ul>
6662
6663 </td> <!-- entry_type -->
6664
6665 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6666 <html><body><p>Whether a result given to the framework is the
6667final one for the capture, or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6668subset of the full set of dynamic metadata
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6669values.<wbr></wbr></p></body></html>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6670 </td>
6671
6672 <td class="entry_units">
6673 </td>
6674
6675 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6676 <html><body><p>Optional. Default value is FINAL.<wbr></wbr></p></body></html>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6677 </td>
6678
6679 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6680 <html><body><p>The entries in the result metadata buffers for a
6681single capture may not overlap, except for this entry. The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6682FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6683requests that generate them, so the FINAL buffer for frame 3 must
6684always be sent to the framework after the FINAL buffer for frame 2, and
6685before the FINAL buffer for frame 4. PARTIAL buffers may be returned
6686in any order relative to other frames, but all PARTIAL buffers for a given
6687capture must arrive before the FINAL buffer for that capture. This entry may
6688only be used by the HAL if quirks.usePartialResult is set to 1.<wbr></wbr></p></body></html>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6689 </td>
6690
6691 <td class="entry_tags">
6692 </td>
6693
6694 </tr> <!-- end of entry -->
6695
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6696
6697
6698 <!-- end of kind -->
6699 </tbody>
6700
6701 <!-- end of section -->
6702 <tr><td colspan="7" id="section_request" class="section">request</td></tr>
6703
6704
6705 <tr><td colspan="7" class="kind">controls</td></tr>
6706
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6707 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6708 <tr>
6709 <th class="th_name">Property Name</th>
6710 <th class="th_type">Type</th>
6711 <th class="th_description">Description</th>
6712 <th class="th_units">Units</th>
6713 <th class="th_range">Range</th>
6714 <th class="th_notes">Notes</th>
6715 <th class="th_tags">Tags</th>
6716 </tr>
6717 </thead>
6718
6719 <tbody>
6720
6721
6722
6723
6724
6725
6726
6727
6728
6729
6730 <tr class="entry" id="controls_android.request.frameCount">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6731 <td class="entry_name"><html><body><p>android.request.frameCount<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6732 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6733 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6734
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6735 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6736
6737
6738 </td> <!-- entry_type -->
6739
6740 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6741 <html><body><p>A frame counter set by the framework. Must
6742be maintained unchanged in output frame. This value monotonically
6743increases with every new result (that is, each new result has a unique
6744frameCount value).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6745 </td>
6746
6747 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6748 <html><body><p>incrementing integer<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6749 </td>
6750
6751 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6752 <html><body><p>Any int<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6753 </td>
6754
6755 <td class="entry_notes">
6756 </td>
6757
6758 <td class="entry_tags">
6759 </td>
6760
6761 </tr> <!-- end of entry -->
6762
6763
6764 <tr class="entry" id="controls_android.request.id">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6765 <td class="entry_name"><html><body><p>android.request.id<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6766 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6767 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6768
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6769 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6770
6771
6772 </td> <!-- entry_type -->
6773
6774 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6775 <html><body><p>An application-specified ID for the current
6776request. Must be maintained unchanged in output
6777frame<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6778 </td>
6779
6780 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6781 <html><body><p>arbitrary integer assigned by application<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6782 </td>
6783
6784 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6785 <html><body><p>Any int<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6786 </td>
6787
6788 <td class="entry_notes">
6789 </td>
6790
6791 <td class="entry_tags">
6792 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6793 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6794 </ul>
6795 </td>
6796
6797 </tr> <!-- end of entry -->
6798
6799
6800 <tr class="entry" id="controls_android.request.inputStreams">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6801 <td class="entry_name"><html><body><p>android.request.inputStreams<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6802 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]6803 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6804 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6805
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6806 <span class="entry_type_array">
6807 n
6808 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6809 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6810
6811
6812 </td> <!-- entry_type -->
6813
6814 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6815 <html><body><p>List which camera reprocess stream is used
6816for the source of reprocessing data.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6817 </td>
6818
6819 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6820 <html><body><p>List of camera reprocess stream IDs<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6821 </td>
6822
6823 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6824 <html><body><p>Typically, only one entry allowed, must be a valid
6825 reprocess stream ID.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6826
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6827 If android.jpeg.needsThumbnail is set, then multiple
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6828 reprocess streams may be included in a single request; they
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6829 must be different scaled versions of the same image.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6830 </td>
6831
6832 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6833 <html><body><p>Only meaningful when android.request.type ==
6834REPROCESS. Ignored otherwise<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6835 </td>
6836
6837 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6838 <ul class="entry_tags">
6839 <li><a href="#tag_HAL2">HAL2</a></li>
6840 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6841 </td>
6842
6843 </tr> <!-- end of entry -->
6844
6845
6846 <tr class="entry" id="controls_android.request.metadataMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6847 <td class="entry_name"><html><body><p>android.request.metadataMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6848 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6849 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6850
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6851 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6852
6853 <ul class="entry_type_enum">
6854 <li>
6855 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6856 <span class="entry_type_enum_notes"><html><body><p>No metadata should be produced on output, except
6857 for application-bound buffer data. If no
6858 application-bound streams exist, no frame should be
6859 placed in the output frame queue. If such streams
6860 exist, a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6861 with null metadata but with the necessary output buffer
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6862 information. Timestamp information should still be
6863 included with any output stream buffers<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6864 </li>
6865 <li>
6866 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6867 <span class="entry_type_enum_notes"><html><body><p>All metadata should be produced. Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6868 only be produced if they are separately
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6869 enabled<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6870 </li>
6871 </ul>
6872
6873 </td> <!-- entry_type -->
6874
6875 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6876 <html><body><p>How much metadata to produce on
6877output<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6878 </td>
6879
6880 <td class="entry_units">
6881 </td>
6882
6883 <td class="entry_range">
6884 </td>
6885
6886 <td class="entry_notes">
6887 </td>
6888
6889 <td class="entry_tags">
6890 </td>
6891
6892 </tr> <!-- end of entry -->
6893
6894
6895 <tr class="entry" id="controls_android.request.outputStreams">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6896 <td class="entry_name"><html><body><p>android.request.outputStreams<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6897 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]6898 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6899 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6900
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6901 <span class="entry_type_array">
6902 n
6903 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6904 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6905
6906
6907 </td> <!-- entry_type -->
6908
6909 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6910 <html><body><p>Lists which camera output streams image data
6911from this capture must be sent to<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6912 </td>
6913
6914 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6915 <html><body><p>List of camera stream IDs<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6916 </td>
6917
6918 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6919 <html><body><p>List must only include streams that have been
6920 created<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6921 </td>
6922
6923 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6924 <html><body><p>If no output streams are listed, then the image
6925data should simply be discarded. The image data must
6926still be captured for metadata and statistics production,
6927and the lens and flash must operate as requested.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6928 </td>
6929
6930 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6931 <ul class="entry_tags">
6932 <li><a href="#tag_HAL2">HAL2</a></li>
6933 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6934 </td>
6935
6936 </tr> <!-- end of entry -->
6937
6938
6939 <tr class="entry" id="controls_android.request.type">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6940 <td class="entry_name"><html><body><p>android.request.type<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6941 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6942 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6943
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6944 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6945
6946 <ul class="entry_type_enum">
6947 <li>
6948 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6949 <span class="entry_type_enum_notes"><html><body><p>Capture a new image from the imaging hardware,
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6950 and process it according to the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6951 settings<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6952 </li>
6953 <li>
6954 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6955 <span class="entry_type_enum_notes"><html><body><p>Process previously captured data; the
6956 android.request.inputStream parameter determines the
6957 source reprocessing stream. TODO: Mark dynamic metadata
6958 needed for reprocessing with [RP]<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6959 </li>
6960 </ul>
6961
6962 </td> <!-- entry_type -->
6963
6964 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6965 <html><body><p>The type of the request; either CAPTURE or
6966REPROCESS. For HAL3, this tag is redundant.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6967 </td>
6968
6969 <td class="entry_units">
6970 </td>
6971
6972 <td class="entry_range">
6973 </td>
6974
6975 <td class="entry_notes">
6976 </td>
6977
6978 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6979 <ul class="entry_tags">
6980 <li><a href="#tag_HAL2">HAL2</a></li>
6981 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6982 </td>
6983
6984 </tr> <!-- end of entry -->
6985
6986
6987
6988 <!-- end of kind -->
6989 </tbody>
6990 <tr><td colspan="7" class="kind">static</td></tr>
6991
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6992 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6993 <tr>
6994 <th class="th_name">Property Name</th>
6995 <th class="th_type">Type</th>
6996 <th class="th_description">Description</th>
6997 <th class="th_units">Units</th>
6998 <th class="th_range">Range</th>
6999 <th class="th_notes">Notes</th>
7000 <th class="th_tags">Tags</th>
7001 </tr>
7002 </thead>
7003
7004 <tbody>
7005
7006
7007
7008
7009
7010
7011
7012
7013
7014
7015 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7016 <td class="entry_name"><html><body><p>android.request.maxNumOutputStreams<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7017 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7018 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7019 <span class="entry_type_container">x</span>
7020
7021 <span class="entry_type_array">
7022 3
7023 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7024 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7025
7026
7027 </td> <!-- entry_type -->
7028
7029 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7030 <html><body><p>How many output streams can be allocated at
7031the same time for each type of stream<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7032 </td>
7033
7034 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7035 <html><body><p>The number of raw sensor streams; the number of
7036 processed, uncompressed streams; and the number of
7037 JPEG-compressed streams<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7038 </td>
7039
7040 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7041 <html><body><p>&gt;=1 for Raw and JPEG-compressed stream. &gt;= 3
7042 for processed, uncompressed streams<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7043 </td>
7044
7045 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7046 <html><body><p>Video snapshot with preview callbacks requires 3
7047processed streams (preview, record, app callbacks) and
7048one JPEG stream (snapshot)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7049 </td>
7050
7051 <td class="entry_tags">
7052 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7053 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7054 </ul>
7055 </td>
7056
7057 </tr> <!-- end of entry -->
7058
7059
7060 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7061 <td class="entry_name"><html><body><p>android.request.maxNumReprocessStreams<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7062 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7063 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7064 <span class="entry_type_container">x</span>
7065
7066 <span class="entry_type_array">
7067 1
7068 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7069 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7070
7071
7072 </td> <!-- entry_type -->
7073
7074 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7075 <html><body><p>How many reprocessing streams of any type
7076can be allocated at the same time<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7077 </td>
7078
7079 <td class="entry_units">
7080 </td>
7081
7082 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7083 <html><body><p>&gt;= 1<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7084 </td>
7085
7086 <td class="entry_notes">
7087 </td>
7088
7089 <td class="entry_tags">
7090 </td>
7091
7092 </tr> <!-- end of entry -->
7093
7094
7095
7096 <!-- end of kind -->
7097 </tbody>
7098 <tr><td colspan="7" class="kind">dynamic</td></tr>
7099
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7100 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7101 <tr>
7102 <th class="th_name">Property Name</th>
7103 <th class="th_type">Type</th>
7104 <th class="th_description">Description</th>
7105 <th class="th_units">Units</th>
7106 <th class="th_range">Range</th>
7107 <th class="th_notes">Notes</th>
7108 <th class="th_tags">Tags</th>
7109 </tr>
7110 </thead>
7111
7112 <tbody>
7113
7114
7115
7116
7117
7118
7119
7120
7121
7122
7123 <tr class="entry" id="dynamic_android.request.frameCount">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7124 <td class="entry_name"><html><body><p>android.request.frameCount<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7125 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7126 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7127
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7128 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7129
7130
7131 </td> <!-- entry_type -->
7132
7133 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7134 <html><body><p>A frame counter set by the framework. This value monotonically
7135increases with every new result (that is, each new result has a unique
7136frameCount value).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7137 </td>
7138
7139 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7140 <html><body><p>count of frames<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7141 </td>
7142
7143 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7144 <html><body><p>&gt; 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7145 </td>
7146
7147 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7148 <html><body><p>Reset on release()<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7149 </td>
7150
7151 <td class="entry_tags">
7152 </td>
7153
7154 </tr> <!-- end of entry -->
7155
7156
7157 <tr class="entry" id="dynamic_android.request.id">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7158 <td class="entry_name"><html><body><p>android.request.id<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7159 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7160 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7161
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7162 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7163
7164
7165 </td> <!-- entry_type -->
7166
7167 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7168 <html><body><p>An application-specified ID for the current
7169request. Must be maintained unchanged in output
7170frame<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7171 </td>
7172
7173 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7174 <html><body><p>arbitrary integer assigned by application<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7175 </td>
7176
7177 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7178 <html><body><p>Any int<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7179 </td>
7180
7181 <td class="entry_notes">
7182 </td>
7183
7184 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7185 <ul class="entry_tags">
7186 <li><a href="#tag_V1">V1</a></li>
7187 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7188 </td>
7189
7190 </tr> <!-- end of entry -->
7191
7192
7193 <tr class="entry" id="dynamic_android.request.metadataMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7194 <td class="entry_name"><html><body><p>android.request.metadataMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7195 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7196 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7197
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7198 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7199
7200 <ul class="entry_type_enum">
7201 <li>
7202 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7203 <span class="entry_type_enum_notes"><html><body><p>No metadata should be produced on output, except
7204 for application-bound buffer data. If no
7205 application-bound streams exist, no frame should be
7206 placed in the output frame queue. If such streams
7207 exist, a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7208 with null metadata but with the necessary output buffer
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7209 information. Timestamp information should still be
7210 included with any output stream buffers<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7211 </li>
7212 <li>
7213 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7214 <span class="entry_type_enum_notes"><html><body><p>All metadata should be produced. Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7215 only be produced if they are separately
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7216 enabled<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7217 </li>
7218 </ul>
7219
7220 </td> <!-- entry_type -->
7221
7222 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7223 <html><body><p>How much metadata to produce on
7224output<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7225 </td>
7226
7227 <td class="entry_units">
7228 </td>
7229
7230 <td class="entry_range">
7231 </td>
7232
7233 <td class="entry_notes">
7234 </td>
7235
7236 <td class="entry_tags">
7237 </td>
7238
7239 </tr> <!-- end of entry -->
7240
7241
7242 <tr class="entry" id="dynamic_android.request.outputStreams">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7243 <td class="entry_name"><html><body><p>android.request.outputStreams<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7244 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7245 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7246 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7247
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7248 <span class="entry_type_array">
7249 n
7250 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7251 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7252
7253
7254 </td> <!-- entry_type -->
7255
7256 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7257 <html><body><p>Lists which camera output streams image data
7258from this capture must be sent to<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7259 </td>
7260
7261 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7262 <html><body><p>List of camera stream IDs<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7263 </td>
7264
7265 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7266 <html><body><p>List must only include streams that have been
7267 created<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7268 </td>
7269
7270 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7271 <html><body><p>If no output streams are listed, then the image
7272data should simply be discarded. The image data must
7273still be captured for metadata and statistics production,
7274and the lens and flash must operate as requested.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7275 </td>
7276
7277 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7278 <ul class="entry_tags">
7279 <li><a href="#tag_HAL2">HAL2</a></li>
7280 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7281 </td>
7282
7283 </tr> <!-- end of entry -->
7284
7285
7286
7287 <!-- end of kind -->
7288 </tbody>
7289
7290 <!-- end of section -->
7291 <tr><td colspan="7" id="section_scaler" class="section">scaler</td></tr>
7292
7293
7294 <tr><td colspan="7" class="kind">controls</td></tr>
7295
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7296 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7297 <tr>
7298 <th class="th_name">Property Name</th>
7299 <th class="th_type">Type</th>
7300 <th class="th_description">Description</th>
7301 <th class="th_units">Units</th>
7302 <th class="th_range">Range</th>
7303 <th class="th_notes">Notes</th>
7304 <th class="th_tags">Tags</th>
7305 </tr>
7306 </thead>
7307
7308 <tbody>
7309
7310
7311
7312
7313
7314
7315
7316
7317
7318
7319 <tr class="entry" id="controls_android.scaler.cropRegion">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7320 <td class="entry_name"><html><body><p>android.scaler.cropRegion<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7321 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7322 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7323 <span class="entry_type_container">x</span>
7324
7325 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7326 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7327 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7328 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7329
7330
7331 </td> <!-- entry_type -->
7332
7333 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7334 <html><body><p>(x, y, width, height).</p>
7335<p>A rectangle with the top-level corner of (x,y) and size
7336(width, height). The region of the sensor that is used for
7337output. Each stream must use this rectangle to produce its
7338output, cropping to a smaller region if necessary to
7339maintain the stream's aspect ratio.</p>
7340<p>HAL2.x uses only (x, y, width)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7341 </td>
7342
7343 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7344 <html><body><p>(x,y) of top-left corner, width and height of region
7345 in pixels; (0,0) is top-left corner of
7346 android.sensor.activeArraySize<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7347 </td>
7348
7349 <td class="entry_range">
7350 </td>
7351
7352 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7353 <html><body><p>Any additional per-stream cropping must be done to
7354maximize the final pixel area of the stream.</p>
7355<p>For example, if the crop region is set to a 4:3 aspect
7356ratio, then 4:3 streams should use the exact crop
7357region. 16:9 streams should further crop vertically
7358(letterbox).</p>
7359<p>Conversely, if the crop region is set to a 16:9, then 4:3
7360outputs should crop horizontally (pillarbox), and 16:9
7361streams should match exactly. These additional crops must
7362be centered within the crop region.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7363<p>The output streams must maintain square pixels at all
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7364times, no matter what the relative aspect ratios of the
7365crop region and the stream are. Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7366corner are allowed for raw output if full pixel array is
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7367larger than active pixel array. Width and height may be
7368rounded to nearest larger supportable width, especially
7369for raw output, where only a few fixed scales may be
7370possible. The width and height of the crop region cannot
7371be set to be smaller than floor( activeArraySize.width /
7372android.scaler.maxDigitalZoom ) and floor(
7373activeArraySize.height / android.scaler.maxDigitalZoom),
7374respectively.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7375 </td>
7376
7377 <td class="entry_tags">
7378 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7379 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7380 </ul>
7381 </td>
7382
7383 </tr> <!-- end of entry -->
7384
7385
7386
7387 <!-- end of kind -->
7388 </tbody>
7389 <tr><td colspan="7" class="kind">static</td></tr>
7390
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7391 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7392 <tr>
7393 <th class="th_name">Property Name</th>
7394 <th class="th_type">Type</th>
7395 <th class="th_description">Description</th>
7396 <th class="th_units">Units</th>
7397 <th class="th_range">Range</th>
7398 <th class="th_notes">Notes</th>
7399 <th class="th_tags">Tags</th>
7400 </tr>
7401 </thead>
7402
7403 <tbody>
7404
7405
7406
7407
7408
7409
7410
7411
7412
7413
7414 <tr class="entry" id="static_android.scaler.availableFormats">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7415 <td class="entry_name"><html><body><p>android.scaler.availableFormats<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7416 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7417 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7418 <span class="entry_type_container">x</span>
7419
7420 <span class="entry_type_array">
7421 n
7422 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]7423 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7424 <div class="entry_type_notes"><html><body><p>values from HAL_PIXEL_FORMAT_* in /system/core/include/system/graphics.h<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7425
7426 <ul class="entry_type_enum">
7427 <li>
7428 <span class="entry_type_enum_name">RAW_SENSOR</span>
7429 <span class="entry_type_enum_value">0x20</span>
7430 </li>
7431 <li>
7432 <span class="entry_type_enum_name">YV12</span>
7433 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7434 <span class="entry_type_enum_notes"><html><body><p>YCrCb 4:2:0 Planar<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7435 </li>
7436 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]7437 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7438 <span class="entry_type_enum_value">0x11</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7439 <span class="entry_type_enum_notes"><html><body><p>NV21<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7440 </li>
7441 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]7442 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
7443 <span class="entry_type_enum_value">0x22</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7444 <span class="entry_type_enum_notes"><html><body><p>Hal Implementation Defined<wbr></wbr></p></body></html></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]7445 </li>
7446 <li>
7447 <span class="entry_type_enum_name">YCbCr_420_888</span>
7448 <span class="entry_type_enum_value">0x23</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7449 <span class="entry_type_enum_notes"><html><body><p>Flexible YUV420 Format<wbr></wbr></p></body></html></span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]7450 </li>
7451 <li>
7452 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7453 <span class="entry_type_enum_value">0x21</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7454 <span class="entry_type_enum_notes"><html><body><p>JPEG<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7455 </li>
7456 </ul>
7457
7458 </td> <!-- entry_type -->
7459
7460 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7461 <html><body><p>List of app-visible formats<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7462 </td>
7463
7464 <td class="entry_units">
7465 </td>
7466
7467 <td class="entry_range">
7468 </td>
7469
7470 <td class="entry_notes">
7471 </td>
7472
7473 <td class="entry_tags">
7474 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7475 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7476 </ul>
7477 </td>
7478
7479 </tr> <!-- end of entry -->
7480
7481
7482 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7483 <td class="entry_name"><html><body><p>android.scaler.availableJpegMinDurations<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7484 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7485 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7486 <span class="entry_type_container">x</span>
7487
7488 <span class="entry_type_array">
7489 n
7490 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7491 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7492
7493
7494 </td> <!-- entry_type -->
7495
7496 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7497 <html><body><p>The minimum frame duration that is supported
7498for each resolution in availableJpegSizes. Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7499correspond to the frame duration when only that JPEG
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7500stream is active and captured in a burst, with all
7501processing set to FAST<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7502 </td>
7503
7504 <td class="entry_units">
7505 </td>
7506
7507 <td class="entry_range">
7508 </td>
7509
7510 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7511 <html><body><p>When multiple streams are configured, the minimum
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7512frame duration will be &gt;= max(individual stream min
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7513durations)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7514 </td>
7515
7516 <td class="entry_tags">
7517 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7518 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7519 </ul>
7520 </td>
7521
7522 </tr> <!-- end of entry -->
7523
7524
7525 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7526 <td class="entry_name"><html><body><p>android.scaler.availableJpegSizes<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7527 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7528 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7529 <span class="entry_type_container">x</span>
7530
7531 <span class="entry_type_array">
7532 n x 2
7533 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7534 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7535
7536
7537 </td> <!-- entry_type -->
7538
7539 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7540 <html><body><p>The resolutions available for output from
7541the JPEG block. Listed as width x height<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7542 </td>
7543
7544 <td class="entry_units">
7545 </td>
7546
7547 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7548 <html><body><p>Must include: - sensor maximum resolution Should
7549 include: - half/quarter max resolution<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7550 </td>
7551
7552 <td class="entry_notes">
7553 </td>
7554
7555 <td class="entry_tags">
7556 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7557 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7558 </ul>
7559 </td>
7560
7561 </tr> <!-- end of entry -->
7562
7563
7564 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7565 <td class="entry_name"><html><body><p>android.scaler.availableMaxDigitalZoom<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7566 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]7567 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7568
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7569 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7570
7571
7572 </td> <!-- entry_type -->
7573
7574 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7575 <html><body><p>The maximum ratio between active area width
7576and crop region width, or between active area height and
7577crop region height, if the crop region height is larger
7578than width<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7579 </td>
7580
7581 <td class="entry_units">
7582 </td>
7583
7584 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7585 <html><body><p>&gt;=1<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7586 </td>
7587
7588 <td class="entry_notes">
7589 </td>
7590
7591 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]7592 <ul class="entry_tags">
7593 <li><a href="#tag_BC">BC</a></li>
7594 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7595 </td>
7596
7597 </tr> <!-- end of entry -->
7598
7599
7600 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7601 <td class="entry_name"><html><body><p>android.scaler.availableProcessedMinDurations<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7602 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7603 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7604 <span class="entry_type_container">x</span>
7605
7606 <span class="entry_type_array">
7607 n
7608 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7609 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7610
7611
7612 </td> <!-- entry_type -->
7613
7614 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7615 <html><body><p>The minimum frame duration that is supported
7616for each resolution in availableProcessedSizes. Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7617correspond to the frame duration when only that processed
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7618stream is active, with all processing set to
7619FAST<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7620 </td>
7621
7622 <td class="entry_units">
7623 </td>
7624
7625 <td class="entry_range">
7626 </td>
7627
7628 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7629 <html><body><p>When multiple streams are configured, the minimum
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7630frame duration will be &gt;= max(individual stream min
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7631durations)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7632 </td>
7633
7634 <td class="entry_tags">
7635 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7636 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7637 </ul>
7638 </td>
7639
7640 </tr> <!-- end of entry -->
7641
7642
7643 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7644 <td class="entry_name"><html><body><p>android.scaler.availableProcessedSizes<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7645 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7646 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7647 <span class="entry_type_container">x</span>
7648
7649 <span class="entry_type_array">
7650 n x 2
7651 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7652 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7653
7654
7655 </td> <!-- entry_type -->
7656
7657 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7658 <html><body><p>The resolutions available for use with
7659processed output streams, such as YV12, NV12, and
7660platform opaque YUV/RGB streams to the GPU or video
7661encoders. Listed as width, height<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7662 </td>
7663
7664 <td class="entry_units">
7665 </td>
7666
7667 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7668 <html><body><p>Must include: - sensor maximum resolution -
7669 standard QCIF, 240p, 480p, 720p, and 1080p
7670 resolutions<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7671 </td>
7672
7673 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7674 <html><body><p>The actual supported resolution list may be limited by
7675consumer end points for different use cases. For example, for
7676recording use case, the largest supported resolution may be
7677limited by max supported size from encoder, for preview use
7678case, the largest supported resolution may be limited by max
7679resolution SurfaceTexture/SurfaceView can support.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7680 </td>
7681
7682 <td class="entry_tags">
7683 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7684 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7685 </ul>
7686 </td>
7687
7688 </tr> <!-- end of entry -->
7689
7690
7691 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7692 <td class="entry_name"><html><body><p>android.scaler.availableRawMinDurations<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7693 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7694 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7695 <span class="entry_type_container">x</span>
7696
7697 <span class="entry_type_array">
7698 n
7699 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7700 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7701
7702
7703 </td> <!-- entry_type -->
7704
7705 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7706 <html><body><p>The minimum frame duration that is supported
7707for each raw resolution in availableRawSizes. Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7708correspond to the frame duration when only the raw stream
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7709is active.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7710 </td>
7711
7712 <td class="entry_units">
7713 </td>
7714
7715 <td class="entry_range">
7716 </td>
7717
7718 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7719 <html><body><p>When multiple streams are configured, the minimum
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7720frame duration will be &gt;= max(individual stream min
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7721durations)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7722 </td>
7723
7724 <td class="entry_tags">
7725 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7726 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7727 </ul>
7728 </td>
7729
7730 </tr> <!-- end of entry -->
7731
7732
7733 <tr class="entry" id="static_android.scaler.availableRawSizes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7734 <td class="entry_name"><html><body><p>android.scaler.availableRawSizes<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7735 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7736 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7737 <span class="entry_type_container">x</span>
7738
7739 <span class="entry_type_array">
7740 n x 2
7741 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7742 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7743
7744
7745 </td> <!-- entry_type -->
7746
7747 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7748 <html><body><p>The resolutions available for use with raw
7749sensor output streams, listed as width,
7750height<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7751 </td>
7752
7753 <td class="entry_units">
7754 </td>
7755
7756 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7757 <html><body><p>Must include: - sensor maximum resolution<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7758 </td>
7759
7760 <td class="entry_notes">
7761 </td>
7762
7763 <td class="entry_tags">
7764 </td>
7765
7766 </tr> <!-- end of entry -->
7767
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7768
7769
7770 <!-- end of kind -->
7771 </tbody>
7772 <tr><td colspan="7" class="kind">dynamic</td></tr>
7773
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7774 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7775 <tr>
7776 <th class="th_name">Property Name</th>
7777 <th class="th_type">Type</th>
7778 <th class="th_description">Description</th>
7779 <th class="th_units">Units</th>
7780 <th class="th_range">Range</th>
7781 <th class="th_notes">Notes</th>
7782 <th class="th_tags">Tags</th>
7783 </tr>
7784 </thead>
7785
7786 <tbody>
7787
7788
7789
7790
7791
7792
7793
7794
7795
7796
7797 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7798 <td class="entry_name"><html><body><p>android.scaler.cropRegion<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7799 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7800 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7801 <span class="entry_type_container">x</span>
7802
7803 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7804 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7805 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7806 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7807
7808
7809 </td> <!-- entry_type -->
7810
7811 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7812 <html><body><p>(x, y, width, height).</p>
7813<p>A rectangle with the top-level corner of (x,y) and size
7814(width, height). The region of the sensor that is used for
7815output. Each stream must use this rectangle to produce its
7816output, cropping to a smaller region if necessary to
7817maintain the stream's aspect ratio.</p>
7818<p>HAL2.x uses only (x, y, width)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7819 </td>
7820
7821 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7822 <html><body><p>(x,y) of top-left corner, width and height of region
7823 in pixels; (0,0) is top-left corner of
7824 android.sensor.activeArraySize<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7825 </td>
7826
7827 <td class="entry_range">
7828 </td>
7829
7830 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7831 <html><body><p>Any additional per-stream cropping must be done to
7832maximize the final pixel area of the stream.</p>
7833<p>For example, if the crop region is set to a 4:3 aspect
7834ratio, then 4:3 streams should use the exact crop
7835region. 16:9 streams should further crop vertically
7836(letterbox).</p>
7837<p>Conversely, if the crop region is set to a 16:9, then 4:3
7838outputs should crop horizontally (pillarbox), and 16:9
7839streams should match exactly. These additional crops must
7840be centered within the crop region.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7841<p>The output streams must maintain square pixels at all
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7842times, no matter what the relative aspect ratios of the
7843crop region and the stream are. Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7844corner are allowed for raw output if full pixel array is
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7845larger than active pixel array. Width and height may be
7846rounded to nearest larger supportable width, especially
7847for raw output, where only a few fixed scales may be
7848possible. The width and height of the crop region cannot
7849be set to be smaller than floor( activeArraySize.width /
7850android.scaler.maxDigitalZoom ) and floor(
7851activeArraySize.height / android.scaler.maxDigitalZoom),
7852respectively.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7853 </td>
7854
7855 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7856 <ul class="entry_tags">
7857 <li><a href="#tag_BC">BC</a></li>
7858 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7859 </td>
7860
7861 </tr> <!-- end of entry -->
7862
7863
7864
7865 <!-- end of kind -->
7866 </tbody>
7867
7868 <!-- end of section -->
7869 <tr><td colspan="7" id="section_sensor" class="section">sensor</td></tr>
7870
7871
7872 <tr><td colspan="7" class="kind">controls</td></tr>
7873
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7874 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7875 <tr>
7876 <th class="th_name">Property Name</th>
7877 <th class="th_type">Type</th>
7878 <th class="th_description">Description</th>
7879 <th class="th_units">Units</th>
7880 <th class="th_range">Range</th>
7881 <th class="th_notes">Notes</th>
7882 <th class="th_tags">Tags</th>
7883 </tr>
7884 </thead>
7885
7886 <tbody>
7887
7888
7889
7890
7891
7892
7893
7894
7895
7896
7897 <tr class="entry" id="controls_android.sensor.exposureTime">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7898 <td class="entry_name"><html><body><p>android.sensor.exposureTime<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7899 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7900 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7901
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7902 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7903
7904
7905 </td> <!-- entry_type -->
7906
7907 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7908 <html><body><p>Duration each pixel is exposed to
7909light.</p>
7910<p>If the sensor can't expose this exact duration, it should shorten the
7911duration exposed to the nearest possible value (rather than expose longer).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7912 </td>
7913
7914 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7915 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7916 </td>
7917
7918 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7919 <html><body><p>android.sensor.info.exposureTimeRange<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7920 </td>
7921
7922 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7923 <html><body><p>1/10000 - 30 sec range. No bulb mode<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7924 </td>
7925
7926 <td class="entry_tags">
7927 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7928 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7929 </ul>
7930 </td>
7931
7932 </tr> <!-- end of entry -->
7933
7934
7935 <tr class="entry" id="controls_android.sensor.frameDuration">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7936 <td class="entry_name"><html><body><p>android.sensor.frameDuration<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7937 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7938 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7939
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7940 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7941
7942
7943 </td> <!-- entry_type -->
7944
7945 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7946 <html><body><p>Duration from start of frame exposure to
7947start of next frame exposure<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7948 </td>
7949
7950 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7951 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7952 </td>
7953
7954 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7955 <html><body><p>see android.sensor.info.maxFrameDuration,
7956 android.scaler.info.availableMinFrameDurations<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7957 </td>
7958
7959 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7960 <html><body><p>Exposure time has priority, so duration is set to
7961max(duration, exposure time + overhead)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7962 </td>
7963
7964 <td class="entry_tags">
7965 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7966 <li><a href="#tag_V1">V1</a></li>
7967 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7968 </ul>
7969 </td>
7970
7971 </tr> <!-- end of entry -->
7972
7973
7974 <tr class="entry" id="controls_android.sensor.sensitivity">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7975 <td class="entry_name"><html><body><p>android.sensor.sensitivity<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7976 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7977 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7978
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7979 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7980
7981
7982 </td> <!-- entry_type -->
7983
7984 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7985 <html><body><p>Gain applied to image data. Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7986implemented through analog gain only if set to values
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7987below 'maximum analog sensitivity'.</p>
7988<p>If the sensor can't apply this exact gain, it should lessen the
7989gain to the nearest possible value (rather than gain more).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7990 </td>
7991
7992 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7993 <html><body><p>ISO arithmetic units<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7994 </td>
7995
7996 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7997 <html><body><p>android.sensor.info.sensitivityRange<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7998 </td>
7999
8000 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8001 <html><body><p>ISO 12232:2006 REI method<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8002 </td>
8003
8004 <td class="entry_tags">
8005 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8006 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8007 </ul>
8008 </td>
8009
8010 </tr> <!-- end of entry -->
8011
8012
8013
8014 <!-- end of kind -->
8015 </tbody>
8016 <tr><td colspan="7" class="kind">static</td></tr>
8017
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8018 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8019 <tr>
8020 <th class="th_name">Property Name</th>
8021 <th class="th_type">Type</th>
8022 <th class="th_description">Description</th>
8023 <th class="th_units">Units</th>
8024 <th class="th_range">Range</th>
8025 <th class="th_notes">Notes</th>
8026 <th class="th_tags">Tags</th>
8027 </tr>
8028 </thead>
8029
8030 <tbody>
8031
8032
8033
8034
8035
8036
8037
8038
8039
8040
8041
8042
8043 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8044 <td class="entry_name"><html><body><p>android.sensor.info.activeArraySize<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8045 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8046 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8047 <span class="entry_type_container">x</span>
8048
8049 <span class="entry_type_array">
8050 4
8051 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8052 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8053 <div class="entry_type_notes"><html><body><p>Four ints defining the active pixel rectangle<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8054
8055
8056 </td> <!-- entry_type -->
8057
8058 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8059 <html><body><p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8060active pixels; smaller or equal to
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8061pixelArraySize.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8062 </td>
8063
8064 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8065 <html><body><p>xmin, ymin, width, height. Top left of full
8066 pixel array is (0,0)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8067 </td>
8068
8069 <td class="entry_range">
8070 </td>
8071
8072 <td class="entry_notes">
8073 </td>
8074
8075 <td class="entry_tags">
8076 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8077 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8078 </ul>
8079 </td>
8080
8081 </tr> <!-- end of entry -->
8082
8083
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]8084 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8085 <td class="entry_name"><html><body><p>android.sensor.info.sensitivityRange<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8086 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8087 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8088 <span class="entry_type_container">x</span>
8089
8090 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]8091 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8092 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8093 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8094 <div class="entry_type_notes"><html><body><p>Range of supported sensitivities<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8095
8096
8097 </td> <!-- entry_type -->
8098
8099 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8100 <html><body><p>Range of valid sensitivities<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8101 </td>
8102
8103 <td class="entry_units">
8104 </td>
8105
8106 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8107 <html><body><p>Min = 1600<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8108 </td>
8109
8110 <td class="entry_notes">
8111 </td>
8112
8113 <td class="entry_tags">
8114 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8115 <li><a href="#tag_BC">BC</a></li>
8116 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8117 </ul>
8118 </td>
8119
8120 </tr> <!-- end of entry -->
8121
8122
8123 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8124 <td class="entry_name"><html><body><p>android.sensor.info.colorFilterArrangement<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8125 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8126 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8127
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8128 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8129
8130 <ul class="entry_type_enum">
8131 <li>
8132 <span class="entry_type_enum_name">RGGB</span>
8133 </li>
8134 <li>
8135 <span class="entry_type_enum_name">GRBG</span>
8136 </li>
8137 <li>
8138 <span class="entry_type_enum_name">GBRG</span>
8139 </li>
8140 <li>
8141 <span class="entry_type_enum_name">BGGR</span>
8142 </li>
8143 <li>
8144 <span class="entry_type_enum_name">RGB</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8145 <span class="entry_type_enum_notes"><html><body><p>Sensor is not Bayer; output has 3 16-bit
8146 values for each pixel, instead of just 1 16-bit value
8147 per pixel.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8148 </li>
8149 </ul>
8150
8151 </td> <!-- entry_type -->
8152
8153 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8154 <html><body><p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8155represents the colors in the top-left 2x2 section of
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8156the sensor, in reading order<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8157 </td>
8158
8159 <td class="entry_units">
8160 </td>
8161
8162 <td class="entry_range">
8163 </td>
8164
8165 <td class="entry_notes">
8166 </td>
8167
8168 <td class="entry_tags">
8169 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8170 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8171 </ul>
8172 </td>
8173
8174 </tr> <!-- end of entry -->
8175
8176
8177 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8178 <td class="entry_name"><html><body><p>android.sensor.info.exposureTimeRange<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8179 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8180 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8181 <span class="entry_type_container">x</span>
8182
8183 <span class="entry_type_array">
8184 2
8185 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8186 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8187 <div class="entry_type_notes"><html><body><p>nanoseconds<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8188
8189
8190 </td> <!-- entry_type -->
8191
8192 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8193 <html><body><p>Range of valid exposure
8194times<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8195 </td>
8196
8197 <td class="entry_units">
8198 </td>
8199
8200 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8201 <html><body><p>Min = 30e9 (30
8202 sec)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8203 </td>
8204
8205 <td class="entry_notes">
8206 </td>
8207
8208 <td class="entry_tags">
8209 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8210 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8211 </ul>
8212 </td>
8213
8214 </tr> <!-- end of entry -->
8215
8216
8217 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8218 <td class="entry_name"><html><body><p>android.sensor.info.maxFrameDuration<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8219 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8220 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8221
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8222 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8223
8224
8225 </td> <!-- entry_type -->
8226
8227 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8228 <html><body><p>Maximum possible frame duration (minimum frame
8229rate)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8230 </td>
8231
8232 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8233 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8234 </td>
8235
8236 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8237 <html><body><p>&gt;= 30e9<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8238 </td>
8239
8240 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8241 <html><body><p>Minimum duration is a function of resolution,
8242processing settings. See
8243android.scaler.availableProcessedMinDurations
8244android.scaler.availableJpegMinDurations
8245android.scaler.availableRawMinDurations<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8246 </td>
8247
8248 <td class="entry_tags">
8249 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8250 <li><a href="#tag_BC">BC</a></li>
8251 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8252 </ul>
8253 </td>
8254
8255 </tr> <!-- end of entry -->
8256
8257
8258 <tr class="entry" id="static_android.sensor.info.physicalSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8259 <td class="entry_name"><html><body><p>android.sensor.info.physicalSize<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8260 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8261 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8262 <span class="entry_type_container">x</span>
8263
8264 <span class="entry_type_array">
8265 2
8266 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]8267 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8268 <div class="entry_type_notes"><html><body><p>width x height in millimeters<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8269
8270
8271 </td> <!-- entry_type -->
8272
8273 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8274 <html><body><p>The physical dimensions of the full pixel
8275array<wbr></wbr></p></body></html>
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
8284 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8285 <html><body><p>Needed for FOV calculation for old API<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8286 </td>
8287
8288 <td class="entry_tags">
8289 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8290 <li><a href="#tag_V1">V1</a></li>
8291 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8292 </ul>
8293 </td>
8294
8295 </tr> <!-- end of entry -->
8296
8297
8298 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8299 <td class="entry_name"><html><body><p>android.sensor.info.pixelArraySize<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8300 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8301 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8302 <span class="entry_type_container">x</span>
8303
8304 <span class="entry_type_array">
8305 2
8306 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8307 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8308
8309
8310 </td> <!-- entry_type -->
8311
8312 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8313 <html><body><p>Dimensions of full pixel array, possibly
8314including black calibration pixels<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8315 </td>
8316
8317 <td class="entry_units">
8318 </td>
8319
8320 <td class="entry_range">
8321 </td>
8322
8323 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8324 <html><body><p>Maximum output resolution for raw format must
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8325match this in
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8326android.scaler.info.availableSizesPerFormat<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8327 </td>
8328
8329 <td class="entry_tags">
8330 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8331 <li><a href="#tag_DNG">DNG</a></li>
8332 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8333 </ul>
8334 </td>
8335
8336 </tr> <!-- end of entry -->
8337
8338
8339 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8340 <td class="entry_name"><html><body><p>android.sensor.info.whiteLevel<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8341 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8342 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8343
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8344 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8345
8346
8347 </td> <!-- entry_type -->
8348
8349 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8350 <html><body><p>Maximum raw value output by
8351sensor<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8352 </td>
8353
8354 <td class="entry_units">
8355 </td>
8356
8357 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8358 <html><body><p>&gt; 1024 (10-bit output)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8359 </td>
8360
8361 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8362 <html><body><p>Defines sensor bit depth (10-14 bits is
8363expected)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8364 </td>
8365
8366 <td class="entry_tags">
8367 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8368 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8369 </ul>
8370 </td>
8371
8372 </tr> <!-- end of entry -->
8373
8374
8375
8376
8377
8378 <tr class="entry" id="static_android.sensor.baseGainFactor">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8379 <td class="entry_name"><html><body><p>android.sensor.baseGainFactor<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8380 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8381 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8382
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8383 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8384
8385
8386 </td> <!-- entry_type -->
8387
8388 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8389 <html><body><p>Gain factor from electrons to raw units when
8390ISO=100<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8391 </td>
8392
8393 <td class="entry_units">
8394 </td>
8395
8396 <td class="entry_range">
8397 </td>
8398
8399 <td class="entry_notes">
8400 </td>
8401
8402 <td class="entry_tags">
8403 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8404 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]8405 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8406 </ul>
8407 </td>
8408
8409 </tr> <!-- end of entry -->
8410
8411
8412 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8413 <td class="entry_name"><html><body><p>android.sensor.blackLevelPattern<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8414 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8415 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8416 <span class="entry_type_container">x</span>
8417
8418 <span class="entry_type_array">
8419 4
8420 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8421 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8422 <div class="entry_type_notes"><html><body><p>2x2 raw count block<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8423
8424
8425 </td> <!-- entry_type -->
8426
8427 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8428 <html><body><p>A fixed black level offset for each of the
8429Bayer mosaic channels<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8430 </td>
8431
8432 <td class="entry_units">
8433 </td>
8434
8435 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8436 <html><body><p>&gt;= 0 each<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8437 </td>
8438
8439 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8440 <html><body><p>As per DNG BlackLevelRepeatDim / BlackLevel
8441tags<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8442 </td>
8443
8444 <td class="entry_tags">
8445 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8446 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8447 </ul>
8448 </td>
8449
8450 </tr> <!-- end of entry -->
8451
8452
8453 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8454 <td class="entry_name"><html><body><p>android.sensor.calibrationTransform1<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8455 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8456 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8457 <span class="entry_type_container">x</span>
8458
8459 <span class="entry_type_array">
8460 9
8461 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8462 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8463 <div class="entry_type_notes"><html><body><p>3x3 matrix in row-major-order<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8464
8465
8466 </td> <!-- entry_type -->
8467
8468 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8469 <html><body><p>Per-device calibration on top of color space
8470transform 1<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8471 </td>
8472
8473 <td class="entry_units">
8474 </td>
8475
8476 <td class="entry_range">
8477 </td>
8478
8479 <td class="entry_notes">
8480 </td>
8481
8482 <td class="entry_tags">
8483 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8484 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8485 </ul>
8486 </td>
8487
8488 </tr> <!-- end of entry -->
8489
8490
8491 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8492 <td class="entry_name"><html><body><p>android.sensor.calibrationTransform2<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8493 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8494 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8495 <span class="entry_type_container">x</span>
8496
8497 <span class="entry_type_array">
8498 9
8499 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8500 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8501 <div class="entry_type_notes"><html><body><p>3x3 matrix in row-major-order<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8502
8503
8504 </td> <!-- entry_type -->
8505
8506 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8507 <html><body><p>Per-device calibration on top of color space
8508transform 2<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8509 </td>
8510
8511 <td class="entry_units">
8512 </td>
8513
8514 <td class="entry_range">
8515 </td>
8516
8517 <td class="entry_notes">
8518 </td>
8519
8520 <td class="entry_tags">
8521 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8522 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8523 </ul>
8524 </td>
8525
8526 </tr> <!-- end of entry -->
8527
8528
8529 <tr class="entry" id="static_android.sensor.colorTransform1">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8530 <td class="entry_name"><html><body><p>android.sensor.colorTransform1<wbr></wbr></p></body></html></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">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8533 <span class="entry_type_container">x</span>
8534
8535 <span class="entry_type_array">
8536 9
8537 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8538 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8539 <div class="entry_type_notes"><html><body><p>3x3 matrix in row-major-order<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8540
8541
8542 </td> <!-- entry_type -->
8543
8544 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8545 <html><body><p>Linear mapping from XYZ (D50) color space to
8546reference linear sensor color, for first reference
8547illuminant<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8548 </td>
8549
8550 <td class="entry_units">
8551 </td>
8552
8553 <td class="entry_range">
8554 </td>
8555
8556 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8557 <html><body><p>Use as follows XYZ = inv(transform) * clip( (raw -
8558black level(raw) ) / ( white level - max black level) ).
8559At least in the simple case<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8560 </td>
8561
8562 <td class="entry_tags">
8563 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8564 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8565 </ul>
8566 </td>
8567
8568 </tr> <!-- end of entry -->
8569
8570
8571 <tr class="entry" id="static_android.sensor.colorTransform2">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8572 <td class="entry_name"><html><body><p>android.sensor.colorTransform2<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8573 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8574 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8575 <span class="entry_type_container">x</span>
8576
8577 <span class="entry_type_array">
8578 9
8579 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8580 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8581 <div class="entry_type_notes"><html><body><p>3x3 matrix in row-major-order<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8582
8583
8584 </td> <!-- entry_type -->
8585
8586 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8587 <html><body><p>Linear mapping from XYZ (D50) color space to
8588reference linear sensor color, for second reference
8589illuminant<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8590 </td>
8591
8592 <td class="entry_units">
8593 </td>
8594
8595 <td class="entry_range">
8596 </td>
8597
8598 <td class="entry_notes">
8599 </td>
8600
8601 <td class="entry_tags">
8602 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8603 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8604 </ul>
8605 </td>
8606
8607 </tr> <!-- end of entry -->
8608
8609
8610 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8611 <td class="entry_name"><html><body><p>android.sensor.forwardMatrix1<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8612 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8613 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8614 <span class="entry_type_container">x</span>
8615
8616 <span class="entry_type_array">
8617 9
8618 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8619 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8620 <div class="entry_type_notes"><html><body><p>3x3 matrix in row-major-order<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8621
8622
8623 </td> <!-- entry_type -->
8624
8625 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8626 <html><body><p>Used by DNG for better WB
8627adaptation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8628 </td>
8629
8630 <td class="entry_units">
8631 </td>
8632
8633 <td class="entry_range">
8634 </td>
8635
8636 <td class="entry_notes">
8637 </td>
8638
8639 <td class="entry_tags">
8640 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8641 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8642 </ul>
8643 </td>
8644
8645 </tr> <!-- end of entry -->
8646
8647
8648 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8649 <td class="entry_name"><html><body><p>android.sensor.forwardMatrix2<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8650 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8651 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8652 <span class="entry_type_container">x</span>
8653
8654 <span class="entry_type_array">
8655 9
8656 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8657 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8658 <div class="entry_type_notes"><html><body><p>3x3 matrix in row-major-order<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8659
8660
8661 </td> <!-- entry_type -->
8662
8663 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8664 <html><body><p>Used by DNG for better WB
8665adaptation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8666 </td>
8667
8668 <td class="entry_units">
8669 </td>
8670
8671 <td class="entry_range">
8672 </td>
8673
8674 <td class="entry_notes">
8675 </td>
8676
8677 <td class="entry_tags">
8678 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8679 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8680 </ul>
8681 </td>
8682
8683 </tr> <!-- end of entry -->
8684
8685
8686 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8687 <td class="entry_name"><html><body><p>android.sensor.maxAnalogSensitivity<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8688 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8689 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8690
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8691 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8692
8693
8694 </td> <!-- entry_type -->
8695
8696 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8697 <html><body><p>Maximum sensitivity that is implemented
8698purely through analog gain<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8699 </td>
8700
8701 <td class="entry_units">
8702 </td>
8703
8704 <td class="entry_range">
8705 </td>
8706
8707 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8708 <html><body><p>For android.sensor.sensitivity values less than or
8709equal to this, all applied gain must be analog. For
8710values above this, it can be a mix of analog and
8711digital<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8712 </td>
8713
8714 <td class="entry_tags">
8715 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8716 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]8717 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8718 </ul>
8719 </td>
8720
8721 </tr> <!-- end of entry -->
8722
8723
8724 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8725 <td class="entry_name"><html><body><p>android.sensor.noiseModelCoefficients<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8726 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8727 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8728 <span class="entry_type_container">x</span>
8729
8730 <span class="entry_type_array">
8731 2
8732 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8733 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8734 <div class="entry_type_notes"><html><body><p>float constants A, B for the noise variance model<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8735
8736
8737 </td> <!-- entry_type -->
8738
8739 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8740 <html><body><p>Estimation of sensor noise
8741characteristics<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8742 </td>
8743
8744 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8745 <html><body><p>var(raw pixel value) = electrons * (baseGainFactor
8746 * iso/100)^2 + A * (baseGainFactor * iso/100)^2 +
8747 B<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8748 </td>
8749
8750 <td class="entry_range">
8751 </td>
8752
8753 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8754 <html><body><p>A represents sensor read noise before analog
8755amplification; B represents noise from A/D conversion and
8756other circuits after amplification. Both noise sources
8757are assumed to be gaussian, independent, and not to vary
8758across the sensor<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8759 </td>
8760
8761 <td class="entry_tags">
8762 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8763 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8764 </ul>
8765 </td>
8766
8767 </tr> <!-- end of entry -->
8768
8769
8770 <tr class="entry" id="static_android.sensor.orientation">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8771 <td class="entry_name"><html><body><p>android.sensor.orientation<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8772 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8773 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8774
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8775 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8776
8777
8778 </td> <!-- entry_type -->
8779
8780 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8781 <html><body><p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8782image needs to be rotated to be upright on the device
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8783screen in its native orientation. Also defines the
8784direction of rolling shutter readout, which is from top
8785to bottom in the sensor's coordinate system<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8786 </td>
8787
8788 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8789 <html><body><p>degrees clockwise rotation, only multiples of
8790 90<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8791 </td>
8792
8793 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8794 <html><body><p>0,90,180,270<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8795 </td>
8796
8797 <td class="entry_notes">
8798 </td>
8799
8800 <td class="entry_tags">
8801 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8802 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8803 </ul>
8804 </td>
8805
8806 </tr> <!-- end of entry -->
8807
8808
8809 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8810 <td class="entry_name"><html><body><p>android.sensor.referenceIlluminant1<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8811 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8812 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8813
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8814 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8815
8816 <ul class="entry_type_enum">
8817 <li>
8818 <span class="entry_type_enum_name">DAYLIGHT</span>
8819 <span class="entry_type_enum_value">1</span>
8820 </li>
8821 <li>
8822 <span class="entry_type_enum_name">FLUORESCENT</span>
8823 <span class="entry_type_enum_value">2</span>
8824 </li>
8825 <li>
8826 <span class="entry_type_enum_name">TUNGSTEN</span>
8827 <span class="entry_type_enum_value">3</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8828 <span class="entry_type_enum_notes"><html><body><p>Incandescent light<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8829 </li>
8830 <li>
8831 <span class="entry_type_enum_name">FLASH</span>
8832 <span class="entry_type_enum_value">4</span>
8833 </li>
8834 <li>
8835 <span class="entry_type_enum_name">FINE_WEATHER</span>
8836 <span class="entry_type_enum_value">9</span>
8837 </li>
8838 <li>
8839 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
8840 <span class="entry_type_enum_value">10</span>
8841 </li>
8842 <li>
8843 <span class="entry_type_enum_name">SHADE</span>
8844 <span class="entry_type_enum_value">11</span>
8845 </li>
8846 <li>
8847 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
8848 <span class="entry_type_enum_value">12</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8849 <span class="entry_type_enum_notes"><html><body><p>D 5700 - 7100K<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8850 </li>
8851 <li>
8852 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
8853 <span class="entry_type_enum_value">13</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8854 <span class="entry_type_enum_notes"><html><body><p>N 4600 - 5400K<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8855 </li>
8856 <li>
8857 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
8858 <span class="entry_type_enum_value">14</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8859 <span class="entry_type_enum_notes"><html><body><p>W 3900 - 4500K<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8860 </li>
8861 <li>
8862 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
8863 <span class="entry_type_enum_value">15</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8864 <span class="entry_type_enum_notes"><html><body><p>WW 3200 - 3700K<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8865 </li>
8866 <li>
8867 <span class="entry_type_enum_name">STANDARD_A</span>
8868 <span class="entry_type_enum_value">17</span>
8869 </li>
8870 <li>
8871 <span class="entry_type_enum_name">STANDARD_B</span>
8872 <span class="entry_type_enum_value">18</span>
8873 </li>
8874 <li>
8875 <span class="entry_type_enum_name">STANDARD_C</span>
8876 <span class="entry_type_enum_value">19</span>
8877 </li>
8878 <li>
8879 <span class="entry_type_enum_name">D55</span>
8880 <span class="entry_type_enum_value">20</span>
8881 </li>
8882 <li>
8883 <span class="entry_type_enum_name">D65</span>
8884 <span class="entry_type_enum_value">21</span>
8885 </li>
8886 <li>
8887 <span class="entry_type_enum_name">D75</span>
8888 <span class="entry_type_enum_value">22</span>
8889 </li>
8890 <li>
8891 <span class="entry_type_enum_name">D50</span>
8892 <span class="entry_type_enum_value">23</span>
8893 </li>
8894 <li>
8895 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
8896 <span class="entry_type_enum_value">24</span>
8897 </li>
8898 </ul>
8899
8900 </td> <!-- entry_type -->
8901
8902 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8903 <html><body><p>Light source used to define transform
89041<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8905 </td>
8906
8907 <td class="entry_units">
8908 </td>
8909
8910 <td class="entry_range">
8911 </td>
8912
8913 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8914 <html><body><p>[EXIF LightSource tag] Must all these be
8915supported? Need CCT for each!<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8916 </td>
8917
8918 <td class="entry_tags">
8919 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8920 <li><a href="#tag_DNG">DNG</a></li>
8921 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8922 </ul>
8923 </td>
8924
8925 </tr> <!-- end of entry -->
8926
8927
8928 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8929 <td class="entry_name"><html><body><p>android.sensor.referenceIlluminant2<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8930 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8931 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8932
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8933 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8934
8935
8936 </td> <!-- entry_type -->
8937
8938 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8939 <html><body><p>Light source used to define transform
89402<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8941 </td>
8942
8943 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8944 <html><body><p>Same as illuminant 1<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8945 </td>
8946
8947 <td class="entry_range">
8948 </td>
8949
8950 <td class="entry_notes">
8951 </td>
8952
8953 <td class="entry_tags">
8954 </td>
8955
8956 </tr> <!-- end of entry -->
8957
8958
8959
8960 <!-- end of kind -->
8961 </tbody>
8962 <tr><td colspan="7" class="kind">dynamic</td></tr>
8963
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8964 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8965 <tr>
8966 <th class="th_name">Property Name</th>
8967 <th class="th_type">Type</th>
8968 <th class="th_description">Description</th>
8969 <th class="th_units">Units</th>
8970 <th class="th_range">Range</th>
8971 <th class="th_notes">Notes</th>
8972 <th class="th_tags">Tags</th>
8973 </tr>
8974 </thead>
8975
8976 <tbody>
8977
8978
8979
8980
8981
8982
8983
8984
8985
8986
8987 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8988 <td class="entry_name"><html><body><p>android.sensor.exposureTime<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8989 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8990 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8991
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8992 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8993
8994
8995 </td> <!-- entry_type -->
8996
8997 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8998 <html><body><p>Duration each pixel is exposed to
8999light.</p>
9000<p>If the sensor can't expose this exact duration, it should shorten the
9001duration exposed to the nearest possible value (rather than expose longer).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9002 </td>
9003
9004 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9005 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9006 </td>
9007
9008 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9009 <html><body><p>android.sensor.info.exposureTimeRange<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9010 </td>
9011
9012 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9013 <html><body><p>1/10000 - 30 sec range. No bulb mode<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9014 </td>
9015
9016 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9017 <ul class="entry_tags">
9018 <li><a href="#tag_V1">V1</a></li>
9019 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9020 </td>
9021
9022 </tr> <!-- end of entry -->
9023
9024
9025 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9026 <td class="entry_name"><html><body><p>android.sensor.frameDuration<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9027 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9028 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9029
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9030 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9031
9032
9033 </td> <!-- entry_type -->
9034
9035 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9036 <html><body><p>Duration from start of frame exposure to
9037start of next frame exposure<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9038 </td>
9039
9040 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9041 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9042 </td>
9043
9044 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9045 <html><body><p>see android.sensor.info.maxFrameDuration,
9046 android.scaler.info.availableMinFrameDurations<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9047 </td>
9048
9049 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9050 <html><body><p>Exposure time has priority, so duration is set to
9051max(duration, exposure time + overhead)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9052 </td>
9053
9054 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9055 <ul class="entry_tags">
9056 <li><a href="#tag_V1">V1</a></li>
9057 <li><a href="#tag_BC">BC</a></li>
9058 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9059 </td>
9060
9061 </tr> <!-- end of entry -->
9062
9063
9064 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9065 <td class="entry_name"><html><body><p>android.sensor.sensitivity<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9066 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9067 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9068
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9069 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9070
9071
9072 </td> <!-- entry_type -->
9073
9074 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9075 <html><body><p>Gain applied to image data. Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9076implemented through analog gain only if set to values
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9077below 'maximum analog sensitivity'.</p>
9078<p>If the sensor can't apply this exact gain, it should lessen the
9079gain to the nearest possible value (rather than gain more).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9080 </td>
9081
9082 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9083 <html><body><p>ISO arithmetic units<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9084 </td>
9085
9086 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9087 <html><body><p>android.sensor.info.sensitivityRange<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9088 </td>
9089
9090 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9091 <html><body><p>ISO 12232:2006 REI method<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9092 </td>
9093
9094 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9095 <ul class="entry_tags">
9096 <li><a href="#tag_V1">V1</a></li>
9097 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9098 </td>
9099
9100 </tr> <!-- end of entry -->
9101
9102
9103 <tr class="entry" id="dynamic_android.sensor.timestamp">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9104 <td class="entry_name"><html><body><p>android.sensor.timestamp<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9105 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9106 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9107
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9108 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9109
9110
9111 </td> <!-- entry_type -->
9112
9113 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9114 <html><body><p>Time at start of exposure of first
9115row<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9116 </td>
9117
9118 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9119 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9120 </td>
9121
9122 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9123 <html><body><p>&gt; 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9124 </td>
9125
9126 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9127 <html><body><p>Monotonic, should be synced to other timestamps in
9128system<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9129 </td>
9130
9131 <td class="entry_tags">
9132 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9133 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9134 </ul>
9135 </td>
9136
9137 </tr> <!-- end of entry -->
9138
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]9139
9140 <tr class="entry" id="dynamic_android.sensor.temperature">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9141 <td class="entry_name"><html><body><p>android.sensor.temperature<wbr></wbr></p></body></html></td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]9142 <td class="entry_type">
9143 <span class="entry_type_name">float</span>
9144
9145 <span class="entry_type_visibility"> [public]</span>
9146
9147
9148 </td> <!-- entry_type -->
9149
9150 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9151 <html><body><p>The temperature of the sensor, sampled at the time
9152exposure began for this frame.</p>
9153<p>The thermal diode being queried should be inside the sensor PCB, or
9154somewhere close to it.<wbr></wbr></p></body></html>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]9155 </td>
9156
9157 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9158 <html><body><p>celsius<wbr></wbr></p></body></html>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]9159 </td>
9160
9161 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9162 <html><body><p>Optional. This value is missing if no temperature is available.<wbr></wbr></p></body></html>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]9163 </td>
9164
9165 <td class="entry_notes">
9166 </td>
9167
9168 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9169 <ul class="entry_tags">
9170 <li><a href="#tag_FULL">FULL</a></li>
9171 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]9172 </td>
9173
9174 </tr> <!-- end of entry -->
9175
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9176
9177
9178 <!-- end of kind -->
9179 </tbody>
9180
9181 <!-- end of section -->
9182 <tr><td colspan="7" id="section_shading" class="section">shading</td></tr>
9183
9184
9185 <tr><td colspan="7" class="kind">controls</td></tr>
9186
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9187 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9188 <tr>
9189 <th class="th_name">Property Name</th>
9190 <th class="th_type">Type</th>
9191 <th class="th_description">Description</th>
9192 <th class="th_units">Units</th>
9193 <th class="th_range">Range</th>
9194 <th class="th_notes">Notes</th>
9195 <th class="th_tags">Tags</th>
9196 </tr>
9197 </thead>
9198
9199 <tbody>
9200
9201
9202
9203
9204
9205
9206
9207
9208
9209
9210 <tr class="entry" id="controls_android.shading.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9211 <td class="entry_name"><html><body><p>android.shading.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9212 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9213 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9214
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9215 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9216
9217 <ul class="entry_type_enum">
9218 <li>
9219 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9220 <span class="entry_type_enum_notes"><html><body><p>No shading correction is applied<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9221 </li>
9222 <li>
9223 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9224 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
9225 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9226 </li>
9227 <li>
9228 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9229 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
9230 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9231 </li>
9232 </ul>
9233
9234 </td> <!-- entry_type -->
9235
9236 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9237 <html><body><p>Quality of lens shading correction applied
9238to the image data<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9239 </td>
9240
9241 <td class="entry_units">
9242 </td>
9243
9244 <td class="entry_range">
9245 </td>
9246
9247 <td class="entry_notes">
9248 </td>
9249
9250 <td class="entry_tags">
9251 </td>
9252
9253 </tr> <!-- end of entry -->
9254
9255
9256 <tr class="entry" id="controls_android.shading.strength">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9257 <td class="entry_name"><html><body><p>android.shading.strength<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9258 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9259 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9260
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9261 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9262
9263
9264 </td> <!-- entry_type -->
9265
9266 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9267 <html><body><p>Control the amount of shading correction
9268applied to the images<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9269 </td>
9270
9271 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9272 <html><body><p>unitless: 1-10; 10 is full shading
9273 compensation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9274 </td>
9275
9276 <td class="entry_range">
9277 </td>
9278
9279 <td class="entry_notes">
9280 </td>
9281
9282 <td class="entry_tags">
9283 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9284 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9285 </ul>
9286 </td>
9287
9288 </tr> <!-- end of entry -->
9289
9290
9291
9292 <!-- end of kind -->
9293 </tbody>
9294 <tr><td colspan="7" class="kind">dynamic</td></tr>
9295
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9296 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9297 <tr>
9298 <th class="th_name">Property Name</th>
9299 <th class="th_type">Type</th>
9300 <th class="th_description">Description</th>
9301 <th class="th_units">Units</th>
9302 <th class="th_range">Range</th>
9303 <th class="th_notes">Notes</th>
9304 <th class="th_tags">Tags</th>
9305 </tr>
9306 </thead>
9307
9308 <tbody>
9309
9310
9311
9312
9313
9314
9315
9316
9317
9318
9319 <tr class="entry" id="dynamic_android.shading.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9320 <td class="entry_name"><html><body><p>android.shading.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9321 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9322 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9323
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9324 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9325
9326 <ul class="entry_type_enum">
9327 <li>
9328 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9329 <span class="entry_type_enum_notes"><html><body><p>No shading correction is applied<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9330 </li>
9331 <li>
9332 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9333 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
9334 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9335 </li>
9336 <li>
9337 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9338 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
9339 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9340 </li>
9341 </ul>
9342
9343 </td> <!-- entry_type -->
9344
9345 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9346 <html><body><p>Quality of lens shading correction applied
9347to the image data<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9348 </td>
9349
9350 <td class="entry_units">
9351 </td>
9352
9353 <td class="entry_range">
9354 </td>
9355
9356 <td class="entry_notes">
9357 </td>
9358
9359 <td class="entry_tags">
9360 </td>
9361
9362 </tr> <!-- end of entry -->
9363
9364
9365
9366 <!-- end of kind -->
9367 </tbody>
9368
9369 <!-- end of section -->
9370 <tr><td colspan="7" id="section_statistics" class="section">statistics</td></tr>
9371
9372
9373 <tr><td colspan="7" class="kind">controls</td></tr>
9374
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9375 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9376 <tr>
9377 <th class="th_name">Property Name</th>
9378 <th class="th_type">Type</th>
9379 <th class="th_description">Description</th>
9380 <th class="th_units">Units</th>
9381 <th class="th_range">Range</th>
9382 <th class="th_notes">Notes</th>
9383 <th class="th_tags">Tags</th>
9384 </tr>
9385 </thead>
9386
9387 <tbody>
9388
9389
9390
9391
9392
9393
9394
9395
9396
9397
9398 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9399 <td class="entry_name"><html><body><p>android.statistics.faceDetectMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9400 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9401 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9402
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9403 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9404
9405 <ul class="entry_type_enum">
9406 <li>
9407 <span class="entry_type_enum_name">OFF</span>
9408 </li>
9409 <li>
9410 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9411 <span class="entry_type_enum_notes"><html><body><p>Optional Return rectangle and confidence
9412 only<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9413 </li>
9414 <li>
9415 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9416 <span class="entry_type_enum_notes"><html><body><p>Optional Return all face
9417 metadata<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9418 </li>
9419 </ul>
9420
9421 </td> <!-- entry_type -->
9422
9423 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9424 <html><body><p>State of the face detector
9425unit<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9426 </td>
9427
9428 <td class="entry_units">
9429 </td>
9430
9431 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9432 <html><body><p>android.statistics.info.availableFaceDetectModes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9433 </td>
9434
9435 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9436 <html><body><p>Whether face detection is enabled, and whether it
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9437should output just the basic fields or the full set of
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9438fields. Value must be one of the
9439android.statistics.info.availableFaceDetectModes.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9440 </td>
9441
9442 <td class="entry_tags">
9443 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9444 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9445 </ul>
9446 </td>
9447
9448 </tr> <!-- end of entry -->
9449
9450
9451 <tr class="entry" id="controls_android.statistics.histogramMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9452 <td class="entry_name"><html><body><p>android.statistics.histogramMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9453 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9454 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9455
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9456 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9457
9458 <ul class="entry_type_enum">
9459 <li>
9460 <span class="entry_type_enum_name">OFF</span>
9461 </li>
9462 <li>
9463 <span class="entry_type_enum_name">ON</span>
9464 </li>
9465 </ul>
9466
9467 </td> <!-- entry_type -->
9468
9469 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9470 <html><body><p>Operating mode for histogram
9471generation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9472 </td>
9473
9474 <td class="entry_units">
9475 </td>
9476
9477 <td class="entry_range">
9478 </td>
9479
9480 <td class="entry_notes">
9481 </td>
9482
9483 <td class="entry_tags">
9484 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9485 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9486 </ul>
9487 </td>
9488
9489 </tr> <!-- end of entry -->
9490
9491
9492 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9493 <td class="entry_name"><html><body><p>android.statistics.sharpnessMapMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9494 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9495 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9496
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9497 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9498
9499 <ul class="entry_type_enum">
9500 <li>
9501 <span class="entry_type_enum_name">OFF</span>
9502 </li>
9503 <li>
9504 <span class="entry_type_enum_name">ON</span>
9505 </li>
9506 </ul>
9507
9508 </td> <!-- entry_type -->
9509
9510 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9511 <html><body><p>Operating mode for sharpness map
9512generation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9513 </td>
9514
9515 <td class="entry_units">
9516 </td>
9517
9518 <td class="entry_range">
9519 </td>
9520
9521 <td class="entry_notes">
9522 </td>
9523
9524 <td class="entry_tags">
9525 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9526 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9527 </ul>
9528 </td>
9529
9530 </tr> <!-- end of entry -->
9531
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9532
9533 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9534 <td class="entry_name"><html><body><p>android.statistics.lensShadingMapMode<wbr></wbr></p></body></html></td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9535 <td class="entry_type">
9536 <span class="entry_type_name entry_type_name_enum">byte</span>
9537
9538 <span class="entry_type_visibility"> [public]</span>
9539
9540 <ul class="entry_type_enum">
9541 <li>
9542 <span class="entry_type_enum_name">OFF</span>
9543 </li>
9544 <li>
9545 <span class="entry_type_enum_name">ON</span>
9546 </li>
9547 </ul>
9548
9549 </td> <!-- entry_type -->
9550
9551 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9552 <html><body><p>Whether the HAL needs to output the lens
9553shading map in output result metadata<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9554 </td>
9555
9556 <td class="entry_units">
9557 </td>
9558
9559 <td class="entry_range">
9560 </td>
9561
9562 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9563 <html><body><p>When set to ON,
9564android.statistics.lensShadingMap must be provided in
9565the output result metadata.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9566 </td>
9567
9568 <td class="entry_tags">
9569 </td>
9570
9571 </tr> <!-- end of entry -->
9572
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9573
9574
9575 <!-- end of kind -->
9576 </tbody>
9577 <tr><td colspan="7" class="kind">static</td></tr>
9578
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9579 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9580 <tr>
9581 <th class="th_name">Property Name</th>
9582 <th class="th_type">Type</th>
9583 <th class="th_description">Description</th>
9584 <th class="th_units">Units</th>
9585 <th class="th_range">Range</th>
9586 <th class="th_notes">Notes</th>
9587 <th class="th_tags">Tags</th>
9588 </tr>
9589 </thead>
9590
9591 <tbody>
9592
9593
9594
9595
9596
9597
9598
9599
9600
9601
9602
9603
9604 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9605 <td class="entry_name"><html><body><p>android.statistics.info.availableFaceDetectModes<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9606 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9607 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9608 <span class="entry_type_container">x</span>
9609
9610 <span class="entry_type_array">
9611 n
9612 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9613 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9614 <div class="entry_type_notes"><html><body><p>List of enums from android.statistics.faceDetectMode<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9615
9616
9617 </td> <!-- entry_type -->
9618
9619 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9620 <html><body><p>Which face detection modes are available,
9621if any<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9622 </td>
9623
9624 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9625 <html><body><p>List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9626 OFF
9627 SIMPLE
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9628 FULL<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9629 </td>
9630
9631 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9632 </td>
9633
9634 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9635 <html><body><p>OFF means face detection is disabled, it must
9636be included in the list.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9637<p>SIMPLE means the device supports the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9638android.statistics.faceRectangles and
9639android.statistics.faceScores outputs.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9640<p>FULL means the device additionally supports the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9641android.statistics.faceIds and
9642android.statistics.faceLandmarks outputs.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9643 </td>
9644
9645 <td class="entry_tags">
9646 </td>
9647
9648 </tr> <!-- end of entry -->
9649
9650
9651 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9652 <td class="entry_name"><html><body><p>android.statistics.info.histogramBucketCount<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9653 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9654 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9655
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9656 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9657
9658
9659 </td> <!-- entry_type -->
9660
9661 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9662 <html><body><p>Number of histogram buckets
9663supported<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9664 </td>
9665
9666 <td class="entry_units">
9667 </td>
9668
9669 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9670 <html><body><p>&gt;= 64<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9671 </td>
9672
9673 <td class="entry_notes">
9674 </td>
9675
9676 <td class="entry_tags">
9677 </td>
9678
9679 </tr> <!-- end of entry -->
9680
9681
9682 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9683 <td class="entry_name"><html><body><p>android.statistics.info.maxFaceCount<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9684 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9685 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9686
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9687 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9688
9689
9690 </td> <!-- entry_type -->
9691
9692 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9693 <html><body><p>Maximum number of simultaneously detectable
9694faces<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9695 </td>
9696
9697 <td class="entry_units">
9698 </td>
9699
9700 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9701 <html><body><p>&gt;= 4 if availableFaceDetectionModes lists
9702 modes besides OFF, otherwise 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9703 </td>
9704
9705 <td class="entry_notes">
9706 </td>
9707
9708 <td class="entry_tags">
9709 </td>
9710
9711 </tr> <!-- end of entry -->
9712
9713
9714 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9715 <td class="entry_name"><html><body><p>android.statistics.info.maxHistogramCount<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9716 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9717 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9718
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9719 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9720
9721
9722 </td> <!-- entry_type -->
9723
9724 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9725 <html><body><p>Maximum value possible for a histogram
9726bucket<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9727 </td>
9728
9729 <td class="entry_units">
9730 </td>
9731
9732 <td class="entry_range">
9733 </td>
9734
9735 <td class="entry_notes">
9736 </td>
9737
9738 <td class="entry_tags">
9739 </td>
9740
9741 </tr> <!-- end of entry -->
9742
9743
9744 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9745 <td class="entry_name"><html><body><p>android.statistics.info.maxSharpnessMapValue<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9746 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9747 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9748
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9749 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9750
9751
9752 </td> <!-- entry_type -->
9753
9754 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9755 <html><body><p>Maximum value possible for a sharpness map
9756region.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9757 </td>
9758
9759 <td class="entry_units">
9760 </td>
9761
9762 <td class="entry_range">
9763 </td>
9764
9765 <td class="entry_notes">
9766 </td>
9767
9768 <td class="entry_tags">
9769 </td>
9770
9771 </tr> <!-- end of entry -->
9772
9773
9774 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9775 <td class="entry_name"><html><body><p>android.statistics.info.sharpnessMapSize<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9776 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9777 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9778 <span class="entry_type_container">x</span>
9779
9780 <span class="entry_type_array">
9781 2
9782 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9783 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9784 <div class="entry_type_notes"><html><body><p>width x height<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9785
9786
9787 </td> <!-- entry_type -->
9788
9789 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9790 <html><body><p>Dimensions of the sharpness
9791map<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9792 </td>
9793
9794 <td class="entry_units">
9795 </td>
9796
9797 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9798 <html><body><p>Must be at least 32 x 32<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9799 </td>
9800
9801 <td class="entry_notes">
9802 </td>
9803
9804 <td class="entry_tags">
9805 </td>
9806
9807 </tr> <!-- end of entry -->
9808
9809
9810
9811
9812
9813
9814 <!-- end of kind -->
9815 </tbody>
9816 <tr><td colspan="7" class="kind">dynamic</td></tr>
9817
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9818 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9819 <tr>
9820 <th class="th_name">Property Name</th>
9821 <th class="th_type">Type</th>
9822 <th class="th_description">Description</th>
9823 <th class="th_units">Units</th>
9824 <th class="th_range">Range</th>
9825 <th class="th_notes">Notes</th>
9826 <th class="th_tags">Tags</th>
9827 </tr>
9828 </thead>
9829
9830 <tbody>
9831
9832
9833
9834
9835
9836
9837
9838
9839
9840
9841 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9842 <td class="entry_name"><html><body><p>android.statistics.faceDetectMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9843 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9844 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9845
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9846 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9847
9848 <ul class="entry_type_enum">
9849 <li>
9850 <span class="entry_type_enum_name">OFF</span>
9851 </li>
9852 <li>
9853 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9854 <span class="entry_type_enum_notes"><html><body><p>Optional Return rectangle and confidence
9855 only<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9856 </li>
9857 <li>
9858 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9859 <span class="entry_type_enum_notes"><html><body><p>Optional Return all face
9860 metadata<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9861 </li>
9862 </ul>
9863
9864 </td> <!-- entry_type -->
9865
9866 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9867 <html><body><p>State of the face detector
9868unit<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9869 </td>
9870
9871 <td class="entry_units">
9872 </td>
9873
9874 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9875 <html><body><p>android.statistics.info.availableFaceDetectModes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9876 </td>
9877
9878 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9879 <html><body><p>Whether face detection is enabled, and whether it
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9880should output just the basic fields or the full set of
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9881fields. Value must be one of the
9882android.statistics.info.availableFaceDetectModes.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9883 </td>
9884
9885 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9886 <ul class="entry_tags">
9887 <li><a href="#tag_BC">BC</a></li>
9888 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9889 </td>
9890
9891 </tr> <!-- end of entry -->
9892
9893
9894 <tr class="entry" id="dynamic_android.statistics.faceIds">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9895 <td class="entry_name"><html><body><p>android.statistics.faceIds<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9896 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9897 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9898 <span class="entry_type_container">x</span>
9899
9900 <span class="entry_type_array">
9901 n
9902 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]9903 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9904
9905
9906 </td> <!-- entry_type -->
9907
9908 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9909 <html><body><p>List of unique IDs for detected
9910faces<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9911 </td>
9912
9913 <td class="entry_units">
9914 </td>
9915
9916 <td class="entry_range">
9917 </td>
9918
9919 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9920 <html><body><p>Only available if faceDetectMode == FULL<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9921 </td>
9922
9923 <td class="entry_tags">
9924 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9925 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9926 </ul>
9927 </td>
9928
9929 </tr> <!-- end of entry -->
9930
9931
9932 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9933 <td class="entry_name"><html><body><p>android.statistics.faceLandmarks<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9934 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9935 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9936 <span class="entry_type_container">x</span>
9937
9938 <span class="entry_type_array">
9939 n x 6
9940 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]9941 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9942 <div class="entry_type_notes"><html><body><p>(leftEyeX, leftEyeY, rightEyeX, rightEyeY, mouthX, mouthY)<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9943
9944
9945 </td> <!-- entry_type -->
9946
9947 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9948 <html><body><p>List of landmarks for detected
9949faces<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9950 </td>
9951
9952 <td class="entry_units">
9953 </td>
9954
9955 <td class="entry_range">
9956 </td>
9957
9958 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9959 <html><body><p>Only available if faceDetectMode == FULL<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9960 </td>
9961
9962 <td class="entry_tags">
9963 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9964 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9965 </ul>
9966 </td>
9967
9968 </tr> <!-- end of entry -->
9969
9970
9971 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9972 <td class="entry_name"><html><body><p>android.statistics.faceRectangles<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9973 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9974 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9975 <span class="entry_type_container">x</span>
9976
9977 <span class="entry_type_array">
9978 n x 4
9979 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]9980 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9981 <div class="entry_type_notes"><html><body><p>(xmin, ymin, xmax, ymax). (0,0) is top-left of active pixel area<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9982
9983
9984 </td> <!-- entry_type -->
9985
9986 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9987 <html><body><p>List of the bounding rectangles for detected
9988faces<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9989 </td>
9990
9991 <td class="entry_units">
9992 </td>
9993
9994 <td class="entry_range">
9995 </td>
9996
9997 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9998 <html><body><p>Only available if faceDetectMode != OFF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9999 </td>
10000
10001 <td class="entry_tags">
10002 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10003 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10004 </ul>
10005 </td>
10006
10007 </tr> <!-- end of entry -->
10008
10009
10010 <tr class="entry" id="dynamic_android.statistics.faceScores">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10011 <td class="entry_name"><html><body><p>android.statistics.faceScores<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10012 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10013 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10014 <span class="entry_type_container">x</span>
10015
10016 <span class="entry_type_array">
10017 n
10018 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]10019 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10020
10021
10022 </td> <!-- entry_type -->
10023
10024 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10025 <html><body><p>List of the face confidence scores for
10026detected faces<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10027 </td>
10028
10029 <td class="entry_units">
10030 </td>
10031
10032 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10033 <html><body><p>1-100<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10034 </td>
10035
10036 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10037 <html><body><p>Only available if faceDetectMode != OFF. The value should be
10038meaningful (for example, setting 100 at all times is illegal).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10039 </td>
10040
10041 <td class="entry_tags">
10042 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10043 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10044 </ul>
10045 </td>
10046
10047 </tr> <!-- end of entry -->
10048
10049
10050 <tr class="entry" id="dynamic_android.statistics.histogram">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10051 <td class="entry_name"><html><body><p>android.statistics.histogram<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10052 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10053 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10054 <span class="entry_type_container">x</span>
10055
10056 <span class="entry_type_array">
10057 n x 3
10058 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10059 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10060 <div class="entry_type_notes"><html><body><p>count of pixels for each color channel that fall into each histogram bucket, scaled to be between 0 and maxHistogramCount<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10061
10062
10063 </td> <!-- entry_type -->
10064
10065 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10066 <html><body><p>A 3-channel histogram based on the raw
10067sensor data<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10068 </td>
10069
10070 <td class="entry_units">
10071 </td>
10072
10073 <td class="entry_range">
10074 </td>
10075
10076 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10077 <html><body><p>The k'th bucket (0-based) covers the input range
10078(with w = android.sensor.info.whiteLevel) of [ k * w/N,
10079(k + 1) * w / N ). If only a monochrome sharpness map is
10080supported, all channels should have the same data<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10081 </td>
10082
10083 <td class="entry_tags">
10084 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10085 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10086 </ul>
10087 </td>
10088
10089 </tr> <!-- end of entry -->
10090
10091
10092 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10093 <td class="entry_name"><html><body><p>android.statistics.histogramMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10094 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10095 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10096
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10097 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10098
10099 <ul class="entry_type_enum">
10100 <li>
10101 <span class="entry_type_enum_name">OFF</span>
10102 </li>
10103 <li>
10104 <span class="entry_type_enum_name">ON</span>
10105 </li>
10106 </ul>
10107
10108 </td> <!-- entry_type -->
10109
10110 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10111 <html><body><p>Operating mode for histogram
10112generation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10113 </td>
10114
10115 <td class="entry_units">
10116 </td>
10117
10118 <td class="entry_range">
10119 </td>
10120
10121 <td class="entry_notes">
10122 </td>
10123
10124 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10125 <ul class="entry_tags">
10126 <li><a href="#tag_V1">V1</a></li>
10127 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10128 </td>
10129
10130 </tr> <!-- end of entry -->
10131
10132
10133 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10134 <td class="entry_name"><html><body><p>android.statistics.sharpnessMap<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10135 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10136 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10137 <span class="entry_type_container">x</span>
10138
10139 <span class="entry_type_array">
10140 n x m x 3
10141 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10142 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10143 <div class="entry_type_notes"><html><body><p>estimated sharpness for each region of the input image. Normalized to be between 0 and maxSharpnessMapValue. Higher values mean sharper (better focused)<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10144
10145
10146 </td> <!-- entry_type -->
10147
10148 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10149 <html><body><p>A 3-channel sharpness map, based on the raw
10150sensor data<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10151 </td>
10152
10153 <td class="entry_units">
10154 </td>
10155
10156 <td class="entry_range">
10157 </td>
10158
10159 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10160 <html><body><p>If only a monochrome sharpness map is supported,
10161all channels should have the same data<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10162 </td>
10163
10164 <td class="entry_tags">
10165 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10166 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10167 </ul>
10168 </td>
10169
10170 </tr> <!-- end of entry -->
10171
10172
10173 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10174 <td class="entry_name"><html><body><p>android.statistics.sharpnessMapMode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10175 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10176 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10177
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10178 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10179
10180 <ul class="entry_type_enum">
10181 <li>
10182 <span class="entry_type_enum_name">OFF</span>
10183 </li>
10184 <li>
10185 <span class="entry_type_enum_name">ON</span>
10186 </li>
10187 </ul>
10188
10189 </td> <!-- entry_type -->
10190
10191 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10192 <html><body><p>Operating mode for sharpness map
10193generation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10194 </td>
10195
10196 <td class="entry_units">
10197 </td>
10198
10199 <td class="entry_range">
10200 </td>
10201
10202 <td class="entry_notes">
10203 </td>
10204
10205 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10206 <ul class="entry_tags">
10207 <li><a href="#tag_V1">V1</a></li>
10208 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10209 </td>
10210
10211 </tr> <!-- end of entry -->
10212
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10213
10214 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10215 <td class="entry_name"><html><body><p>android.statistics.lensShadingMap<wbr></wbr></p></body></html></td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10216 <td class="entry_type">
10217 <span class="entry_type_name">float</span>
10218 <span class="entry_type_container">x</span>
10219
10220 <span class="entry_type_array">
10221 4 x n x m
10222 </span>
10223 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10224 <div class="entry_type_notes"><html><body><p>2D array of float gain factors per channel to correct lens shading<wbr></wbr></p></body></html></div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10225
10226
10227 </td> <!-- entry_type -->
10228
10229 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10230 <html><body><p>The shading map is a low-resolution floating-point map
10231that lists the coefficients used to correct for vignetting, for each
10232Bayer color channel.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10233 </td>
10234
10235 <td class="entry_units">
10236 </td>
10237
10238 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10239 <html><body><p>Each gain factor is &gt;= 1<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10240 </td>
10241
10242 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10243 <html><body><p>The least shaded section of the image should have a gain factor
10244of 1; all other sections should have gains above 1.</p>
10245<p>When android.colorCorrection.mode = TRANSFORM_MATRIX, the map
10246must take into account the colorCorrection settings.</p>
10247<p>The shading map is for the entire active pixel array, and is not
10248affected by the crop region specified in the request. Each shading map
10249entry is the value of the shading compensation map over a specific
10250pixel on the sensor. Specifically, with a (N x M) resolution shading
10251map, and an active pixel array size (W x H), shading map entry
10252(x,y) ϵ (0 ... N-1, 0 ... M-1) is the value of the shading map at
10253pixel ( ((W-1)/(N-1)) * x, ((H-1)/(M-1)) * y) for the four color channels.
10254The map is assumed to be bilinearly interpolated between the sample points.</p>
10255<p>The channel order is [R, Geven, Godd, B], where Geven is the green
10256channel for the even rows of a Bayer pattern, and Godd is the odd rows.
10257The shading map is stored in a fully interleaved format, and its size
10258is provided in the camera static metadata by android.lens.info.shadingMapSize.</p>
10259<p>The shading map should have on the order of 30-40 rows and columns,
10260and must be smaller than 64x64.</p>
10261<p>As an example, given a very small map defined as:</p>
10262<pre><code>android.lens.info.shadingMapSize = [ 4, 3 ]
10263android.statistics.lensShadingMap =
10264[ 1.3, 1.2, 1.15, 1.2, 1.2, 1.2, 1.15, 1.2,
10265 1.1, 1.2, 1.2, 1.2, 1.3, 1.2, 1.3, 1.3,
10266 1.2, 1.2, 1.25, 1.1, 1.1, 1.1, 1.1, 1.0,
10267 1.0, 1.0, 1.0, 1.0, 1.2, 1.3, 1.25, 1.2,
10268 1.3, 1.2, 1.2, 1.3, 1.2, 1.15, 1.1, 1.2,
10269 1.2, 1.1, 1.0, 1.2, 1.3, 1.15, 1.2, 1.3 ]
10270</code></pre>
10271<p>The low-resolution scaling map images for each channel are
10272(displayed using nearest-neighbor interpolation):</p>
10273<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
10274<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
10275<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
10276<img alt="Blue lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/blue_shading.png"/></p>
10277<p>As a visualization only, inverting the full-color map to recover an
10278image of a gray wall (using bicubic interpolation for visual quality) as captured by the sensor gives:</p>
10279<wbr></wbr><p><img alt="Image of a uniform white wall (inverse shading map)" src="images/camera2/metadata/android.statistics.lensShadingMap/inv_shading.png"/></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10280 </td>
10281
10282 <td class="entry_tags">
10283 </td>
10284
10285 </tr> <!-- end of entry -->
10286
10287
10288 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10289 <td class="entry_name"><html><body><p>android.statistics.predictedColorGains<wbr></wbr></p></body></html></td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10290 <td class="entry_type">
10291 <span class="entry_type_name">float</span>
10292 <span class="entry_type_container">x</span>
10293
10294 <span class="entry_type_array">
10295 4
10296 </span>
10297 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10298 <div class="entry_type_notes"><html><body><p>A 1D array of floats for 4 color channel gains<wbr></wbr></p></body></html></div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10299
10300
10301 </td> <!-- entry_type -->
10302
10303 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10304 <html><body><p>The best-fit color channel gains calculated
10305by the HAL's statistics units for the current output frame<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10306 </td>
10307
10308 <td class="entry_units">
10309 </td>
10310
10311 <td class="entry_range">
10312 </td>
10313
10314 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10315 <html><body><p>This may be different than the gains used for this frame,
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10316since statistics processing on data from a new frame
10317typically completes after the transform has already been
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10318applied to that frame.</p>
10319<p>The 4 channel gains are defined in Bayer domain,
10320see android.colorCorrection.gains for details.</p>
10321<p>This value should always be calculated by the AWB block,
10322regardless of the android.control.* current values.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10323 </td>
10324
10325 <td class="entry_tags">
10326 </td>
10327
10328 </tr> <!-- end of entry -->
10329
10330
10331 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10332 <td class="entry_name"><html><body><p>android.statistics.predictedColorTransform<wbr></wbr></p></body></html></td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10333 <td class="entry_type">
10334 <span class="entry_type_name">rational</span>
10335 <span class="entry_type_container">x</span>
10336
10337 <span class="entry_type_array">
10338 3 x 3
10339 </span>
10340 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10341 <div class="entry_type_notes"><html><body><p>3x3 rational matrix in row-major order<wbr></wbr></p></body></html></div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10342
10343
10344 </td> <!-- entry_type -->
10345
10346 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10347 <html><body><p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10348calculated by the HAL's statistics units for the current
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10349output frame<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10350 </td>
10351
10352 <td class="entry_units">
10353 </td>
10354
10355 <td class="entry_range">
10356 </td>
10357
10358 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10359 <html><body><p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10360statistics unit on the white balance transforms to use
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10361for the next frame. These are the values the HAL believes
10362are the best fit for the current output frame. This may
10363be different than the transform used for this frame, since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10364statistics processing on data from a new frame typically
10365completes after the transform has already been applied to
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10366that frame.</p>
10367<p>These estimates must be provided for all frames, even if
10368capture settings and color transforms are set by the application.</p>
10369<p>This value should always be calculated by the AWB block,
10370regardless of the android.control.* current values.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10371 </td>
10372
10373 <td class="entry_tags">
10374 </td>
10375
10376 </tr> <!-- end of entry -->
10377
10378
10379 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10380 <td class="entry_name"><html><body><p>android.statistics.sceneFlicker<wbr></wbr></p></body></html></td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10381 <td class="entry_type">
10382 <span class="entry_type_name entry_type_name_enum">byte</span>
10383
10384 <span class="entry_type_visibility"> [public]</span>
10385
10386 <ul class="entry_type_enum">
10387 <li>
10388 <span class="entry_type_enum_name">NONE</span>
10389 </li>
10390 <li>
10391 <span class="entry_type_enum_name">50HZ</span>
10392 </li>
10393 <li>
10394 <span class="entry_type_enum_name">60HZ</span>
10395 </li>
10396 </ul>
10397
10398 </td> <!-- entry_type -->
10399
10400 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10401 <html><body><p>The HAL estimated scene illumination lighting
10402frequency<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10403 </td>
10404
10405 <td class="entry_units">
10406 </td>
10407
10408 <td class="entry_range">
10409 </td>
10410
10411 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10412 <html><body><p>Report NONE if there doesn't appear to be flickering
10413illumination<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10414 </td>
10415
10416 <td class="entry_tags">
10417 </td>
10418
10419 </tr> <!-- end of entry -->
10420
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10421
10422
10423 <!-- end of kind -->
10424 </tbody>
10425
10426 <!-- end of section -->
10427 <tr><td colspan="7" id="section_tonemap" class="section">tonemap</td></tr>
10428
10429
10430 <tr><td colspan="7" class="kind">controls</td></tr>
10431
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10432 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10433 <tr>
10434 <th class="th_name">Property Name</th>
10435 <th class="th_type">Type</th>
10436 <th class="th_description">Description</th>
10437 <th class="th_units">Units</th>
10438 <th class="th_range">Range</th>
10439 <th class="th_notes">Notes</th>
10440 <th class="th_tags">Tags</th>
10441 </tr>
10442 </thead>
10443
10444 <tbody>
10445
10446
10447
10448
10449
10450
10451
10452
10453
10454
10455 <tr class="entry" id="controls_android.tonemap.curveBlue">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10456 <td class="entry_name"><html><body><p>android.tonemap.curveBlue<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10457 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]10458 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10459 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10460
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10461 <span class="entry_type_array">
10462 n x 2
10463 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10464 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10465 <div class="entry_type_notes"><html><body><p>1D array of float pairs (P_IN, P_OUT). The maximum number of pairs is specified by android.tonemap.maxCurvePoints.<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10466
10467
10468 </td> <!-- entry_type -->
10469
10470 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10471 <html><body><p>Table mapping blue input values to output
10472values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10473 </td>
10474
10475 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10476 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10477 </td>
10478
10479 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10480 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10481 </td>
10482
10483 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10484 <html><body><p>Tonemapping / contrast / gamma curve for the blue
10485channel, to use when android.tonemap.mode is CONTRAST_CURVE.</p>
10486<p>See android.tonemap.curveRed for more details.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10487 </td>
10488
10489 <td class="entry_tags">
10490 </td>
10491
10492 </tr> <!-- end of entry -->
10493
10494
10495 <tr class="entry" id="controls_android.tonemap.curveGreen">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10496 <td class="entry_name"><html><body><p>android.tonemap.curveGreen<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10497 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]10498 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10499 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10500
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10501 <span class="entry_type_array">
10502 n x 2
10503 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10504 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10505 <div class="entry_type_notes"><html><body><p>1D array of float pairs (P_IN, P_OUT). The maximum number of pairs is specified by android.tonemap.maxCurvePoints.<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10506
10507
10508 </td> <!-- entry_type -->
10509
10510 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10511 <html><body><p>Table mapping green input values to output
10512values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10513 </td>
10514
10515 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10516 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10517 </td>
10518
10519 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10520 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10521 </td>
10522
10523 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10524 <html><body><p>Tonemapping / contrast / gamma curve for the green
10525channel, to use when android.tonemap.mode is CONTRAST_CURVE.</p>
10526<p>See android.tonemap.curveRed for more details.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10527 </td>
10528
10529 <td class="entry_tags">
10530 </td>
10531
10532 </tr> <!-- end of entry -->
10533
10534
10535 <tr class="entry" id="controls_android.tonemap.curveRed">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10536 <td class="entry_name"><html><body><p>android.tonemap.curveRed<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10537 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10538 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10539 <span class="entry_type_container">x</span>
10540
10541 <span class="entry_type_array">
10542 n x 2
10543 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10544 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10545 <div class="entry_type_notes"><html><body><p>1D array of float pairs (P_IN, P_OUT). The maximum number of pairs is specified by android.tonemap.maxCurvePoints.<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10546
10547
10548 </td> <!-- entry_type -->
10549
10550 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10551 <html><body><p>Table mapping red input values to output
10552values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10553 </td>
10554
10555 <td class="entry_units">
10556 </td>
10557
10558 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10559 <html><body><p>0-1 on input and output coordinates.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10560 </td>
10561
10562 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10563 <html><body><p>Tonemapping / contrast / gamma curve for the red
10564channel, to use when android.tonemap.mode is CONTRAST_CURVE.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10565<p>Since the input and output ranges may vary depending on
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10566the camera pipeline, the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10567are represented by normalized floating-point values
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10568between 0 and 1, with 0 == black and 1 == white.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10569<p>The curve should be linearly interpolated between the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10570defined points. The points will be listed in increasing
10571order of P_IN. For example, if the array is: [0.0, 0.0,
105720.3, 0.5, 1.0, 1.0], then the input-&gt;output mapping
10573for a few sample points would be: 0 -&gt; 0, 0.15 -&gt;
105740.25, 0.3 -&gt; 0.5, 0.5 -&gt; 0.64<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10575 </td>
10576
10577 <td class="entry_tags">
10578 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10579 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10580 </ul>
10581 </td>
10582
10583 </tr> <!-- end of entry -->
10584
10585
10586 <tr class="entry" id="controls_android.tonemap.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10587 <td class="entry_name"><html><body><p>android.tonemap.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10588 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10589 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10590
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10591 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10592
10593 <ul class="entry_type_enum">
10594 <li>
10595 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10596 <span class="entry_type_enum_notes"><html><body><p>Use the tone mapping curve specified in
10597 android.tonemap.curve<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10598 </li>
10599 <li>
10600 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10601 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
10602 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10603 </li>
10604 <li>
10605 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10606 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
10607 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10608 </li>
10609 </ul>
10610
10611 </td> <!-- entry_type -->
10612
10613 <td class="entry_description">
10614 </td>
10615
10616 <td class="entry_units">
10617 </td>
10618
10619 <td class="entry_range">
10620 </td>
10621
10622 <td class="entry_notes">
10623 </td>
10624
10625 <td class="entry_tags">
10626 </td>
10627
10628 </tr> <!-- end of entry -->
10629
10630
10631
10632 <!-- end of kind -->
10633 </tbody>
10634 <tr><td colspan="7" class="kind">static</td></tr>
10635
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10636 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10637 <tr>
10638 <th class="th_name">Property Name</th>
10639 <th class="th_type">Type</th>
10640 <th class="th_description">Description</th>
10641 <th class="th_units">Units</th>
10642 <th class="th_range">Range</th>
10643 <th class="th_notes">Notes</th>
10644 <th class="th_tags">Tags</th>
10645 </tr>
10646 </thead>
10647
10648 <tbody>
10649
10650
10651
10652
10653
10654
10655
10656
10657
10658
10659 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10660 <td class="entry_name"><html><body><p>android.tonemap.maxCurvePoints<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10661 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10662 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10663
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10664 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10665
10666
10667 </td> <!-- entry_type -->
10668
10669 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10670 <html><body><p>Maximum number of supported points in the
10671tonemap curve<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10672 </td>
10673
10674 <td class="entry_units">
10675 </td>
10676
10677 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10678 <html><body><p>&gt;= 128<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10679 </td>
10680
10681 <td class="entry_notes">
10682 </td>
10683
10684 <td class="entry_tags">
10685 </td>
10686
10687 </tr> <!-- end of entry -->
10688
10689
10690
10691 <!-- end of kind -->
10692 </tbody>
10693 <tr><td colspan="7" class="kind">dynamic</td></tr>
10694
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10695 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10696 <tr>
10697 <th class="th_name">Property Name</th>
10698 <th class="th_type">Type</th>
10699 <th class="th_description">Description</th>
10700 <th class="th_units">Units</th>
10701 <th class="th_range">Range</th>
10702 <th class="th_notes">Notes</th>
10703 <th class="th_tags">Tags</th>
10704 </tr>
10705 </thead>
10706
10707 <tbody>
10708
10709
10710
10711
10712
10713
10714
10715
10716
10717
10718 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10719 <td class="entry_name"><html><body><p>android.tonemap.curveBlue<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10720 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]10721 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10722 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10723
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10724 <span class="entry_type_array">
10725 n x 2
10726 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10727 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10728 <div class="entry_type_notes"><html><body><p>1D array of float pairs (P_IN, P_OUT). The maximum number of pairs is specified by android.tonemap.maxCurvePoints.<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10729
10730
10731 </td> <!-- entry_type -->
10732
10733 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10734 <html><body><p>Table mapping blue input values to output
10735values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10736 </td>
10737
10738 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10739 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10740 </td>
10741
10742 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10743 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10744 </td>
10745
10746 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10747 <html><body><p>Tonemapping / contrast / gamma curve for the blue
10748channel, to use when android.tonemap.mode is CONTRAST_CURVE.</p>
10749<p>See android.tonemap.curveRed for more details.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10750 </td>
10751
10752 <td class="entry_tags">
10753 </td>
10754
10755 </tr> <!-- end of entry -->
10756
10757
10758 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10759 <td class="entry_name"><html><body><p>android.tonemap.curveGreen<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10760 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]10761 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10762 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10763
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10764 <span class="entry_type_array">
10765 n x 2
10766 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10767 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10768 <div class="entry_type_notes"><html><body><p>1D array of float pairs (P_IN, P_OUT). The maximum number of pairs is specified by android.tonemap.maxCurvePoints.<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10769
10770
10771 </td> <!-- entry_type -->
10772
10773 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10774 <html><body><p>Table mapping green input values to output
10775values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10776 </td>
10777
10778 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10779 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10780 </td>
10781
10782 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10783 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10784 </td>
10785
10786 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10787 <html><body><p>Tonemapping / contrast / gamma curve for the green
10788channel, to use when android.tonemap.mode is CONTRAST_CURVE.</p>
10789<p>See android.tonemap.curveRed for more details.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10790 </td>
10791
10792 <td class="entry_tags">
10793 </td>
10794
10795 </tr> <!-- end of entry -->
10796
10797
10798 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10799 <td class="entry_name"><html><body><p>android.tonemap.curveRed<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10800 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10801 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10802 <span class="entry_type_container">x</span>
10803
10804 <span class="entry_type_array">
10805 n x 2
10806 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10807 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10808 <div class="entry_type_notes"><html><body><p>1D array of float pairs (P_IN, P_OUT). The maximum number of pairs is specified by android.tonemap.maxCurvePoints.<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10809
10810
10811 </td> <!-- entry_type -->
10812
10813 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10814 <html><body><p>Table mapping red input values to output
10815values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10816 </td>
10817
10818 <td class="entry_units">
10819 </td>
10820
10821 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10822 <html><body><p>0-1 on input and output coordinates.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10823 </td>
10824
10825 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10826 <html><body><p>Tonemapping / contrast / gamma curve for the red
10827channel, to use when android.tonemap.mode is CONTRAST_CURVE.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10828<p>Since the input and output ranges may vary depending on
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10829the camera pipeline, the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10830are represented by normalized floating-point values
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10831between 0 and 1, with 0 == black and 1 == white.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10832<p>The curve should be linearly interpolated between the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10833defined points. The points will be listed in increasing
10834order of P_IN. For example, if the array is: [0.0, 0.0,
108350.3, 0.5, 1.0, 1.0], then the input-&gt;output mapping
10836for a few sample points would be: 0 -&gt; 0, 0.15 -&gt;
108370.25, 0.3 -&gt; 0.5, 0.5 -&gt; 0.64<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10838 </td>
10839
10840 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10841 <ul class="entry_tags">
10842 <li><a href="#tag_DNG">DNG</a></li>
10843 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10844 </td>
10845
10846 </tr> <!-- end of entry -->
10847
10848
10849 <tr class="entry" id="dynamic_android.tonemap.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10850 <td class="entry_name"><html><body><p>android.tonemap.mode<wbr></wbr></p></body></html></td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10851 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10852 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10853
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10854 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10855
10856 <ul class="entry_type_enum">
10857 <li>
10858 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10859 <span class="entry_type_enum_notes"><html><body><p>Use the tone mapping curve specified in
10860 android.tonemap.curve<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10861 </li>
10862 <li>
10863 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10864 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
10865 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10866 </li>
10867 <li>
10868 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10869 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
10870 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10871 </li>
10872 </ul>
10873
10874 </td> <!-- entry_type -->
10875
10876 <td class="entry_description">
10877 </td>
10878
10879 <td class="entry_units">
10880 </td>
10881
10882 <td class="entry_range">
10883 </td>
10884
10885 <td class="entry_notes">
10886 </td>
10887
10888 <td class="entry_tags">
10889 </td>
10890
10891 </tr> <!-- end of entry -->
10892
10893
10894
10895 <!-- end of kind -->
10896 </tbody>
10897
10898 <!-- end of section -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10899 <tr><td colspan="7" id="section_led" class="section">led</td></tr>
10900
10901
10902 <tr><td colspan="7" class="kind">controls</td></tr>
10903
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10904 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10905 <tr>
10906 <th class="th_name">Property Name</th>
10907 <th class="th_type">Type</th>
10908 <th class="th_description">Description</th>
10909 <th class="th_units">Units</th>
10910 <th class="th_range">Range</th>
10911 <th class="th_notes">Notes</th>
10912 <th class="th_tags">Tags</th>
10913 </tr>
10914 </thead>
10915
10916 <tbody>
10917
10918
10919
10920
10921
10922
10923
10924
10925
10926
10927 <tr class="entry" id="controls_android.led.transmit">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10928 <td class="entry_name"><html><body><p>android.led.transmit<wbr></wbr></p></body></html></td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10929 <td class="entry_type">
10930 <span class="entry_type_name entry_type_name_enum">byte</span>
10931
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10932 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10933
10934 <ul class="entry_type_enum">
10935 <li>
10936 <span class="entry_type_enum_name">OFF</span>
10937 </li>
10938 <li>
10939 <span class="entry_type_enum_name">ON</span>
10940 </li>
10941 </ul>
10942
10943 </td> <!-- entry_type -->
10944
10945 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10946 <html><body><p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10947that the camera is powered on and may be streaming images back to the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10948Application Processor. In certain rare circumstances, the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10949disable this when video is processed locally and not transmitted to
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10950any untrusted applications.</p>
10951<p>In particular, the LED <em>must</em> always be on when the data could be
10952transmitted off the device. The LED <em>should</em> always be on whenever
10953data is stored locally on the device.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10954<p>The LED <em>may</em> be off if a trusted application is using the data that
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10955doesn't violate the above rules.<wbr></wbr></p></body></html>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10956 </td>
10957
10958 <td class="entry_units">
10959 </td>
10960
10961 <td class="entry_range">
10962 </td>
10963
10964 <td class="entry_notes">
10965 </td>
10966
10967 <td class="entry_tags">
10968 </td>
10969
10970 </tr> <!-- end of entry -->
10971
10972
10973
10974 <!-- end of kind -->
10975 </tbody>
10976 <tr><td colspan="7" class="kind">dynamic</td></tr>
10977
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10978 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10979 <tr>
10980 <th class="th_name">Property Name</th>
10981 <th class="th_type">Type</th>
10982 <th class="th_description">Description</th>
10983 <th class="th_units">Units</th>
10984 <th class="th_range">Range</th>
10985 <th class="th_notes">Notes</th>
10986 <th class="th_tags">Tags</th>
10987 </tr>
10988 </thead>
10989
10990 <tbody>
10991
10992
10993
10994
10995
10996
10997
10998
10999
11000
11001 <tr class="entry" id="dynamic_android.led.transmit">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11002 <td class="entry_name"><html><body><p>android.led.transmit<wbr></wbr></p></body></html></td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]11003 <td class="entry_type">
11004 <span class="entry_type_name entry_type_name_enum">byte</span>
11005
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11006 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]11007
11008 <ul class="entry_type_enum">
11009 <li>
11010 <span class="entry_type_enum_name">OFF</span>
11011 </li>
11012 <li>
11013 <span class="entry_type_enum_name">ON</span>
11014 </li>
11015 </ul>
11016
11017 </td> <!-- entry_type -->
11018
11019 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11020 <html><body><p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11021that the camera is powered on and may be streaming images back to the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11022Application Processor. In certain rare circumstances, the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11023disable this when video is processed locally and not transmitted to
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11024any untrusted applications.</p>
11025<p>In particular, the LED <em>must</em> always be on when the data could be
11026transmitted off the device. The LED <em>should</em> always be on whenever
11027data is stored locally on the device.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11028<p>The LED <em>may</em> be off if a trusted application is using the data that
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11029doesn't violate the above rules.<wbr></wbr></p></body></html>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]11030 </td>
11031
11032 <td class="entry_units">
11033 </td>
11034
11035 <td class="entry_range">
11036 </td>
11037
11038 <td class="entry_notes">
11039 </td>
11040
11041 <td class="entry_tags">
11042 </td>
11043
11044 </tr> <!-- end of entry -->
11045
11046
11047
11048 <!-- end of kind -->
11049 </tbody>
11050 <tr><td colspan="7" class="kind">static</td></tr>
11051
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11052 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]11053 <tr>
11054 <th class="th_name">Property Name</th>
11055 <th class="th_type">Type</th>
11056 <th class="th_description">Description</th>
11057 <th class="th_units">Units</th>
11058 <th class="th_range">Range</th>
11059 <th class="th_notes">Notes</th>
11060 <th class="th_tags">Tags</th>
11061 </tr>
11062 </thead>
11063
11064 <tbody>
11065
11066
11067
11068
11069
11070
11071
11072
11073
11074
11075 <tr class="entry" id="static_android.led.availableLeds">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11076 <td class="entry_name"><html><body><p>android.led.availableLeds<wbr></wbr></p></body></html></td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]11077 <td class="entry_type">
11078 <span class="entry_type_name entry_type_name_enum">byte</span>
11079 <span class="entry_type_container">x</span>
11080
11081 <span class="entry_type_array">
11082 n
11083 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11084 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]11085
11086 <ul class="entry_type_enum">
11087 <li>
11088 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11089 <span class="entry_type_enum_notes"><html><body><p>android.led.transmit control is used<wbr></wbr></p></body></html></span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]11090 </li>
11091 </ul>
11092
11093 </td> <!-- entry_type -->
11094
11095 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11096 <html><body><p>A list of camera LEDs that are available on this system.<wbr></wbr></p></body></html>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]11097 </td>
11098
11099 <td class="entry_units">
11100 </td>
11101
11102 <td class="entry_range">
11103 </td>
11104
11105 <td class="entry_notes">
11106 </td>
11107
11108 <td class="entry_tags">
11109 </td>
11110
11111 </tr> <!-- end of entry -->
11112
11113
11114
11115 <!-- end of kind -->
11116 </tbody>
11117
11118 <!-- end of section -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]11119 <tr><td colspan="7" id="section_info" class="section">info</td></tr>
11120
11121
11122 <tr><td colspan="7" class="kind">static</td></tr>
11123
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11124 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]11125 <tr>
11126 <th class="th_name">Property Name</th>
11127 <th class="th_type">Type</th>
11128 <th class="th_description">Description</th>
11129 <th class="th_units">Units</th>
11130 <th class="th_range">Range</th>
11131 <th class="th_notes">Notes</th>
11132 <th class="th_tags">Tags</th>
11133 </tr>
11134 </thead>
11135
11136 <tbody>
11137
11138
11139
11140
11141
11142
11143
11144
11145
11146
11147 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11148 <td class="entry_name"><html><body><p>android.info.supportedHardwareLevel<wbr></wbr></p></body></html></td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]11149 <td class="entry_type">
11150 <span class="entry_type_name entry_type_name_enum">byte</span>
11151
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11152 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]11153
11154 <ul class="entry_type_enum">
11155 <li>
11156 <span class="entry_type_enum_name">LIMITED</span>
11157 </li>
11158 <li>
11159 <span class="entry_type_enum_name">FULL</span>
11160 </li>
11161 </ul>
11162
11163 </td> <!-- entry_type -->
11164
11165 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11166 <html><body><p>The camera 3 HAL device can implement one of two possible
11167operational modes; limited and full. Full support is
11168expected from new higher-end devices. Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11169hardware requirements roughly in line with those for a
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11170camera HAL device v1 implementation, and is expected from
11171older or inexpensive devices. Full is a strict superset of
11172limited, and they share the same essential operational flow.</p>
11173<p>For full details refer to "S3. Operational Modes" in camera3.h<wbr></wbr></p></body></html>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]11174 </td>
11175
11176 <td class="entry_units">
11177 </td>
11178
11179 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11180 <html><body><p>Optional. Default value is LIMITED.<wbr></wbr></p></body></html>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]11181 </td>
11182
11183 <td class="entry_notes">
11184 </td>
11185
11186 <td class="entry_tags">
11187 </td>
11188
11189 </tr> <!-- end of entry -->
11190
11191
11192
11193 <!-- end of kind -->
11194 </tbody>
11195
11196 <!-- end of section -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11197 <tr><td colspan="7" id="section_blackLevel" class="section">blackLevel</td></tr>
11198
11199
11200 <tr><td colspan="7" class="kind">controls</td></tr>
11201
11202 <thead class="entries_header">
11203 <tr>
11204 <th class="th_name">Property Name</th>
11205 <th class="th_type">Type</th>
11206 <th class="th_description">Description</th>
11207 <th class="th_units">Units</th>
11208 <th class="th_range">Range</th>
11209 <th class="th_notes">Notes</th>
11210 <th class="th_tags">Tags</th>
11211 </tr>
11212 </thead>
11213
11214 <tbody>
11215
11216
11217
11218
11219
11220
11221
11222
11223
11224
11225 <tr class="entry" id="controls_android.blackLevel.lock">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11226 <td class="entry_name"><html><body><p>android.blackLevel.lock<wbr></wbr></p></body></html></td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11227 <td class="entry_type">
11228 <span class="entry_type_name entry_type_name_enum">byte</span>
11229
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11230 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11231
11232 <ul class="entry_type_enum">
11233 <li>
11234 <span class="entry_type_enum_name">OFF</span>
11235 </li>
11236 <li>
11237 <span class="entry_type_enum_name">ON</span>
11238 </li>
11239 </ul>
11240
11241 </td> <!-- entry_type -->
11242
11243 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11244 <html><body><p>Whether black-level compensation is locked
11245to its current values, or is free to vary<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11246 </td>
11247
11248 <td class="entry_units">
11249 </td>
11250
11251 <td class="entry_range">
11252 </td>
11253
11254 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11255 <html><body><p>When set to ON, the values used for black-level
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11256compensation must not change until the lock is set to
11257OFF</p>
11258<p>Since changes to certain capture parameters (such as
11259exposure time) may require resetting of black level
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11260compensation, the HAL must report whether setting the
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11261black level lock was successful in the output result
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11262metadata.</p>
11263<p>For example, if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11264<ul>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11265<li>Request 1: Exposure = 10ms, Black level lock = OFF</li>
11266<li>Request 2: Exposure = 10ms, Black level lock = ON</li>
11267<li>Request 3: Exposure = 10ms, Black level lock = ON</li>
11268<li>Request 4: Exposure = 20ms, Black level lock = ON</li>
11269<li>Request 5: Exposure = 20ms, Black level lock = ON</li>
11270<li>Request 6: Exposure = 20ms, Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11271</ul>
11272<p>And the exposure change in Request 4 requires resetting the black
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11273level offsets, then the output result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11274<ul>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11275<li>Result 1: Exposure = 10ms, Black level lock = OFF</li>
11276<li>Result 2: Exposure = 10ms, Black level lock = ON</li>
11277<li>Result 3: Exposure = 10ms, Black level lock = ON</li>
11278<li>Result 4: Exposure = 20ms, Black level lock = OFF</li>
11279<li>Result 5: Exposure = 20ms, Black level lock = ON</li>
11280<li>Result 6: Exposure = 20ms, Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11281</ul>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11282<p>This indicates to the application that on frame 4, black levels were
11283reset due to exposure value changes, and pixel values may not be
11284consistent across captures.</p>
11285<p>The black level locking must happen at the sensor, and not at the ISP.
11286If for some reason black level locking is no longer legal (for example,
11287the analog gain has changed, which forces black levels to be
11288recalculated), then the HAL is free to override this request (and it
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11289must report 'OFF' when this does happen) until the next time locking
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11290is legal again.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11291 </td>
11292
11293 <td class="entry_tags">
11294 <ul class="entry_tags">
11295 <li><a href="#tag_HAL2">HAL2</a></li>
11296 </ul>
11297 </td>
11298
11299 </tr> <!-- end of entry -->
11300
11301
11302
11303 <!-- end of kind -->
11304 </tbody>
11305 <tr><td colspan="7" class="kind">dynamic</td></tr>
11306
11307 <thead class="entries_header">
11308 <tr>
11309 <th class="th_name">Property Name</th>
11310 <th class="th_type">Type</th>
11311 <th class="th_description">Description</th>
11312 <th class="th_units">Units</th>
11313 <th class="th_range">Range</th>
11314 <th class="th_notes">Notes</th>
11315 <th class="th_tags">Tags</th>
11316 </tr>
11317 </thead>
11318
11319 <tbody>
11320
11321
11322
11323
11324
11325
11326
11327
11328
11329
11330 <tr class="entry" id="dynamic_android.blackLevel.lock">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11331 <td class="entry_name"><html><body><p>android.blackLevel.lock<wbr></wbr></p></body></html></td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11332 <td class="entry_type">
11333 <span class="entry_type_name entry_type_name_enum">byte</span>
11334
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11335 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11336
11337 <ul class="entry_type_enum">
11338 <li>
11339 <span class="entry_type_enum_name">OFF</span>
11340 </li>
11341 <li>
11342 <span class="entry_type_enum_name">ON</span>
11343 </li>
11344 </ul>
11345
11346 </td> <!-- entry_type -->
11347
11348 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11349 <html><body><p>Whether black-level compensation is locked
11350to its current values, or is free to vary<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11351 </td>
11352
11353 <td class="entry_units">
11354 </td>
11355
11356 <td class="entry_range">
11357 </td>
11358
11359 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11360 <html><body><p>Whether the black level offset was locked for this frame.
11361Should be ON if android.blackLevel.lock was ON in the capture request,
11362unless a change in capture settings forced a black level reset.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11363 </td>
11364
11365 <td class="entry_tags">
11366 <ul class="entry_tags">
11367 <li><a href="#tag_HAL2">HAL2</a></li>
11368 </ul>
11369 </td>
11370
11371 </tr> <!-- end of entry -->
11372
11373
11374
11375 <!-- end of kind -->
11376 </tbody>
11377
11378 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11379<!-- </namespace> -->
11380 </table>
11381
11382 <div class="tags" id="tag_index">
11383 <h2>Tags</h2>
11384 <ul>
11385 <li id="tag_AWB">AWB -
11386 Needed for auto white balance
11387
11388 <ul class="tags_entries">
11389 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
11390 </ul>
11391 </li> <!-- tag_AWB -->
11392 <li id="tag_BC">BC -
11393 Needed for backwards compatibility with old Java API
11394
11395 <ul class="tags_entries">
11396 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
11397 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
11398 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
11399 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
11400 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]11401 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11402 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
11403 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]11404 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11405 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
11406 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
11407 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
11408 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
11409 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
11410 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
11411 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
11412 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
11413 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
11414 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
11415 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
11416 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
11417 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
11418 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
11419 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
11420 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
11421 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
11422 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
11423 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
11424 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
11425 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
11426 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
11427 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
11428 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
11429 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
11430 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
11431 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
11432 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
11433 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
11434 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
11435 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
11436 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
11437 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
11438 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
11439 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
11440 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]11441 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11442 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
11443 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
11444 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11445 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11446 <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]11447 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
11448 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
11449 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
11450 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
11451 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
11452 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
11453 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
11454 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
11455 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
11456 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
11457 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
11458 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
11459 </ul>
11460 </li> <!-- tag_BC -->
11461 <li id="tag_V1">V1 -
11462 New features for first camera 2 release (API1)
11463
11464 <ul class="tags_entries">
11465 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
11466 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
11467 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
11468 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
11469 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
11470 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
11471 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
11472 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
11473 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
11474 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
11475 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
11476 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
11477 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
11478 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
11479 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
11480 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
11481 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
11482 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
11483 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
11484 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
11485 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
11486 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
11487 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
11488 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11489 <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]11490 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
11491 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
11492 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
11493 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
11494 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
11495 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
11496 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
11497 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
11498 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
11499 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
11500 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
11501 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
11502 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
11503 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
11504 </ul>
11505 </li> <!-- tag_V1 -->
11506 <li id="tag_ADV">ADV - None
11507 <ul class="tags_entries">
11508 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
11509 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
11510 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
11511 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
11512 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
11513 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
11514 </ul>
11515 </li> <!-- tag_ADV -->
11516 <li id="tag_DNG">DNG -
11517 Needed for DNG file support
11518
11519 <ul class="tags_entries">
11520 <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]11521 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
11522 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
11523 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
11524 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
11525 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
11526 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
11527 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
11528 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
11529 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
11530 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
11531 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
11532 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
11533 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
11534 </ul>
11535 </li> <!-- tag_DNG -->
11536 <li id="tag_EXIF">EXIF - None
11537 <ul class="tags_entries">
11538 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
11539 </ul>
11540 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]11541 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]11542 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]11543
11544 <ul class="tags_entries">
11545 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
11546 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
11547 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11548 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]11549 </ul>
11550 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]11551 <li id="tag_FULL">FULL -
11552 Entry is required for full hardware level devices, and optional for other hardware levels
11553
11554 <ul class="tags_entries">
11555 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
11556 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
11557 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
11558 </ul>
11559 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11560 </ul>
11561 </div>
11562
11563 [ <a href="#">top</a> ]
11564
11565</body>
11566</html>