Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / f552923139b17795bcfbb53cd44d2744fe5331ab / . / camera / docs / docs.html
blob: 2cb0cf9fc53f939f49c24d5bfe26e0cd019af0f5 [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>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3431 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
3432 bayer 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">
3455 </td>
3456
3457 <td class="entry_tags">
3458 </td>
3459
3460 </tr> <!-- end of entry -->
3461
3462
3463 <tr class="entry" id="controls_android.edge.strength">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3464 <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]3465 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3466 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3467
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3468 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3469
3470
3471 </td> <!-- entry_type -->
3472
3473 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3474 <html><body><p>Control the amount of edge enhancement
3475applied to the images<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3476 </td>
3477
3478 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3479 <html><body><p>1-10; 10 is maximum sharpening<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3480 </td>
3481
3482 <td class="entry_range">
3483 </td>
3484
3485 <td class="entry_notes">
3486 </td>
3487
3488 <td class="entry_tags">
3489 </td>
3490
3491 </tr> <!-- end of entry -->
3492
3493
3494
3495 <!-- end of kind -->
3496 </tbody>
3497 <tr><td colspan="7" class="kind">dynamic</td></tr>
3498
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3499 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3500 <tr>
3501 <th class="th_name">Property Name</th>
3502 <th class="th_type">Type</th>
3503 <th class="th_description">Description</th>
3504 <th class="th_units">Units</th>
3505 <th class="th_range">Range</th>
3506 <th class="th_notes">Notes</th>
3507 <th class="th_tags">Tags</th>
3508 </tr>
3509 </thead>
3510
3511 <tbody>
3512
3513
3514
3515
3516
3517
3518
3519
3520
3521
3522 <tr class="entry" id="dynamic_android.edge.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3523 <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]3524 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3525 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3526
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3527 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3528
3529 <ul class="entry_type_enum">
3530 <li>
3531 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3532 <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]3533 </li>
3534 <li>
3535 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3536 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
3537 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3538 </li>
3539 <li>
3540 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3541 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
3542 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3543 </li>
3544 </ul>
3545
3546 </td> <!-- entry_type -->
3547
3548 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3549 <html><body><p>Operation mode for edge
3550enhancement<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3551 </td>
3552
3553 <td class="entry_units">
3554 </td>
3555
3556 <td class="entry_range">
3557 </td>
3558
3559 <td class="entry_notes">
3560 </td>
3561
3562 <td class="entry_tags">
3563 </td>
3564
3565 </tr> <!-- end of entry -->
3566
3567
3568
3569 <!-- end of kind -->
3570 </tbody>
3571
3572 <!-- end of section -->
3573 <tr><td colspan="7" id="section_flash" class="section">flash</td></tr>
3574
3575
3576 <tr><td colspan="7" class="kind">controls</td></tr>
3577
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3578 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3579 <tr>
3580 <th class="th_name">Property Name</th>
3581 <th class="th_type">Type</th>
3582 <th class="th_description">Description</th>
3583 <th class="th_units">Units</th>
3584 <th class="th_range">Range</th>
3585 <th class="th_notes">Notes</th>
3586 <th class="th_tags">Tags</th>
3587 </tr>
3588 </thead>
3589
3590 <tbody>
3591
3592
3593
3594
3595
3596
3597
3598
3599
3600
3601 <tr class="entry" id="controls_android.flash.firingPower">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3602 <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]3603 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3604 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3605
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3606 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3607
3608
3609 </td> <!-- entry_type -->
3610
3611 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3612 <html><body><p>Power for flash firing/torch<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3613 </td>
3614
3615 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3616 <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]3617 </td>
3618
3619 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3620 <html><body><p>0 - 10<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3621 </td>
3622
3623 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3624 <html><body><p>Power for snapshot may use a different scale than
3625for torch mode. Only one entry for torch mode will be
3626used<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3627 </td>
3628
3629 <td class="entry_tags">
3630 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3631 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3632 </ul>
3633 </td>
3634
3635 </tr> <!-- end of entry -->
3636
3637
3638 <tr class="entry" id="controls_android.flash.firingTime">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3639 <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]3640 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3641 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3642
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3643 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3644
3645
3646 </td> <!-- entry_type -->
3647
3648 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3649 <html><body><p>Firing time of flash relative to start of
3650exposure<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3651 </td>
3652
3653 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3654 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3655 </td>
3656
3657 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3658 <html><body><p>0-(exposure time-flash duration)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3659 </td>
3660
3661 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3662 <html><body><p>Clamped to (0, exposure time - flash
3663duration).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3664 </td>
3665
3666 <td class="entry_tags">
3667 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3668 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3669 </ul>
3670 </td>
3671
3672 </tr> <!-- end of entry -->
3673
3674
3675 <tr class="entry" id="controls_android.flash.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3676 <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]3677 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3678 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3679
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3680 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3681
3682 <ul class="entry_type_enum">
3683 <li>
3684 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3685 <span class="entry_type_enum_notes"><html><body><p>Do not fire the flash for this
3686 capture<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3687 </li>
3688 <li>
3689 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3690 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Fire flash
3691 for this capture based on firingPower,
3692 firingTime.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3693 </li>
3694 <li>
3695 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3696 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Flash
3697 continuously on, power set by
3698 firingPower<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3699 </li>
3700 </ul>
3701
3702 </td> <!-- entry_type -->
3703
3704 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3705 <html><body><p>Select flash operation mode<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3706 </td>
3707
3708 <td class="entry_units">
3709 </td>
3710
3711 <td class="entry_range">
3712 </td>
3713
3714 <td class="entry_notes">
3715 </td>
3716
3717 <td class="entry_tags">
3718 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3719 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3720 </ul>
3721 </td>
3722
3723 </tr> <!-- end of entry -->
3724
3725
3726
3727 <!-- end of kind -->
3728 </tbody>
3729 <tr><td colspan="7" class="kind">static</td></tr>
3730
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3731 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3732 <tr>
3733 <th class="th_name">Property Name</th>
3734 <th class="th_type">Type</th>
3735 <th class="th_description">Description</th>
3736 <th class="th_units">Units</th>
3737 <th class="th_range">Range</th>
3738 <th class="th_notes">Notes</th>
3739 <th class="th_tags">Tags</th>
3740 </tr>
3741 </thead>
3742
3743 <tbody>
3744
3745
3746
3747
3748
3749
3750
3751
3752
3753
3754
3755
3756 <tr class="entry" id="static_android.flash.info.available">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3757 <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]3758 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3759 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3760
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3761 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3762
3763
3764 </td> <!-- entry_type -->
3765
3766 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3767 <html><body><p>Whether this camera has a
3768flash<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3769 </td>
3770
3771 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3772 <html><body><p>boolean (0 = false, otherwise true)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3773 </td>
3774
3775 <td class="entry_range">
3776 </td>
3777
3778 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3779 <html><body><p>If no flash, none of the flash controls do
3780anything. All other metadata should return 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3781 </td>
3782
3783 <td class="entry_tags">
3784 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3785 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3786 </ul>
3787 </td>
3788
3789 </tr> <!-- end of entry -->
3790
3791
3792 <tr class="entry" id="static_android.flash.info.chargeDuration">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3793 <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]3794 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3795 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3796
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3797 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3798
3799
3800 </td> <!-- entry_type -->
3801
3802 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3803 <html><body><p>Time taken before flash can fire
3804again<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3805 </td>
3806
3807 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3808 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3809 </td>
3810
3811 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3812 <html><body><p>0-1e9<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3813 </td>
3814
3815 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3816 <html><body><p>1 second too long/too short for recharge? Should
3817this be power-dependent?<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3818 </td>
3819
3820 <td class="entry_tags">
3821 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3822 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3823 </ul>
3824 </td>
3825
3826 </tr> <!-- end of entry -->
3827
3828
3829
3830
3831
3832 <tr class="entry" id="static_android.flash.colorTemperature">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3833 <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]3834 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3835 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3836
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3837 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3838
3839
3840 </td> <!-- entry_type -->
3841
3842 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3843 <html><body><p>The x,y whitepoint of the
3844flash<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3845 </td>
3846
3847 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3848 <html><body><p>pair of floats<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3849 </td>
3850
3851 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3852 <html><body><p>0-1 for both<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3853 </td>
3854
3855 <td class="entry_notes">
3856 </td>
3857
3858 <td class="entry_tags">
3859 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3860 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3861 </ul>
3862 </td>
3863
3864 </tr> <!-- end of entry -->
3865
3866
3867 <tr class="entry" id="static_android.flash.maxEnergy">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3868 <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]3869 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3870 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3871
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3872 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3873
3874
3875 </td> <!-- entry_type -->
3876
3877 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3878 <html><body><p>Max energy output of the flash for a full
3879power single flash<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3880 </td>
3881
3882 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3883 <html><body><p>lumen-seconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3884 </td>
3885
3886 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3887 <html><body><p>&gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3888 </td>
3889
3890 <td class="entry_notes">
3891 </td>
3892
3893 <td class="entry_tags">
3894 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3895 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3896 </ul>
3897 </td>
3898
3899 </tr> <!-- end of entry -->
3900
3901
3902
3903 <!-- end of kind -->
3904 </tbody>
3905 <tr><td colspan="7" class="kind">dynamic</td></tr>
3906
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3907 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3908 <tr>
3909 <th class="th_name">Property Name</th>
3910 <th class="th_type">Type</th>
3911 <th class="th_description">Description</th>
3912 <th class="th_units">Units</th>
3913 <th class="th_range">Range</th>
3914 <th class="th_notes">Notes</th>
3915 <th class="th_tags">Tags</th>
3916 </tr>
3917 </thead>
3918
3919 <tbody>
3920
3921
3922
3923
3924
3925
3926
3927
3928
3929
3930 <tr class="entry" id="dynamic_android.flash.firingPower">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3931 <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]3932 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3933 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3934
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3935 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3936
3937
3938 </td> <!-- entry_type -->
3939
3940 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3941 <html><body><p>Power for flash firing/torch<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3942 </td>
3943
3944 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3945 <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]3946 </td>
3947
3948 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3949 <html><body><p>0 - 10<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3950 </td>
3951
3952 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3953 <html><body><p>Power for snapshot may use a different scale than
3954for torch mode. Only one entry for torch mode will be
3955used<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3956 </td>
3957
3958 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3959 <ul class="entry_tags">
3960 <li><a href="#tag_V1">V1</a></li>
3961 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3962 </td>
3963
3964 </tr> <!-- end of entry -->
3965
3966
3967 <tr class="entry" id="dynamic_android.flash.firingTime">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3968 <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]3969 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3970 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3971
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3972 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3973
3974
3975 </td> <!-- entry_type -->
3976
3977 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3978 <html><body><p>Firing time of flash relative to start of
3979exposure<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3980 </td>
3981
3982 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3983 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3984 </td>
3985
3986 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3987 <html><body><p>0-(exposure time-flash duration)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3988 </td>
3989
3990 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]3991 <html><body><p>Clamped to (0, exposure time - flash
3992duration).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3993 </td>
3994
3995 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3996 <ul class="entry_tags">
3997 <li><a href="#tag_V1">V1</a></li>
3998 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3999 </td>
4000
4001 </tr> <!-- end of entry -->
4002
4003
4004 <tr class="entry" id="dynamic_android.flash.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4005 <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]4006 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4007 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4008
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4009 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4010
4011 <ul class="entry_type_enum">
4012 <li>
4013 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4014 <span class="entry_type_enum_notes"><html><body><p>Do not fire the flash for this
4015 capture<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4016 </li>
4017 <li>
4018 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4019 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Fire flash
4020 for this capture based on firingPower,
4021 firingTime.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4022 </li>
4023 <li>
4024 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4025 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Flash
4026 continuously on, power set by
4027 firingPower<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4028 </li>
4029 </ul>
4030
4031 </td> <!-- entry_type -->
4032
4033 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4034 <html><body><p>Select flash operation mode<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4035 </td>
4036
4037 <td class="entry_units">
4038 </td>
4039
4040 <td class="entry_range">
4041 </td>
4042
4043 <td class="entry_notes">
4044 </td>
4045
4046 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4047 <ul class="entry_tags">
4048 <li><a href="#tag_BC">BC</a></li>
4049 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4050 </td>
4051
4052 </tr> <!-- end of entry -->
4053
4054
4055 <tr class="entry" id="dynamic_android.flash.state">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4056 <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]4057 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4058 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4059
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4060 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4061
4062 <ul class="entry_type_enum">
4063 <li>
4064 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4065 <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]4066 </li>
4067 <li>
4068 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4069 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Flash is
4070 charging and cannot be fired<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4071 </li>
4072 <li>
4073 <span class="entry_type_enum_name">READY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4074 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Flash is
4075 ready to fire<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4076 </li>
4077 <li>
4078 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4079 <span class="entry_type_enum_notes"><html><body><p>if android.flash.available is true Flash fired
4080 for this capture<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4081 </li>
4082 </ul>
4083
4084 </td> <!-- entry_type -->
4085
4086 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4087 <html><body><p>Current state of the flash
4088unit<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4089 </td>
4090
4091 <td class="entry_units">
4092 </td>
4093
4094 <td class="entry_range">
4095 </td>
4096
4097 <td class="entry_notes">
4098 </td>
4099
4100 <td class="entry_tags">
4101 </td>
4102
4103 </tr> <!-- end of entry -->
4104
4105
4106
4107 <!-- end of kind -->
4108 </tbody>
4109
4110 <!-- end of section -->
4111 <tr><td colspan="7" id="section_geometric" class="section">geometric</td></tr>
4112
4113
4114 <tr><td colspan="7" class="kind">controls</td></tr>
4115
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4116 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4117 <tr>
4118 <th class="th_name">Property Name</th>
4119 <th class="th_type">Type</th>
4120 <th class="th_description">Description</th>
4121 <th class="th_units">Units</th>
4122 <th class="th_range">Range</th>
4123 <th class="th_notes">Notes</th>
4124 <th class="th_tags">Tags</th>
4125 </tr>
4126 </thead>
4127
4128 <tbody>
4129
4130
4131
4132
4133
4134
4135
4136
4137
4138
4139 <tr class="entry" id="controls_android.geometric.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4140 <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]4141 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4142 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4143
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4144 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4145
4146 <ul class="entry_type_enum">
4147 <li>
4148 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4149 <span class="entry_type_enum_notes"><html><body><p>No geometric correction is
4150 applied<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4151 </li>
4152 <li>
4153 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4154 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
4155 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4156 </li>
4157 <li>
4158 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4159 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
4160 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4161 </li>
4162 </ul>
4163
4164 </td> <!-- entry_type -->
4165
4166 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4167 <html><body><p>Operating mode of geometric
4168correction<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4169 </td>
4170
4171 <td class="entry_units">
4172 </td>
4173
4174 <td class="entry_range">
4175 </td>
4176
4177 <td class="entry_notes">
4178 </td>
4179
4180 <td class="entry_tags">
4181 </td>
4182
4183 </tr> <!-- end of entry -->
4184
4185
4186 <tr class="entry" id="controls_android.geometric.strength">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4187 <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]4188 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4189 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4190
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4191 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4192
4193
4194 </td> <!-- entry_type -->
4195
4196 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4197 <html><body><p>Control the amount of shading correction
4198applied to the images<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4199 </td>
4200
4201 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4202 <html><body><p>unitless: 1-10; 10 is full shading
4203 compensation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4204 </td>
4205
4206 <td class="entry_range">
4207 </td>
4208
4209 <td class="entry_notes">
4210 </td>
4211
4212 <td class="entry_tags">
4213 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4214 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4215 </ul>
4216 </td>
4217
4218 </tr> <!-- end of entry -->
4219
4220
4221
4222 <!-- end of kind -->
4223 </tbody>
4224
4225 <!-- end of section -->
4226 <tr><td colspan="7" id="section_hotPixel" class="section">hotPixel</td></tr>
4227
4228
4229 <tr><td colspan="7" class="kind">controls</td></tr>
4230
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4231 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4232 <tr>
4233 <th class="th_name">Property Name</th>
4234 <th class="th_type">Type</th>
4235 <th class="th_description">Description</th>
4236 <th class="th_units">Units</th>
4237 <th class="th_range">Range</th>
4238 <th class="th_notes">Notes</th>
4239 <th class="th_tags">Tags</th>
4240 </tr>
4241 </thead>
4242
4243 <tbody>
4244
4245
4246
4247
4248
4249
4250
4251
4252
4253
4254 <tr class="entry" id="controls_android.hotPixel.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4255 <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]4256 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4257 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4258
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4259 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4260
4261 <ul class="entry_type_enum">
4262 <li>
4263 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4264 <span class="entry_type_enum_notes"><html><body><p>No hot pixel correction can be
4265 applied<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4266 </li>
4267 <li>
4268 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4269 <span class="entry_type_enum_notes"><html><body><p>Frame rate must not be reduced compared to raw
4270 Bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4271 </li>
4272 <li>
4273 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4274 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
4275 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4276 </li>
4277 </ul>
4278
4279 </td> <!-- entry_type -->
4280
4281 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4282 <html><body><p>Set operational mode for hot pixel
4283correction<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4284 </td>
4285
4286 <td class="entry_units">
4287 </td>
4288
4289 <td class="entry_range">
4290 </td>
4291
4292 <td class="entry_notes">
4293 </td>
4294
4295 <td class="entry_tags">
4296 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4297 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4298 </ul>
4299 </td>
4300
4301 </tr> <!-- end of entry -->
4302
4303
4304
4305 <!-- end of kind -->
4306 </tbody>
4307 <tr><td colspan="7" class="kind">static</td></tr>
4308
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4309 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4310 <tr>
4311 <th class="th_name">Property Name</th>
4312 <th class="th_type">Type</th>
4313 <th class="th_description">Description</th>
4314 <th class="th_units">Units</th>
4315 <th class="th_range">Range</th>
4316 <th class="th_notes">Notes</th>
4317 <th class="th_tags">Tags</th>
4318 </tr>
4319 </thead>
4320
4321 <tbody>
4322
4323
4324
4325
4326
4327
4328
4329
4330
4331
4332
4333
4334 <tr class="entry" id="static_android.hotPixel.info.map">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4335 <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]4336 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4337 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4338 <span class="entry_type_container">x</span>
4339
4340 <span class="entry_type_array">
4341 2 x n
4342 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4343 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4344 <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]4345
4346
4347 </td> <!-- entry_type -->
4348
4349 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4350 <html><body><p>Location of hot/defective pixels on
4351sensor<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4352 </td>
4353
4354 <td class="entry_units">
4355 </td>
4356
4357 <td class="entry_range">
4358 </td>
4359
4360 <td class="entry_notes">
4361 </td>
4362
4363 <td class="entry_tags">
4364 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4365 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4366 </ul>
4367 </td>
4368
4369 </tr> <!-- end of entry -->
4370
4371
4372
4373
4374
4375
4376 <!-- end of kind -->
4377 </tbody>
4378 <tr><td colspan="7" class="kind">dynamic</td></tr>
4379
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4380 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4381 <tr>
4382 <th class="th_name">Property Name</th>
4383 <th class="th_type">Type</th>
4384 <th class="th_description">Description</th>
4385 <th class="th_units">Units</th>
4386 <th class="th_range">Range</th>
4387 <th class="th_notes">Notes</th>
4388 <th class="th_tags">Tags</th>
4389 </tr>
4390 </thead>
4391
4392 <tbody>
4393
4394
4395
4396
4397
4398
4399
4400
4401
4402
4403 <tr class="entry" id="dynamic_android.hotPixel.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4404 <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]4405 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4406 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4407
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4408 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4409
4410 <ul class="entry_type_enum">
4411 <li>
4412 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4413 <span class="entry_type_enum_notes"><html><body><p>No hot pixel correction can be
4414 applied<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4415 </li>
4416 <li>
4417 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4418 <span class="entry_type_enum_notes"><html><body><p>Frame rate must not be reduced compared to raw
4419 Bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4420 </li>
4421 <li>
4422 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4423 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
4424 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4425 </li>
4426 </ul>
4427
4428 </td> <!-- entry_type -->
4429
4430 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4431 <html><body><p>Set operational mode for hot pixel
4432correction<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4433 </td>
4434
4435 <td class="entry_units">
4436 </td>
4437
4438 <td class="entry_range">
4439 </td>
4440
4441 <td class="entry_notes">
4442 </td>
4443
4444 <td class="entry_tags">
4445 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4446 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4447 </ul>
4448 </td>
4449
4450 </tr> <!-- end of entry -->
4451
4452
4453
4454 <!-- end of kind -->
4455 </tbody>
4456
4457 <!-- end of section -->
4458 <tr><td colspan="7" id="section_jpeg" class="section">jpeg</td></tr>
4459
4460
4461 <tr><td colspan="7" class="kind">controls</td></tr>
4462
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4463 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4464 <tr>
4465 <th class="th_name">Property Name</th>
4466 <th class="th_type">Type</th>
4467 <th class="th_description">Description</th>
4468 <th class="th_units">Units</th>
4469 <th class="th_range">Range</th>
4470 <th class="th_notes">Notes</th>
4471 <th class="th_tags">Tags</th>
4472 </tr>
4473 </thead>
4474
4475 <tbody>
4476
4477
4478
4479
4480
4481
4482
4483
4484
4485
4486 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4487 <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]4488 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4489 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4490 <span class="entry_type_container">x</span>
4491
4492 <span class="entry_type_array">
4493 3
4494 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4495 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4496 <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]4497
4498
4499 </td> <!-- entry_type -->
4500
4501 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4502 <html><body><p>GPS coordinates to include in output JPEG
4503EXIF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4504 </td>
4505
4506 <td class="entry_units">
4507 </td>
4508
4509 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4510 <html><body><p>(-180 - 180], [-90,90], [-inf, inf]<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4511 </td>
4512
4513 <td class="entry_notes">
4514 </td>
4515
4516 <td class="entry_tags">
4517 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4518 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4519 </ul>
4520 </td>
4521
4522 </tr> <!-- end of entry -->
4523
4524
4525 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4526 <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]4527 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4528 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4529
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]4530 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4531
4532
4533 </td> <!-- entry_type -->
4534
4535 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4536 <html><body><p>32 characters describing GPS algorithm to
4537include in EXIF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4538 </td>
4539
4540 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4541 <html><body><p>UTF-8 null-terminated string<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4542 </td>
4543
4544 <td class="entry_range">
4545 </td>
4546
4547 <td class="entry_notes">
4548 </td>
4549
4550 <td class="entry_tags">
4551 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4552 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4553 </ul>
4554 </td>
4555
4556 </tr> <!-- end of entry -->
4557
4558
4559 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4560 <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]4561 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4562 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4563
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4564 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4565
4566
4567 </td> <!-- entry_type -->
4568
4569 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4570 <html><body><p>Time GPS fix was made to include in
4571EXIF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4572 </td>
4573
4574 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4575 <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]4576 </td>
4577
4578 <td class="entry_range">
4579 </td>
4580
4581 <td class="entry_notes">
4582 </td>
4583
4584 <td class="entry_tags">
4585 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4586 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4587 </ul>
4588 </td>
4589
4590 </tr> <!-- end of entry -->
4591
4592
4593 <tr class="entry" id="controls_android.jpeg.orientation">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4594 <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]4595 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4596 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4597
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4598 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4599
4600
4601 </td> <!-- entry_type -->
4602
4603 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4604 <html><body><p>Orientation of JPEG image to
4605write<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4606 </td>
4607
4608 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4609 <html><body><p>Degrees in multiples of 90<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4610 </td>
4611
4612 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4613 <html><body><p>0, 90, 180, 270<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4614 </td>
4615
4616 <td class="entry_notes">
4617 </td>
4618
4619 <td class="entry_tags">
4620 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4621 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4622 </ul>
4623 </td>
4624
4625 </tr> <!-- end of entry -->
4626
4627
4628 <tr class="entry" id="controls_android.jpeg.quality">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4629 <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]4630 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4631 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4632
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4633 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4634
4635
4636 </td> <!-- entry_type -->
4637
4638 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4639 <html><body><p>Compression quality of the final JPEG
4640image<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4641 </td>
4642
4643 <td class="entry_units">
4644 </td>
4645
4646 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4647 <html><body><p>1-100; larger is higher quality<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4648 </td>
4649
4650 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4651 <html><body><p>85-95 is typical usage range<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4652 </td>
4653
4654 <td class="entry_tags">
4655 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4656 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4657 </ul>
4658 </td>
4659
4660 </tr> <!-- end of entry -->
4661
4662
4663 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4664 <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]4665 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4666 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4667
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4668 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4669
4670
4671 </td> <!-- entry_type -->
4672
4673 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4674 <html><body><p>Compression quality of JPEG
4675thumbnail<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4676 </td>
4677
4678 <td class="entry_units">
4679 </td>
4680
4681 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4682 <html><body><p>1-100; larger is higher quality<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4683 </td>
4684
4685 <td class="entry_notes">
4686 </td>
4687
4688 <td class="entry_tags">
4689 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4690 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4691 </ul>
4692 </td>
4693
4694 </tr> <!-- end of entry -->
4695
4696
4697 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4698 <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]4699 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4700 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4701 <span class="entry_type_container">x</span>
4702
4703 <span class="entry_type_array">
4704 2
4705 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]4706 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4707
4708
4709 </td> <!-- entry_type -->
4710
4711 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4712 <html><body><p>Resolution of embedded JPEG
4713thumbnail<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4714 </td>
4715
4716 <td class="entry_units">
4717 </td>
4718
4719 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4720 <html><body><p>from android.jpeg.availableThumbnailSizes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4721 </td>
4722
4723 <td class="entry_notes">
4724 </td>
4725
4726 <td class="entry_tags">
4727 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4728 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4729 </ul>
4730 </td>
4731
4732 </tr> <!-- end of entry -->
4733
4734
4735
4736 <!-- end of kind -->
4737 </tbody>
4738 <tr><td colspan="7" class="kind">static</td></tr>
4739
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4740 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4741 <tr>
4742 <th class="th_name">Property Name</th>
4743 <th class="th_type">Type</th>
4744 <th class="th_description">Description</th>
4745 <th class="th_units">Units</th>
4746 <th class="th_range">Range</th>
4747 <th class="th_notes">Notes</th>
4748 <th class="th_tags">Tags</th>
4749 </tr>
4750 </thead>
4751
4752 <tbody>
4753
4754
4755
4756
4757
4758
4759
4760
4761
4762
4763 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4764 <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]4765 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4766 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4767 <span class="entry_type_container">x</span>
4768
4769 <span class="entry_type_array">
4770 2 x n
4771 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]4772 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4773 <div class="entry_type_notes"><html><body><p>list of resolution pairs<wbr></wbr></p></body></html></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4774
4775
4776 </td> <!-- entry_type -->
4777
4778 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4779 <html><body><p>Supported resolutions for the JPEG
4780thumbnail<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4781 </td>
4782
4783 <td class="entry_units">
4784 </td>
4785
4786 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4787 <html><body><p>Must include at least one valid resolution, plus
4788 (0,0) for no thumbnail generation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4789 </td>
4790
4791 <td class="entry_notes">
4792 </td>
4793
4794 <td class="entry_tags">
4795 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4796 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4797 </ul>
4798 </td>
4799
4800 </tr> <!-- end of entry -->
4801
4802
4803 <tr class="entry" id="static_android.jpeg.maxSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4804 <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]4805 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4806 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4807
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4808 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4809
4810
4811 </td> <!-- entry_type -->
4812
4813 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4814 <html><body><p>Maximum size in bytes for the compressed
4815JPEG buffer<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4816 </td>
4817
4818 <td class="entry_units">
4819 </td>
4820
4821 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4822 <html><body><p>Must be large enough to fit any JPEG produced by
4823 the camera<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4824 </td>
4825
4826 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4827 <html><body><p>This is used for sizing the gralloc buffers for
4828JPEG<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4829 </td>
4830
4831 <td class="entry_tags">
4832 </td>
4833
4834 </tr> <!-- end of entry -->
4835
4836
4837
4838 <!-- end of kind -->
4839 </tbody>
4840 <tr><td colspan="7" class="kind">dynamic</td></tr>
4841
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4842 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4843 <tr>
4844 <th class="th_name">Property Name</th>
4845 <th class="th_type">Type</th>
4846 <th class="th_description">Description</th>
4847 <th class="th_units">Units</th>
4848 <th class="th_range">Range</th>
4849 <th class="th_notes">Notes</th>
4850 <th class="th_tags">Tags</th>
4851 </tr>
4852 </thead>
4853
4854 <tbody>
4855
4856
4857
4858
4859
4860
4861
4862
4863
4864
4865 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4866 <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]4867 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4868 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4869 <span class="entry_type_container">x</span>
4870
4871 <span class="entry_type_array">
4872 3
4873 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4874 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4875 <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]4876
4877
4878 </td> <!-- entry_type -->
4879
4880 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4881 <html><body><p>GPS coordinates to include in output JPEG
4882EXIF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4883 </td>
4884
4885 <td class="entry_units">
4886 </td>
4887
4888 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4889 <html><body><p>(-180 - 180], [-90,90], [-inf, inf]<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4890 </td>
4891
4892 <td class="entry_notes">
4893 </td>
4894
4895 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4896 <ul class="entry_tags">
4897 <li><a href="#tag_BC">BC</a></li>
4898 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4899 </td>
4900
4901 </tr> <!-- end of entry -->
4902
4903
4904 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4905 <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]4906 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4907 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4908
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]4909 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4910
4911
4912 </td> <!-- entry_type -->
4913
4914 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4915 <html><body><p>32 characters describing GPS algorithm to
4916include in EXIF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4917 </td>
4918
4919 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4920 <html><body><p>UTF-8 null-terminated string<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4921 </td>
4922
4923 <td class="entry_range">
4924 </td>
4925
4926 <td class="entry_notes">
4927 </td>
4928
4929 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4930 <ul class="entry_tags">
4931 <li><a href="#tag_BC">BC</a></li>
4932 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4933 </td>
4934
4935 </tr> <!-- end of entry -->
4936
4937
4938 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4939 <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]4940 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4941 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4942
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4943 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4944
4945
4946 </td> <!-- entry_type -->
4947
4948 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4949 <html><body><p>Time GPS fix was made to include in
4950EXIF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4951 </td>
4952
4953 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4954 <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]4955 </td>
4956
4957 <td class="entry_range">
4958 </td>
4959
4960 <td class="entry_notes">
4961 </td>
4962
4963 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4964 <ul class="entry_tags">
4965 <li><a href="#tag_BC">BC</a></li>
4966 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4967 </td>
4968
4969 </tr> <!-- end of entry -->
4970
4971
4972 <tr class="entry" id="dynamic_android.jpeg.orientation">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4973 <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]4974 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4975 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4976
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4977 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4978
4979
4980 </td> <!-- entry_type -->
4981
4982 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4983 <html><body><p>Orientation of JPEG image to
4984write<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4985 </td>
4986
4987 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4988 <html><body><p>Degrees in multiples of 90<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4989 </td>
4990
4991 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]4992 <html><body><p>0, 90, 180, 270<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4993 </td>
4994
4995 <td class="entry_notes">
4996 </td>
4997
4998 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4999 <ul class="entry_tags">
5000 <li><a href="#tag_BC">BC</a></li>
5001 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5002 </td>
5003
5004 </tr> <!-- end of entry -->
5005
5006
5007 <tr class="entry" id="dynamic_android.jpeg.quality">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5008 <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]5009 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5010 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5011
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5012 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5013
5014
5015 </td> <!-- entry_type -->
5016
5017 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5018 <html><body><p>Compression quality of the final JPEG
5019image<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5020 </td>
5021
5022 <td class="entry_units">
5023 </td>
5024
5025 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5026 <html><body><p>1-100; larger is higher quality<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5027 </td>
5028
5029 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5030 <html><body><p>85-95 is typical usage range<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5031 </td>
5032
5033 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5034 <ul class="entry_tags">
5035 <li><a href="#tag_BC">BC</a></li>
5036 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5037 </td>
5038
5039 </tr> <!-- end of entry -->
5040
5041
5042 <tr class="entry" id="dynamic_android.jpeg.size">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5043 <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]5044 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5045 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5046
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5047 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5048
5049
5050 </td> <!-- entry_type -->
5051
5052 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5053 <html><body><p>The size of the compressed JPEG image, in
5054bytes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5055 </td>
5056
5057 <td class="entry_units">
5058 </td>
5059
5060 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5061 <html><body><p>&gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5062 </td>
5063
5064 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5065 <html><body><p>If no JPEG output is produced for the request,
5066this must be 0.</p>
5067<p>Otherwise, this describes the real size of the compressed
5068JPEG image placed in the output stream. More specifically,
5069if android.jpeg.maxSize = 1000000, and a specific capture
5070has android.jpeg.size = 500000, then the output buffer from
5071the JPEG stream will be 1000000 bytes, of which the first
5072500000 make up the real data.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5073 </td>
5074
5075 <td class="entry_tags">
5076 </td>
5077
5078 </tr> <!-- end of entry -->
5079
5080
5081 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5082 <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]5083 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5084 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5085
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5086 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5087
5088
5089 </td> <!-- entry_type -->
5090
5091 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5092 <html><body><p>Compression quality of JPEG
5093thumbnail<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5094 </td>
5095
5096 <td class="entry_units">
5097 </td>
5098
5099 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5100 <html><body><p>1-100; larger is higher quality<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5101 </td>
5102
5103 <td class="entry_notes">
5104 </td>
5105
5106 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5107 <ul class="entry_tags">
5108 <li><a href="#tag_BC">BC</a></li>
5109 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5110 </td>
5111
5112 </tr> <!-- end of entry -->
5113
5114
5115 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5116 <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]5117 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5118 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5119 <span class="entry_type_container">x</span>
5120
5121 <span class="entry_type_array">
5122 2
5123 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5124 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5125
5126
5127 </td> <!-- entry_type -->
5128
5129 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5130 <html><body><p>Resolution of embedded JPEG
5131thumbnail<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5132 </td>
5133
5134 <td class="entry_units">
5135 </td>
5136
5137 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5138 <html><body><p>from android.jpeg.availableThumbnailSizes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5139 </td>
5140
5141 <td class="entry_notes">
5142 </td>
5143
5144 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5145 <ul class="entry_tags">
5146 <li><a href="#tag_BC">BC</a></li>
5147 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5148 </td>
5149
5150 </tr> <!-- end of entry -->
5151
5152
5153
5154 <!-- end of kind -->
5155 </tbody>
5156
5157 <!-- end of section -->
5158 <tr><td colspan="7" id="section_lens" class="section">lens</td></tr>
5159
5160
5161 <tr><td colspan="7" class="kind">controls</td></tr>
5162
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5163 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5164 <tr>
5165 <th class="th_name">Property Name</th>
5166 <th class="th_type">Type</th>
5167 <th class="th_description">Description</th>
5168 <th class="th_units">Units</th>
5169 <th class="th_range">Range</th>
5170 <th class="th_notes">Notes</th>
5171 <th class="th_tags">Tags</th>
5172 </tr>
5173 </thead>
5174
5175 <tbody>
5176
5177
5178
5179
5180
5181
5182
5183
5184
5185
5186 <tr class="entry" id="controls_android.lens.aperture">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5187 <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]5188 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5189 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5190
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5191 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5192
5193
5194 </td> <!-- entry_type -->
5195
5196 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5197 <html><body><p>Size of the lens aperture<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5198 </td>
5199
5200 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5201 <html><body><p>f-number (f/NNN)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5202 </td>
5203
5204 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5205 <html><body><p>android.lens.info.availableApertures<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5206 </td>
5207
5208 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5209 <html><body><p>Will not be supported on most devices. Can only
5210pick from supported list<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5211 </td>
5212
5213 <td class="entry_tags">
5214 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5215 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5216 </ul>
5217 </td>
5218
5219 </tr> <!-- end of entry -->
5220
5221
5222 <tr class="entry" id="controls_android.lens.filterDensity">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5223 <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]5224 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5225 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5226
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5227 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5228
5229
5230 </td> <!-- entry_type -->
5231
5232 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5233 <html><body><p>State of lens neutral density
5234filter(s)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5235 </td>
5236
5237 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5238 <html><body><p>number of stops of filtering<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5239 </td>
5240
5241 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5242 <html><body><p>android.lens.info.availableFilterDensities<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5243 </td>
5244
5245 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5246 <html><body><p>Will not be supported on most devices. Can only
5247pick from supported list<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5248 </td>
5249
5250 <td class="entry_tags">
5251 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5252 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5253 </ul>
5254 </td>
5255
5256 </tr> <!-- end of entry -->
5257
5258
5259 <tr class="entry" id="controls_android.lens.focalLength">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5260 <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]5261 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5262 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5263
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5264 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5265
5266
5267 </td> <!-- entry_type -->
5268
5269 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5270 <html><body><p>Lens optical zoom setting<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5271 </td>
5272
5273 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5274 <html><body><p>focal length in mm<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5275 </td>
5276
5277 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5278 <html><body><p>&gt; 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5279 </td>
5280
5281 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5282 <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]5283 </td>
5284
5285 <td class="entry_tags">
5286 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5287 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5288 </ul>
5289 </td>
5290
5291 </tr> <!-- end of entry -->
5292
5293
5294 <tr class="entry" id="controls_android.lens.focusDistance">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5295 <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]5296 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5297 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5298
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5299 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5300
5301
5302 </td> <!-- entry_type -->
5303
5304 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5305 <html><body><p>Distance to plane of sharpest focus,
5306measured from frontmost surface of the lens<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5307 </td>
5308
5309 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5310 <html><body><p>diopters (1/m)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5311 </td>
5312
5313 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5314 <html><body><p>&gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5315 </td>
5316
5317 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5318 <html><body><p>0 = infinity focus. Used value should be clamped
5319to (0,minimum focus distance)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5320 </td>
5321
5322 <td class="entry_tags">
5323 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5324 <li><a href="#tag_BC">BC</a></li>
5325 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5326 </ul>
5327 </td>
5328
5329 </tr> <!-- end of entry -->
5330
5331
5332 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5333 <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]5334 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5335 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5336
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5337 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5338
5339 <ul class="entry_type_enum">
5340 <li>
5341 <span class="entry_type_enum_name">OFF</span>
5342 </li>
5343 <li>
5344 <span class="entry_type_enum_name">ON</span>
5345 <span class="entry_type_enum_optional">optional</span>
5346 </li>
5347 </ul>
5348
5349 </td> <!-- entry_type -->
5350
5351 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5352 <html><body><p>Whether optical image stabilization is
5353enabled.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5354 </td>
5355
5356 <td class="entry_units">
5357 </td>
5358
5359 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5360 <html><body><p>android.lens.availableOpticalStabilization<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5361 </td>
5362
5363 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5364 <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]5365 </td>
5366
5367 <td class="entry_tags">
5368 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5369 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5370 </ul>
5371 </td>
5372
5373 </tr> <!-- end of entry -->
5374
5375
5376
5377 <!-- end of kind -->
5378 </tbody>
5379 <tr><td colspan="7" class="kind">static</td></tr>
5380
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5381 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5382 <tr>
5383 <th class="th_name">Property Name</th>
5384 <th class="th_type">Type</th>
5385 <th class="th_description">Description</th>
5386 <th class="th_units">Units</th>
5387 <th class="th_range">Range</th>
5388 <th class="th_notes">Notes</th>
5389 <th class="th_tags">Tags</th>
5390 </tr>
5391 </thead>
5392
5393 <tbody>
5394
5395
5396
5397
5398
5399
5400
5401
5402
5403
5404
5405
5406 <tr class="entry" id="static_android.lens.info.availableApertures">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5407 <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]5408 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5409 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5410 <span class="entry_type_container">x</span>
5411
5412 <span class="entry_type_array">
5413 n
5414 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5415 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5416
5417
5418 </td> <!-- entry_type -->
5419
5420 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5421 <html><body><p>List of supported aperture
5422values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5423 </td>
5424
5425 <td class="entry_units">
5426 </td>
5427
5428 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5429 <html><body><p>one entry required, &gt; 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5430 </td>
5431
5432 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5433 <html><body><p>If variable aperture not available, only setting
5434should be for the fixed aperture<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5435 </td>
5436
5437 <td class="entry_tags">
5438 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5439 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5440 </ul>
5441 </td>
5442
5443 </tr> <!-- end of entry -->
5444
5445
5446 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5447 <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]5448 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5449 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5450 <span class="entry_type_container">x</span>
5451
5452 <span class="entry_type_array">
5453 n
5454 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5455 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5456
5457
5458 </td> <!-- entry_type -->
5459
5460 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5461 <html><body><p>List of supported ND filter
5462values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5463 </td>
5464
5465 <td class="entry_units">
5466 </td>
5467
5468 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5469 <html><body><p>one entry required, &gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5470 </td>
5471
5472 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5473 <html><body><p>If not available, only setting is 0. Otherwise,
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]5474lists the available exposure index values for dimming
5475(2 would mean the filter is set to reduce incoming
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5476light by two stops)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5477 </td>
5478
5479 <td class="entry_tags">
5480 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5481 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5482 </ul>
5483 </td>
5484
5485 </tr> <!-- end of entry -->
5486
5487
5488 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5489 <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]5490 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5491 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5492 <span class="entry_type_container">x</span>
5493
5494 <span class="entry_type_array">
5495 n
5496 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5497 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5498 <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]5499
5500
5501 </td> <!-- entry_type -->
5502
5503 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5504 <html><body><p>If fitted with optical zoom, what focal
5505lengths are available. If not, the static focal
5506length<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5507 </td>
5508
5509 <td class="entry_units">
5510 </td>
5511
5512 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5513 <html><body><p>&gt; 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5514 </td>
5515
5516 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5517 <html><body><p>If optical zoom not supported, only one value
5518should be reported<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5519 </td>
5520
5521 <td class="entry_tags">
5522 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5523 <li><a href="#tag_BC">BC</a></li>
5524 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5525 </ul>
5526 </td>
5527
5528 </tr> <!-- end of entry -->
5529
5530
5531 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5532 <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]5533 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5534 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5535 <span class="entry_type_container">x</span>
5536
5537 <span class="entry_type_array">
5538 n
5539 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5540 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5541 <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]5542
5543
5544 </td> <!-- entry_type -->
5545
5546 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5547 <html><body><p>List of supported optical image
5548stabilization modes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5549 </td>
5550
5551 <td class="entry_units">
5552 </td>
5553
5554 <td class="entry_range">
5555 </td>
5556
5557 <td class="entry_notes">
5558 </td>
5559
5560 <td class="entry_tags">
5561 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5562 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5563 </ul>
5564 </td>
5565
5566 </tr> <!-- end of entry -->
5567
5568
5569 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5570 <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]5571 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5572 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5573 <span class="entry_type_container">x</span>
5574
5575 <span class="entry_type_array">
5576 2 x 3 x n x m
5577 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5578 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5579 <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]5580
5581
5582 </td> <!-- entry_type -->
5583
5584 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5585 <html><body><p>A low-resolution map for correction of
5586geometric distortions and chromatic aberrations, per
5587color channel<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5588 </td>
5589
5590 <td class="entry_units">
5591 </td>
5592
5593 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5594 <html><body><p>N, M &gt;= 2<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5595 </td>
5596
5597 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5598 <html><body><p>[DNG wants a function instead]. What's easiest
5599for implementers? With an array size (M, N), entry (i,
5600j) provides the destination for pixel (i/(M-1) * width,
5601j/(N-1) * height). Data is row-major, with each array
5602entry 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]5603 </td>
5604
5605 <td class="entry_tags">
5606 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5607 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5608 </ul>
5609 </td>
5610
5611 </tr> <!-- end of entry -->
5612
5613
5614 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5615 <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]5616 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5617 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5618 <span class="entry_type_container">x</span>
5619
5620 <span class="entry_type_array">
5621 2
5622 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5623 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5624 <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]5625
5626
5627 </td> <!-- entry_type -->
5628
5629 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5630 <html><body><p>Dimensions of geometric correction
5631map<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5632 </td>
5633
5634 <td class="entry_units">
5635 </td>
5636
5637 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5638 <html><body><p>Both values &gt;= 2<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5639 </td>
5640
5641 <td class="entry_notes">
5642 </td>
5643
5644 <td class="entry_tags">
5645 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5646 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5647 </ul>
5648 </td>
5649
5650 </tr> <!-- end of entry -->
5651
5652
5653 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5654 <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]5655 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5656 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5657
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5658 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5659
5660
5661 </td> <!-- entry_type -->
5662
5663 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5664 <html><body><p>Hyperfocal distance for this lens; set to
56650 if fixed focus<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5666 </td>
5667
5668 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5669 <html><body><p>diopters<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5670 </td>
5671
5672 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5673 <html><body><p>&gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5674 </td>
5675
5676 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5677 <html><body><p>The hyperfocal distance is used for the old
5678API's 'fixed' setting<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5679 </td>
5680
5681 <td class="entry_tags">
5682 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5683 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5684 </ul>
5685 </td>
5686
5687 </tr> <!-- end of entry -->
5688
5689
5690 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5691 <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]5692 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5693 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5694
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5695 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5696
5697
5698 </td> <!-- entry_type -->
5699
5700 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5701 <html><body><p>Shortest distance from frontmost surface
5702of the lens that can be focused correctly<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5703 </td>
5704
5705 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5706 <html><body><p>diopters<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5707 </td>
5708
5709 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5710 <html><body><p>&gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5711 </td>
5712
5713 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5714 <html><body><p>If the lens is fixed-focus, this should be
57150<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5716 </td>
5717
5718 <td class="entry_tags">
5719 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5720 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5721 </ul>
5722 </td>
5723
5724 </tr> <!-- end of entry -->
5725
5726
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5727 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5728 <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]5729 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5730 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5731 <span class="entry_type_container">x</span>
5732
5733 <span class="entry_type_array">
5734 2
5735 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5736 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5737 <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]5738
5739
5740 </td> <!-- entry_type -->
5741
5742 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5743 <html><body><p>Dimensions of lens shading map.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5744 </td>
5745
5746 <td class="entry_units">
5747 </td>
5748
5749 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5750 <html><body><p>Both values &gt;= 1<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5751 </td>
5752
5753 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5754 <html><body><p>The map should be on the order of 30-40 rows and columns, and
5755must be smaller than 64x64.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5756 </td>
5757
5758 <td class="entry_tags">
5759 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5760 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5761 </ul>
5762 </td>
5763
5764 </tr> <!-- end of entry -->
5765
5766
5767
5768
5769
5770 <tr class="entry" id="static_android.lens.facing">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5771 <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]5772 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5773 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5774
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5775 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5776
5777 <ul class="entry_type_enum">
5778 <li>
5779 <span class="entry_type_enum_name">FRONT</span>
5780 </li>
5781 <li>
5782 <span class="entry_type_enum_name">BACK</span>
5783 </li>
5784 </ul>
5785
5786 </td> <!-- entry_type -->
5787
5788 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5789 <html><body><p>Direction the camera faces relative to
5790device screen<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5791 </td>
5792
5793 <td class="entry_units">
5794 </td>
5795
5796 <td class="entry_range">
5797 </td>
5798
5799 <td class="entry_notes">
5800 </td>
5801
5802 <td class="entry_tags">
5803 </td>
5804
5805 </tr> <!-- end of entry -->
5806
5807
5808 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5809 <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]5810 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5811 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5812 <span class="entry_type_container">x</span>
5813
5814 <span class="entry_type_array">
5815 2
5816 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5817 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5818 <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]5819
5820
5821 </td> <!-- entry_type -->
5822
5823 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5824 <html><body><p>Relative angle of camera optical axis to the
5825perpendicular axis from the display<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5826 </td>
5827
5828 <td class="entry_units">
5829 </td>
5830
5831 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5832 <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]5833 </td>
5834
5835 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5836 <html><body><p>Examples:</p>
5837<p>(0,0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]5838is perpendicular to the display surface;</p>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5839<p>(45,0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]5840device is held upright;</p>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5841<p>(45,90) means the camera points 45 degrees to the right when
5842the device is held upright.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]5843<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5844direction<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5845 </td>
5846
5847 <td class="entry_tags">
5848 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5849 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5850 </ul>
5851 </td>
5852
5853 </tr> <!-- end of entry -->
5854
5855
5856 <tr class="entry" id="static_android.lens.position">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5857 <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]5858 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5859 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5860 <span class="entry_type_container">x</span>
5861
5862 <span class="entry_type_array">
5863 3, location in mm, in the sensor coordinate
5864 system
5865 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5866 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5867
5868
5869 </td> <!-- entry_type -->
5870
5871 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5872 <html><body><p>Coordinates of camera optical axis on
5873device<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5874 </td>
5875
5876 <td class="entry_units">
5877 </td>
5878
5879 <td class="entry_range">
5880 </td>
5881
5882 <td class="entry_notes">
5883 </td>
5884
5885 <td class="entry_tags">
5886 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5887 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5888 </ul>
5889 </td>
5890
5891 </tr> <!-- end of entry -->
5892
5893
5894
5895 <!-- end of kind -->
5896 </tbody>
5897 <tr><td colspan="7" class="kind">dynamic</td></tr>
5898
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5899 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5900 <tr>
5901 <th class="th_name">Property Name</th>
5902 <th class="th_type">Type</th>
5903 <th class="th_description">Description</th>
5904 <th class="th_units">Units</th>
5905 <th class="th_range">Range</th>
5906 <th class="th_notes">Notes</th>
5907 <th class="th_tags">Tags</th>
5908 </tr>
5909 </thead>
5910
5911 <tbody>
5912
5913
5914
5915
5916
5917
5918
5919
5920
5921
5922 <tr class="entry" id="dynamic_android.lens.aperture">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5923 <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]5924 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5925 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5926
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5927 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5928
5929
5930 </td> <!-- entry_type -->
5931
5932 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5933 <html><body><p>Size of the lens aperture<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5934 </td>
5935
5936 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5937 <html><body><p>f-number (f/NNN)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5938 </td>
5939
5940 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5941 <html><body><p>android.lens.info.availableApertures<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5942 </td>
5943
5944 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5945 <html><body><p>Will not be supported on most devices. Can only
5946pick from supported list<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5947 </td>
5948
5949 <td class="entry_tags">
5950 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5951 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5952 </ul>
5953 </td>
5954
5955 </tr> <!-- end of entry -->
5956
5957
5958 <tr class="entry" id="dynamic_android.lens.filterDensity">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5959 <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]5960 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5961 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5962
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5963 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5964
5965
5966 </td> <!-- entry_type -->
5967
5968 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5969 <html><body><p>State of lens neutral density
5970filter(s)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5971 </td>
5972
5973 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5974 <html><body><p>number of stops of filtering<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5975 </td>
5976
5977 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5978 <html><body><p>android.lens.info.availableFilterDensities<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5979 </td>
5980
5981 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5982 <html><body><p>Will not be supported on most devices. Can only
5983pick from supported list<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5984 </td>
5985
5986 <td class="entry_tags">
5987 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5988 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5989 </ul>
5990 </td>
5991
5992 </tr> <!-- end of entry -->
5993
5994
5995 <tr class="entry" id="dynamic_android.lens.focalLength">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]5996 <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]5997 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5998 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5999
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6000 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6001
6002
6003 </td> <!-- entry_type -->
6004
6005 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6006 <html><body><p>Lens optical zoom setting<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6007 </td>
6008
6009 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6010 <html><body><p>focal length in mm<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6011 </td>
6012
6013 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6014 <html><body><p>&gt; 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6015 </td>
6016
6017 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6018 <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]6019 </td>
6020
6021 <td class="entry_tags">
6022 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6023 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6024 </ul>
6025 </td>
6026
6027 </tr> <!-- end of entry -->
6028
6029
6030 <tr class="entry" id="dynamic_android.lens.focusDistance">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6031 <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]6032 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6033 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6034
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6035 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6036
6037
6038 </td> <!-- entry_type -->
6039
6040 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6041 <html><body><p>Distance to plane of sharpest focus,
6042measured from frontmost surface of the lens<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6043 </td>
6044
6045 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6046 <html><body><p>diopters (1/m)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6047 </td>
6048
6049 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6050 <html><body><p>&gt;= 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6051 </td>
6052
6053 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6054 <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]6055 </td>
6056
6057 <td class="entry_tags">
6058 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6059 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6060 </ul>
6061 </td>
6062
6063 </tr> <!-- end of entry -->
6064
6065
6066 <tr class="entry" id="dynamic_android.lens.focusRange">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6067 <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]6068 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6069 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]6070 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6071
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]6072 <span class="entry_type_array">
6073 2
6074 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6075 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6076 <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]6077
6078
6079 </td> <!-- entry_type -->
6080
6081 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6082 <html><body><p>The range of scene distances that are in
6083sharp focus (depth of field)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6084 </td>
6085
6086 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6087 <html><body><p>pair of focus distances in diopters: (near,
6088 far)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6089 </td>
6090
6091 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6092 <html><body><p>&gt;=0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6093 </td>
6094
6095 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6096 <html><body><p>If variable focus not supported, can still report
6097fixed depth of field range<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6098 </td>
6099
6100 <td class="entry_tags">
6101 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6102 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6103 </ul>
6104 </td>
6105
6106 </tr> <!-- end of entry -->
6107
6108
6109 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6110 <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]6111 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6112 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6113
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6114 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6115
6116 <ul class="entry_type_enum">
6117 <li>
6118 <span class="entry_type_enum_name">OFF</span>
6119 </li>
6120 <li>
6121 <span class="entry_type_enum_name">ON</span>
6122 <span class="entry_type_enum_optional">optional</span>
6123 </li>
6124 </ul>
6125
6126 </td> <!-- entry_type -->
6127
6128 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6129 <html><body><p>Whether optical image stabilization is
6130enabled.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6131 </td>
6132
6133 <td class="entry_units">
6134 </td>
6135
6136 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6137 <html><body><p>android.lens.availableOpticalStabilization<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6138 </td>
6139
6140 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6141 <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]6142 </td>
6143
6144 <td class="entry_tags">
6145 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6146 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6147 </ul>
6148 </td>
6149
6150 </tr> <!-- end of entry -->
6151
6152
6153 <tr class="entry" id="dynamic_android.lens.state">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6154 <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]6155 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6156 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6157
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6158 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6159
6160 <ul class="entry_type_enum">
6161 <li>
6162 <span class="entry_type_enum_name">STATIONARY</span>
6163 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]6164 <li>
6165 <span class="entry_type_enum_name">MOVING</span>
6166 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6167 </ul>
6168
6169 </td> <!-- entry_type -->
6170
6171 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6172 <html><body><p>Current lens status<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6173 </td>
6174
6175 <td class="entry_units">
6176 </td>
6177
6178 <td class="entry_range">
6179 </td>
6180
6181 <td class="entry_notes">
6182 </td>
6183
6184 <td class="entry_tags">
6185 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6186 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6187 </ul>
6188 </td>
6189
6190 </tr> <!-- end of entry -->
6191
6192
6193
6194 <!-- end of kind -->
6195 </tbody>
6196
6197 <!-- end of section -->
6198 <tr><td colspan="7" id="section_noiseReduction" class="section">noiseReduction</td></tr>
6199
6200
6201 <tr><td colspan="7" class="kind">controls</td></tr>
6202
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6203 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6204 <tr>
6205 <th class="th_name">Property Name</th>
6206 <th class="th_type">Type</th>
6207 <th class="th_description">Description</th>
6208 <th class="th_units">Units</th>
6209 <th class="th_range">Range</th>
6210 <th class="th_notes">Notes</th>
6211 <th class="th_tags">Tags</th>
6212 </tr>
6213 </thead>
6214
6215 <tbody>
6216
6217
6218
6219
6220
6221
6222
6223
6224
6225
6226 <tr class="entry" id="controls_android.noiseReduction.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6227 <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]6228 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6229 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6230
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6231 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6232
6233 <ul class="entry_type_enum">
6234 <li>
6235 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6236 <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]6237 </li>
6238 <li>
6239 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6240 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
6241 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6242 </li>
6243 <li>
6244 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6245 <span class="entry_type_enum_notes"><html><body><p>May slow down frame rate to provide highest
6246 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6247 </li>
6248 </ul>
6249
6250 </td> <!-- entry_type -->
6251
6252 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6253 <html><body><p>Mode of operation for the noise reduction
6254algorithm<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6255 </td>
6256
6257 <td class="entry_units">
6258 </td>
6259
6260 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6261 <html><body><p>android.noiseReduction.availableModes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6262 </td>
6263
6264 <td class="entry_notes">
6265 </td>
6266
6267 <td class="entry_tags">
6268 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6269 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6270 </ul>
6271 </td>
6272
6273 </tr> <!-- end of entry -->
6274
6275
6276 <tr class="entry" id="controls_android.noiseReduction.strength">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6277 <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]6278 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6279 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6280
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6281 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6282
6283
6284 </td> <!-- entry_type -->
6285
6286 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6287 <html><body><p>Control the amount of noise reduction
6288applied to the images<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6289 </td>
6290
6291 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6292 <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]6293 </td>
6294
6295 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6296 <html><body><p>1 - 10<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6297 </td>
6298
6299 <td class="entry_notes">
6300 </td>
6301
6302 <td class="entry_tags">
6303 </td>
6304
6305 </tr> <!-- end of entry -->
6306
6307
6308
6309 <!-- end of kind -->
6310 </tbody>
6311 <tr><td colspan="7" class="kind">dynamic</td></tr>
6312
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6313 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6314 <tr>
6315 <th class="th_name">Property Name</th>
6316 <th class="th_type">Type</th>
6317 <th class="th_description">Description</th>
6318 <th class="th_units">Units</th>
6319 <th class="th_range">Range</th>
6320 <th class="th_notes">Notes</th>
6321 <th class="th_tags">Tags</th>
6322 </tr>
6323 </thead>
6324
6325 <tbody>
6326
6327
6328
6329
6330
6331
6332
6333
6334
6335
6336 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6337 <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]6338 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6339 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6340
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6341 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6342
6343 <ul class="entry_type_enum">
6344 <li>
6345 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6346 <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]6347 </li>
6348 <li>
6349 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6350 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
6351 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6352 </li>
6353 <li>
6354 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6355 <span class="entry_type_enum_notes"><html><body><p>May slow down frame rate to provide highest
6356 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6357 </li>
6358 </ul>
6359
6360 </td> <!-- entry_type -->
6361
6362 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6363 <html><body><p>Mode of operation for the noise reduction
6364algorithm<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6365 </td>
6366
6367 <td class="entry_units">
6368 </td>
6369
6370 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6371 <html><body><p>android.noiseReduction.availableModes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6372 </td>
6373
6374 <td class="entry_notes">
6375 </td>
6376
6377 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6378 <ul class="entry_tags">
6379 <li><a href="#tag_V1">V1</a></li>
6380 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6381 </td>
6382
6383 </tr> <!-- end of entry -->
6384
6385
6386
6387 <!-- end of kind -->
6388 </tbody>
6389
6390 <!-- end of section -->
6391 <tr><td colspan="7" id="section_quirks" class="section">quirks</td></tr>
6392
6393
6394 <tr><td colspan="7" class="kind">static</td></tr>
6395
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6396 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6397 <tr>
6398 <th class="th_name">Property Name</th>
6399 <th class="th_type">Type</th>
6400 <th class="th_description">Description</th>
6401 <th class="th_units">Units</th>
6402 <th class="th_range">Range</th>
6403 <th class="th_notes">Notes</th>
6404 <th class="th_tags">Tags</th>
6405 </tr>
6406 </thead>
6407
6408 <tbody>
6409
6410
6411
6412
6413
6414
6415
6416
6417
6418
6419 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6420 <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]6421 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6422 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6423
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6424 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6425
6426
6427 </td> <!-- entry_type -->
6428
6429 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6430 <html><body><p>If set to 1, the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6431scale 'normalized' coordinates with respect to the crop
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6432region. This applies to metering input (a{e,f,wb}Region
6433and output (face rectangles).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6434 </td>
6435
6436 <td class="entry_units">
6437 </td>
6438
6439 <td class="entry_range">
6440 </td>
6441
6442 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6443 <html><body><p>Normalized coordinates refer to those in the
6444(-1000,1000) range mentioned in the
6445android.hardware.Camera API.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6446<p>HAL implementations should instead always use and emit
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6447sensor array-relative coordinates for all region data. Does
6448not need to be listed in static metadata. Support will be
6449removed in future versions of camera service.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6450 </td>
6451
6452 <td class="entry_tags">
6453 </td>
6454
6455 </tr> <!-- end of entry -->
6456
6457
6458 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6459 <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]6460 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6461 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6462
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6463 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6464
6465
6466 </td> <!-- entry_type -->
6467
6468 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6469 <html><body><p>If set to 1, then the camera service always
6470switches to FOCUS_MODE_AUTO before issuing a AF
6471trigger.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6472 </td>
6473
6474 <td class="entry_units">
6475 </td>
6476
6477 <td class="entry_range">
6478 </td>
6479
6480 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6481 <html><body><p>HAL implementations should implement AF trigger
6482modes for AUTO, MACRO, CONTINUOUS_FOCUS, and
6483CONTINUOUS_PICTURE modes instead of using this flag. Does
6484not need to be listed in static metadata. Support will be
6485removed in future versions of camera service<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6486 </td>
6487
6488 <td class="entry_tags">
6489 </td>
6490
6491 </tr> <!-- end of entry -->
6492
6493
6494 <tr class="entry" id="static_android.quirks.useZslFormat">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6495 <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]6496 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6497 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6498
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6499 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6500
6501
6502 </td> <!-- entry_type -->
6503
6504 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6505 <html><body><p>If set to 1, the camera service uses
6506CAMERA2_PIXEL_FORMAT_ZSL instead of
6507HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED for the zero
6508shutter lag stream<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6509 </td>
6510
6511 <td class="entry_units">
6512 </td>
6513
6514 <td class="entry_range">
6515 </td>
6516
6517 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6518 <html><body><p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6519to determine that a stream will be used for
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6520zero-shutter-lag, instead of relying on an explicit
6521format setting. Does not need to be listed in static
6522metadata. Support will be removed in future versions of
6523camera service.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6524 </td>
6525
6526 <td class="entry_tags">
6527 </td>
6528
6529 </tr> <!-- end of entry -->
6530
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6531
6532 <tr class="entry" id="static_android.quirks.usePartialResult">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6533 <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]6534 <td class="entry_type">
6535 <span class="entry_type_name">byte</span>
6536
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]6537 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6538
6539
6540 </td> <!-- entry_type -->
6541
6542 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6543 <html><body><p>If set to 1, the HAL will always split result
6544metadata for a single capture into multiple buffers,
6545returned using multiple process_capture_result calls.<wbr></wbr></p></body></html>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6546 </td>
6547
6548 <td class="entry_units">
6549 </td>
6550
6551 <td class="entry_range">
6552 </td>
6553
6554 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6555 <html><body><p>Does not need to be listed in static
6556metadata. Support for partial results will be reworked in
6557future versions of camera service. This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6558working at that point; DO NOT USE without careful
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6559consideration of future support.<wbr></wbr></p></body></html>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6560 </td>
6561
6562 <td class="entry_tags">
6563 </td>
6564
6565 </tr> <!-- end of entry -->
6566
6567
6568
6569 <!-- end of kind -->
6570 </tbody>
6571 <tr><td colspan="7" class="kind">dynamic</td></tr>
6572
6573 <thead class="entries_header">
6574 <tr>
6575 <th class="th_name">Property Name</th>
6576 <th class="th_type">Type</th>
6577 <th class="th_description">Description</th>
6578 <th class="th_units">Units</th>
6579 <th class="th_range">Range</th>
6580 <th class="th_notes">Notes</th>
6581 <th class="th_tags">Tags</th>
6582 </tr>
6583 </thead>
6584
6585 <tbody>
6586
6587
6588
6589
6590
6591
6592
6593
6594
6595
6596 <tr class="entry" id="dynamic_android.quirks.partialResult">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6597 <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]6598 <td class="entry_type">
6599 <span class="entry_type_name entry_type_name_enum">byte</span>
6600
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]6601 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6602
6603 <ul class="entry_type_enum">
6604 <li>
6605 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6606 <span class="entry_type_enum_notes"><html><body><p>The last or only metadata result buffer
6607 for this capture.<wbr></wbr></p></body></html></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6608 </li>
6609 <li>
6610 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6611 <span class="entry_type_enum_notes"><html><body><p>A partial buffer of result metadata for this
6612 capture. More result buffers for this capture will be sent
6613 by the HAL, the last of which will be marked
6614 FINAL.<wbr></wbr></p></body></html></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6615 </li>
6616 </ul>
6617
6618 </td> <!-- entry_type -->
6619
6620 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6621 <html><body><p>Whether a result given to the framework is the
6622final one for the capture, or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6623subset of the full set of dynamic metadata
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6624values.<wbr></wbr></p></body></html>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6625 </td>
6626
6627 <td class="entry_units">
6628 </td>
6629
6630 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6631 <html><body><p>Optional. Default value is FINAL.<wbr></wbr></p></body></html>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]6632 </td>
6633
6634 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6635 <html><body><p>The entries in the result metadata buffers for a
6636single capture may not overlap, except for this entry. The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6637FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6638requests that generate them, so the FINAL buffer for frame 3 must
6639always be sent to the framework after the FINAL buffer for frame 2, and
6640before the FINAL buffer for frame 4. PARTIAL buffers may be returned
6641in any order relative to other frames, but all PARTIAL buffers for a given
6642capture must arrive before the FINAL buffer for that capture. This entry may
6643only 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]6644 </td>
6645
6646 <td class="entry_tags">
6647 </td>
6648
6649 </tr> <!-- end of entry -->
6650
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6651
6652
6653 <!-- end of kind -->
6654 </tbody>
6655
6656 <!-- end of section -->
6657 <tr><td colspan="7" id="section_request" class="section">request</td></tr>
6658
6659
6660 <tr><td colspan="7" class="kind">controls</td></tr>
6661
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6662 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6663 <tr>
6664 <th class="th_name">Property Name</th>
6665 <th class="th_type">Type</th>
6666 <th class="th_description">Description</th>
6667 <th class="th_units">Units</th>
6668 <th class="th_range">Range</th>
6669 <th class="th_notes">Notes</th>
6670 <th class="th_tags">Tags</th>
6671 </tr>
6672 </thead>
6673
6674 <tbody>
6675
6676
6677
6678
6679
6680
6681
6682
6683
6684
6685 <tr class="entry" id="controls_android.request.frameCount">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6686 <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]6687 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6688 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6689
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6690 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6691
6692
6693 </td> <!-- entry_type -->
6694
6695 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6696 <html><body><p>A frame counter set by the framework. Must
6697be maintained unchanged in output frame. This value monotonically
6698increases with every new result (that is, each new result has a unique
6699frameCount value).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6700 </td>
6701
6702 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6703 <html><body><p>incrementing integer<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6704 </td>
6705
6706 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6707 <html><body><p>Any int<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6708 </td>
6709
6710 <td class="entry_notes">
6711 </td>
6712
6713 <td class="entry_tags">
6714 </td>
6715
6716 </tr> <!-- end of entry -->
6717
6718
6719 <tr class="entry" id="controls_android.request.id">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6720 <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]6721 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6722 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6723
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6724 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6725
6726
6727 </td> <!-- entry_type -->
6728
6729 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6730 <html><body><p>An application-specified ID for the current
6731request. Must be maintained unchanged in output
6732frame<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6733 </td>
6734
6735 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6736 <html><body><p>arbitrary integer assigned by application<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6737 </td>
6738
6739 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6740 <html><body><p>Any int<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6741 </td>
6742
6743 <td class="entry_notes">
6744 </td>
6745
6746 <td class="entry_tags">
6747 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6748 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6749 </ul>
6750 </td>
6751
6752 </tr> <!-- end of entry -->
6753
6754
6755 <tr class="entry" id="controls_android.request.inputStreams">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6756 <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]6757 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]6758 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6759 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6760
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6761 <span class="entry_type_array">
6762 n
6763 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6764 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6765
6766
6767 </td> <!-- entry_type -->
6768
6769 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6770 <html><body><p>List which camera reprocess stream is used
6771for the source of reprocessing data.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6772 </td>
6773
6774 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6775 <html><body><p>List of camera reprocess stream IDs<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6776 </td>
6777
6778 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6779 <html><body><p>Typically, only one entry allowed, must be a valid
6780 reprocess stream ID.
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6781
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6782 If android.jpeg.needsThumbnail is set, then multiple
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6783 reprocess streams may be included in a single request; they
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6784 must be different scaled versions of the same image.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6785 </td>
6786
6787 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6788 <html><body><p>Only meaningful when android.request.type ==
6789REPROCESS. Ignored otherwise<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6790 </td>
6791
6792 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6793 <ul class="entry_tags">
6794 <li><a href="#tag_HAL2">HAL2</a></li>
6795 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6796 </td>
6797
6798 </tr> <!-- end of entry -->
6799
6800
6801 <tr class="entry" id="controls_android.request.metadataMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6802 <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]6803 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6804 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6805
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6806 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6807
6808 <ul class="entry_type_enum">
6809 <li>
6810 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6811 <span class="entry_type_enum_notes"><html><body><p>No metadata should be produced on output, except
6812 for application-bound buffer data. If no
6813 application-bound streams exist, no frame should be
6814 placed in the output frame queue. If such streams
6815 exist, a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6816 with null metadata but with the necessary output buffer
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6817 information. Timestamp information should still be
6818 included with any output stream buffers<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6819 </li>
6820 <li>
6821 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6822 <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]6823 only be produced if they are separately
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6824 enabled<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6825 </li>
6826 </ul>
6827
6828 </td> <!-- entry_type -->
6829
6830 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6831 <html><body><p>How much metadata to produce on
6832output<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6833 </td>
6834
6835 <td class="entry_units">
6836 </td>
6837
6838 <td class="entry_range">
6839 </td>
6840
6841 <td class="entry_notes">
6842 </td>
6843
6844 <td class="entry_tags">
6845 </td>
6846
6847 </tr> <!-- end of entry -->
6848
6849
6850 <tr class="entry" id="controls_android.request.outputStreams">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6851 <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]6852 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]6853 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6854 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6855
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6856 <span class="entry_type_array">
6857 n
6858 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6859 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6860
6861
6862 </td> <!-- entry_type -->
6863
6864 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6865 <html><body><p>Lists which camera output streams image data
6866from this capture must be sent to<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6867 </td>
6868
6869 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6870 <html><body><p>List of camera stream IDs<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6871 </td>
6872
6873 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6874 <html><body><p>List must only include streams that have been
6875 created<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6876 </td>
6877
6878 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6879 <html><body><p>If no output streams are listed, then the image
6880data should simply be discarded. The image data must
6881still be captured for metadata and statistics production,
6882and the lens and flash must operate as requested.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6883 </td>
6884
6885 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6886 <ul class="entry_tags">
6887 <li><a href="#tag_HAL2">HAL2</a></li>
6888 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6889 </td>
6890
6891 </tr> <!-- end of entry -->
6892
6893
6894 <tr class="entry" id="controls_android.request.type">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6895 <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]6896 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6897 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6898
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6899 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6900
6901 <ul class="entry_type_enum">
6902 <li>
6903 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6904 <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]6905 and process it according to the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6906 settings<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6907 </li>
6908 <li>
6909 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6910 <span class="entry_type_enum_notes"><html><body><p>Process previously captured data; the
6911 android.request.inputStream parameter determines the
6912 source reprocessing stream. TODO: Mark dynamic metadata
6913 needed for reprocessing with [RP]<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6914 </li>
6915 </ul>
6916
6917 </td> <!-- entry_type -->
6918
6919 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6920 <html><body><p>The type of the request; either CAPTURE or
6921REPROCESS. For HAL3, this tag is redundant.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6922 </td>
6923
6924 <td class="entry_units">
6925 </td>
6926
6927 <td class="entry_range">
6928 </td>
6929
6930 <td class="entry_notes">
6931 </td>
6932
6933 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6934 <ul class="entry_tags">
6935 <li><a href="#tag_HAL2">HAL2</a></li>
6936 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6937 </td>
6938
6939 </tr> <!-- end of entry -->
6940
6941
6942
6943 <!-- end of kind -->
6944 </tbody>
6945 <tr><td colspan="7" class="kind">static</td></tr>
6946
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6947 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6948 <tr>
6949 <th class="th_name">Property Name</th>
6950 <th class="th_type">Type</th>
6951 <th class="th_description">Description</th>
6952 <th class="th_units">Units</th>
6953 <th class="th_range">Range</th>
6954 <th class="th_notes">Notes</th>
6955 <th class="th_tags">Tags</th>
6956 </tr>
6957 </thead>
6958
6959 <tbody>
6960
6961
6962
6963
6964
6965
6966
6967
6968
6969
6970 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6971 <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]6972 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6973 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6974 <span class="entry_type_container">x</span>
6975
6976 <span class="entry_type_array">
6977 3
6978 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6979 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6980
6981
6982 </td> <!-- entry_type -->
6983
6984 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6985 <html><body><p>How many output streams can be allocated at
6986the same time for each type of stream<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6987 </td>
6988
6989 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6990 <html><body><p>The number of raw sensor streams; the number of
6991 processed, uncompressed streams; and the number of
6992 JPEG-compressed streams<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6993 </td>
6994
6995 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]6996 <html><body><p>&gt;=1 for Raw and JPEG-compressed stream. &gt;= 3
6997 for processed, uncompressed streams<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6998 </td>
6999
7000 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7001 <html><body><p>Video snapshot with preview callbacks requires 3
7002processed streams (preview, record, app callbacks) and
7003one JPEG stream (snapshot)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7004 </td>
7005
7006 <td class="entry_tags">
7007 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7008 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7009 </ul>
7010 </td>
7011
7012 </tr> <!-- end of entry -->
7013
7014
7015 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7016 <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]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 1
7023 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7024 <span class="entry_type_visibility"> [system]</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 reprocessing streams of any type
7031can be allocated at the same time<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7032 </td>
7033
7034 <td class="entry_units">
7035 </td>
7036
7037 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7038 <html><body><p>&gt;= 1<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7039 </td>
7040
7041 <td class="entry_notes">
7042 </td>
7043
7044 <td class="entry_tags">
7045 </td>
7046
7047 </tr> <!-- end of entry -->
7048
7049
7050
7051 <!-- end of kind -->
7052 </tbody>
7053 <tr><td colspan="7" class="kind">dynamic</td></tr>
7054
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7055 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7056 <tr>
7057 <th class="th_name">Property Name</th>
7058 <th class="th_type">Type</th>
7059 <th class="th_description">Description</th>
7060 <th class="th_units">Units</th>
7061 <th class="th_range">Range</th>
7062 <th class="th_notes">Notes</th>
7063 <th class="th_tags">Tags</th>
7064 </tr>
7065 </thead>
7066
7067 <tbody>
7068
7069
7070
7071
7072
7073
7074
7075
7076
7077
7078 <tr class="entry" id="dynamic_android.request.frameCount">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7079 <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]7080 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7081 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7082
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7083 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7084
7085
7086 </td> <!-- entry_type -->
7087
7088 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7089 <html><body><p>A frame counter set by the framework. This value monotonically
7090increases with every new result (that is, each new result has a unique
7091frameCount value).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7092 </td>
7093
7094 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7095 <html><body><p>count of frames<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7096 </td>
7097
7098 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7099 <html><body><p>&gt; 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7100 </td>
7101
7102 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7103 <html><body><p>Reset on release()<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7104 </td>
7105
7106 <td class="entry_tags">
7107 </td>
7108
7109 </tr> <!-- end of entry -->
7110
7111
7112 <tr class="entry" id="dynamic_android.request.id">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7113 <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]7114 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7115 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7116
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7117 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7118
7119
7120 </td> <!-- entry_type -->
7121
7122 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7123 <html><body><p>An application-specified ID for the current
7124request. Must be maintained unchanged in output
7125frame<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7126 </td>
7127
7128 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7129 <html><body><p>arbitrary integer assigned by application<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7130 </td>
7131
7132 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7133 <html><body><p>Any int<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7134 </td>
7135
7136 <td class="entry_notes">
7137 </td>
7138
7139 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7140 <ul class="entry_tags">
7141 <li><a href="#tag_V1">V1</a></li>
7142 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7143 </td>
7144
7145 </tr> <!-- end of entry -->
7146
7147
7148 <tr class="entry" id="dynamic_android.request.metadataMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7149 <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]7150 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7151 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7152
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7153 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7154
7155 <ul class="entry_type_enum">
7156 <li>
7157 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7158 <span class="entry_type_enum_notes"><html><body><p>No metadata should be produced on output, except
7159 for application-bound buffer data. If no
7160 application-bound streams exist, no frame should be
7161 placed in the output frame queue. If such streams
7162 exist, a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7163 with null metadata but with the necessary output buffer
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7164 information. Timestamp information should still be
7165 included with any output stream buffers<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7166 </li>
7167 <li>
7168 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7169 <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]7170 only be produced if they are separately
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7171 enabled<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7172 </li>
7173 </ul>
7174
7175 </td> <!-- entry_type -->
7176
7177 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7178 <html><body><p>How much metadata to produce on
7179output<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7180 </td>
7181
7182 <td class="entry_units">
7183 </td>
7184
7185 <td class="entry_range">
7186 </td>
7187
7188 <td class="entry_notes">
7189 </td>
7190
7191 <td class="entry_tags">
7192 </td>
7193
7194 </tr> <!-- end of entry -->
7195
7196
7197 <tr class="entry" id="dynamic_android.request.outputStreams">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7198 <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]7199 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7200 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7201 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7202
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7203 <span class="entry_type_array">
7204 n
7205 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7206 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7207
7208
7209 </td> <!-- entry_type -->
7210
7211 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7212 <html><body><p>Lists which camera output streams image data
7213from this capture must be sent to<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7214 </td>
7215
7216 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7217 <html><body><p>List of camera stream IDs<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7218 </td>
7219
7220 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7221 <html><body><p>List must only include streams that have been
7222 created<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7223 </td>
7224
7225 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7226 <html><body><p>If no output streams are listed, then the image
7227data should simply be discarded. The image data must
7228still be captured for metadata and statistics production,
7229and the lens and flash must operate as requested.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7230 </td>
7231
7232 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7233 <ul class="entry_tags">
7234 <li><a href="#tag_HAL2">HAL2</a></li>
7235 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7236 </td>
7237
7238 </tr> <!-- end of entry -->
7239
7240
7241
7242 <!-- end of kind -->
7243 </tbody>
7244
7245 <!-- end of section -->
7246 <tr><td colspan="7" id="section_scaler" class="section">scaler</td></tr>
7247
7248
7249 <tr><td colspan="7" class="kind">controls</td></tr>
7250
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7251 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7252 <tr>
7253 <th class="th_name">Property Name</th>
7254 <th class="th_type">Type</th>
7255 <th class="th_description">Description</th>
7256 <th class="th_units">Units</th>
7257 <th class="th_range">Range</th>
7258 <th class="th_notes">Notes</th>
7259 <th class="th_tags">Tags</th>
7260 </tr>
7261 </thead>
7262
7263 <tbody>
7264
7265
7266
7267
7268
7269
7270
7271
7272
7273
7274 <tr class="entry" id="controls_android.scaler.cropRegion">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7275 <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]7276 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7277 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7278 <span class="entry_type_container">x</span>
7279
7280 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7281 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7282 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7283 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7284
7285
7286 </td> <!-- entry_type -->
7287
7288 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7289 <html><body><p>(x, y, width, height).</p>
7290<p>A rectangle with the top-level corner of (x,y) and size
7291(width, height). The region of the sensor that is used for
7292output. Each stream must use this rectangle to produce its
7293output, cropping to a smaller region if necessary to
7294maintain the stream's aspect ratio.</p>
7295<p>HAL2.x uses only (x, y, width)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7296 </td>
7297
7298 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7299 <html><body><p>(x,y) of top-left corner, width and height of region
7300 in pixels; (0,0) is top-left corner of
7301 android.sensor.activeArraySize<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7302 </td>
7303
7304 <td class="entry_range">
7305 </td>
7306
7307 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7308 <html><body><p>Any additional per-stream cropping must be done to
7309maximize the final pixel area of the stream.</p>
7310<p>For example, if the crop region is set to a 4:3 aspect
7311ratio, then 4:3 streams should use the exact crop
7312region. 16:9 streams should further crop vertically
7313(letterbox).</p>
7314<p>Conversely, if the crop region is set to a 16:9, then 4:3
7315outputs should crop horizontally (pillarbox), and 16:9
7316streams should match exactly. These additional crops must
7317be centered within the crop region.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7318<p>The output streams must maintain square pixels at all
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7319times, no matter what the relative aspect ratios of the
7320crop region and the stream are. Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7321corner are allowed for raw output if full pixel array is
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7322larger than active pixel array. Width and height may be
7323rounded to nearest larger supportable width, especially
7324for raw output, where only a few fixed scales may be
7325possible. The width and height of the crop region cannot
7326be set to be smaller than floor( activeArraySize.width /
7327android.scaler.maxDigitalZoom ) and floor(
7328activeArraySize.height / android.scaler.maxDigitalZoom),
7329respectively.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7330 </td>
7331
7332 <td class="entry_tags">
7333 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7334 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7335 </ul>
7336 </td>
7337
7338 </tr> <!-- end of entry -->
7339
7340
7341
7342 <!-- end of kind -->
7343 </tbody>
7344 <tr><td colspan="7" class="kind">static</td></tr>
7345
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7346 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7347 <tr>
7348 <th class="th_name">Property Name</th>
7349 <th class="th_type">Type</th>
7350 <th class="th_description">Description</th>
7351 <th class="th_units">Units</th>
7352 <th class="th_range">Range</th>
7353 <th class="th_notes">Notes</th>
7354 <th class="th_tags">Tags</th>
7355 </tr>
7356 </thead>
7357
7358 <tbody>
7359
7360
7361
7362
7363
7364
7365
7366
7367
7368
7369 <tr class="entry" id="static_android.scaler.availableFormats">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7370 <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]7371 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7372 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7373 <span class="entry_type_container">x</span>
7374
7375 <span class="entry_type_array">
7376 n
7377 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]7378 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7379 <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]7380
7381 <ul class="entry_type_enum">
7382 <li>
7383 <span class="entry_type_enum_name">RAW_SENSOR</span>
7384 <span class="entry_type_enum_value">0x20</span>
7385 </li>
7386 <li>
7387 <span class="entry_type_enum_name">YV12</span>
7388 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7389 <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]7390 </li>
7391 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]7392 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7393 <span class="entry_type_enum_value">0x11</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7394 <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]7395 </li>
7396 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]7397 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
7398 <span class="entry_type_enum_value">0x22</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7399 <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]7400 </li>
7401 <li>
7402 <span class="entry_type_enum_name">YCbCr_420_888</span>
7403 <span class="entry_type_enum_value">0x23</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7404 <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]7405 </li>
7406 <li>
7407 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7408 <span class="entry_type_enum_value">0x21</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7409 <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]7410 </li>
7411 </ul>
7412
7413 </td> <!-- entry_type -->
7414
7415 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7416 <html><body><p>List of app-visible formats<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7417 </td>
7418
7419 <td class="entry_units">
7420 </td>
7421
7422 <td class="entry_range">
7423 </td>
7424
7425 <td class="entry_notes">
7426 </td>
7427
7428 <td class="entry_tags">
7429 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7430 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7431 </ul>
7432 </td>
7433
7434 </tr> <!-- end of entry -->
7435
7436
7437 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7438 <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]7439 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7440 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7441 <span class="entry_type_container">x</span>
7442
7443 <span class="entry_type_array">
7444 n
7445 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7446 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7447
7448
7449 </td> <!-- entry_type -->
7450
7451 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7452 <html><body><p>The minimum frame duration that is supported
7453for each resolution in availableJpegSizes. Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7454correspond to the frame duration when only that JPEG
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7455stream is active and captured in a burst, with all
7456processing set to FAST<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7457 </td>
7458
7459 <td class="entry_units">
7460 </td>
7461
7462 <td class="entry_range">
7463 </td>
7464
7465 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7466 <html><body><p>When multiple streams are configured, the minimum
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7467frame duration will be &gt;= max(individual stream min
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7468durations)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7469 </td>
7470
7471 <td class="entry_tags">
7472 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7473 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7474 </ul>
7475 </td>
7476
7477 </tr> <!-- end of entry -->
7478
7479
7480 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7481 <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]7482 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7483 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7484 <span class="entry_type_container">x</span>
7485
7486 <span class="entry_type_array">
7487 n x 2
7488 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7489 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7490
7491
7492 </td> <!-- entry_type -->
7493
7494 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7495 <html><body><p>The resolutions available for output from
7496the JPEG block. Listed as width x height<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7497 </td>
7498
7499 <td class="entry_units">
7500 </td>
7501
7502 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7503 <html><body><p>Must include: - sensor maximum resolution Should
7504 include: - half/quarter max resolution<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7505 </td>
7506
7507 <td class="entry_notes">
7508 </td>
7509
7510 <td class="entry_tags">
7511 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7512 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7513 </ul>
7514 </td>
7515
7516 </tr> <!-- end of entry -->
7517
7518
7519 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7520 <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]7521 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]7522 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7523
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7524 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7525
7526
7527 </td> <!-- entry_type -->
7528
7529 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7530 <html><body><p>The maximum ratio between active area width
7531and crop region width, or between active area height and
7532crop region height, if the crop region height is larger
7533than width<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7534 </td>
7535
7536 <td class="entry_units">
7537 </td>
7538
7539 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7540 <html><body><p>&gt;=1<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7541 </td>
7542
7543 <td class="entry_notes">
7544 </td>
7545
7546 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]7547 <ul class="entry_tags">
7548 <li><a href="#tag_BC">BC</a></li>
7549 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7550 </td>
7551
7552 </tr> <!-- end of entry -->
7553
7554
7555 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7556 <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]7557 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7558 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7559 <span class="entry_type_container">x</span>
7560
7561 <span class="entry_type_array">
7562 n
7563 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7564 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7565
7566
7567 </td> <!-- entry_type -->
7568
7569 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7570 <html><body><p>The minimum frame duration that is supported
7571for each resolution in availableProcessedSizes. Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7572correspond to the frame duration when only that processed
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7573stream is active, with all processing set to
7574FAST<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7575 </td>
7576
7577 <td class="entry_units">
7578 </td>
7579
7580 <td class="entry_range">
7581 </td>
7582
7583 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7584 <html><body><p>When multiple streams are configured, the minimum
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7585frame duration will be &gt;= max(individual stream min
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7586durations)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7587 </td>
7588
7589 <td class="entry_tags">
7590 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7591 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7592 </ul>
7593 </td>
7594
7595 </tr> <!-- end of entry -->
7596
7597
7598 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7599 <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]7600 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7601 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7602 <span class="entry_type_container">x</span>
7603
7604 <span class="entry_type_array">
7605 n x 2
7606 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7607 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7608
7609
7610 </td> <!-- entry_type -->
7611
7612 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7613 <html><body><p>The resolutions available for use with
7614processed output streams, such as YV12, NV12, and
7615platform opaque YUV/RGB streams to the GPU or video
7616encoders. Listed as width, height<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7617 </td>
7618
7619 <td class="entry_units">
7620 </td>
7621
7622 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7623 <html><body><p>Must include: - sensor maximum resolution -
7624 standard QCIF, 240p, 480p, 720p, and 1080p
7625 resolutions<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7626 </td>
7627
7628 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7629 <html><body><p>The actual supported resolution list may be limited by
7630consumer end points for different use cases. For example, for
7631recording use case, the largest supported resolution may be
7632limited by max supported size from encoder, for preview use
7633case, the largest supported resolution may be limited by max
7634resolution SurfaceTexture/SurfaceView can support.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7635 </td>
7636
7637 <td class="entry_tags">
7638 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7639 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7640 </ul>
7641 </td>
7642
7643 </tr> <!-- end of entry -->
7644
7645
7646 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7647 <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]7648 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7649 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7650 <span class="entry_type_container">x</span>
7651
7652 <span class="entry_type_array">
7653 n
7654 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7655 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7656
7657
7658 </td> <!-- entry_type -->
7659
7660 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7661 <html><body><p>The minimum frame duration that is supported
7662for each raw resolution in availableRawSizes. Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7663correspond to the frame duration when only the raw stream
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7664is active.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7665 </td>
7666
7667 <td class="entry_units">
7668 </td>
7669
7670 <td class="entry_range">
7671 </td>
7672
7673 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7674 <html><body><p>When multiple streams are configured, the minimum
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7675frame duration will be &gt;= max(individual stream min
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7676durations)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7677 </td>
7678
7679 <td class="entry_tags">
7680 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7681 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7682 </ul>
7683 </td>
7684
7685 </tr> <!-- end of entry -->
7686
7687
7688 <tr class="entry" id="static_android.scaler.availableRawSizes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7689 <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]7690 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7691 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7692 <span class="entry_type_container">x</span>
7693
7694 <span class="entry_type_array">
7695 n x 2
7696 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7697 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7698
7699
7700 </td> <!-- entry_type -->
7701
7702 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7703 <html><body><p>The resolutions available for use with raw
7704sensor output streams, listed as width,
7705height<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7706 </td>
7707
7708 <td class="entry_units">
7709 </td>
7710
7711 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7712 <html><body><p>Must include: - sensor maximum resolution<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7713 </td>
7714
7715 <td class="entry_notes">
7716 </td>
7717
7718 <td class="entry_tags">
7719 </td>
7720
7721 </tr> <!-- end of entry -->
7722
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7723
7724
7725 <!-- end of kind -->
7726 </tbody>
7727 <tr><td colspan="7" class="kind">dynamic</td></tr>
7728
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7729 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7730 <tr>
7731 <th class="th_name">Property Name</th>
7732 <th class="th_type">Type</th>
7733 <th class="th_description">Description</th>
7734 <th class="th_units">Units</th>
7735 <th class="th_range">Range</th>
7736 <th class="th_notes">Notes</th>
7737 <th class="th_tags">Tags</th>
7738 </tr>
7739 </thead>
7740
7741 <tbody>
7742
7743
7744
7745
7746
7747
7748
7749
7750
7751
7752 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7753 <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]7754 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7755 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7756 <span class="entry_type_container">x</span>
7757
7758 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7759 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7760 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]7761 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7762
7763
7764 </td> <!-- entry_type -->
7765
7766 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7767 <html><body><p>(x, y, width, height).</p>
7768<p>A rectangle with the top-level corner of (x,y) and size
7769(width, height). The region of the sensor that is used for
7770output. Each stream must use this rectangle to produce its
7771output, cropping to a smaller region if necessary to
7772maintain the stream's aspect ratio.</p>
7773<p>HAL2.x uses only (x, y, width)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7774 </td>
7775
7776 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7777 <html><body><p>(x,y) of top-left corner, width and height of region
7778 in pixels; (0,0) is top-left corner of
7779 android.sensor.activeArraySize<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7780 </td>
7781
7782 <td class="entry_range">
7783 </td>
7784
7785 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7786 <html><body><p>Any additional per-stream cropping must be done to
7787maximize the final pixel area of the stream.</p>
7788<p>For example, if the crop region is set to a 4:3 aspect
7789ratio, then 4:3 streams should use the exact crop
7790region. 16:9 streams should further crop vertically
7791(letterbox).</p>
7792<p>Conversely, if the crop region is set to a 16:9, then 4:3
7793outputs should crop horizontally (pillarbox), and 16:9
7794streams should match exactly. These additional crops must
7795be centered within the crop region.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7796<p>The output streams must maintain square pixels at all
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7797times, no matter what the relative aspect ratios of the
7798crop region and the stream are. Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7799corner are allowed for raw output if full pixel array is
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7800larger than active pixel array. Width and height may be
7801rounded to nearest larger supportable width, especially
7802for raw output, where only a few fixed scales may be
7803possible. The width and height of the crop region cannot
7804be set to be smaller than floor( activeArraySize.width /
7805android.scaler.maxDigitalZoom ) and floor(
7806activeArraySize.height / android.scaler.maxDigitalZoom),
7807respectively.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7808 </td>
7809
7810 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7811 <ul class="entry_tags">
7812 <li><a href="#tag_BC">BC</a></li>
7813 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7814 </td>
7815
7816 </tr> <!-- end of entry -->
7817
7818
7819
7820 <!-- end of kind -->
7821 </tbody>
7822
7823 <!-- end of section -->
7824 <tr><td colspan="7" id="section_sensor" class="section">sensor</td></tr>
7825
7826
7827 <tr><td colspan="7" class="kind">controls</td></tr>
7828
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7829 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7830 <tr>
7831 <th class="th_name">Property Name</th>
7832 <th class="th_type">Type</th>
7833 <th class="th_description">Description</th>
7834 <th class="th_units">Units</th>
7835 <th class="th_range">Range</th>
7836 <th class="th_notes">Notes</th>
7837 <th class="th_tags">Tags</th>
7838 </tr>
7839 </thead>
7840
7841 <tbody>
7842
7843
7844
7845
7846
7847
7848
7849
7850
7851
7852 <tr class="entry" id="controls_android.sensor.exposureTime">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7853 <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]7854 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7855 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7856
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7857 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7858
7859
7860 </td> <!-- entry_type -->
7861
7862 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7863 <html><body><p>Duration each pixel is exposed to
7864light.</p>
7865<p>If the sensor can't expose this exact duration, it should shorten the
7866duration 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]7867 </td>
7868
7869 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7870 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7871 </td>
7872
7873 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7874 <html><body><p>android.sensor.info.exposureTimeRange<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7875 </td>
7876
7877 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7878 <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]7879 </td>
7880
7881 <td class="entry_tags">
7882 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7883 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7884 </ul>
7885 </td>
7886
7887 </tr> <!-- end of entry -->
7888
7889
7890 <tr class="entry" id="controls_android.sensor.frameDuration">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7891 <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]7892 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7893 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7894
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7895 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7896
7897
7898 </td> <!-- entry_type -->
7899
7900 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7901 <html><body><p>Duration from start of frame exposure to
7902start of next frame exposure<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7903 </td>
7904
7905 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7906 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7907 </td>
7908
7909 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7910 <html><body><p>see android.sensor.info.maxFrameDuration,
7911 android.scaler.info.availableMinFrameDurations<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7912 </td>
7913
7914 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7915 <html><body><p>Exposure time has priority, so duration is set to
7916max(duration, exposure time + overhead)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7917 </td>
7918
7919 <td class="entry_tags">
7920 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7921 <li><a href="#tag_V1">V1</a></li>
7922 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7923 </ul>
7924 </td>
7925
7926 </tr> <!-- end of entry -->
7927
7928
7929 <tr class="entry" id="controls_android.sensor.sensitivity">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7930 <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]7931 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7932 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7933
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7934 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7935
7936
7937 </td> <!-- entry_type -->
7938
7939 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7940 <html><body><p>Gain applied to image data. Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7941implemented through analog gain only if set to values
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7942below 'maximum analog sensitivity'.</p>
7943<p>If the sensor can't apply this exact gain, it should lessen the
7944gain to the nearest possible value (rather than gain more).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7945 </td>
7946
7947 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7948 <html><body><p>ISO arithmetic units<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7949 </td>
7950
7951 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7952 <html><body><p>android.sensor.info.sensitivityRange<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7953 </td>
7954
7955 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7956 <html><body><p>ISO 12232:2006 REI method<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7957 </td>
7958
7959 <td class="entry_tags">
7960 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7961 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7962 </ul>
7963 </td>
7964
7965 </tr> <!-- end of entry -->
7966
7967
7968
7969 <!-- end of kind -->
7970 </tbody>
7971 <tr><td colspan="7" class="kind">static</td></tr>
7972
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7973 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7974 <tr>
7975 <th class="th_name">Property Name</th>
7976 <th class="th_type">Type</th>
7977 <th class="th_description">Description</th>
7978 <th class="th_units">Units</th>
7979 <th class="th_range">Range</th>
7980 <th class="th_notes">Notes</th>
7981 <th class="th_tags">Tags</th>
7982 </tr>
7983 </thead>
7984
7985 <tbody>
7986
7987
7988
7989
7990
7991
7992
7993
7994
7995
7996
7997
7998 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]7999 <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]8000 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8001 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8002 <span class="entry_type_container">x</span>
8003
8004 <span class="entry_type_array">
8005 4
8006 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8007 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8008 <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]8009
8010
8011 </td> <!-- entry_type -->
8012
8013 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8014 <html><body><p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8015active pixels; smaller or equal to
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8016pixelArraySize.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8017 </td>
8018
8019 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8020 <html><body><p>xmin, ymin, width, height. Top left of full
8021 pixel array is (0,0)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8022 </td>
8023
8024 <td class="entry_range">
8025 </td>
8026
8027 <td class="entry_notes">
8028 </td>
8029
8030 <td class="entry_tags">
8031 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8032 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8033 </ul>
8034 </td>
8035
8036 </tr> <!-- end of entry -->
8037
8038
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]8039 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8040 <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]8041 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8042 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8043 <span class="entry_type_container">x</span>
8044
8045 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]8046 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8047 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8048 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8049 <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]8050
8051
8052 </td> <!-- entry_type -->
8053
8054 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8055 <html><body><p>Range of valid sensitivities<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8056 </td>
8057
8058 <td class="entry_units">
8059 </td>
8060
8061 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8062 <html><body><p>Min = 1600<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8063 </td>
8064
8065 <td class="entry_notes">
8066 </td>
8067
8068 <td class="entry_tags">
8069 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8070 <li><a href="#tag_BC">BC</a></li>
8071 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8072 </ul>
8073 </td>
8074
8075 </tr> <!-- end of entry -->
8076
8077
8078 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8079 <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]8080 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8081 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8082
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8083 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8084
8085 <ul class="entry_type_enum">
8086 <li>
8087 <span class="entry_type_enum_name">RGGB</span>
8088 </li>
8089 <li>
8090 <span class="entry_type_enum_name">GRBG</span>
8091 </li>
8092 <li>
8093 <span class="entry_type_enum_name">GBRG</span>
8094 </li>
8095 <li>
8096 <span class="entry_type_enum_name">BGGR</span>
8097 </li>
8098 <li>
8099 <span class="entry_type_enum_name">RGB</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8100 <span class="entry_type_enum_notes"><html><body><p>Sensor is not Bayer; output has 3 16-bit
8101 values for each pixel, instead of just 1 16-bit value
8102 per pixel.<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8103 </li>
8104 </ul>
8105
8106 </td> <!-- entry_type -->
8107
8108 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8109 <html><body><p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8110represents the colors in the top-left 2x2 section of
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8111the sensor, in reading order<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8112 </td>
8113
8114 <td class="entry_units">
8115 </td>
8116
8117 <td class="entry_range">
8118 </td>
8119
8120 <td class="entry_notes">
8121 </td>
8122
8123 <td class="entry_tags">
8124 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8125 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8126 </ul>
8127 </td>
8128
8129 </tr> <!-- end of entry -->
8130
8131
8132 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8133 <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]8134 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8135 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8136 <span class="entry_type_container">x</span>
8137
8138 <span class="entry_type_array">
8139 2
8140 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8141 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8142 <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]8143
8144
8145 </td> <!-- entry_type -->
8146
8147 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8148 <html><body><p>Range of valid exposure
8149times<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8150 </td>
8151
8152 <td class="entry_units">
8153 </td>
8154
8155 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8156 <html><body><p>Min = 30e9 (30
8157 sec)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8158 </td>
8159
8160 <td class="entry_notes">
8161 </td>
8162
8163 <td class="entry_tags">
8164 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8165 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8166 </ul>
8167 </td>
8168
8169 </tr> <!-- end of entry -->
8170
8171
8172 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8173 <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]8174 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8175 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8176
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8177 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8178
8179
8180 </td> <!-- entry_type -->
8181
8182 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8183 <html><body><p>Maximum possible frame duration (minimum frame
8184rate)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8185 </td>
8186
8187 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8188 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8189 </td>
8190
8191 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8192 <html><body><p>&gt;= 30e9<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8193 </td>
8194
8195 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8196 <html><body><p>Minimum duration is a function of resolution,
8197processing settings. See
8198android.scaler.availableProcessedMinDurations
8199android.scaler.availableJpegMinDurations
8200android.scaler.availableRawMinDurations<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8201 </td>
8202
8203 <td class="entry_tags">
8204 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8205 <li><a href="#tag_BC">BC</a></li>
8206 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8207 </ul>
8208 </td>
8209
8210 </tr> <!-- end of entry -->
8211
8212
8213 <tr class="entry" id="static_android.sensor.info.physicalSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8214 <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]8215 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8216 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8217 <span class="entry_type_container">x</span>
8218
8219 <span class="entry_type_array">
8220 2
8221 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]8222 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8223 <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]8224
8225
8226 </td> <!-- entry_type -->
8227
8228 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8229 <html><body><p>The physical dimensions of the full pixel
8230array<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8231 </td>
8232
8233 <td class="entry_units">
8234 </td>
8235
8236 <td class="entry_range">
8237 </td>
8238
8239 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8240 <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]8241 </td>
8242
8243 <td class="entry_tags">
8244 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8245 <li><a href="#tag_V1">V1</a></li>
8246 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8247 </ul>
8248 </td>
8249
8250 </tr> <!-- end of entry -->
8251
8252
8253 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8254 <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]8255 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8256 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8257 <span class="entry_type_container">x</span>
8258
8259 <span class="entry_type_array">
8260 2
8261 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8262 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8263
8264
8265 </td> <!-- entry_type -->
8266
8267 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8268 <html><body><p>Dimensions of full pixel array, possibly
8269including black calibration pixels<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8270 </td>
8271
8272 <td class="entry_units">
8273 </td>
8274
8275 <td class="entry_range">
8276 </td>
8277
8278 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8279 <html><body><p>Maximum output resolution for raw format must
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8280match this in
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8281android.scaler.info.availableSizesPerFormat<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8282 </td>
8283
8284 <td class="entry_tags">
8285 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8286 <li><a href="#tag_DNG">DNG</a></li>
8287 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8288 </ul>
8289 </td>
8290
8291 </tr> <!-- end of entry -->
8292
8293
8294 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8295 <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]8296 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8297 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8298
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8299 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8300
8301
8302 </td> <!-- entry_type -->
8303
8304 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8305 <html><body><p>Maximum raw value output by
8306sensor<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8307 </td>
8308
8309 <td class="entry_units">
8310 </td>
8311
8312 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8313 <html><body><p>&gt; 1024 (10-bit output)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8314 </td>
8315
8316 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8317 <html><body><p>Defines sensor bit depth (10-14 bits is
8318expected)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8319 </td>
8320
8321 <td class="entry_tags">
8322 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8323 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8324 </ul>
8325 </td>
8326
8327 </tr> <!-- end of entry -->
8328
8329
8330
8331
8332
8333 <tr class="entry" id="static_android.sensor.baseGainFactor">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8334 <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]8335 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8336 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8337
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8338 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8339
8340
8341 </td> <!-- entry_type -->
8342
8343 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8344 <html><body><p>Gain factor from electrons to raw units when
8345ISO=100<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8346 </td>
8347
8348 <td class="entry_units">
8349 </td>
8350
8351 <td class="entry_range">
8352 </td>
8353
8354 <td class="entry_notes">
8355 </td>
8356
8357 <td class="entry_tags">
8358 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8359 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]8360 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8361 </ul>
8362 </td>
8363
8364 </tr> <!-- end of entry -->
8365
8366
8367 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8368 <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]8369 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8370 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8371 <span class="entry_type_container">x</span>
8372
8373 <span class="entry_type_array">
8374 4
8375 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8376 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8377 <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]8378
8379
8380 </td> <!-- entry_type -->
8381
8382 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8383 <html><body><p>A fixed black level offset for each of the
8384Bayer mosaic channels<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8385 </td>
8386
8387 <td class="entry_units">
8388 </td>
8389
8390 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8391 <html><body><p>&gt;= 0 each<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8392 </td>
8393
8394 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8395 <html><body><p>As per DNG BlackLevelRepeatDim / BlackLevel
8396tags<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8397 </td>
8398
8399 <td class="entry_tags">
8400 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8401 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8402 </ul>
8403 </td>
8404
8405 </tr> <!-- end of entry -->
8406
8407
8408 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8409 <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]8410 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8411 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8412 <span class="entry_type_container">x</span>
8413
8414 <span class="entry_type_array">
8415 9
8416 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8417 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8418 <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]8419
8420
8421 </td> <!-- entry_type -->
8422
8423 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8424 <html><body><p>Per-device calibration on top of color space
8425transform 1<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8426 </td>
8427
8428 <td class="entry_units">
8429 </td>
8430
8431 <td class="entry_range">
8432 </td>
8433
8434 <td class="entry_notes">
8435 </td>
8436
8437 <td class="entry_tags">
8438 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8439 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8440 </ul>
8441 </td>
8442
8443 </tr> <!-- end of entry -->
8444
8445
8446 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8447 <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]8448 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8449 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8450 <span class="entry_type_container">x</span>
8451
8452 <span class="entry_type_array">
8453 9
8454 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8455 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8456 <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]8457
8458
8459 </td> <!-- entry_type -->
8460
8461 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8462 <html><body><p>Per-device calibration on top of color space
8463transform 2<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8464 </td>
8465
8466 <td class="entry_units">
8467 </td>
8468
8469 <td class="entry_range">
8470 </td>
8471
8472 <td class="entry_notes">
8473 </td>
8474
8475 <td class="entry_tags">
8476 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8477 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8478 </ul>
8479 </td>
8480
8481 </tr> <!-- end of entry -->
8482
8483
8484 <tr class="entry" id="static_android.sensor.colorTransform1">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8485 <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]8486 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8487 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8488 <span class="entry_type_container">x</span>
8489
8490 <span class="entry_type_array">
8491 9
8492 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8493 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8494 <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]8495
8496
8497 </td> <!-- entry_type -->
8498
8499 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8500 <html><body><p>Linear mapping from XYZ (D50) color space to
8501reference linear sensor color, for first reference
8502illuminant<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8503 </td>
8504
8505 <td class="entry_units">
8506 </td>
8507
8508 <td class="entry_range">
8509 </td>
8510
8511 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8512 <html><body><p>Use as follows XYZ = inv(transform) * clip( (raw -
8513black level(raw) ) / ( white level - max black level) ).
8514At least in the simple case<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8515 </td>
8516
8517 <td class="entry_tags">
8518 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8519 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8520 </ul>
8521 </td>
8522
8523 </tr> <!-- end of entry -->
8524
8525
8526 <tr class="entry" id="static_android.sensor.colorTransform2">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8527 <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]8528 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8529 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8530 <span class="entry_type_container">x</span>
8531
8532 <span class="entry_type_array">
8533 9
8534 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8535 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8536 <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]8537
8538
8539 </td> <!-- entry_type -->
8540
8541 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8542 <html><body><p>Linear mapping from XYZ (D50) color space to
8543reference linear sensor color, for second reference
8544illuminant<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8545 </td>
8546
8547 <td class="entry_units">
8548 </td>
8549
8550 <td class="entry_range">
8551 </td>
8552
8553 <td class="entry_notes">
8554 </td>
8555
8556 <td class="entry_tags">
8557 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8558 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8559 </ul>
8560 </td>
8561
8562 </tr> <!-- end of entry -->
8563
8564
8565 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8566 <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]8567 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8568 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8569 <span class="entry_type_container">x</span>
8570
8571 <span class="entry_type_array">
8572 9
8573 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8574 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8575 <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]8576
8577
8578 </td> <!-- entry_type -->
8579
8580 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8581 <html><body><p>Used by DNG for better WB
8582adaptation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8583 </td>
8584
8585 <td class="entry_units">
8586 </td>
8587
8588 <td class="entry_range">
8589 </td>
8590
8591 <td class="entry_notes">
8592 </td>
8593
8594 <td class="entry_tags">
8595 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8596 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8597 </ul>
8598 </td>
8599
8600 </tr> <!-- end of entry -->
8601
8602
8603 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8604 <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]8605 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8606 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8607 <span class="entry_type_container">x</span>
8608
8609 <span class="entry_type_array">
8610 9
8611 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8612 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8613 <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]8614
8615
8616 </td> <!-- entry_type -->
8617
8618 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8619 <html><body><p>Used by DNG for better WB
8620adaptation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8621 </td>
8622
8623 <td class="entry_units">
8624 </td>
8625
8626 <td class="entry_range">
8627 </td>
8628
8629 <td class="entry_notes">
8630 </td>
8631
8632 <td class="entry_tags">
8633 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8634 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8635 </ul>
8636 </td>
8637
8638 </tr> <!-- end of entry -->
8639
8640
8641 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8642 <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]8643 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8644 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8645
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8646 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8647
8648
8649 </td> <!-- entry_type -->
8650
8651 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8652 <html><body><p>Maximum sensitivity that is implemented
8653purely through analog gain<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8654 </td>
8655
8656 <td class="entry_units">
8657 </td>
8658
8659 <td class="entry_range">
8660 </td>
8661
8662 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8663 <html><body><p>For android.sensor.sensitivity values less than or
8664equal to this, all applied gain must be analog. For
8665values above this, it can be a mix of analog and
8666digital<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8667 </td>
8668
8669 <td class="entry_tags">
8670 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8671 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]8672 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8673 </ul>
8674 </td>
8675
8676 </tr> <!-- end of entry -->
8677
8678
8679 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8680 <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]8681 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8682 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8683 <span class="entry_type_container">x</span>
8684
8685 <span class="entry_type_array">
8686 2
8687 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8688 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8689 <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]8690
8691
8692 </td> <!-- entry_type -->
8693
8694 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8695 <html><body><p>Estimation of sensor noise
8696characteristics<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8697 </td>
8698
8699 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8700 <html><body><p>var(raw pixel value) = electrons * (baseGainFactor
8701 * iso/100)^2 + A * (baseGainFactor * iso/100)^2 +
8702 B<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8703 </td>
8704
8705 <td class="entry_range">
8706 </td>
8707
8708 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8709 <html><body><p>A represents sensor read noise before analog
8710amplification; B represents noise from A/D conversion and
8711other circuits after amplification. Both noise sources
8712are assumed to be gaussian, independent, and not to vary
8713across the sensor<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8714 </td>
8715
8716 <td class="entry_tags">
8717 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8718 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8719 </ul>
8720 </td>
8721
8722 </tr> <!-- end of entry -->
8723
8724
8725 <tr class="entry" id="static_android.sensor.orientation">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8726 <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]8727 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8728 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8729
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8730 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8731
8732
8733 </td> <!-- entry_type -->
8734
8735 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8736 <html><body><p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8737image needs to be rotated to be upright on the device
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8738screen in its native orientation. Also defines the
8739direction of rolling shutter readout, which is from top
8740to bottom in the sensor's coordinate system<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8741 </td>
8742
8743 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8744 <html><body><p>degrees clockwise rotation, only multiples of
8745 90<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8746 </td>
8747
8748 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8749 <html><body><p>0,90,180,270<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8750 </td>
8751
8752 <td class="entry_notes">
8753 </td>
8754
8755 <td class="entry_tags">
8756 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8757 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8758 </ul>
8759 </td>
8760
8761 </tr> <!-- end of entry -->
8762
8763
8764 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8765 <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]8766 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8767 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8768
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8769 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8770
8771 <ul class="entry_type_enum">
8772 <li>
8773 <span class="entry_type_enum_name">DAYLIGHT</span>
8774 <span class="entry_type_enum_value">1</span>
8775 </li>
8776 <li>
8777 <span class="entry_type_enum_name">FLUORESCENT</span>
8778 <span class="entry_type_enum_value">2</span>
8779 </li>
8780 <li>
8781 <span class="entry_type_enum_name">TUNGSTEN</span>
8782 <span class="entry_type_enum_value">3</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8783 <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]8784 </li>
8785 <li>
8786 <span class="entry_type_enum_name">FLASH</span>
8787 <span class="entry_type_enum_value">4</span>
8788 </li>
8789 <li>
8790 <span class="entry_type_enum_name">FINE_WEATHER</span>
8791 <span class="entry_type_enum_value">9</span>
8792 </li>
8793 <li>
8794 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
8795 <span class="entry_type_enum_value">10</span>
8796 </li>
8797 <li>
8798 <span class="entry_type_enum_name">SHADE</span>
8799 <span class="entry_type_enum_value">11</span>
8800 </li>
8801 <li>
8802 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
8803 <span class="entry_type_enum_value">12</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8804 <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]8805 </li>
8806 <li>
8807 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
8808 <span class="entry_type_enum_value">13</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8809 <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]8810 </li>
8811 <li>
8812 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
8813 <span class="entry_type_enum_value">14</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8814 <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]8815 </li>
8816 <li>
8817 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
8818 <span class="entry_type_enum_value">15</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8819 <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]8820 </li>
8821 <li>
8822 <span class="entry_type_enum_name">STANDARD_A</span>
8823 <span class="entry_type_enum_value">17</span>
8824 </li>
8825 <li>
8826 <span class="entry_type_enum_name">STANDARD_B</span>
8827 <span class="entry_type_enum_value">18</span>
8828 </li>
8829 <li>
8830 <span class="entry_type_enum_name">STANDARD_C</span>
8831 <span class="entry_type_enum_value">19</span>
8832 </li>
8833 <li>
8834 <span class="entry_type_enum_name">D55</span>
8835 <span class="entry_type_enum_value">20</span>
8836 </li>
8837 <li>
8838 <span class="entry_type_enum_name">D65</span>
8839 <span class="entry_type_enum_value">21</span>
8840 </li>
8841 <li>
8842 <span class="entry_type_enum_name">D75</span>
8843 <span class="entry_type_enum_value">22</span>
8844 </li>
8845 <li>
8846 <span class="entry_type_enum_name">D50</span>
8847 <span class="entry_type_enum_value">23</span>
8848 </li>
8849 <li>
8850 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
8851 <span class="entry_type_enum_value">24</span>
8852 </li>
8853 </ul>
8854
8855 </td> <!-- entry_type -->
8856
8857 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8858 <html><body><p>Light source used to define transform
88591<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8860 </td>
8861
8862 <td class="entry_units">
8863 </td>
8864
8865 <td class="entry_range">
8866 </td>
8867
8868 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8869 <html><body><p>[EXIF LightSource tag] Must all these be
8870supported? Need CCT for each!<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8871 </td>
8872
8873 <td class="entry_tags">
8874 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8875 <li><a href="#tag_DNG">DNG</a></li>
8876 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8877 </ul>
8878 </td>
8879
8880 </tr> <!-- end of entry -->
8881
8882
8883 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8884 <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]8885 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8886 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8887
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8888 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8889
8890
8891 </td> <!-- entry_type -->
8892
8893 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8894 <html><body><p>Light source used to define transform
88952<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8896 </td>
8897
8898 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8899 <html><body><p>Same as illuminant 1<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8900 </td>
8901
8902 <td class="entry_range">
8903 </td>
8904
8905 <td class="entry_notes">
8906 </td>
8907
8908 <td class="entry_tags">
8909 </td>
8910
8911 </tr> <!-- end of entry -->
8912
8913
8914
8915 <!-- end of kind -->
8916 </tbody>
8917 <tr><td colspan="7" class="kind">dynamic</td></tr>
8918
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8919 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8920 <tr>
8921 <th class="th_name">Property Name</th>
8922 <th class="th_type">Type</th>
8923 <th class="th_description">Description</th>
8924 <th class="th_units">Units</th>
8925 <th class="th_range">Range</th>
8926 <th class="th_notes">Notes</th>
8927 <th class="th_tags">Tags</th>
8928 </tr>
8929 </thead>
8930
8931 <tbody>
8932
8933
8934
8935
8936
8937
8938
8939
8940
8941
8942 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8943 <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]8944 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8945 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8946
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8947 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8948
8949
8950 </td> <!-- entry_type -->
8951
8952 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8953 <html><body><p>Duration each pixel is exposed to
8954light.</p>
8955<p>If the sensor can't expose this exact duration, it should shorten the
8956duration 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]8957 </td>
8958
8959 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8960 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8961 </td>
8962
8963 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8964 <html><body><p>android.sensor.info.exposureTimeRange<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8965 </td>
8966
8967 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8968 <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]8969 </td>
8970
8971 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8972 <ul class="entry_tags">
8973 <li><a href="#tag_V1">V1</a></li>
8974 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8975 </td>
8976
8977 </tr> <!-- end of entry -->
8978
8979
8980 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8981 <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]8982 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8983 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8984
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8985 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8986
8987
8988 </td> <!-- entry_type -->
8989
8990 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8991 <html><body><p>Duration from start of frame exposure to
8992start of next frame exposure<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8993 </td>
8994
8995 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]8996 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8997 </td>
8998
8999 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9000 <html><body><p>see android.sensor.info.maxFrameDuration,
9001 android.scaler.info.availableMinFrameDurations<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9002 </td>
9003
9004 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9005 <html><body><p>Exposure time has priority, so duration is set to
9006max(duration, exposure time + overhead)<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9007 </td>
9008
9009 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9010 <ul class="entry_tags">
9011 <li><a href="#tag_V1">V1</a></li>
9012 <li><a href="#tag_BC">BC</a></li>
9013 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9014 </td>
9015
9016 </tr> <!-- end of entry -->
9017
9018
9019 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9020 <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]9021 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9022 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9023
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9024 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9025
9026
9027 </td> <!-- entry_type -->
9028
9029 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9030 <html><body><p>Gain applied to image data. Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9031implemented through analog gain only if set to values
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9032below 'maximum analog sensitivity'.</p>
9033<p>If the sensor can't apply this exact gain, it should lessen the
9034gain to the nearest possible value (rather than gain more).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9035 </td>
9036
9037 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9038 <html><body><p>ISO arithmetic units<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9039 </td>
9040
9041 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9042 <html><body><p>android.sensor.info.sensitivityRange<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9043 </td>
9044
9045 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9046 <html><body><p>ISO 12232:2006 REI method<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9047 </td>
9048
9049 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9050 <ul class="entry_tags">
9051 <li><a href="#tag_V1">V1</a></li>
9052 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9053 </td>
9054
9055 </tr> <!-- end of entry -->
9056
9057
9058 <tr class="entry" id="dynamic_android.sensor.timestamp">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9059 <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]9060 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9061 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9062
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9063 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9064
9065
9066 </td> <!-- entry_type -->
9067
9068 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9069 <html><body><p>Time at start of exposure of first
9070row<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9071 </td>
9072
9073 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9074 <html><body><p>nanoseconds<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9075 </td>
9076
9077 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9078 <html><body><p>&gt; 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9079 </td>
9080
9081 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9082 <html><body><p>Monotonic, should be synced to other timestamps in
9083system<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9084 </td>
9085
9086 <td class="entry_tags">
9087 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9088 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9089 </ul>
9090 </td>
9091
9092 </tr> <!-- end of entry -->
9093
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]9094
9095 <tr class="entry" id="dynamic_android.sensor.temperature">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9096 <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]9097 <td class="entry_type">
9098 <span class="entry_type_name">float</span>
9099
9100 <span class="entry_type_visibility"> [public]</span>
9101
9102
9103 </td> <!-- entry_type -->
9104
9105 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9106 <html><body><p>The temperature of the sensor, sampled at the time
9107exposure began for this frame.</p>
9108<p>The thermal diode being queried should be inside the sensor PCB, or
9109somewhere close to it.<wbr></wbr></p></body></html>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]9110 </td>
9111
9112 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9113 <html><body><p>celsius<wbr></wbr></p></body></html>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]9114 </td>
9115
9116 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9117 <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]9118 </td>
9119
9120 <td class="entry_notes">
9121 </td>
9122
9123 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9124 <ul class="entry_tags">
9125 <li><a href="#tag_FULL">FULL</a></li>
9126 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]9127 </td>
9128
9129 </tr> <!-- end of entry -->
9130
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9131
9132
9133 <!-- end of kind -->
9134 </tbody>
9135
9136 <!-- end of section -->
9137 <tr><td colspan="7" id="section_shading" class="section">shading</td></tr>
9138
9139
9140 <tr><td colspan="7" class="kind">controls</td></tr>
9141
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9142 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9143 <tr>
9144 <th class="th_name">Property Name</th>
9145 <th class="th_type">Type</th>
9146 <th class="th_description">Description</th>
9147 <th class="th_units">Units</th>
9148 <th class="th_range">Range</th>
9149 <th class="th_notes">Notes</th>
9150 <th class="th_tags">Tags</th>
9151 </tr>
9152 </thead>
9153
9154 <tbody>
9155
9156
9157
9158
9159
9160
9161
9162
9163
9164
9165 <tr class="entry" id="controls_android.shading.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9166 <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]9167 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9168 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9169
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9170 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9171
9172 <ul class="entry_type_enum">
9173 <li>
9174 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9175 <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]9176 </li>
9177 <li>
9178 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9179 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
9180 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9181 </li>
9182 <li>
9183 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9184 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
9185 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9186 </li>
9187 </ul>
9188
9189 </td> <!-- entry_type -->
9190
9191 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9192 <html><body><p>Quality of lens shading correction applied
9193to the image data<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9194 </td>
9195
9196 <td class="entry_units">
9197 </td>
9198
9199 <td class="entry_range">
9200 </td>
9201
9202 <td class="entry_notes">
9203 </td>
9204
9205 <td class="entry_tags">
9206 </td>
9207
9208 </tr> <!-- end of entry -->
9209
9210
9211 <tr class="entry" id="controls_android.shading.strength">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9212 <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]9213 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9214 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9215
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9216 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9217
9218
9219 </td> <!-- entry_type -->
9220
9221 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9222 <html><body><p>Control the amount of shading correction
9223applied to the images<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9224 </td>
9225
9226 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9227 <html><body><p>unitless: 1-10; 10 is full shading
9228 compensation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9229 </td>
9230
9231 <td class="entry_range">
9232 </td>
9233
9234 <td class="entry_notes">
9235 </td>
9236
9237 <td class="entry_tags">
9238 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9239 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9240 </ul>
9241 </td>
9242
9243 </tr> <!-- end of entry -->
9244
9245
9246
9247 <!-- end of kind -->
9248 </tbody>
9249 <tr><td colspan="7" class="kind">dynamic</td></tr>
9250
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9251 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9252 <tr>
9253 <th class="th_name">Property Name</th>
9254 <th class="th_type">Type</th>
9255 <th class="th_description">Description</th>
9256 <th class="th_units">Units</th>
9257 <th class="th_range">Range</th>
9258 <th class="th_notes">Notes</th>
9259 <th class="th_tags">Tags</th>
9260 </tr>
9261 </thead>
9262
9263 <tbody>
9264
9265
9266
9267
9268
9269
9270
9271
9272
9273
9274 <tr class="entry" id="dynamic_android.shading.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9275 <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]9276 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9277 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9278
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9279 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9280
9281 <ul class="entry_type_enum">
9282 <li>
9283 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9284 <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]9285 </li>
9286 <li>
9287 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9288 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
9289 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9290 </li>
9291 <li>
9292 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9293 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
9294 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9295 </li>
9296 </ul>
9297
9298 </td> <!-- entry_type -->
9299
9300 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9301 <html><body><p>Quality of lens shading correction applied
9302to the image data<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9303 </td>
9304
9305 <td class="entry_units">
9306 </td>
9307
9308 <td class="entry_range">
9309 </td>
9310
9311 <td class="entry_notes">
9312 </td>
9313
9314 <td class="entry_tags">
9315 </td>
9316
9317 </tr> <!-- end of entry -->
9318
9319
9320
9321 <!-- end of kind -->
9322 </tbody>
9323
9324 <!-- end of section -->
9325 <tr><td colspan="7" id="section_statistics" class="section">statistics</td></tr>
9326
9327
9328 <tr><td colspan="7" class="kind">controls</td></tr>
9329
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9330 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9331 <tr>
9332 <th class="th_name">Property Name</th>
9333 <th class="th_type">Type</th>
9334 <th class="th_description">Description</th>
9335 <th class="th_units">Units</th>
9336 <th class="th_range">Range</th>
9337 <th class="th_notes">Notes</th>
9338 <th class="th_tags">Tags</th>
9339 </tr>
9340 </thead>
9341
9342 <tbody>
9343
9344
9345
9346
9347
9348
9349
9350
9351
9352
9353 <tr class="entry" id="controls_android.statistics.faceDetectMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9354 <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]9355 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9356 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9357
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9358 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9359
9360 <ul class="entry_type_enum">
9361 <li>
9362 <span class="entry_type_enum_name">OFF</span>
9363 </li>
9364 <li>
9365 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9366 <span class="entry_type_enum_notes"><html><body><p>Optional Return rectangle and confidence
9367 only<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9368 </li>
9369 <li>
9370 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9371 <span class="entry_type_enum_notes"><html><body><p>Optional Return all face
9372 metadata<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9373 </li>
9374 </ul>
9375
9376 </td> <!-- entry_type -->
9377
9378 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9379 <html><body><p>State of the face detector
9380unit<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9381 </td>
9382
9383 <td class="entry_units">
9384 </td>
9385
9386 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9387 <html><body><p>android.statistics.info.availableFaceDetectModes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9388 </td>
9389
9390 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9391 <html><body><p>Whether face detection is enabled, and whether it
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9392should output just the basic fields or the full set of
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9393fields. Value must be one of the
9394android.statistics.info.availableFaceDetectModes.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9395 </td>
9396
9397 <td class="entry_tags">
9398 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9399 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9400 </ul>
9401 </td>
9402
9403 </tr> <!-- end of entry -->
9404
9405
9406 <tr class="entry" id="controls_android.statistics.histogramMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9407 <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]9408 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9409 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9410
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9411 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9412
9413 <ul class="entry_type_enum">
9414 <li>
9415 <span class="entry_type_enum_name">OFF</span>
9416 </li>
9417 <li>
9418 <span class="entry_type_enum_name">ON</span>
9419 </li>
9420 </ul>
9421
9422 </td> <!-- entry_type -->
9423
9424 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9425 <html><body><p>Operating mode for histogram
9426generation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9427 </td>
9428
9429 <td class="entry_units">
9430 </td>
9431
9432 <td class="entry_range">
9433 </td>
9434
9435 <td class="entry_notes">
9436 </td>
9437
9438 <td class="entry_tags">
9439 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9440 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9441 </ul>
9442 </td>
9443
9444 </tr> <!-- end of entry -->
9445
9446
9447 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9448 <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]9449 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9450 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9451
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9452 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9453
9454 <ul class="entry_type_enum">
9455 <li>
9456 <span class="entry_type_enum_name">OFF</span>
9457 </li>
9458 <li>
9459 <span class="entry_type_enum_name">ON</span>
9460 </li>
9461 </ul>
9462
9463 </td> <!-- entry_type -->
9464
9465 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9466 <html><body><p>Operating mode for sharpness map
9467generation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9468 </td>
9469
9470 <td class="entry_units">
9471 </td>
9472
9473 <td class="entry_range">
9474 </td>
9475
9476 <td class="entry_notes">
9477 </td>
9478
9479 <td class="entry_tags">
9480 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9481 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9482 </ul>
9483 </td>
9484
9485 </tr> <!-- end of entry -->
9486
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9487
9488 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9489 <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]9490 <td class="entry_type">
9491 <span class="entry_type_name entry_type_name_enum">byte</span>
9492
9493 <span class="entry_type_visibility"> [public]</span>
9494
9495 <ul class="entry_type_enum">
9496 <li>
9497 <span class="entry_type_enum_name">OFF</span>
9498 </li>
9499 <li>
9500 <span class="entry_type_enum_name">ON</span>
9501 </li>
9502 </ul>
9503
9504 </td> <!-- entry_type -->
9505
9506 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9507 <html><body><p>Whether the HAL needs to output the lens
9508shading map in output result metadata<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9509 </td>
9510
9511 <td class="entry_units">
9512 </td>
9513
9514 <td class="entry_range">
9515 </td>
9516
9517 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9518 <html><body><p>When set to ON,
9519android.statistics.lensShadingMap must be provided in
9520the output result metadata.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9521 </td>
9522
9523 <td class="entry_tags">
9524 </td>
9525
9526 </tr> <!-- end of entry -->
9527
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9528
9529
9530 <!-- end of kind -->
9531 </tbody>
9532 <tr><td colspan="7" class="kind">static</td></tr>
9533
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9534 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9535 <tr>
9536 <th class="th_name">Property Name</th>
9537 <th class="th_type">Type</th>
9538 <th class="th_description">Description</th>
9539 <th class="th_units">Units</th>
9540 <th class="th_range">Range</th>
9541 <th class="th_notes">Notes</th>
9542 <th class="th_tags">Tags</th>
9543 </tr>
9544 </thead>
9545
9546 <tbody>
9547
9548
9549
9550
9551
9552
9553
9554
9555
9556
9557
9558
9559 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9560 <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]9561 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9562 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9563 <span class="entry_type_container">x</span>
9564
9565 <span class="entry_type_array">
9566 n
9567 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9568 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9569 <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]9570
9571
9572 </td> <!-- entry_type -->
9573
9574 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9575 <html><body><p>Which face detection modes are available,
9576if any<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9577 </td>
9578
9579 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9580 <html><body><p>List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9581 OFF
9582 SIMPLE
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9583 FULL<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9584 </td>
9585
9586 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9587 </td>
9588
9589 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9590 <html><body><p>OFF means face detection is disabled, it must
9591be included in the list.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9592<p>SIMPLE means the device supports the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9593android.statistics.faceRectangles and
9594android.statistics.faceScores outputs.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9595<p>FULL means the device additionally supports the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9596android.statistics.faceIds and
9597android.statistics.faceLandmarks outputs.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9598 </td>
9599
9600 <td class="entry_tags">
9601 </td>
9602
9603 </tr> <!-- end of entry -->
9604
9605
9606 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9607 <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]9608 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9609 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9610
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9611 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9612
9613
9614 </td> <!-- entry_type -->
9615
9616 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9617 <html><body><p>Number of histogram buckets
9618supported<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9619 </td>
9620
9621 <td class="entry_units">
9622 </td>
9623
9624 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9625 <html><body><p>&gt;= 64<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9626 </td>
9627
9628 <td class="entry_notes">
9629 </td>
9630
9631 <td class="entry_tags">
9632 </td>
9633
9634 </tr> <!-- end of entry -->
9635
9636
9637 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9638 <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]9639 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9640 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9641
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9642 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9643
9644
9645 </td> <!-- entry_type -->
9646
9647 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9648 <html><body><p>Maximum number of simultaneously detectable
9649faces<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9650 </td>
9651
9652 <td class="entry_units">
9653 </td>
9654
9655 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9656 <html><body><p>&gt;= 4 if availableFaceDetectionModes lists
9657 modes besides OFF, otherwise 0<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9658 </td>
9659
9660 <td class="entry_notes">
9661 </td>
9662
9663 <td class="entry_tags">
9664 </td>
9665
9666 </tr> <!-- end of entry -->
9667
9668
9669 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9670 <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]9671 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9672 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9673
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9674 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9675
9676
9677 </td> <!-- entry_type -->
9678
9679 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9680 <html><body><p>Maximum value possible for a histogram
9681bucket<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9682 </td>
9683
9684 <td class="entry_units">
9685 </td>
9686
9687 <td class="entry_range">
9688 </td>
9689
9690 <td class="entry_notes">
9691 </td>
9692
9693 <td class="entry_tags">
9694 </td>
9695
9696 </tr> <!-- end of entry -->
9697
9698
9699 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9700 <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]9701 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9702 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9703
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9704 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9705
9706
9707 </td> <!-- entry_type -->
9708
9709 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9710 <html><body><p>Maximum value possible for a sharpness map
9711region.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9712 </td>
9713
9714 <td class="entry_units">
9715 </td>
9716
9717 <td class="entry_range">
9718 </td>
9719
9720 <td class="entry_notes">
9721 </td>
9722
9723 <td class="entry_tags">
9724 </td>
9725
9726 </tr> <!-- end of entry -->
9727
9728
9729 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9730 <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]9731 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9732 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9733 <span class="entry_type_container">x</span>
9734
9735 <span class="entry_type_array">
9736 2
9737 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9738 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9739 <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]9740
9741
9742 </td> <!-- entry_type -->
9743
9744 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9745 <html><body><p>Dimensions of the sharpness
9746map<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9747 </td>
9748
9749 <td class="entry_units">
9750 </td>
9751
9752 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9753 <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]9754 </td>
9755
9756 <td class="entry_notes">
9757 </td>
9758
9759 <td class="entry_tags">
9760 </td>
9761
9762 </tr> <!-- end of entry -->
9763
9764
9765
9766
9767
9768
9769 <!-- end of kind -->
9770 </tbody>
9771 <tr><td colspan="7" class="kind">dynamic</td></tr>
9772
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9773 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9774 <tr>
9775 <th class="th_name">Property Name</th>
9776 <th class="th_type">Type</th>
9777 <th class="th_description">Description</th>
9778 <th class="th_units">Units</th>
9779 <th class="th_range">Range</th>
9780 <th class="th_notes">Notes</th>
9781 <th class="th_tags">Tags</th>
9782 </tr>
9783 </thead>
9784
9785 <tbody>
9786
9787
9788
9789
9790
9791
9792
9793
9794
9795
9796 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9797 <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]9798 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9799 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9800
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9801 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9802
9803 <ul class="entry_type_enum">
9804 <li>
9805 <span class="entry_type_enum_name">OFF</span>
9806 </li>
9807 <li>
9808 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9809 <span class="entry_type_enum_notes"><html><body><p>Optional Return rectangle and confidence
9810 only<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9811 </li>
9812 <li>
9813 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9814 <span class="entry_type_enum_notes"><html><body><p>Optional Return all face
9815 metadata<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9816 </li>
9817 </ul>
9818
9819 </td> <!-- entry_type -->
9820
9821 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9822 <html><body><p>State of the face detector
9823unit<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9824 </td>
9825
9826 <td class="entry_units">
9827 </td>
9828
9829 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9830 <html><body><p>android.statistics.info.availableFaceDetectModes<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9831 </td>
9832
9833 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9834 <html><body><p>Whether face detection is enabled, and whether it
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9835should output just the basic fields or the full set of
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9836fields. Value must be one of the
9837android.statistics.info.availableFaceDetectModes.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9838 </td>
9839
9840 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9841 <ul class="entry_tags">
9842 <li><a href="#tag_BC">BC</a></li>
9843 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9844 </td>
9845
9846 </tr> <!-- end of entry -->
9847
9848
9849 <tr class="entry" id="dynamic_android.statistics.faceIds">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9850 <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]9851 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9852 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9853 <span class="entry_type_container">x</span>
9854
9855 <span class="entry_type_array">
9856 n
9857 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]9858 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9859
9860
9861 </td> <!-- entry_type -->
9862
9863 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9864 <html><body><p>List of unique IDs for detected
9865faces<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9866 </td>
9867
9868 <td class="entry_units">
9869 </td>
9870
9871 <td class="entry_range">
9872 </td>
9873
9874 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9875 <html><body><p>Only available if faceDetectMode == FULL<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9876 </td>
9877
9878 <td class="entry_tags">
9879 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9880 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9881 </ul>
9882 </td>
9883
9884 </tr> <!-- end of entry -->
9885
9886
9887 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9888 <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]9889 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9890 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9891 <span class="entry_type_container">x</span>
9892
9893 <span class="entry_type_array">
9894 n x 6
9895 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]9896 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9897 <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]9898
9899
9900 </td> <!-- entry_type -->
9901
9902 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9903 <html><body><p>List of landmarks for detected
9904faces<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9905 </td>
9906
9907 <td class="entry_units">
9908 </td>
9909
9910 <td class="entry_range">
9911 </td>
9912
9913 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9914 <html><body><p>Only available if faceDetectMode == FULL<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9915 </td>
9916
9917 <td class="entry_tags">
9918 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9919 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9920 </ul>
9921 </td>
9922
9923 </tr> <!-- end of entry -->
9924
9925
9926 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9927 <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]9928 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9929 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9930 <span class="entry_type_container">x</span>
9931
9932 <span class="entry_type_array">
9933 n x 4
9934 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]9935 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9936 <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]9937
9938
9939 </td> <!-- entry_type -->
9940
9941 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9942 <html><body><p>List of the bounding rectangles for detected
9943faces<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9944 </td>
9945
9946 <td class="entry_units">
9947 </td>
9948
9949 <td class="entry_range">
9950 </td>
9951
9952 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9953 <html><body><p>Only available if faceDetectMode != OFF<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9954 </td>
9955
9956 <td class="entry_tags">
9957 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9958 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9959 </ul>
9960 </td>
9961
9962 </tr> <!-- end of entry -->
9963
9964
9965 <tr class="entry" id="dynamic_android.statistics.faceScores">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9966 <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]9967 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9968 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9969 <span class="entry_type_container">x</span>
9970
9971 <span class="entry_type_array">
9972 n
9973 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]9974 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9975
9976
9977 </td> <!-- entry_type -->
9978
9979 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9980 <html><body><p>List of the face confidence scores for
9981detected faces<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9982 </td>
9983
9984 <td class="entry_units">
9985 </td>
9986
9987 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9988 <html><body><p>1-100<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9989 </td>
9990
9991 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]9992 <html><body><p>Only available if faceDetectMode != OFF. The value should be
9993meaningful (for example, setting 100 at all times is illegal).<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9994 </td>
9995
9996 <td class="entry_tags">
9997 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9998 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9999 </ul>
10000 </td>
10001
10002 </tr> <!-- end of entry -->
10003
10004
10005 <tr class="entry" id="dynamic_android.statistics.histogram">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10006 <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]10007 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10008 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10009 <span class="entry_type_container">x</span>
10010
10011 <span class="entry_type_array">
10012 n x 3
10013 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10014 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10015 <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]10016
10017
10018 </td> <!-- entry_type -->
10019
10020 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10021 <html><body><p>A 3-channel histogram based on the raw
10022sensor data<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10023 </td>
10024
10025 <td class="entry_units">
10026 </td>
10027
10028 <td class="entry_range">
10029 </td>
10030
10031 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10032 <html><body><p>The k'th bucket (0-based) covers the input range
10033(with w = android.sensor.info.whiteLevel) of [ k * w/N,
10034(k + 1) * w / N ). If only a monochrome sharpness map is
10035supported, all channels should have the same data<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10036 </td>
10037
10038 <td class="entry_tags">
10039 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10040 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10041 </ul>
10042 </td>
10043
10044 </tr> <!-- end of entry -->
10045
10046
10047 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10048 <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]10049 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10050 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10051
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10052 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10053
10054 <ul class="entry_type_enum">
10055 <li>
10056 <span class="entry_type_enum_name">OFF</span>
10057 </li>
10058 <li>
10059 <span class="entry_type_enum_name">ON</span>
10060 </li>
10061 </ul>
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>Operating mode for histogram
10067generation<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">
10077 </td>
10078
10079 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10080 <ul class="entry_tags">
10081 <li><a href="#tag_V1">V1</a></li>
10082 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10083 </td>
10084
10085 </tr> <!-- end of entry -->
10086
10087
10088 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10089 <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]10090 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10091 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10092 <span class="entry_type_container">x</span>
10093
10094 <span class="entry_type_array">
10095 n x m x 3
10096 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10097 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10098 <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]10099
10100
10101 </td> <!-- entry_type -->
10102
10103 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10104 <html><body><p>A 3-channel sharpness map, based on the raw
10105sensor data<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10106 </td>
10107
10108 <td class="entry_units">
10109 </td>
10110
10111 <td class="entry_range">
10112 </td>
10113
10114 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10115 <html><body><p>If only a monochrome sharpness map is supported,
10116all channels should have the same data<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10117 </td>
10118
10119 <td class="entry_tags">
10120 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10121 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10122 </ul>
10123 </td>
10124
10125 </tr> <!-- end of entry -->
10126
10127
10128 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10129 <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]10130 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10131 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10132
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10133 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10134
10135 <ul class="entry_type_enum">
10136 <li>
10137 <span class="entry_type_enum_name">OFF</span>
10138 </li>
10139 <li>
10140 <span class="entry_type_enum_name">ON</span>
10141 </li>
10142 </ul>
10143
10144 </td> <!-- entry_type -->
10145
10146 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10147 <html><body><p>Operating mode for sharpness map
10148generation<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10149 </td>
10150
10151 <td class="entry_units">
10152 </td>
10153
10154 <td class="entry_range">
10155 </td>
10156
10157 <td class="entry_notes">
10158 </td>
10159
10160 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10161 <ul class="entry_tags">
10162 <li><a href="#tag_V1">V1</a></li>
10163 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10164 </td>
10165
10166 </tr> <!-- end of entry -->
10167
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10168
10169 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10170 <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]10171 <td class="entry_type">
10172 <span class="entry_type_name">float</span>
10173 <span class="entry_type_container">x</span>
10174
10175 <span class="entry_type_array">
10176 4 x n x m
10177 </span>
10178 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10179 <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]10180
10181
10182 </td> <!-- entry_type -->
10183
10184 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10185 <html><body><p>The shading map is a low-resolution floating-point map
10186that lists the coefficients used to correct for vignetting, for each
10187Bayer color channel.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10188 </td>
10189
10190 <td class="entry_units">
10191 </td>
10192
10193 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10194 <html><body><p>Each gain factor is &gt;= 1<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10195 </td>
10196
10197 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10198 <html><body><p>The least shaded section of the image should have a gain factor
10199of 1; all other sections should have gains above 1.</p>
10200<p>When android.colorCorrection.mode = TRANSFORM_MATRIX, the map
10201must take into account the colorCorrection settings.</p>
10202<p>The shading map is for the entire active pixel array, and is not
10203affected by the crop region specified in the request. Each shading map
10204entry is the value of the shading compensation map over a specific
10205pixel on the sensor. Specifically, with a (N x M) resolution shading
10206map, and an active pixel array size (W x H), shading map entry
10207(x,y) ϵ (0 ... N-1, 0 ... M-1) is the value of the shading map at
10208pixel ( ((W-1)/(N-1)) * x, ((H-1)/(M-1)) * y) for the four color channels.
10209The map is assumed to be bilinearly interpolated between the sample points.</p>
10210<p>The channel order is [R, Geven, Godd, B], where Geven is the green
10211channel for the even rows of a Bayer pattern, and Godd is the odd rows.
10212The shading map is stored in a fully interleaved format, and its size
10213is provided in the camera static metadata by android.lens.info.shadingMapSize.</p>
10214<p>The shading map should have on the order of 30-40 rows and columns,
10215and must be smaller than 64x64.</p>
10216<p>As an example, given a very small map defined as:</p>
10217<pre><code>android.lens.info.shadingMapSize = [ 4, 3 ]
10218android.statistics.lensShadingMap =
10219[ 1.3, 1.2, 1.15, 1.2, 1.2, 1.2, 1.15, 1.2,
10220 1.1, 1.2, 1.2, 1.2, 1.3, 1.2, 1.3, 1.3,
10221 1.2, 1.2, 1.25, 1.1, 1.1, 1.1, 1.1, 1.0,
10222 1.0, 1.0, 1.0, 1.0, 1.2, 1.3, 1.25, 1.2,
10223 1.3, 1.2, 1.2, 1.3, 1.2, 1.15, 1.1, 1.2,
10224 1.2, 1.1, 1.0, 1.2, 1.3, 1.15, 1.2, 1.3 ]
10225</code></pre>
10226<p>The low-resolution scaling map images for each channel are
10227(displayed using nearest-neighbor interpolation):</p>
10228<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
10229<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
10230<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
10231<img alt="Blue lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/blue_shading.png"/></p>
10232<p>As a visualization only, inverting the full-color map to recover an
10233image of a gray wall (using bicubic interpolation for visual quality) as captured by the sensor gives:</p>
10234<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]10235 </td>
10236
10237 <td class="entry_tags">
10238 </td>
10239
10240 </tr> <!-- end of entry -->
10241
10242
10243 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10244 <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]10245 <td class="entry_type">
10246 <span class="entry_type_name">float</span>
10247 <span class="entry_type_container">x</span>
10248
10249 <span class="entry_type_array">
10250 4
10251 </span>
10252 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10253 <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]10254
10255
10256 </td> <!-- entry_type -->
10257
10258 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10259 <html><body><p>The best-fit color channel gains calculated
10260by 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]10261 </td>
10262
10263 <td class="entry_units">
10264 </td>
10265
10266 <td class="entry_range">
10267 </td>
10268
10269 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10270 <html><body><p>This may be different than the gains used for this frame,
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10271since statistics processing on data from a new frame
10272typically completes after the transform has already been
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10273applied to that frame.</p>
10274<p>The 4 channel gains are defined in Bayer domain,
10275see android.colorCorrection.gains for details.</p>
10276<p>This value should always be calculated by the AWB block,
10277regardless of the android.control.* current values.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10278 </td>
10279
10280 <td class="entry_tags">
10281 </td>
10282
10283 </tr> <!-- end of entry -->
10284
10285
10286 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10287 <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]10288 <td class="entry_type">
10289 <span class="entry_type_name">rational</span>
10290 <span class="entry_type_container">x</span>
10291
10292 <span class="entry_type_array">
10293 3 x 3
10294 </span>
10295 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10296 <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]10297
10298
10299 </td> <!-- entry_type -->
10300
10301 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10302 <html><body><p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10303calculated by the HAL's statistics units for the current
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10304output frame<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10305 </td>
10306
10307 <td class="entry_units">
10308 </td>
10309
10310 <td class="entry_range">
10311 </td>
10312
10313 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10314 <html><body><p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10315statistics unit on the white balance transforms to use
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10316for the next frame. These are the values the HAL believes
10317are the best fit for the current output frame. This may
10318be different than the transform used for this frame, since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10319statistics processing on data from a new frame typically
10320completes after the transform has already been applied to
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10321that frame.</p>
10322<p>These estimates must be provided for all frames, even if
10323capture settings and color transforms are set by the application.</p>
10324<p>This value should always be calculated by the AWB block,
10325regardless of the android.control.* current values.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10326 </td>
10327
10328 <td class="entry_tags">
10329 </td>
10330
10331 </tr> <!-- end of entry -->
10332
10333
10334 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10335 <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]10336 <td class="entry_type">
10337 <span class="entry_type_name entry_type_name_enum">byte</span>
10338
10339 <span class="entry_type_visibility"> [public]</span>
10340
10341 <ul class="entry_type_enum">
10342 <li>
10343 <span class="entry_type_enum_name">NONE</span>
10344 </li>
10345 <li>
10346 <span class="entry_type_enum_name">50HZ</span>
10347 </li>
10348 <li>
10349 <span class="entry_type_enum_name">60HZ</span>
10350 </li>
10351 </ul>
10352
10353 </td> <!-- entry_type -->
10354
10355 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10356 <html><body><p>The HAL estimated scene illumination lighting
10357frequency<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10358 </td>
10359
10360 <td class="entry_units">
10361 </td>
10362
10363 <td class="entry_range">
10364 </td>
10365
10366 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10367 <html><body><p>Report NONE if there doesn't appear to be flickering
10368illumination<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10369 </td>
10370
10371 <td class="entry_tags">
10372 </td>
10373
10374 </tr> <!-- end of entry -->
10375
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10376
10377
10378 <!-- end of kind -->
10379 </tbody>
10380
10381 <!-- end of section -->
10382 <tr><td colspan="7" id="section_tonemap" class="section">tonemap</td></tr>
10383
10384
10385 <tr><td colspan="7" class="kind">controls</td></tr>
10386
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10387 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10388 <tr>
10389 <th class="th_name">Property Name</th>
10390 <th class="th_type">Type</th>
10391 <th class="th_description">Description</th>
10392 <th class="th_units">Units</th>
10393 <th class="th_range">Range</th>
10394 <th class="th_notes">Notes</th>
10395 <th class="th_tags">Tags</th>
10396 </tr>
10397 </thead>
10398
10399 <tbody>
10400
10401
10402
10403
10404
10405
10406
10407
10408
10409
10410 <tr class="entry" id="controls_android.tonemap.curveBlue">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10411 <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]10412 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]10413 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10414 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10415
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10416 <span class="entry_type_array">
10417 n x 2
10418 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10419 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10420 <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]10421
10422
10423 </td> <!-- entry_type -->
10424
10425 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10426 <html><body><p>Table mapping blue input values to output
10427values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10428 </td>
10429
10430 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10431 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10432 </td>
10433
10434 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10435 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10436 </td>
10437
10438 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10439 <html><body><p>Tonemapping / contrast / gamma curve for the blue
10440channel, to use when android.tonemap.mode is CONTRAST_CURVE.</p>
10441<p>See android.tonemap.curveRed for more details.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10442 </td>
10443
10444 <td class="entry_tags">
10445 </td>
10446
10447 </tr> <!-- end of entry -->
10448
10449
10450 <tr class="entry" id="controls_android.tonemap.curveGreen">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10451 <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]10452 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]10453 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10454 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10455
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10456 <span class="entry_type_array">
10457 n x 2
10458 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10459 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10460 <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]10461
10462
10463 </td> <!-- entry_type -->
10464
10465 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10466 <html><body><p>Table mapping green input values to output
10467values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10468 </td>
10469
10470 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10471 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10472 </td>
10473
10474 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10475 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10476 </td>
10477
10478 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10479 <html><body><p>Tonemapping / contrast / gamma curve for the green
10480channel, to use when android.tonemap.mode is CONTRAST_CURVE.</p>
10481<p>See android.tonemap.curveRed for more details.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10482 </td>
10483
10484 <td class="entry_tags">
10485 </td>
10486
10487 </tr> <!-- end of entry -->
10488
10489
10490 <tr class="entry" id="controls_android.tonemap.curveRed">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10491 <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]10492 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10493 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10494 <span class="entry_type_container">x</span>
10495
10496 <span class="entry_type_array">
10497 n x 2
10498 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10499 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10500 <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]10501
10502
10503 </td> <!-- entry_type -->
10504
10505 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10506 <html><body><p>Table mapping red input values to output
10507values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10508 </td>
10509
10510 <td class="entry_units">
10511 </td>
10512
10513 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10514 <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]10515 </td>
10516
10517 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10518 <html><body><p>Tonemapping / contrast / gamma curve for the red
10519channel, to use when android.tonemap.mode is CONTRAST_CURVE.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10520<p>Since the input and output ranges may vary depending on
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10521the camera pipeline, the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10522are represented by normalized floating-point values
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10523between 0 and 1, with 0 == black and 1 == white.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10524<p>The curve should be linearly interpolated between the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10525defined points. The points will be listed in increasing
10526order of P_IN. For example, if the array is: [0.0, 0.0,
105270.3, 0.5, 1.0, 1.0], then the input-&gt;output mapping
10528for a few sample points would be: 0 -&gt; 0, 0.15 -&gt;
105290.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]10530 </td>
10531
10532 <td class="entry_tags">
10533 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10534 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10535 </ul>
10536 </td>
10537
10538 </tr> <!-- end of entry -->
10539
10540
10541 <tr class="entry" id="controls_android.tonemap.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10542 <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]10543 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10544 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10545
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10546 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10547
10548 <ul class="entry_type_enum">
10549 <li>
10550 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10551 <span class="entry_type_enum_notes"><html><body><p>Use the tone mapping curve specified in
10552 android.tonemap.curve<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10553 </li>
10554 <li>
10555 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10556 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
10557 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10558 </li>
10559 <li>
10560 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10561 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
10562 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10563 </li>
10564 </ul>
10565
10566 </td> <!-- entry_type -->
10567
10568 <td class="entry_description">
10569 </td>
10570
10571 <td class="entry_units">
10572 </td>
10573
10574 <td class="entry_range">
10575 </td>
10576
10577 <td class="entry_notes">
10578 </td>
10579
10580 <td class="entry_tags">
10581 </td>
10582
10583 </tr> <!-- end of entry -->
10584
10585
10586
10587 <!-- end of kind -->
10588 </tbody>
10589 <tr><td colspan="7" class="kind">static</td></tr>
10590
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10591 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10592 <tr>
10593 <th class="th_name">Property Name</th>
10594 <th class="th_type">Type</th>
10595 <th class="th_description">Description</th>
10596 <th class="th_units">Units</th>
10597 <th class="th_range">Range</th>
10598 <th class="th_notes">Notes</th>
10599 <th class="th_tags">Tags</th>
10600 </tr>
10601 </thead>
10602
10603 <tbody>
10604
10605
10606
10607
10608
10609
10610
10611
10612
10613
10614 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10615 <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]10616 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10617 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10618
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10619 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10620
10621
10622 </td> <!-- entry_type -->
10623
10624 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10625 <html><body><p>Maximum number of supported points in the
10626tonemap curve<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10627 </td>
10628
10629 <td class="entry_units">
10630 </td>
10631
10632 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10633 <html><body><p>&gt;= 128<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10634 </td>
10635
10636 <td class="entry_notes">
10637 </td>
10638
10639 <td class="entry_tags">
10640 </td>
10641
10642 </tr> <!-- end of entry -->
10643
10644
10645
10646 <!-- end of kind -->
10647 </tbody>
10648 <tr><td colspan="7" class="kind">dynamic</td></tr>
10649
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10650 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10651 <tr>
10652 <th class="th_name">Property Name</th>
10653 <th class="th_type">Type</th>
10654 <th class="th_description">Description</th>
10655 <th class="th_units">Units</th>
10656 <th class="th_range">Range</th>
10657 <th class="th_notes">Notes</th>
10658 <th class="th_tags">Tags</th>
10659 </tr>
10660 </thead>
10661
10662 <tbody>
10663
10664
10665
10666
10667
10668
10669
10670
10671
10672
10673 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10674 <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]10675 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]10676 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10677 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10678
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10679 <span class="entry_type_array">
10680 n x 2
10681 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10682 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10683 <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]10684
10685
10686 </td> <!-- entry_type -->
10687
10688 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10689 <html><body><p>Table mapping blue input values to output
10690values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10691 </td>
10692
10693 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10694 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10695 </td>
10696
10697 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10698 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10699 </td>
10700
10701 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10702 <html><body><p>Tonemapping / contrast / gamma curve for the blue
10703channel, to use when android.tonemap.mode is CONTRAST_CURVE.</p>
10704<p>See android.tonemap.curveRed for more details.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10705 </td>
10706
10707 <td class="entry_tags">
10708 </td>
10709
10710 </tr> <!-- end of entry -->
10711
10712
10713 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10714 <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]10715 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]10716 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10717 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10718
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]10719 <span class="entry_type_array">
10720 n x 2
10721 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10722 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10723 <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]10724
10725
10726 </td> <!-- entry_type -->
10727
10728 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10729 <html><body><p>Table mapping green input values to output
10730values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10731 </td>
10732
10733 <td class="entry_units">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10734 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10735 </td>
10736
10737 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10738 <html><body><p>same as android.tonemap.curveRed<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10739 </td>
10740
10741 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10742 <html><body><p>Tonemapping / contrast / gamma curve for the green
10743channel, to use when android.tonemap.mode is CONTRAST_CURVE.</p>
10744<p>See android.tonemap.curveRed for more details.<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10745 </td>
10746
10747 <td class="entry_tags">
10748 </td>
10749
10750 </tr> <!-- end of entry -->
10751
10752
10753 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10754 <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]10755 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10756 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10757 <span class="entry_type_container">x</span>
10758
10759 <span class="entry_type_array">
10760 n x 2
10761 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10762 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10763 <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]10764
10765
10766 </td> <!-- entry_type -->
10767
10768 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10769 <html><body><p>Table mapping red input values to output
10770values<wbr></wbr></p></body></html>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10771 </td>
10772
10773 <td class="entry_units">
10774 </td>
10775
10776 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10777 <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]10778 </td>
10779
10780 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10781 <html><body><p>Tonemapping / contrast / gamma curve for the red
10782channel, to use when android.tonemap.mode is CONTRAST_CURVE.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10783<p>Since the input and output ranges may vary depending on
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10784the camera pipeline, the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10785are represented by normalized floating-point values
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10786between 0 and 1, with 0 == black and 1 == white.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10787<p>The curve should be linearly interpolated between the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10788defined points. The points will be listed in increasing
10789order of P_IN. For example, if the array is: [0.0, 0.0,
107900.3, 0.5, 1.0, 1.0], then the input-&gt;output mapping
10791for a few sample points would be: 0 -&gt; 0, 0.15 -&gt;
107920.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]10793 </td>
10794
10795 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10796 <ul class="entry_tags">
10797 <li><a href="#tag_DNG">DNG</a></li>
10798 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10799 </td>
10800
10801 </tr> <!-- end of entry -->
10802
10803
10804 <tr class="entry" id="dynamic_android.tonemap.mode">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10805 <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]10806 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10807 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10808
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10809 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10810
10811 <ul class="entry_type_enum">
10812 <li>
10813 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10814 <span class="entry_type_enum_notes"><html><body><p>Use the tone mapping curve specified in
10815 android.tonemap.curve<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10816 </li>
10817 <li>
10818 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10819 <span class="entry_type_enum_notes"><html><body><p>Must not slow down frame rate relative to raw
10820 bayer output<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10821 </li>
10822 <li>
10823 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10824 <span class="entry_type_enum_notes"><html><body><p>Frame rate may be reduced by high
10825 quality<wbr></wbr></p></body></html></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10826 </li>
10827 </ul>
10828
10829 </td> <!-- entry_type -->
10830
10831 <td class="entry_description">
10832 </td>
10833
10834 <td class="entry_units">
10835 </td>
10836
10837 <td class="entry_range">
10838 </td>
10839
10840 <td class="entry_notes">
10841 </td>
10842
10843 <td class="entry_tags">
10844 </td>
10845
10846 </tr> <!-- end of entry -->
10847
10848
10849
10850 <!-- end of kind -->
10851 </tbody>
10852
10853 <!-- end of section -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10854 <tr><td colspan="7" id="section_led" class="section">led</td></tr>
10855
10856
10857 <tr><td colspan="7" class="kind">controls</td></tr>
10858
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10859 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10860 <tr>
10861 <th class="th_name">Property Name</th>
10862 <th class="th_type">Type</th>
10863 <th class="th_description">Description</th>
10864 <th class="th_units">Units</th>
10865 <th class="th_range">Range</th>
10866 <th class="th_notes">Notes</th>
10867 <th class="th_tags">Tags</th>
10868 </tr>
10869 </thead>
10870
10871 <tbody>
10872
10873
10874
10875
10876
10877
10878
10879
10880
10881
10882 <tr class="entry" id="controls_android.led.transmit">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10883 <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]10884 <td class="entry_type">
10885 <span class="entry_type_name entry_type_name_enum">byte</span>
10886
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10887 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10888
10889 <ul class="entry_type_enum">
10890 <li>
10891 <span class="entry_type_enum_name">OFF</span>
10892 </li>
10893 <li>
10894 <span class="entry_type_enum_name">ON</span>
10895 </li>
10896 </ul>
10897
10898 </td> <!-- entry_type -->
10899
10900 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10901 <html><body><p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10902that the camera is powered on and may be streaming images back to the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10903Application Processor. In certain rare circumstances, the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10904disable this when video is processed locally and not transmitted to
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10905any untrusted applications.</p>
10906<p>In particular, the LED <em>must</em> always be on when the data could be
10907transmitted off the device. The LED <em>should</em> always be on whenever
10908data is stored locally on the device.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10909<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]10910doesn't violate the above rules.<wbr></wbr></p></body></html>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10911 </td>
10912
10913 <td class="entry_units">
10914 </td>
10915
10916 <td class="entry_range">
10917 </td>
10918
10919 <td class="entry_notes">
10920 </td>
10921
10922 <td class="entry_tags">
10923 </td>
10924
10925 </tr> <!-- end of entry -->
10926
10927
10928
10929 <!-- end of kind -->
10930 </tbody>
10931 <tr><td colspan="7" class="kind">dynamic</td></tr>
10932
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10933 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10934 <tr>
10935 <th class="th_name">Property Name</th>
10936 <th class="th_type">Type</th>
10937 <th class="th_description">Description</th>
10938 <th class="th_units">Units</th>
10939 <th class="th_range">Range</th>
10940 <th class="th_notes">Notes</th>
10941 <th class="th_tags">Tags</th>
10942 </tr>
10943 </thead>
10944
10945 <tbody>
10946
10947
10948
10949
10950
10951
10952
10953
10954
10955
10956 <tr class="entry" id="dynamic_android.led.transmit">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10957 <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]10958 <td class="entry_type">
10959 <span class="entry_type_name entry_type_name_enum">byte</span>
10960
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10961 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10962
10963 <ul class="entry_type_enum">
10964 <li>
10965 <span class="entry_type_enum_name">OFF</span>
10966 </li>
10967 <li>
10968 <span class="entry_type_enum_name">ON</span>
10969 </li>
10970 </ul>
10971
10972 </td> <!-- entry_type -->
10973
10974 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10975 <html><body><p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10976that the camera is powered on and may be streaming images back to the
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10977Application Processor. In certain rare circumstances, the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10978disable this when video is processed locally and not transmitted to
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]10979any untrusted applications.</p>
10980<p>In particular, the LED <em>must</em> always be on when the data could be
10981transmitted off the device. The LED <em>should</em> always be on whenever
10982data is stored locally on the device.</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10983<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]10984doesn't violate the above rules.<wbr></wbr></p></body></html>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10985 </td>
10986
10987 <td class="entry_units">
10988 </td>
10989
10990 <td class="entry_range">
10991 </td>
10992
10993 <td class="entry_notes">
10994 </td>
10995
10996 <td class="entry_tags">
10997 </td>
10998
10999 </tr> <!-- end of entry -->
11000
11001
11002
11003 <!-- end of kind -->
11004 </tbody>
11005 <tr><td colspan="7" class="kind">static</td></tr>
11006
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11007 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]11008 <tr>
11009 <th class="th_name">Property Name</th>
11010 <th class="th_type">Type</th>
11011 <th class="th_description">Description</th>
11012 <th class="th_units">Units</th>
11013 <th class="th_range">Range</th>
11014 <th class="th_notes">Notes</th>
11015 <th class="th_tags">Tags</th>
11016 </tr>
11017 </thead>
11018
11019 <tbody>
11020
11021
11022
11023
11024
11025
11026
11027
11028
11029
11030 <tr class="entry" id="static_android.led.availableLeds">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11031 <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]11032 <td class="entry_type">
11033 <span class="entry_type_name entry_type_name_enum">byte</span>
11034 <span class="entry_type_container">x</span>
11035
11036 <span class="entry_type_array">
11037 n
11038 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11039 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]11040
11041 <ul class="entry_type_enum">
11042 <li>
11043 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11044 <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]11045 </li>
11046 </ul>
11047
11048 </td> <!-- entry_type -->
11049
11050 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11051 <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]11052 </td>
11053
11054 <td class="entry_units">
11055 </td>
11056
11057 <td class="entry_range">
11058 </td>
11059
11060 <td class="entry_notes">
11061 </td>
11062
11063 <td class="entry_tags">
11064 </td>
11065
11066 </tr> <!-- end of entry -->
11067
11068
11069
11070 <!-- end of kind -->
11071 </tbody>
11072
11073 <!-- end of section -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]11074 <tr><td colspan="7" id="section_info" class="section">info</td></tr>
11075
11076
11077 <tr><td colspan="7" class="kind">static</td></tr>
11078
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11079 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]11080 <tr>
11081 <th class="th_name">Property Name</th>
11082 <th class="th_type">Type</th>
11083 <th class="th_description">Description</th>
11084 <th class="th_units">Units</th>
11085 <th class="th_range">Range</th>
11086 <th class="th_notes">Notes</th>
11087 <th class="th_tags">Tags</th>
11088 </tr>
11089 </thead>
11090
11091 <tbody>
11092
11093
11094
11095
11096
11097
11098
11099
11100
11101
11102 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11103 <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]11104 <td class="entry_type">
11105 <span class="entry_type_name entry_type_name_enum">byte</span>
11106
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11107 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]11108
11109 <ul class="entry_type_enum">
11110 <li>
11111 <span class="entry_type_enum_name">LIMITED</span>
11112 </li>
11113 <li>
11114 <span class="entry_type_enum_name">FULL</span>
11115 </li>
11116 </ul>
11117
11118 </td> <!-- entry_type -->
11119
11120 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11121 <html><body><p>The camera 3 HAL device can implement one of two possible
11122operational modes; limited and full. Full support is
11123expected from new higher-end devices. Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11124hardware requirements roughly in line with those for a
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11125camera HAL device v1 implementation, and is expected from
11126older or inexpensive devices. Full is a strict superset of
11127limited, and they share the same essential operational flow.</p>
11128<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]11129 </td>
11130
11131 <td class="entry_units">
11132 </td>
11133
11134 <td class="entry_range">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11135 <html><body><p>Optional. Default value is LIMITED.<wbr></wbr></p></body></html>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]11136 </td>
11137
11138 <td class="entry_notes">
11139 </td>
11140
11141 <td class="entry_tags">
11142 </td>
11143
11144 </tr> <!-- end of entry -->
11145
11146
11147
11148 <!-- end of kind -->
11149 </tbody>
11150
11151 <!-- end of section -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11152 <tr><td colspan="7" id="section_blackLevel" class="section">blackLevel</td></tr>
11153
11154
11155 <tr><td colspan="7" class="kind">controls</td></tr>
11156
11157 <thead class="entries_header">
11158 <tr>
11159 <th class="th_name">Property Name</th>
11160 <th class="th_type">Type</th>
11161 <th class="th_description">Description</th>
11162 <th class="th_units">Units</th>
11163 <th class="th_range">Range</th>
11164 <th class="th_notes">Notes</th>
11165 <th class="th_tags">Tags</th>
11166 </tr>
11167 </thead>
11168
11169 <tbody>
11170
11171
11172
11173
11174
11175
11176
11177
11178
11179
11180 <tr class="entry" id="controls_android.blackLevel.lock">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11181 <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]11182 <td class="entry_type">
11183 <span class="entry_type_name entry_type_name_enum">byte</span>
11184
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11185 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11186
11187 <ul class="entry_type_enum">
11188 <li>
11189 <span class="entry_type_enum_name">OFF</span>
11190 </li>
11191 <li>
11192 <span class="entry_type_enum_name">ON</span>
11193 </li>
11194 </ul>
11195
11196 </td> <!-- entry_type -->
11197
11198 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11199 <html><body><p>Whether black-level compensation is locked
11200to its current values, or is free to vary<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11201 </td>
11202
11203 <td class="entry_units">
11204 </td>
11205
11206 <td class="entry_range">
11207 </td>
11208
11209 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11210 <html><body><p>When set to ON, the values used for black-level
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11211compensation must not change until the lock is set to
11212OFF</p>
11213<p>Since changes to certain capture parameters (such as
11214exposure time) may require resetting of black level
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11215compensation, the HAL must report whether setting the
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11216black level lock was successful in the output result
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11217metadata.</p>
11218<p>For example, if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11219<ul>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11220<li>Request 1: Exposure = 10ms, Black level lock = OFF</li>
11221<li>Request 2: Exposure = 10ms, Black level lock = ON</li>
11222<li>Request 3: Exposure = 10ms, Black level lock = ON</li>
11223<li>Request 4: Exposure = 20ms, Black level lock = ON</li>
11224<li>Request 5: Exposure = 20ms, Black level lock = ON</li>
11225<li>Request 6: Exposure = 20ms, Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11226</ul>
11227<p>And the exposure change in Request 4 requires resetting the black
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11228level offsets, then the output result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11229<ul>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11230<li>Result 1: Exposure = 10ms, Black level lock = OFF</li>
11231<li>Result 2: Exposure = 10ms, Black level lock = ON</li>
11232<li>Result 3: Exposure = 10ms, Black level lock = ON</li>
11233<li>Result 4: Exposure = 20ms, Black level lock = OFF</li>
11234<li>Result 5: Exposure = 20ms, Black level lock = ON</li>
11235<li>Result 6: Exposure = 20ms, Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11236</ul>
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11237<p>This indicates to the application that on frame 4, black levels were
11238reset due to exposure value changes, and pixel values may not be
11239consistent across captures.</p>
11240<p>The black level locking must happen at the sensor, and not at the ISP.
11241If for some reason black level locking is no longer legal (for example,
11242the analog gain has changed, which forces black levels to be
11243recalculated), then the HAL is free to override this request (and it
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11244must report 'OFF' when this does happen) until the next time locking
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11245is legal again.<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11246 </td>
11247
11248 <td class="entry_tags">
11249 <ul class="entry_tags">
11250 <li><a href="#tag_HAL2">HAL2</a></li>
11251 </ul>
11252 </td>
11253
11254 </tr> <!-- end of entry -->
11255
11256
11257
11258 <!-- end of kind -->
11259 </tbody>
11260 <tr><td colspan="7" class="kind">dynamic</td></tr>
11261
11262 <thead class="entries_header">
11263 <tr>
11264 <th class="th_name">Property Name</th>
11265 <th class="th_type">Type</th>
11266 <th class="th_description">Description</th>
11267 <th class="th_units">Units</th>
11268 <th class="th_range">Range</th>
11269 <th class="th_notes">Notes</th>
11270 <th class="th_tags">Tags</th>
11271 </tr>
11272 </thead>
11273
11274 <tbody>
11275
11276
11277
11278
11279
11280
11281
11282
11283
11284
11285 <tr class="entry" id="dynamic_android.blackLevel.lock">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11286 <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]11287 <td class="entry_type">
11288 <span class="entry_type_name entry_type_name_enum">byte</span>
11289
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11290 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11291
11292 <ul class="entry_type_enum">
11293 <li>
11294 <span class="entry_type_enum_name">OFF</span>
11295 </li>
11296 <li>
11297 <span class="entry_type_enum_name">ON</span>
11298 </li>
11299 </ul>
11300
11301 </td> <!-- entry_type -->
11302
11303 <td class="entry_description">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11304 <html><body><p>Whether black-level compensation is locked
11305to its current values, or is free to vary<wbr></wbr></p></body></html>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11306 </td>
11307
11308 <td class="entry_units">
11309 </td>
11310
11311 <td class="entry_range">
11312 </td>
11313
11314 <td class="entry_notes">
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11315 <html><body><p>Whether the black level offset was locked for this frame.
11316Should be ON if android.blackLevel.lock was ON in the capture request,
11317unless 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]11318 </td>
11319
11320 <td class="entry_tags">
11321 <ul class="entry_tags">
11322 <li><a href="#tag_HAL2">HAL2</a></li>
11323 </ul>
11324 </td>
11325
11326 </tr> <!-- end of entry -->
11327
11328
11329
11330 <!-- end of kind -->
11331 </tbody>
11332
11333 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11334<!-- </namespace> -->
11335 </table>
11336
11337 <div class="tags" id="tag_index">
11338 <h2>Tags</h2>
11339 <ul>
11340 <li id="tag_AWB">AWB -
11341 Needed for auto white balance
11342
11343 <ul class="tags_entries">
11344 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
11345 </ul>
11346 </li> <!-- tag_AWB -->
11347 <li id="tag_BC">BC -
11348 Needed for backwards compatibility with old Java API
11349
11350 <ul class="tags_entries">
11351 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
11352 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
11353 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
11354 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
11355 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]11356 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11357 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
11358 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]11359 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11360 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
11361 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
11362 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
11363 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
11364 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
11365 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
11366 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
11367 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
11368 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
11369 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
11370 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
11371 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
11372 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
11373 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
11374 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
11375 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
11376 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
11377 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
11378 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
11379 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
11380 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
11381 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
11382 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
11383 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
11384 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
11385 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
11386 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
11387 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
11388 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
11389 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
11390 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
11391 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
11392 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
11393 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
11394 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
11395 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]11396 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11397 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
11398 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
11399 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11400 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11401 <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]11402 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
11403 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
11404 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
11405 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
11406 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
11407 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
11408 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
11409 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
11410 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
11411 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
11412 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
11413 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
11414 </ul>
11415 </li> <!-- tag_BC -->
11416 <li id="tag_V1">V1 -
11417 New features for first camera 2 release (API1)
11418
11419 <ul class="tags_entries">
11420 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
11421 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
11422 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
11423 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
11424 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
11425 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
11426 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
11427 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
11428 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
11429 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
11430 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
11431 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
11432 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
11433 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
11434 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
11435 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
11436 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
11437 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
11438 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
11439 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
11440 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
11441 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
11442 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
11443 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11444 <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]11445 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
11446 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
11447 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
11448 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
11449 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
11450 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
11451 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
11452 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
11453 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
11454 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
11455 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
11456 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
11457 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
11458 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
11459 </ul>
11460 </li> <!-- tag_V1 -->
11461 <li id="tag_ADV">ADV - None
11462 <ul class="tags_entries">
11463 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
11464 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
11465 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
11466 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
11467 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
11468 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
11469 </ul>
11470 </li> <!-- tag_ADV -->
11471 <li id="tag_DNG">DNG -
11472 Needed for DNG file support
11473
11474 <ul class="tags_entries">
11475 <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]11476 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
11477 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
11478 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
11479 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
11480 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
11481 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
11482 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
11483 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
11484 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
11485 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
11486 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
11487 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
11488 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
11489 </ul>
11490 </li> <!-- tag_DNG -->
11491 <li id="tag_EXIF">EXIF - None
11492 <ul class="tags_entries">
11493 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
11494 </ul>
11495 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]11496 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]11497 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]11498
11499 <ul class="tags_entries">
11500 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
11501 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
11502 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11503 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]11504 </ul>
11505 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]11506 <li id="tag_FULL">FULL -
11507 Entry is required for full hardware level devices, and optional for other hardware levels
11508
11509 <ul class="tags_entries">
11510 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
11511 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
11512 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
11513 </ul>
11514 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11515 </ul>
11516 </div>
11517
11518 [ <a href="#">top</a> ]
11519
11520</body>
11521</html>