Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / b8dc88148bca2e5a267c2ff39aff94b98b00ad6d / . / camera / docs / docs.html
blob: 49d2e3c23fd12c84d077a964bc402e3c3ca4870e [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>
389 </ul>
390 </li>
391 </ul> <!-- toc_section -->
392 </li>
393 <li>
394 <span class="toc_section_header"><a href="#section_request">request</a></span>
395 <ul class="toc_section">
396 <li>
397 <span class="toc_kind_header">controls</span>
398 <ul class="toc_section">
399 <li><a href="#controls_android.request.frameCount">android.request.frameCount</a></li>
400 <li><a href="#controls_android.request.id">android.request.id</a></li>
401 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a></li>
402 <li><a href="#controls_android.request.metadataMode">android.request.metadataMode</a></li>
403 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a></li>
404 <li><a href="#controls_android.request.type">android.request.type</a></li>
405 </ul>
406 </li>
407 <li>
408 <span class="toc_kind_header">static</span>
409 <ul class="toc_section">
410 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a></li>
411 <li><a href="#static_android.request.maxNumReprocessStreams">android.request.maxNumReprocessStreams</a></li>
412 </ul>
413 </li>
414 <li>
415 <span class="toc_kind_header">dynamic</span>
416 <ul class="toc_section">
417 <li><a href="#dynamic_android.request.frameCount">android.request.frameCount</a></li>
418 <li><a href="#dynamic_android.request.id">android.request.id</a></li>
419 <li><a href="#dynamic_android.request.metadataMode">android.request.metadataMode</a></li>
420 <li><a href="#dynamic_android.request.outputStreams">android.request.outputStreams</a></li>
421 </ul>
422 </li>
423 </ul> <!-- toc_section -->
424 </li>
425 <li>
426 <span class="toc_section_header"><a href="#section_scaler">scaler</a></span>
427 <ul class="toc_section">
428 <li>
429 <span class="toc_kind_header">controls</span>
430 <ul class="toc_section">
431 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
432 </ul>
433 </li>
434 <li>
435 <span class="toc_kind_header">static</span>
436 <ul class="toc_section">
437 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a></li>
438 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a></li>
439 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a></li>
440 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a></li>
441 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a></li>
442 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a></li>
443 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a></li>
444 <li><a href="#static_android.scaler.availableRawSizes">android.scaler.availableRawSizes</a></li>
445 </ul>
446 </li>
447 <li>
448 <span class="toc_kind_header">dynamic</span>
449 <ul class="toc_section">
450 <li><a href="#dynamic_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
451 </ul>
452 </li>
453 </ul> <!-- toc_section -->
454 </li>
455 <li>
456 <span class="toc_section_header"><a href="#section_sensor">sensor</a></span>
457 <ul class="toc_section">
458 <li>
459 <span class="toc_kind_header">controls</span>
460 <ul class="toc_section">
461 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
462 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
463 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
464 </ul>
465 </li>
466 <li>
467 <span class="toc_kind_header">static</span>
468 <ul class="toc_section">
469
470 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]471 <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]472 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a></li>
473 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a></li>
474 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a></li>
475 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a></li>
476 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a></li>
477 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a></li>
478
479 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a></li>
480 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a></li>
481 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a></li>
482 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a></li>
483 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a></li>
484 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a></li>
485 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a></li>
486 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a></li>
487 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a></li>
488 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a></li>
489 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a></li>
490 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a></li>
491 <li><a href="#static_android.sensor.referenceIlluminant2">android.sensor.referenceIlluminant2</a></li>
492 </ul>
493 </li>
494 <li>
495 <span class="toc_kind_header">dynamic</span>
496 <ul class="toc_section">
497 <li><a href="#dynamic_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
498 <li><a href="#dynamic_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
499 <li><a href="#dynamic_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
500 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a></li>
501 </ul>
502 </li>
503 </ul> <!-- toc_section -->
504 </li>
505 <li>
506 <span class="toc_section_header"><a href="#section_shading">shading</a></span>
507 <ul class="toc_section">
508 <li>
509 <span class="toc_kind_header">controls</span>
510 <ul class="toc_section">
511 <li><a href="#controls_android.shading.mode">android.shading.mode</a></li>
512 <li><a href="#controls_android.shading.strength">android.shading.strength</a></li>
513 </ul>
514 </li>
515 <li>
516 <span class="toc_kind_header">dynamic</span>
517 <ul class="toc_section">
518 <li><a href="#dynamic_android.shading.mode">android.shading.mode</a></li>
519 </ul>
520 </li>
521 </ul> <!-- toc_section -->
522 </li>
523 <li>
524 <span class="toc_section_header"><a href="#section_statistics">statistics</a></span>
525 <ul class="toc_section">
526 <li>
527 <span class="toc_kind_header">controls</span>
528 <ul class="toc_section">
529 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
530 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
531 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]532 <li><a href="#controls_android.statistics.lensShadingMapMode">android.statistics.lensShadingMapMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]533 </ul>
534 </li>
535 <li>
536 <span class="toc_kind_header">static</span>
537 <ul class="toc_section">
538
539 <li><a href="#static_android.statistics.info.availableFaceDetectModes">android.statistics.info.availableFaceDetectModes</a></li>
540 <li><a href="#static_android.statistics.info.histogramBucketCount">android.statistics.info.histogramBucketCount</a></li>
541 <li><a href="#static_android.statistics.info.maxFaceCount">android.statistics.info.maxFaceCount</a></li>
542 <li><a href="#static_android.statistics.info.maxHistogramCount">android.statistics.info.maxHistogramCount</a></li>
543 <li><a href="#static_android.statistics.info.maxSharpnessMapValue">android.statistics.info.maxSharpnessMapValue</a></li>
544 <li><a href="#static_android.statistics.info.sharpnessMapSize">android.statistics.info.sharpnessMapSize</a></li>
545
546 </ul>
547 </li>
548 <li>
549 <span class="toc_kind_header">dynamic</span>
550 <ul class="toc_section">
551 <li><a href="#dynamic_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
552 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a></li>
553 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a></li>
554 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a></li>
555 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a></li>
556 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a></li>
557 <li><a href="#dynamic_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
558 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a></li>
559 <li><a href="#dynamic_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]560 <li><a href="#dynamic_android.statistics.lensShadingMap">android.statistics.lensShadingMap</a></li>
561 <li><a href="#dynamic_android.statistics.predictedColorGains">android.statistics.predictedColorGains</a></li>
562 <li><a href="#dynamic_android.statistics.predictedColorTransform">android.statistics.predictedColorTransform</a></li>
563 <li><a href="#dynamic_android.statistics.sceneFlicker">android.statistics.sceneFlicker</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]564 </ul>
565 </li>
566 </ul> <!-- toc_section -->
567 </li>
568 <li>
569 <span class="toc_section_header"><a href="#section_tonemap">tonemap</a></span>
570 <ul class="toc_section">
571 <li>
572 <span class="toc_kind_header">controls</span>
573 <ul class="toc_section">
574 <li><a href="#controls_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
575 <li><a href="#controls_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
576 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
577 <li><a href="#controls_android.tonemap.mode">android.tonemap.mode</a></li>
578 </ul>
579 </li>
580 <li>
581 <span class="toc_kind_header">static</span>
582 <ul class="toc_section">
583 <li><a href="#static_android.tonemap.maxCurvePoints">android.tonemap.maxCurvePoints</a></li>
584 </ul>
585 </li>
586 <li>
587 <span class="toc_kind_header">dynamic</span>
588 <ul class="toc_section">
589 <li><a href="#dynamic_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
590 <li><a href="#dynamic_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
591 <li><a href="#dynamic_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
592 <li><a href="#dynamic_android.tonemap.mode">android.tonemap.mode</a></li>
593 </ul>
594 </li>
595 </ul> <!-- toc_section -->
596 </li>
597 <li>
598 <span class="toc_section_header"><a href="#section_led">led</a></span>
599 <ul class="toc_section">
600 <li>
601 <span class="toc_kind_header">controls</span>
602 <ul class="toc_section">
603 <li><a href="#controls_android.led.transmit">android.led.transmit</a></li>
604 </ul>
605 </li>
606 <li>
607 <span class="toc_kind_header">dynamic</span>
608 <ul class="toc_section">
609 <li><a href="#dynamic_android.led.transmit">android.led.transmit</a></li>
610 </ul>
611 </li>
612 <li>
613 <span class="toc_kind_header">static</span>
614 <ul class="toc_section">
615 <li><a href="#static_android.led.availableLeds">android.led.availableLeds</a></li>
616 </ul>
617 </li>
618 </ul> <!-- toc_section -->
619 </li>
620 <li>
621 <span class="toc_section_header"><a href="#section_info">info</a></span>
622 <ul class="toc_section">
623 <li>
624 <span class="toc_kind_header">static</span>
625 <ul class="toc_section">
626 <li><a href="#static_android.info.supportedHardwareLevel">android.info.supportedHardwareLevel</a></li>
627 </ul>
628 </li>
629 </ul> <!-- toc_section -->
630 </li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]631 <li>
632 <span class="toc_section_header"><a href="#section_blackLevel">blackLevel</a></span>
633 <ul class="toc_section">
634 <li>
635 <span class="toc_kind_header">controls</span>
636 <ul class="toc_section">
637 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a></li>
638 </ul>
639 </li>
640 <li>
641 <span class="toc_kind_header">dynamic</span>
642 <ul class="toc_section">
643 <li><a href="#dynamic_android.blackLevel.lock">android.blackLevel.lock</a></li>
644 </ul>
645 </li>
646 </ul> <!-- toc_section -->
647 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]648 </ul>
649
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]650
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]651 <h1>Properties</h1>
652 <table class="properties">
653
654 <thead class="thead_dummy">
655 <tr>
656 <th class="th_name">Property Name</th>
657 <th class="th_type">Type</th>
658 <th class="th_description">Description</th>
659 <th class="th_units">Units</th>
660 <th class="th_range">Range</th>
661 <th class="th_notes">Notes</th>
662 <th class="th_tags">Tags</th>
663 </tr>
664 </thead> <!-- so that the first occurrence of thead is not
665 above the first occurrence of tr -->
666<!-- <namespace name="android"> -->
667 <tr><td colspan="7" id="section_colorCorrection" class="section">colorCorrection</td></tr>
668
669
670 <tr><td colspan="7" class="kind">controls</td></tr>
671
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]672 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]673 <tr>
674 <th class="th_name">Property Name</th>
675 <th class="th_type">Type</th>
676 <th class="th_description">Description</th>
677 <th class="th_units">Units</th>
678 <th class="th_range">Range</th>
679 <th class="th_notes">Notes</th>
680 <th class="th_tags">Tags</th>
681 </tr>
682 </thead>
683
684 <tbody>
685
686
687
688
689
690
691
692
693
694
695 <tr class="entry" id="controls_android.colorCorrection.mode">
696 <td class="entry_name">android.<wbr>color<wbr>Correction.<wbr>mode</td>
697 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]698 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]699
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]700 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]701
702 <ul class="entry_type_enum">
703 <li>
704 <span class="entry_type_enum_name">TRANSFORM_MATRIX</span>
705 <span class="entry_type_enum_notes">Use the android.<wbr>color<wbr>Correction.<wbr>transform matrix
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]706 and android.<wbr>color<wbr>Correction.<wbr>gains to do color conversion</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]707 </li>
708 <li>
709 <span class="entry_type_enum_name">FAST</span>
710 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
711 bayer output</span>
712 </li>
713 <li>
714 <span class="entry_type_enum_name">HIGH_QUALITY</span>
715 <span class="entry_type_enum_notes">Frame rate may be reduced by high
716 quality</span>
717 </li>
718 </ul>
719
720 </td> <!-- entry_type -->
721
722 <td class="entry_description">
723 </td>
724
725 <td class="entry_units">
726 </td>
727
728 <td class="entry_range">
729 </td>
730
731 <td class="entry_notes">
732 </td>
733
734 <td class="entry_tags">
735 </td>
736
737 </tr> <!-- end of entry -->
738
739
740 <tr class="entry" id="controls_android.colorCorrection.transform">
741 <td class="entry_name">android.<wbr>color<wbr>Correction.<wbr>transform</td>
742 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]743 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]744 <span class="entry_type_container">x</span>
745
746 <span class="entry_type_array">
747 3 x 3
748 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]749 <span class="entry_type_visibility"> [public]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]750 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]751
752
753 </td> <!-- entry_type -->
754
755 <td class="entry_description">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]756 A color transform matrix to use to transform
757 from sensor RGB color space to output linear sRGB color space
758
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]759 </td>
760
761 <td class="entry_units">
762 </td>
763
764 <td class="entry_range">
765 Output values are expected to be in the range
766 (0,<wbr>1)
767 </td>
768
769 <td class="entry_notes">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]770 This matrix is either set by HAL when the request
771 android.<wbr>color<wbr>Correction.<wbr>mode is not TRANSFORM_<wbr>MATRIX,<wbr> or
772 directly by the application in the request when the
773 androird.<wbr>color<wbr>Correction.<wbr>mode is TRANSFORM_<wbr>MATRIX.<wbr>
774 In the latter case,<wbr> the HAL may round the matrix to account
775 for precision issues; the final rounded matrix should be
776 reported back in this matrix result metadata.<wbr>
777 </td>
778
779 <td class="entry_tags">
780 </td>
781
782 </tr> <!-- end of entry -->
783
784
785 <tr class="entry" id="controls_android.colorCorrection.gains">
786 <td class="entry_name">android.<wbr>color<wbr>Correction.<wbr>gains</td>
787 <td class="entry_type">
788 <span class="entry_type_name">float</span>
789 <span class="entry_type_container">x</span>
790
791 <span class="entry_type_array">
792 4
793 </span>
794 <span class="entry_type_visibility"> [public]</span>
795 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
796
797
798 </td> <!-- entry_type -->
799
800 <td class="entry_description">
801 Gains applying to Bayer color channels for
802 white-balance
803 </td>
804
805 <td class="entry_units">
806 </td>
807
808 <td class="entry_range">
809 </td>
810
811 <td class="entry_notes">
812 The 4-channel white-balance gains are defined in
813 the order of [R G_<wbr>even G_<wbr>odd B],<wbr> where G_<wbr>even is the gain
814 for green pixels on even rows of the output,<wbr> and G_<wbr>odd
815 is the gain for greenpixels on the odd rows.<wbr> if a HAL
816 does not support a separate gain for even/<wbr>odd green channels,<wbr>
817 it should use the G_<wbr>even value,<wbr>and write G_<wbr>odd equal to
818 G_<wbr>even in the output result metadata.<wbr>
819<br>
820<br> The ouput should be the gains actually applied by the HAL to
821 the current frame.<wbr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]822 </td>
823
824 <td class="entry_tags">
825 </td>
826
827 </tr> <!-- end of entry -->
828
829
830
831 <!-- end of kind -->
832 </tbody>
833 <tr><td colspan="7" class="kind">dynamic</td></tr>
834
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]835 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]836 <tr>
837 <th class="th_name">Property Name</th>
838 <th class="th_type">Type</th>
839 <th class="th_description">Description</th>
840 <th class="th_units">Units</th>
841 <th class="th_range">Range</th>
842 <th class="th_notes">Notes</th>
843 <th class="th_tags">Tags</th>
844 </tr>
845 </thead>
846
847 <tbody>
848
849
850
851
852
853
854
855
856
857
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]858 <tr class="entry" id="dynamic_android.colorCorrection.transform">
859 <td class="entry_name">android.<wbr>color<wbr>Correction.<wbr>transform</td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]860 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]861 <span class="entry_type_name">rational</span>
862 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]863
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]864 <span class="entry_type_array">
865 3 x 3
866 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]867 <span class="entry_type_visibility"> [public]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]868 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]869
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]870
871 </td> <!-- entry_type -->
872
873 <td class="entry_description">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]874 A color transform matrix to use to transform
875 from sensor RGB color space to output linear sRGB color space
876
877 </td>
878
879 <td class="entry_units">
880 </td>
881
882 <td class="entry_range">
883 Output values are expected to be in the range
884 (0,<wbr>1)
885 </td>
886
887 <td class="entry_notes">
888 This matrix is either set by HAL when the request
889 android.<wbr>color<wbr>Correction.<wbr>mode is not TRANSFORM_<wbr>MATRIX,<wbr> or
890 directly by the application in the request when the
891 androird.<wbr>color<wbr>Correction.<wbr>mode is TRANSFORM_<wbr>MATRIX.<wbr>
892 In the latter case,<wbr> the HAL may round the matrix to account
893 for precision issues; the final rounded matrix should be
894 reported back in this matrix result metadata.<wbr>
895 </td>
896
897 <td class="entry_tags">
898 </td>
899
900 </tr> <!-- end of entry -->
901
902
903 <tr class="entry" id="dynamic_android.colorCorrection.gains">
904 <td class="entry_name">android.<wbr>color<wbr>Correction.<wbr>gains</td>
905 <td class="entry_type">
906 <span class="entry_type_name">float</span>
907 <span class="entry_type_container">x</span>
908
909 <span class="entry_type_array">
910 4
911 </span>
912 <span class="entry_type_visibility"> [public]</span>
913 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
914
915
916 </td> <!-- entry_type -->
917
918 <td class="entry_description">
919 Gains applying to Bayer color channels for
920 white-balance
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]921 </td>
922
923 <td class="entry_units">
924 </td>
925
926 <td class="entry_range">
927 </td>
928
929 <td class="entry_notes">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]930 The 4-channel white-balance gains are defined in
931 the order of [R G_<wbr>even G_<wbr>odd B],<wbr> where G_<wbr>even is the gain
932 for green pixels on even rows of the output,<wbr> and G_<wbr>odd
933 is the gain for greenpixels on the odd rows.<wbr> if a HAL
934 does not support a separate gain for even/<wbr>odd green channels,<wbr>
935 it should use the G_<wbr>even value,<wbr>and write G_<wbr>odd equal to
936 G_<wbr>even in the output result metadata.<wbr>
937<br>
938<br> The ouput should be the gains actually applied by the HAL to
939 the current frame.<wbr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]940 </td>
941
942 <td class="entry_tags">
943 </td>
944
945 </tr> <!-- end of entry -->
946
947
948
949 <!-- end of kind -->
950 </tbody>
951
952 <!-- end of section -->
953 <tr><td colspan="7" id="section_control" class="section">control</td></tr>
954
955
956 <tr><td colspan="7" class="kind">controls</td></tr>
957
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]958 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]959 <tr>
960 <th class="th_name">Property Name</th>
961 <th class="th_type">Type</th>
962 <th class="th_description">Description</th>
963 <th class="th_units">Units</th>
964 <th class="th_range">Range</th>
965 <th class="th_notes">Notes</th>
966 <th class="th_tags">Tags</th>
967 </tr>
968 </thead>
969
970 <tbody>
971
972
973
974
975
976
977
978
979
980
981 <tr class="entry" id="controls_android.control.aeAntibandingMode">
982 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Antibanding<wbr>Mode</td>
983 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]984 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]985
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]986 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]987
988 <ul class="entry_type_enum">
989 <li>
990 <span class="entry_type_enum_name">OFF</span>
991 </li>
992 <li>
993 <span class="entry_type_enum_name">50HZ</span>
994 </li>
995 <li>
996 <span class="entry_type_enum_name">60HZ</span>
997 </li>
998 <li>
999 <span class="entry_type_enum_name">AUTO</span>
1000 </li>
1001 </ul>
1002
1003 </td> <!-- entry_type -->
1004
1005 <td class="entry_description">
1006 Enum for controlling
1007 antibanding
1008 </td>
1009
1010 <td class="entry_units">
1011 </td>
1012
1013 <td class="entry_range">
1014
1015 android.<wbr>control.<wbr>ae<wbr>Available<wbr>Antibanding<wbr>Modes
1016 </td>
1017
1018 <td class="entry_notes">
1019 </td>
1020
1021 <td class="entry_tags">
1022 </td>
1023
1024 </tr> <!-- end of entry -->
1025
1026
1027 <tr class="entry" id="controls_android.control.aeExposureCompensation">
1028 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Exposure<wbr>Compensation</td>
1029 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1030 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1031
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1032 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1033
1034
1035 </td> <!-- entry_type -->
1036
1037 <td class="entry_description">
1038 Adjustment to AE target image
1039 brightness
1040 </td>
1041
1042 <td class="entry_units">
1043 count of positive/<wbr>negative EV steps
1044 </td>
1045
1046 <td class="entry_range">
1047 </td>
1048
1049 <td class="entry_notes">
1050 For example,<wbr> if EV step is 0.<wbr>333,<wbr> '6' will mean an
1051 exposure compensation of +2 EV; -3 will mean an exposure
1052 compensation of -1
1053 </td>
1054
1055 <td class="entry_tags">
1056 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1057 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1058 </ul>
1059 </td>
1060
1061 </tr> <!-- end of entry -->
1062
1063
1064 <tr class="entry" id="controls_android.control.aeLock">
1065 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Lock</td>
1066 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1067 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1068
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]1069 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1070
1071 <ul class="entry_type_enum">
1072 <li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1073 <span class="entry_type_enum_name">OFF</span>
1074 <span class="entry_type_enum_notes">Autoexposure lock is disabled; the AE algorithm
1075 is free to update its parameters.<wbr></span>
1076 </li>
1077 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1078 <span class="entry_type_enum_name">ON</span>
1079 <span class="entry_type_enum_notes">Autoexposure lock is enabled; the AE algorithm
1080 must not update the exposure and sensitivity parameters
1081 while the lock is active</span>
1082 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1083 </ul>
1084
1085 </td> <!-- entry_type -->
1086
1087 <td class="entry_description">
1088 Whether AE is currently locked to its latest
1089 calculated values
1090 </td>
1091
1092 <td class="entry_units">
1093 </td>
1094
1095 <td class="entry_range">
1096 </td>
1097
1098 <td class="entry_notes">
1099 Note that even when AE is locked,<wbr> the flash may be
1100 fired if the AE mode is ON_<wbr>AUTO_<wbr>FLASH /<wbr> ON_<wbr>ALWAYS_<wbr>FLASH /<wbr>
1101 ON_<wbr>AUTO_<wbr>FLASH_<wbr>REDEYE.<wbr>
1102 </td>
1103
1104 <td class="entry_tags">
1105 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1106 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1107 </ul>
1108 </td>
1109
1110 </tr> <!-- end of entry -->
1111
1112
1113 <tr class="entry" id="controls_android.control.aeMode">
1114 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Mode</td>
1115 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1116 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1117
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1118 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1119
1120 <ul class="entry_type_enum">
1121 <li>
1122 <span class="entry_type_enum_name">OFF</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]1123 <span class="entry_type_enum_notes">Autoexposure is disabled; sensor.<wbr>exposureTime,<wbr>
1124 sensor.<wbr>sensitivity and sensor.<wbr>frameDuration are used</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1125 </li>
1126 <li>
1127 <span class="entry_type_enum_name">ON</span>
1128 <span class="entry_type_enum_notes">Autoexposure is active,<wbr> no flash
1129 control</span>
1130 </li>
1131 <li>
1132 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
1133 <span class="entry_type_enum_notes">if flash exists Autoexposure is active,<wbr> auto
1134 flash control; flash may be fired when precapture
1135 trigger is activated,<wbr> and for captures for which
1136 captureIntent = STILL_<wbr>CAPTURE</span>
1137 </li>
1138 <li>
1139 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
1140 <span class="entry_type_enum_notes">if flash exists Autoexposure is active,<wbr> auto
1141 flash control for precapture trigger and always flash
1142 when captureIntent = STILL_<wbr>CAPTURE</span>
1143 </li>
1144 <li>
1145 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
1146 <span class="entry_type_enum_notes">optional Automatic red eye reduction with flash.<wbr>
1147 If deemed necessary,<wbr> red eye reduction sequence should
1148 fire when precapture trigger is activated,<wbr> and final
1149 flash should fire when captureIntent =
1150 STILL_<wbr>CAPTURE</span>
1151 </li>
1152 </ul>
1153
1154 </td> <!-- entry_type -->
1155
1156 <td class="entry_description">
1157 Whether AE is currently updating the sensor
1158 exposure and sensitivity fields
1159 </td>
1160
1161 <td class="entry_units">
1162 </td>
1163
1164 <td class="entry_range">
1165 android.<wbr>control.<wbr>ae<wbr>Available<wbr>Modes
1166 </td>
1167
1168 <td class="entry_notes">
1169 Only effective if android.<wbr>control.<wbr>mode =
1170 AUTO
1171 </td>
1172
1173 <td class="entry_tags">
1174 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1175 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1176 </ul>
1177 </td>
1178
1179 </tr> <!-- end of entry -->
1180
1181
1182 <tr class="entry" id="controls_android.control.aeRegions">
1183 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Regions</td>
1184 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1185 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1186 <span class="entry_type_container">x</span>
1187
1188 <span class="entry_type_array">
1189 5 x area_count
1190 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1191 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1192
1193
1194 </td> <!-- entry_type -->
1195
1196 <td class="entry_description">
1197 List of areas to use for
1198 metering
1199 </td>
1200
1201 <td class="entry_units">
1202 </td>
1203
1204 <td class="entry_range">
1205 </td>
1206
1207 <td class="entry_notes">
1208 Each area is a rectangle plus weight: xmin,<wbr> ymin,<wbr>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1209 xmax,<wbr> ymax,<wbr> weight.<wbr>
1210<br>
1211<br> The coordinate system is based on the active pixel array,<wbr>
1212 with (0,<wbr>0) being the top-left of the active pixel array,<wbr> and
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1213 (android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size.<wbr>width,<wbr>
1214 android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size.<wbr>height) being the
1215 bottom-right point of the active pixel array.<wbr> The weight
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1216 should be nonnegative.<wbr>
1217<br>
1218<br> If all regions have 0 weight,<wbr> then no specific metering area
1219 needs to be used by the HAL.<wbr> If the metering region is
1220 outside the current android.<wbr>scaler.<wbr>crop<wbr>Region,<wbr> the HAL
1221 should ignore the sections outside the region and output the
1222 used sections in the frame metadata
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1223 </td>
1224
1225 <td class="entry_tags">
1226 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1227 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1228 </ul>
1229 </td>
1230
1231 </tr> <!-- end of entry -->
1232
1233
1234 <tr class="entry" id="controls_android.control.aeTargetFpsRange">
1235 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Target<wbr>Fps<wbr>Range</td>
1236 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1237 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1238 <span class="entry_type_container">x</span>
1239
1240 <span class="entry_type_array">
1241 2
1242 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1243 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1244
1245
1246 </td> <!-- entry_type -->
1247
1248 <td class="entry_description">
1249 Range over which fps can be adjusted to
1250 maintain exposure
1251 </td>
1252
1253 <td class="entry_units">
1254 </td>
1255
1256 <td class="entry_range">
1257 android.<wbr>control.<wbr>ae<wbr>Available<wbr>Target<wbr>Fps<wbr>Ranges
1258 </td>
1259
1260 <td class="entry_notes">
1261 Only constrains AE algorithm,<wbr> not manual control
1262 of android.<wbr>sensor.<wbr>exposure<wbr>Time
1263 </td>
1264
1265 <td class="entry_tags">
1266 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1267 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1268 </ul>
1269 </td>
1270
1271 </tr> <!-- end of entry -->
1272
1273
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1274 <tr class="entry" id="controls_android.control.aePrecaptureTrigger">
1275 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Precapture<wbr>Trigger</td>
1276 <td class="entry_type">
1277 <span class="entry_type_name entry_type_name_enum">byte</span>
1278
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1279 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1280
1281 <ul class="entry_type_enum">
1282 <li>
1283 <span class="entry_type_enum_name">IDLE</span>
1284 <span class="entry_type_enum_notes">The trigger is idle.<wbr></span>
1285 </li>
1286 <li>
1287 <span class="entry_type_enum_name">START</span>
1288 <span class="entry_type_enum_notes">The precapture metering sequence
1289 must be started.<wbr> The exact effect of the precapture
1290 trigger depends on the current AE mode and
1291 state.<wbr></span>
1292 </li>
1293 </ul>
1294
1295 </td> <!-- entry_type -->
1296
1297 <td class="entry_description">
1298 Whether the HAL must trigger precapture
1299 metering.<wbr>
1300 </td>
1301
1302 <td class="entry_units">
1303 </td>
1304
1305 <td class="entry_range">
1306 </td>
1307
1308 <td class="entry_notes">
1309 This entry is normally set to IDLE,<wbr> or is not
1310 included at all in the request settings.<wbr> When included and
1311 set to START,<wbr> the HAL must trigger the autoexposure
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1312 precapture metering sequence.<wbr>
1313<br>
1314<br> The effect of AE precapture trigger depends on the current
1315 AE mode and state; see the camera HAL device v3 header for
1316 details.<wbr>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1317 </td>
1318
1319 <td class="entry_tags">
1320 <ul class="entry_tags">
1321 <li><a href="#tag_BC">BC</a></li>
1322 </ul>
1323 </td>
1324
1325 </tr> <!-- end of entry -->
1326
1327
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1328 <tr class="entry" id="controls_android.control.afMode">
1329 <td class="entry_name">android.<wbr>control.<wbr>af<wbr>Mode</td>
1330 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1331 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1332
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1333 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1334
1335 <ul class="entry_type_enum">
1336 <li>
1337 <span class="entry_type_enum_name">OFF</span>
1338 <span class="entry_type_enum_notes">The 3A routines do not control the lens;
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]1339 android.<wbr>lens.<wbr>focus<wbr>Distance is controlled by the
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1340 application</span>
1341 </li>
1342 <li>
1343 <span class="entry_type_enum_name">AUTO</span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1344 <span class="entry_type_enum_notes">if lens is not fixed focus.<wbr>
1345
1346 Use android.<wbr>lens.<wbr>minimum<wbr>Focus<wbr>Distance to determine if lens
1347 is fixed focus In this mode,<wbr> the lens does not move unless
1348 the autofocus trigger action is called.<wbr> When that trigger
1349 is activated,<wbr> AF must transition to ACTIVE_<wbr>SCAN,<wbr> then to
1350 the outcome of the scan (FOCUSED or
1351 NOT_<wbr>FOCUSED).<wbr>
1352
1353 Triggering cancel AF resets the lens position to default,<wbr>
1354 and sets the AF state to INACTIVE.<wbr></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1355 </li>
1356 <li>
1357 <span class="entry_type_enum_name">MACRO</span>
1358 <span class="entry_type_enum_notes">In this mode,<wbr> the lens does not move unless the
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1359 autofocus trigger action is called.<wbr>
1360
1361 When that trigger is activated,<wbr> AF must transition to
1362 ACTIVE_<wbr>SCAN,<wbr> then to the outcome of the scan (FOCUSED or
1363 NOT_<wbr>FOCUSED).<wbr> Triggering cancel AF resets the lens
1364 position to default,<wbr> and sets the AF state to
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1365 INACTIVE.<wbr></span>
1366 </li>
1367 <li>
1368 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
1369 <span class="entry_type_enum_notes">In this mode,<wbr> the AF algorithm modifies the lens
1370 position continually to attempt to provide a
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1371 constantly-in-focus image stream.<wbr>
1372
1373 The focusing behavior should be suitable for good quality
1374 video recording; typically this means slower focus
1375 movement and no overshoots.<wbr> When the AF trigger is not
1376 involved,<wbr> the AF algorithm should start in INACTIVE state,<wbr>
1377 and then transition into PASSIVE_<wbr>SCAN and PASSIVE_<wbr>FOCUSED
1378 states as appropriate.<wbr> When the AF trigger is activated,<wbr>
1379 the algorithm should immediately transition into
1380 AF_<wbr>FOCUSED or AF_<wbr>NOT_<wbr>FOCUSED as appropriate,<wbr> and lock the
1381 lens position until a cancel AF trigger is received.<wbr>
1382
1383 Once cancel is received,<wbr> the algorithm should transition
1384 back to INACTIVE and resume passive scan.<wbr> Note that this
1385 behavior is not identical to CONTINUOUS_<wbr>PICTURE,<wbr> since an
1386 ongoing PASSIVE_<wbr>SCAN must immediately be
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1387 canceled.<wbr></span>
1388 </li>
1389 <li>
1390 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
1391 <span class="entry_type_enum_notes">In this mode,<wbr> the AF algorithm modifies the lens
1392 position continually to attempt to provide a
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1393 constantly-in-focus image stream.<wbr>
1394
1395 The focusing behavior should be suitable for still image
1396 capture; typically this means focusing as fast as
1397 possible.<wbr> When the AF trigger is not involved,<wbr> the AF
1398 algorithm should start in INACTIVE state,<wbr> and then
1399 transition into PASSIVE_<wbr>SCAN and PASSIVE_<wbr>FOCUSED states as
1400 appropriate as it attempts to maintain focus.<wbr> When the AF
1401 trigger is activated,<wbr> the algorithm should finish its
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1402 PASSIVE_<wbr>SCAN if active,<wbr> and then transition into
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1403 AF_<wbr>FOCUSED or AF_<wbr>NOT_<wbr>FOCUSED as appropriate,<wbr> and lock the
1404 lens position until a cancel AF trigger is received.<wbr>
1405
1406 When the AF cancel trigger is activated,<wbr> the algorithm
1407 should transition back to INACTIVE and then act as if it
1408 has just been started.<wbr></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1409 </li>
1410 <li>
1411 <span class="entry_type_enum_name">EDOF</span>
1412 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr> AF
1413 trigger is ignored,<wbr> AF state should always be
1414 INACTIVE.<wbr></span>
1415 </li>
1416 </ul>
1417
1418 </td> <!-- entry_type -->
1419
1420 <td class="entry_description">
1421 Whether AF is currently enabled,<wbr> and what
1422 mode it is set to
1423 </td>
1424
1425 <td class="entry_units">
1426 </td>
1427
1428 <td class="entry_range">
1429 </td>
1430
1431 <td class="entry_notes">
1432 </td>
1433
1434 <td class="entry_tags">
1435 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1436 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1437 </ul>
1438 </td>
1439
1440 </tr> <!-- end of entry -->
1441
1442
1443 <tr class="entry" id="controls_android.control.afRegions">
1444 <td class="entry_name">android.<wbr>control.<wbr>af<wbr>Regions</td>
1445 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1446 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1447 <span class="entry_type_container">x</span>
1448
1449 <span class="entry_type_array">
1450 5 x area_count
1451 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1452 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1453
1454
1455 </td> <!-- entry_type -->
1456
1457 <td class="entry_description">
1458 List of areas to use for focus
1459 estimation
1460 </td>
1461
1462 <td class="entry_units">
1463 </td>
1464
1465 <td class="entry_range">
1466 </td>
1467
1468 <td class="entry_notes">
1469 Each area is a rectangle plus weight: xmin,<wbr> ymin,<wbr>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1470 xmax,<wbr> ymax,<wbr> weight.<wbr>
1471<br>
1472<br> The coordinate system is based on the active pixel array,<wbr>
1473 with (0,<wbr>0) being the top-left of the active pixel array,<wbr> and
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1474 (android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size.<wbr>width,<wbr>
1475 android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size.<wbr>height) being the
1476 bottom-right point of the active pixel array.<wbr> The weight
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1477 should be nonnegative.<wbr>
1478<br>
1479<br> If all regions have 0 weight,<wbr> then no specific focus area
1480 needs to be used by the HAL.<wbr> If the focusing region is
1481 outside the current android.<wbr>scaler.<wbr>crop<wbr>Region,<wbr> the HAL
1482 should ignore the sections outside the region and output the
1483 used sections in the frame metadata
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1484 </td>
1485
1486 <td class="entry_tags">
1487 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1488 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1489 </ul>
1490 </td>
1491
1492 </tr> <!-- end of entry -->
1493
1494
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1495 <tr class="entry" id="controls_android.control.afTrigger">
1496 <td class="entry_name">android.<wbr>control.<wbr>af<wbr>Trigger</td>
1497 <td class="entry_type">
1498 <span class="entry_type_name entry_type_name_enum">byte</span>
1499
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1500 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1501
1502 <ul class="entry_type_enum">
1503 <li>
1504 <span class="entry_type_enum_name">IDLE</span>
1505 <span class="entry_type_enum_notes">The trigger is idle.<wbr></span>
1506 </li>
1507 <li>
1508 <span class="entry_type_enum_name">START</span>
1509 <span class="entry_type_enum_notes">Autofocus must trigger now.<wbr></span>
1510 </li>
1511 <li>
1512 <span class="entry_type_enum_name">CANCEL</span>
1513 <span class="entry_type_enum_notes">Autofocus must return to initial
1514 state,<wbr> and cancel any active trigger.<wbr></span>
1515 </li>
1516 </ul>
1517
1518 </td> <!-- entry_type -->
1519
1520 <td class="entry_description">
1521 Whether the HAL must trigger autofocus.<wbr>
1522 </td>
1523
1524 <td class="entry_units">
1525 </td>
1526
1527 <td class="entry_range">
1528 </td>
1529
1530 <td class="entry_notes">
1531 This entry is normally set to IDLE,<wbr> or is not
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1532 included at all in the request settings.<wbr>
1533<br>
1534<br> When included and set to START,<wbr> the HAL must trigger the
1535 autofocus algorithm.<wbr> The effect of AF trigger depends on the
1536 current AF mode and state; see the camera HAL device v3
1537 header for details.<wbr> When set to CANCEL,<wbr> the HAL must cancel
1538 any active trigger,<wbr> and return to initial AF state.<wbr>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1539 </td>
1540
1541 <td class="entry_tags">
1542 <ul class="entry_tags">
1543 <li><a href="#tag_BC">BC</a></li>
1544 </ul>
1545 </td>
1546
1547 </tr> <!-- end of entry -->
1548
1549
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1550 <tr class="entry" id="controls_android.control.awbLock">
1551 <td class="entry_name">android.<wbr>control.<wbr>awb<wbr>Lock</td>
1552 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1553 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1554
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]1555 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1556
1557 <ul class="entry_type_enum">
1558 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1559 <span class="entry_type_enum_name">OFF</span>
1560 <span class="entry_type_enum_notes">Auto-whitebalance lock is disabled; the AWB
1561 algorithm is free to update its parameters if in AUTO
1562 mode.<wbr></span>
1563 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1564 <li>
1565 <span class="entry_type_enum_name">ON</span>
1566 <span class="entry_type_enum_notes">Auto-whitebalance lock is enabled; the AWB
1567 algorithm must not update the exposure and sensitivity
1568 parameters while the lock is active</span>
1569 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1570 </ul>
1571
1572 </td> <!-- entry_type -->
1573
1574 <td class="entry_description">
1575 Whether AWB is currently locked to its
1576 latest calculated values
1577 </td>
1578
1579 <td class="entry_units">
1580 </td>
1581
1582 <td class="entry_range">
1583 </td>
1584
1585 <td class="entry_notes">
1586 Note that AWB lock is only meaningful for AUTO
1587 mode; in other modes,<wbr> AWB is already fixed to a specific
1588 setting
1589 </td>
1590
1591 <td class="entry_tags">
1592 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1593 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1594 </ul>
1595 </td>
1596
1597 </tr> <!-- end of entry -->
1598
1599
1600 <tr class="entry" id="controls_android.control.awbMode">
1601 <td class="entry_name">android.<wbr>control.<wbr>awb<wbr>Mode</td>
1602 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1603 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1604
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1605 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1606
1607 <ul class="entry_type_enum">
1608 <li>
1609 <span class="entry_type_enum_name">OFF</span>
1610 </li>
1611 <li>
1612 <span class="entry_type_enum_name">AUTO</span>
1613 </li>
1614 <li>
1615 <span class="entry_type_enum_name">INCANDESCENT</span>
1616 </li>
1617 <li>
1618 <span class="entry_type_enum_name">FLUORESCENT</span>
1619 </li>
1620 <li>
1621 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
1622 </li>
1623 <li>
1624 <span class="entry_type_enum_name">DAYLIGHT</span>
1625 </li>
1626 <li>
1627 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
1628 </li>
1629 <li>
1630 <span class="entry_type_enum_name">TWILIGHT</span>
1631 </li>
1632 <li>
1633 <span class="entry_type_enum_name">SHADE</span>
1634 </li>
1635 </ul>
1636
1637 </td> <!-- entry_type -->
1638
1639 <td class="entry_description">
1640 Whether AWB is currently setting the color
1641 transform fields,<wbr> and what its illumination target
1642 is
1643 </td>
1644
1645 <td class="entry_units">
1646 </td>
1647
1648 <td class="entry_range">
1649 </td>
1650
1651 <td class="entry_notes">
1652 [BC - AWB lock,<wbr>AWB modes]
1653 </td>
1654
1655 <td class="entry_tags">
1656 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1657 <li><a href="#tag_BC">BC</a></li>
1658 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1659 </ul>
1660 </td>
1661
1662 </tr> <!-- end of entry -->
1663
1664
1665 <tr class="entry" id="controls_android.control.awbRegions">
1666 <td class="entry_name">android.<wbr>control.<wbr>awb<wbr>Regions</td>
1667 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1668 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1669 <span class="entry_type_container">x</span>
1670
1671 <span class="entry_type_array">
1672 5 x area_count
1673 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1674 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1675
1676
1677 </td> <!-- entry_type -->
1678
1679 <td class="entry_description">
1680 List of areas to use for illuminant
1681 estimation
1682 </td>
1683
1684 <td class="entry_units">
1685 </td>
1686
1687 <td class="entry_range">
1688 </td>
1689
1690 <td class="entry_notes">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1691 Only used in AUTO mode.<wbr>
1692<br>
1693<br> Each area is a rectangle plus weight: xmin,<wbr> ymin,<wbr> xmax,<wbr>
1694 ymax,<wbr> weight.<wbr> The coordinate system is based on the active
1695 pixel array,<wbr> with (0,<wbr>0) being the top-left of the active
1696 pixel array,<wbr> and (android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size.<wbr>width,<wbr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1697 android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size.<wbr>height) being the
1698 bottom-right point of the active pixel array.<wbr> The weight
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1699 should be nonnegative.<wbr>
1700<br>
1701<br> If all regions have 0 weight,<wbr> then no specific metering area
1702 needs to be used by the HAL.<wbr> If the metering region is
1703 outside the current android.<wbr>scaler.<wbr>crop<wbr>Region,<wbr> the HAL
1704 should ignore the sections outside the region and output the
1705 used sections in the frame metadata
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1706 </td>
1707
1708 <td class="entry_tags">
1709 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1710 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1711 </ul>
1712 </td>
1713
1714 </tr> <!-- end of entry -->
1715
1716
1717 <tr class="entry" id="controls_android.control.captureIntent">
1718 <td class="entry_name">android.<wbr>control.<wbr>capture<wbr>Intent</td>
1719 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1720 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1721
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1722 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1723
1724 <ul class="entry_type_enum">
1725 <li>
1726 <span class="entry_type_enum_name">CUSTOM</span>
1727 <span class="entry_type_enum_notes">This request doesn't fall into the other
1728 categories.<wbr> Default to preview-like
1729 behavior.<wbr></span>
1730 </li>
1731 <li>
1732 <span class="entry_type_enum_name">PREVIEW</span>
1733 <span class="entry_type_enum_notes">This request is for a preview-like usecase.<wbr> The
1734 precapture trigger may be used to start off a metering
1735 w/<wbr>flash sequence</span>
1736 </li>
1737 <li>
1738 <span class="entry_type_enum_name">STILL_CAPTURE</span>
1739 <span class="entry_type_enum_notes">This request is for a still capture-type
1740 usecase.<wbr></span>
1741 </li>
1742 <li>
1743 <span class="entry_type_enum_name">VIDEO_RECORD</span>
1744 <span class="entry_type_enum_notes">This request is for a video recording
1745 usecase.<wbr></span>
1746 </li>
1747 <li>
1748 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
1749 <span class="entry_type_enum_notes">This request is for a video snapshot (still
1750 image while recording video) usecase</span>
1751 </li>
1752 <li>
1753 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
1754 <span class="entry_type_enum_notes">This request is for a ZSL usecase; the
1755 application will stream full-resolution images and
1756 reprocess one or several later for a final
1757 capture</span>
1758 </li>
1759 </ul>
1760
1761 </td> <!-- entry_type -->
1762
1763 <td class="entry_description">
1764 Information to 3A routines about the purpose
1765 of this capture,<wbr> to help decide optimal 3A
1766 strategy
1767 </td>
1768
1769 <td class="entry_units">
1770 </td>
1771
1772 <td class="entry_range">
1773 all must be supported
1774 </td>
1775
1776 <td class="entry_notes">
1777 Only used if android.<wbr>control.<wbr>mode != OFF.<wbr>
1778 </td>
1779
1780 <td class="entry_tags">
1781 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1782 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1783 </ul>
1784 </td>
1785
1786 </tr> <!-- end of entry -->
1787
1788
1789 <tr class="entry" id="controls_android.control.effectMode">
1790 <td class="entry_name">android.<wbr>control.<wbr>effect<wbr>Mode</td>
1791 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1792 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1793
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1794 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1795
1796 <ul class="entry_type_enum">
1797 <li>
1798 <span class="entry_type_enum_name">OFF</span>
1799 </li>
1800 <li>
1801 <span class="entry_type_enum_name">MONO</span>
1802 <span class="entry_type_enum_optional">optional</span>
1803 </li>
1804 <li>
1805 <span class="entry_type_enum_name">NEGATIVE</span>
1806 <span class="entry_type_enum_optional">optional</span>
1807 </li>
1808 <li>
1809 <span class="entry_type_enum_name">SOLARIZE</span>
1810 <span class="entry_type_enum_optional">optional</span>
1811 </li>
1812 <li>
1813 <span class="entry_type_enum_name">SEPIA</span>
1814 <span class="entry_type_enum_optional">optional</span>
1815 </li>
1816 <li>
1817 <span class="entry_type_enum_name">POSTERIZE</span>
1818 <span class="entry_type_enum_optional">optional</span>
1819 </li>
1820 <li>
1821 <span class="entry_type_enum_name">WHITEBOARD</span>
1822 <span class="entry_type_enum_optional">optional</span>
1823 </li>
1824 <li>
1825 <span class="entry_type_enum_name">BLACKBOARD</span>
1826 <span class="entry_type_enum_optional">optional</span>
1827 </li>
1828 <li>
1829 <span class="entry_type_enum_name">AQUA</span>
1830 <span class="entry_type_enum_optional">optional</span>
1831 </li>
1832 </ul>
1833
1834 </td> <!-- entry_type -->
1835
1836 <td class="entry_description">
1837 Whether any special color effect is in use.<wbr>
1838 Only used if android.<wbr>control.<wbr>mode != OFF
1839 </td>
1840
1841 <td class="entry_units">
1842 </td>
1843
1844 <td class="entry_range">
1845 android.<wbr>control.<wbr>available<wbr>Effects
1846 </td>
1847
1848 <td class="entry_notes">
1849 </td>
1850
1851 <td class="entry_tags">
1852 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1853 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1854 </ul>
1855 </td>
1856
1857 </tr> <!-- end of entry -->
1858
1859
1860 <tr class="entry" id="controls_android.control.mode">
1861 <td class="entry_name">android.<wbr>control.<wbr>mode</td>
1862 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1863 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1864
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1865 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1866
1867 <ul class="entry_type_enum">
1868 <li>
1869 <span class="entry_type_enum_name">OFF</span>
1870 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr> All 3A
1871 routines are disabled,<wbr> no other settings in
1872 android.<wbr>control.<wbr>* have any effect</span>
1873 </li>
1874 <li>
1875 <span class="entry_type_enum_name">AUTO</span>
1876 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr>
1877 Manual control of capture parameters is disabled.<wbr> All
1878 controls in android.<wbr>control.<wbr>* besides sceneMode take
1879 effect</span>
1880 </li>
1881 <li>
1882 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
1883 <span class="entry_type_enum_notes">Use specific scene mode.<wbr> Enabling this disables
1884 control.<wbr>aeMode,<wbr> control.<wbr>awbMode and control.<wbr>afMode
1885 controls; the HAL must ignore those settings while
1886 USE_<wbr>SCENE_<wbr>MODE is active (except for FACE_<wbr>PRIORITY
1887 scene mode).<wbr> Other control entries are still active.<wbr>
1888 This setting can only be used if availableSceneModes !=
1889 UNSUPPORTED</span>
1890 </li>
1891 </ul>
1892
1893 </td> <!-- entry_type -->
1894
1895 <td class="entry_description">
1896 Overall mode of 3A control
1897 routines
1898 </td>
1899
1900 <td class="entry_units">
1901 </td>
1902
1903 <td class="entry_range">
1904 all must be supported
1905 </td>
1906
1907 <td class="entry_notes">
1908 </td>
1909
1910 <td class="entry_tags">
1911 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1912 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1913 </ul>
1914 </td>
1915
1916 </tr> <!-- end of entry -->
1917
1918
1919 <tr class="entry" id="controls_android.control.sceneMode">
1920 <td class="entry_name">android.<wbr>control.<wbr>scene<wbr>Mode</td>
1921 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1922 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1923
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1924 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1925
1926 <ul class="entry_type_enum">
1927 <li>
1928 <span class="entry_type_enum_name">UNSUPPORTED</span>
1929 <span class="entry_type_enum_value">0</span>
1930 </li>
1931 <li>
1932 <span class="entry_type_enum_name">FACE_PRIORITY</span>
1933 <span class="entry_type_enum_notes">if face detection support exists Use face
1934 detection data to drive 3A routines.<wbr> If face detection
1935 statistics are disabled,<wbr> should still operate correctly
1936 (but not return face detection statistics to the
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1937 framework).<wbr>
1938
1939 Unlike the other scene modes,<wbr> aeMode,<wbr> awbMode,<wbr> and afMode
1940 remain active when FACE_<wbr>PRIORITY is set.<wbr> This is due to
1941 compatibility concerns with the old camera
1942 API</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1943 </li>
1944 <li>
1945 <span class="entry_type_enum_name">ACTION</span>
1946 <span class="entry_type_enum_optional">optional</span>
1947 </li>
1948 <li>
1949 <span class="entry_type_enum_name">PORTRAIT</span>
1950 <span class="entry_type_enum_optional">optional</span>
1951 </li>
1952 <li>
1953 <span class="entry_type_enum_name">LANDSCAPE</span>
1954 <span class="entry_type_enum_optional">optional</span>
1955 </li>
1956 <li>
1957 <span class="entry_type_enum_name">NIGHT</span>
1958 <span class="entry_type_enum_optional">optional</span>
1959 </li>
1960 <li>
1961 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
1962 <span class="entry_type_enum_optional">optional</span>
1963 </li>
1964 <li>
1965 <span class="entry_type_enum_name">THEATRE</span>
1966 <span class="entry_type_enum_optional">optional</span>
1967 </li>
1968 <li>
1969 <span class="entry_type_enum_name">BEACH</span>
1970 <span class="entry_type_enum_optional">optional</span>
1971 </li>
1972 <li>
1973 <span class="entry_type_enum_name">SNOW</span>
1974 <span class="entry_type_enum_optional">optional</span>
1975 </li>
1976 <li>
1977 <span class="entry_type_enum_name">SUNSET</span>
1978 <span class="entry_type_enum_optional">optional</span>
1979 </li>
1980 <li>
1981 <span class="entry_type_enum_name">STEADYPHOTO</span>
1982 <span class="entry_type_enum_optional">optional</span>
1983 </li>
1984 <li>
1985 <span class="entry_type_enum_name">FIREWORKS</span>
1986 <span class="entry_type_enum_optional">optional</span>
1987 </li>
1988 <li>
1989 <span class="entry_type_enum_name">SPORTS</span>
1990 <span class="entry_type_enum_optional">optional</span>
1991 </li>
1992 <li>
1993 <span class="entry_type_enum_name">PARTY</span>
1994 <span class="entry_type_enum_optional">optional</span>
1995 </li>
1996 <li>
1997 <span class="entry_type_enum_name">CANDLELIGHT</span>
1998 <span class="entry_type_enum_optional">optional</span>
1999 </li>
2000 <li>
2001 <span class="entry_type_enum_name">BARCODE</span>
2002 <span class="entry_type_enum_optional">optional</span>
2003 </li>
2004 </ul>
2005
2006 </td> <!-- entry_type -->
2007
2008 <td class="entry_description">
2009 Which scene mode is active when
2010 android.<wbr>control.<wbr>mode = SCENE_<wbr>MODE
2011 </td>
2012
2013 <td class="entry_units">
2014 </td>
2015
2016 <td class="entry_range">
2017 android.<wbr>control.<wbr>available<wbr>Scene<wbr>Modes
2018 </td>
2019
2020 <td class="entry_notes">
2021 </td>
2022
2023 <td class="entry_tags">
2024 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2025 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2026 </ul>
2027 </td>
2028
2029 </tr> <!-- end of entry -->
2030
2031
2032 <tr class="entry" id="controls_android.control.videoStabilizationMode">
2033 <td class="entry_name">android.<wbr>control.<wbr>video<wbr>Stabilization<wbr>Mode</td>
2034 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2035 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2036
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]2037 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2038
2039 <ul class="entry_type_enum">
2040 <li>
2041 <span class="entry_type_enum_name">OFF</span>
2042 </li>
2043 <li>
2044 <span class="entry_type_enum_name">ON</span>
2045 </li>
2046 </ul>
2047
2048 </td> <!-- entry_type -->
2049
2050 <td class="entry_description">
2051 Whether video stabilization is
2052 active
2053 </td>
2054
2055 <td class="entry_units">
2056 </td>
2057
2058 <td class="entry_range">
2059 </td>
2060
2061 <td class="entry_notes">
2062 If enabled,<wbr> video stabilization can modify the
2063 android.<wbr>scaler.<wbr>crop<wbr>Region to keep the video stream
2064 stabilized
2065 </td>
2066
2067 <td class="entry_tags">
2068 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2069 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2070 </ul>
2071 </td>
2072
2073 </tr> <!-- end of entry -->
2074
2075
2076
2077 <!-- end of kind -->
2078 </tbody>
2079 <tr><td colspan="7" class="kind">static</td></tr>
2080
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2081 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2082 <tr>
2083 <th class="th_name">Property Name</th>
2084 <th class="th_type">Type</th>
2085 <th class="th_description">Description</th>
2086 <th class="th_units">Units</th>
2087 <th class="th_range">Range</th>
2088 <th class="th_notes">Notes</th>
2089 <th class="th_tags">Tags</th>
2090 </tr>
2091 </thead>
2092
2093 <tbody>
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
2105 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Available<wbr>Antibanding<wbr>Modes</td>
2106 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2107 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2108 <span class="entry_type_container">x</span>
2109
2110 <span class="entry_type_array">
2111 n
2112 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2113 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2114 <div class="entry_type_notes">list of enums</div>
2115
2116
2117 </td> <!-- entry_type -->
2118
2119 <td class="entry_description">
2120 Which set of antibanding modes are
2121 supported
2122 </td>
2123
2124 <td class="entry_units">
2125 </td>
2126
2127 <td class="entry_range">
2128 </td>
2129
2130 <td class="entry_notes">
2131 </td>
2132
2133 <td class="entry_tags">
2134 </td>
2135
2136 </tr> <!-- end of entry -->
2137
2138
2139 <tr class="entry" id="static_android.control.aeAvailableModes">
2140 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Available<wbr>Modes</td>
2141 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2142 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2143 <span class="entry_type_container">x</span>
2144
2145 <span class="entry_type_array">
2146 n
2147 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2148 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2149 <div class="entry_type_notes">list of enums</div>
2150
2151
2152 </td> <!-- entry_type -->
2153
2154 <td class="entry_description">
2155 Which subset of AE modes is
2156 supported
2157 </td>
2158
2159 <td class="entry_units">
2160 </td>
2161
2162 <td class="entry_range">
2163 OFF,<wbr> ON must be supported.<wbr>
2164 ON_<wbr>AUTO_<wbr>FLASH/<wbr>ON_<wbr>ALWAYS_<wbr>FLASH must be supported if flash
2165 unit is available
2166 </td>
2167
2168 <td class="entry_notes">
2169 </td>
2170
2171 <td class="entry_tags">
2172 </td>
2173
2174 </tr> <!-- end of entry -->
2175
2176
2177 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
2178 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Available<wbr>Target<wbr>Fps<wbr>Ranges</td>
2179 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2180 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2181 <span class="entry_type_container">x</span>
2182
2183 <span class="entry_type_array">
2184 2 x n
2185 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2186 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2187 <div class="entry_type_notes">list of pairs of frame rates</div>
2188
2189
2190 </td> <!-- entry_type -->
2191
2192 <td class="entry_description">
2193 List of frame rate ranges supported by the
2194 AE algorithm/<wbr>hardware
2195 </td>
2196
2197 <td class="entry_units">
2198 </td>
2199
2200 <td class="entry_range">
2201 </td>
2202
2203 <td class="entry_notes">
2204 </td>
2205
2206 <td class="entry_tags">
2207 </td>
2208
2209 </tr> <!-- end of entry -->
2210
2211
2212 <tr class="entry" id="static_android.control.aeCompensationRange">
2213 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Compensation<wbr>Range</td>
2214 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2215 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2216 <span class="entry_type_container">x</span>
2217
2218 <span class="entry_type_array">
2219 2
2220 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2221 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2222
2223
2224 </td> <!-- entry_type -->
2225
2226 <td class="entry_description">
2227 Maximum and minimum exposure compensation
2228 setting,<wbr> in counts of
2229 android.<wbr>control.<wbr>ae<wbr>Compensation<wbr>Step<wbr>Size
2230 </td>
2231
2232 <td class="entry_units">
2233 </td>
2234
2235 <td class="entry_range">
2236 At least (-2,<wbr>2)/<wbr>(exp compensation step
2237 size)
2238 </td>
2239
2240 <td class="entry_notes">
2241 </td>
2242
2243 <td class="entry_tags">
2244 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2245 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2246 </ul>
2247 </td>
2248
2249 </tr> <!-- end of entry -->
2250
2251
2252 <tr class="entry" id="static_android.control.aeCompensationStep">
2253 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Compensation<wbr>Step</td>
2254 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2255 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2256
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2257 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2258
2259
2260 </td> <!-- entry_type -->
2261
2262 <td class="entry_description">
2263 Smallest step by which exposure compensation
2264 can be changed
2265 </td>
2266
2267 <td class="entry_units">
2268 </td>
2269
2270 <td class="entry_range">
2271 <= 1/<wbr>2
2272 </td>
2273
2274 <td class="entry_notes">
2275 </td>
2276
2277 <td class="entry_tags">
2278 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2279 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2280 </ul>
2281 </td>
2282
2283 </tr> <!-- end of entry -->
2284
2285
2286 <tr class="entry" id="static_android.control.afAvailableModes">
2287 <td class="entry_name">android.<wbr>control.<wbr>af<wbr>Available<wbr>Modes</td>
2288 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2289 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2290 <span class="entry_type_container">x</span>
2291
2292 <span class="entry_type_array">
2293 n
2294 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2295 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2296 <div class="entry_type_notes">List of enums</div>
2297
2298
2299 </td> <!-- entry_type -->
2300
2301 <td class="entry_description">
2302 List of AF modes that can be
2303 selected
2304 </td>
2305
2306 <td class="entry_units">
2307 </td>
2308
2309 <td class="entry_range">
2310 OFF must be included.<wbr> AUTO must be supported if
2311 lens allows for changing focus
2312 </td>
2313
2314 <td class="entry_notes">
2315 </td>
2316
2317 <td class="entry_tags">
2318 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2319 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2320 </ul>
2321 </td>
2322
2323 </tr> <!-- end of entry -->
2324
2325
2326 <tr class="entry" id="static_android.control.availableEffects">
2327 <td class="entry_name">android.<wbr>control.<wbr>available<wbr>Effects</td>
2328 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2329 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2330 <span class="entry_type_container">x</span>
2331
2332 <span class="entry_type_array">
2333 n
2334 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2335 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2336 <div class="entry_type_notes">list of enums</div>
2337
2338
2339 </td> <!-- entry_type -->
2340
2341 <td class="entry_description">
2342 what subset of the full color effect enum
2343 list is supported
2344 </td>
2345
2346 <td class="entry_units">
2347 </td>
2348
2349 <td class="entry_range">
2350 OFF must be listed
2351 </td>
2352
2353 <td class="entry_notes">
2354 </td>
2355
2356 <td class="entry_tags">
2357 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2358 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2359 </ul>
2360 </td>
2361
2362 </tr> <!-- end of entry -->
2363
2364
2365 <tr class="entry" id="static_android.control.availableSceneModes">
2366 <td class="entry_name">android.<wbr>control.<wbr>available<wbr>Scene<wbr>Modes</td>
2367 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2368 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2369 <span class="entry_type_container">x</span>
2370
2371 <span class="entry_type_array">
2372 n
2373 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2374 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2375 <div class="entry_type_notes">list of enums from android.<wbr>control.<wbr>scene<wbr>Mode,<wbr> plus UNSUPPORTED to indicate no scene modes are supported</div>
2376
2377
2378 </td> <!-- entry_type -->
2379
2380 <td class="entry_description">
2381 what subset of the scene mode enum list is
2382 supported.<wbr>
2383 </td>
2384
2385 <td class="entry_units">
2386 </td>
2387
2388 <td class="entry_range">
2389 SCENE_<wbr>MODE_<wbr>FACE_<wbr>PRIORITY must be supported if face
2390 detection is supported
2391 </td>
2392
2393 <td class="entry_notes">
2394 </td>
2395
2396 <td class="entry_tags">
2397 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2398 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2399 </ul>
2400 </td>
2401
2402 </tr> <!-- end of entry -->
2403
2404
2405 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
2406 <td class="entry_name">android.<wbr>control.<wbr>available<wbr>Video<wbr>Stabilization<wbr>Modes</td>
2407 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2408 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2409 <span class="entry_type_container">x</span>
2410
2411 <span class="entry_type_array">
2412 n
2413 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2414 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2415 <div class="entry_type_notes">List of enums.<wbr></div>
2416
2417
2418 </td> <!-- entry_type -->
2419
2420 <td class="entry_description">
2421 List of video stabilization modes that can
2422 be supported
2423 </td>
2424
2425 <td class="entry_units">
2426 </td>
2427
2428 <td class="entry_range">
2429 OFF must be included
2430 </td>
2431
2432 <td class="entry_notes">
2433 </td>
2434
2435 <td class="entry_tags">
2436 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2437 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2438 </ul>
2439 </td>
2440
2441 </tr> <!-- end of entry -->
2442
2443
2444 <tr class="entry" id="static_android.control.awbAvailableModes">
2445 <td class="entry_name">android.<wbr>control.<wbr>awb<wbr>Available<wbr>Modes</td>
2446 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2447 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2448 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2449
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2450 <span class="entry_type_array">
2451 n
2452 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2453 <span class="entry_type_visibility"> [public]</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2454 <div class="entry_type_notes">List of enums (android.<wbr>control.<wbr>awb<wbr>Mode)</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2455
2456
2457 </td> <!-- entry_type -->
2458
2459 <td class="entry_description">
2460 </td>
2461
2462 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2463 </td>
2464
2465 <td class="entry_range">
2466 OFF,<wbr> AUTO must be included
2467 </td>
2468
2469 <td class="entry_notes">
2470 </td>
2471
2472 <td class="entry_tags">
2473 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2474 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2475 </ul>
2476 </td>
2477
2478 </tr> <!-- end of entry -->
2479
2480
2481 <tr class="entry" id="static_android.control.maxRegions">
2482 <td class="entry_name">android.<wbr>control.<wbr>max<wbr>Regions</td>
2483 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2484 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2485
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2486 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2487
2488
2489 </td> <!-- entry_type -->
2490
2491 <td class="entry_description">
2492 For AE,<wbr> AWB,<wbr> and AF,<wbr> how many individual
2493 regions can be listed for metering?
2494 </td>
2495
2496 <td class="entry_units">
2497 </td>
2498
2499 <td class="entry_range">
2500 >= 1
2501 </td>
2502
2503 <td class="entry_notes">
2504 </td>
2505
2506 <td class="entry_tags">
2507 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2508 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2509 </ul>
2510 </td>
2511
2512 </tr> <!-- end of entry -->
2513
2514
2515 <tr class="entry" id="static_android.control.sceneModeOverrides">
2516 <td class="entry_name">android.<wbr>control.<wbr>scene<wbr>Mode<wbr>Overrides</td>
2517 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2518 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2519 <span class="entry_type_container">x</span>
2520
2521 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2522 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2523 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2524 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2525
2526
2527 </td> <!-- entry_type -->
2528
2529 <td class="entry_description">
2530 List of AE,<wbr> AWB,<wbr> and AF modes to use for
2531 each available scene mode
2532 </td>
2533
2534 <td class="entry_units">
2535 </td>
2536
2537 <td class="entry_range">
2538 For each listed scene mode,<wbr> lists the aeMode,<wbr>
2539 awbMode,<wbr> and afMode that the HAL wants to use for that
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2540 scene mode.<wbr>
2541
2542 For each entry,<wbr> the order is {aeMode,<wbr> awbMode,<wbr> afMode} in
2543 order of increasing index
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2544 </td>
2545
2546 <td class="entry_notes">
2547 When a scene mode is enabled,<wbr> the HAL is expected
2548 to override aeMode,<wbr> awbMode,<wbr> and afMode with its
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2549 preferred settings for that scene mode.<wbr>
2550<br>
2551<br> To simplify communication with old camera API applications,<wbr>
2552 the service wants this override list in the static metadata.<wbr>
2553 The order of this list matches that of availableSceneModes,<wbr>
2554 with 3 entires for each scene mode.<wbr> The overrides listed
2555 for SCENE_<wbr>MODE_<wbr>FACE_<wbr>PRIORITY are ignored,<wbr> since for that
2556 mode,<wbr> the application-set aeMode,<wbr> awbMode,<wbr> and afMode are
2557 used instead,<wbr> like they are when android.<wbr>control.<wbr>mode is
2558 AUTO.<wbr>
2559<br>
2560<br> It is recommended that for FACE_<wbr>PRIORITY,<wbr> the overrides
2561 should be set to 0.<wbr> As an example,<wbr> if availableSceneModes is
2562 { FACE_<wbr>PRIORITY,<wbr> ACTION,<wbr> NIGHT },<wbr> then the service expects
2563 this field to have 9 entries; for example { 0 ,<wbr> 0,<wbr> 0,<wbr>
2564 ON_<wbr>AUTO_<wbr>FLASH,<wbr> AUTO,<wbr> CONTINUOUS_<wbr>PICTURE,<wbr> ON_<wbr>AUTO_<wbr>FLASH,<wbr>
2565 INCANDESCENT,<wbr> AUTO }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2566 </td>
2567
2568 <td class="entry_tags">
2569 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2570 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2571 </ul>
2572 </td>
2573
2574 </tr> <!-- end of entry -->
2575
2576
2577
2578 <!-- end of kind -->
2579 </tbody>
2580 <tr><td colspan="7" class="kind">dynamic</td></tr>
2581
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2582 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2583 <tr>
2584 <th class="th_name">Property Name</th>
2585 <th class="th_type">Type</th>
2586 <th class="th_description">Description</th>
2587 <th class="th_units">Units</th>
2588 <th class="th_range">Range</th>
2589 <th class="th_notes">Notes</th>
2590 <th class="th_tags">Tags</th>
2591 </tr>
2592 </thead>
2593
2594 <tbody>
2595
2596
2597
2598
2599
2600
2601
2602
2603
2604
2605 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
2606 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Precapture<wbr>Id</td>
2607 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2608 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2609
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2610 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2611
2612
2613 </td> <!-- entry_type -->
2614
2615 <td class="entry_description">
2616 The ID sent with the latest
2617 CAMERA2_<wbr>TRIGGER_<wbr>PRECAPTURE_<wbr>METERING call
2618 </td>
2619
2620 <td class="entry_units">
2621 </td>
2622
2623 <td class="entry_range">
2624 </td>
2625
2626 <td class="entry_notes">
2627 Must be 0 if no
2628 CAMERA2_<wbr>TRIGGER_<wbr>PRECAPTURE_<wbr>METERING trigger received yet
2629 by HAL.<wbr> Always updated even if AE algorithm ignores the
2630 trigger
2631 </td>
2632
2633 <td class="entry_tags">
2634 </td>
2635
2636 </tr> <!-- end of entry -->
2637
2638
2639 <tr class="entry" id="dynamic_android.control.aeRegions">
2640 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>Regions</td>
2641 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2642 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2643 <span class="entry_type_container">x</span>
2644
2645 <span class="entry_type_array">
2646 5 x area_count
2647 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2648 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2649
2650
2651 </td> <!-- entry_type -->
2652
2653 <td class="entry_description">
2654 List of areas to use for
2655 metering
2656 </td>
2657
2658 <td class="entry_units">
2659 </td>
2660
2661 <td class="entry_range">
2662 </td>
2663
2664 <td class="entry_notes">
2665 Each area is a rectangle plus weight: xmin,<wbr> ymin,<wbr>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2666 xmax,<wbr> ymax,<wbr> weight.<wbr>
2667<br>
2668<br> The coordinate system is based on the active pixel array,<wbr>
2669 with (0,<wbr>0) being the top-left of the active pixel array,<wbr> and
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2670 (android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size.<wbr>width,<wbr>
2671 android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size.<wbr>height) being the
2672 bottom-right point of the active pixel array.<wbr> The weight
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2673 should be nonnegative.<wbr>
2674<br>
2675<br> If all regions have 0 weight,<wbr> then no specific metering area
2676 needs to be used by the HAL.<wbr> If the metering region is
2677 outside the current android.<wbr>scaler.<wbr>crop<wbr>Region,<wbr> the HAL
2678 should ignore the sections outside the region and output the
2679 used sections in the frame metadata
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2680 </td>
2681
2682 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2683 <ul class="entry_tags">
2684 <li><a href="#tag_BC">BC</a></li>
2685 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2686 </td>
2687
2688 </tr> <!-- end of entry -->
2689
2690
2691 <tr class="entry" id="dynamic_android.control.aeState">
2692 <td class="entry_name">android.<wbr>control.<wbr>ae<wbr>State</td>
2693 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2694 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2695
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2696 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2697
2698 <ul class="entry_type_enum">
2699 <li>
2700 <span class="entry_type_enum_name">INACTIVE</span>
Alex Ray7aeb05e2013-03-27 16:26:41 -0700[diff] [blame]2701 <span class="entry_type_enum_notes">AE is off.<wbr> When a camera device is opened,<wbr> it starts in
2702 this state.<wbr></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2703 </li>
2704 <li>
2705 <span class="entry_type_enum_name">SEARCHING</span>
2706 <span class="entry_type_enum_notes">AE doesn't yet have a good set of control values
2707 for the current scene</span>
2708 </li>
2709 <li>
2710 <span class="entry_type_enum_name">CONVERGED</span>
2711 <span class="entry_type_enum_notes">AE has a good set of control values for the
2712 current scene</span>
2713 </li>
2714 <li>
2715 <span class="entry_type_enum_name">LOCKED</span>
2716 <span class="entry_type_enum_notes">AE has been locked (aeMode =
2717 LOCKED)</span>
2718 </li>
2719 <li>
2720 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
2721 <span class="entry_type_enum_notes">AE has a good set of control values,<wbr> but flash
2722 needs to be fired for good quality still
2723 capture</span>
2724 </li>
2725 <li>
2726 <span class="entry_type_enum_name">PRECAPTURE</span>
2727 <span class="entry_type_enum_notes">AE has been asked to do a precapture sequence
2728 (through the
2729 trigger_<wbr>action(CAMERA2_<wbr>TRIGGER_<wbr>PRECAPTURE_<wbr>METERING)
2730 call),<wbr> and is currently executing it.<wbr> Once PRECAPTURE
2731 completes,<wbr> AE will transition to CONVERGED or
2732 FLASH_<wbr>REQUIRED as appropriate</span>
2733 </li>
2734 </ul>
2735
2736 </td> <!-- entry_type -->
2737
2738 <td class="entry_description">
2739 Current state of AE algorithm
2740 </td>
2741
2742 <td class="entry_units">
2743 </td>
2744
2745 <td class="entry_range">
2746 </td>
2747
2748 <td class="entry_notes">
2749 Whenever the AE algorithm state changes,<wbr> a
2750 MSG_<wbr>AUTOEXPOSURE notification must be send if a
2751 notification callback is registered.<wbr>
2752 </td>
2753
2754 <td class="entry_tags">
2755 </td>
2756
2757 </tr> <!-- end of entry -->
2758
2759
2760 <tr class="entry" id="dynamic_android.control.afMode">
2761 <td class="entry_name">android.<wbr>control.<wbr>af<wbr>Mode</td>
2762 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2763 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2764
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2765 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2766
2767 <ul class="entry_type_enum">
2768 <li>
2769 <span class="entry_type_enum_name">OFF</span>
2770 <span class="entry_type_enum_notes">The 3A routines do not control the lens;
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]2771 android.<wbr>lens.<wbr>focus<wbr>Distance is controlled by the
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2772 application</span>
2773 </li>
2774 <li>
2775 <span class="entry_type_enum_name">AUTO</span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2776 <span class="entry_type_enum_notes">if lens is not fixed focus.<wbr>
2777
2778 Use android.<wbr>lens.<wbr>minimum<wbr>Focus<wbr>Distance to determine if lens
2779 is fixed focus In this mode,<wbr> the lens does not move unless
2780 the autofocus trigger action is called.<wbr> When that trigger
2781 is activated,<wbr> AF must transition to ACTIVE_<wbr>SCAN,<wbr> then to
2782 the outcome of the scan (FOCUSED or
2783 NOT_<wbr>FOCUSED).<wbr>
2784
2785 Triggering cancel AF resets the lens position to default,<wbr>
2786 and sets the AF state to INACTIVE.<wbr></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2787 </li>
2788 <li>
2789 <span class="entry_type_enum_name">MACRO</span>
2790 <span class="entry_type_enum_notes">In this mode,<wbr> the lens does not move unless the
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2791 autofocus trigger action is called.<wbr>
2792
2793 When that trigger is activated,<wbr> AF must transition to
2794 ACTIVE_<wbr>SCAN,<wbr> then to the outcome of the scan (FOCUSED or
2795 NOT_<wbr>FOCUSED).<wbr> Triggering cancel AF resets the lens
2796 position to default,<wbr> and sets the AF state to
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2797 INACTIVE.<wbr></span>
2798 </li>
2799 <li>
2800 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
2801 <span class="entry_type_enum_notes">In this mode,<wbr> the AF algorithm modifies the lens
2802 position continually to attempt to provide a
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2803 constantly-in-focus image stream.<wbr>
2804
2805 The focusing behavior should be suitable for good quality
2806 video recording; typically this means slower focus
2807 movement and no overshoots.<wbr> When the AF trigger is not
2808 involved,<wbr> the AF algorithm should start in INACTIVE state,<wbr>
2809 and then transition into PASSIVE_<wbr>SCAN and PASSIVE_<wbr>FOCUSED
2810 states as appropriate.<wbr> When the AF trigger is activated,<wbr>
2811 the algorithm should immediately transition into
2812 AF_<wbr>FOCUSED or AF_<wbr>NOT_<wbr>FOCUSED as appropriate,<wbr> and lock the
2813 lens position until a cancel AF trigger is received.<wbr>
2814
2815 Once cancel is received,<wbr> the algorithm should transition
2816 back to INACTIVE and resume passive scan.<wbr> Note that this
2817 behavior is not identical to CONTINUOUS_<wbr>PICTURE,<wbr> since an
2818 ongoing PASSIVE_<wbr>SCAN must immediately be
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2819 canceled.<wbr></span>
2820 </li>
2821 <li>
2822 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
2823 <span class="entry_type_enum_notes">In this mode,<wbr> the AF algorithm modifies the lens
2824 position continually to attempt to provide a
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2825 constantly-in-focus image stream.<wbr>
2826
2827 The focusing behavior should be suitable for still image
2828 capture; typically this means focusing as fast as
2829 possible.<wbr> When the AF trigger is not involved,<wbr> the AF
2830 algorithm should start in INACTIVE state,<wbr> and then
2831 transition into PASSIVE_<wbr>SCAN and PASSIVE_<wbr>FOCUSED states as
2832 appropriate as it attempts to maintain focus.<wbr> When the AF
2833 trigger is activated,<wbr> the algorithm should finish its
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2834 PASSIVE_<wbr>SCAN if active,<wbr> and then transition into
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2835 AF_<wbr>FOCUSED or AF_<wbr>NOT_<wbr>FOCUSED as appropriate,<wbr> and lock the
2836 lens position until a cancel AF trigger is received.<wbr>
2837
2838 When the AF cancel trigger is activated,<wbr> the algorithm
2839 should transition back to INACTIVE and then act as if it
2840 has just been started.<wbr></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2841 </li>
2842 <li>
2843 <span class="entry_type_enum_name">EDOF</span>
2844 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr> AF
2845 trigger is ignored,<wbr> AF state should always be
2846 INACTIVE.<wbr></span>
2847 </li>
2848 </ul>
2849
2850 </td> <!-- entry_type -->
2851
2852 <td class="entry_description">
2853 Whether AF is currently enabled,<wbr> and what
2854 mode it is set to
2855 </td>
2856
2857 <td class="entry_units">
2858 </td>
2859
2860 <td class="entry_range">
2861 </td>
2862
2863 <td class="entry_notes">
2864 </td>
2865
2866 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2867 <ul class="entry_tags">
2868 <li><a href="#tag_BC">BC</a></li>
2869 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2870 </td>
2871
2872 </tr> <!-- end of entry -->
2873
2874
2875 <tr class="entry" id="dynamic_android.control.afRegions">
2876 <td class="entry_name">android.<wbr>control.<wbr>af<wbr>Regions</td>
2877 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2878 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2879 <span class="entry_type_container">x</span>
2880
2881 <span class="entry_type_array">
2882 5 x area_count
2883 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2884 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2885
2886
2887 </td> <!-- entry_type -->
2888
2889 <td class="entry_description">
2890 List of areas to use for focus
2891 estimation
2892 </td>
2893
2894 <td class="entry_units">
2895 </td>
2896
2897 <td class="entry_range">
2898 </td>
2899
2900 <td class="entry_notes">
2901 Each area is a rectangle plus weight: xmin,<wbr> ymin,<wbr>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2902 xmax,<wbr> ymax,<wbr> weight.<wbr>
2903<br>
2904<br> The coordinate system is based on the active pixel array,<wbr>
2905 with (0,<wbr>0) being the top-left of the active pixel array,<wbr> and
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2906 (android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size.<wbr>width,<wbr>
2907 android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size.<wbr>height) being the
2908 bottom-right point of the active pixel array.<wbr> The weight
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2909 should be nonnegative.<wbr>
2910<br>
2911<br> If all regions have 0 weight,<wbr> then no specific focus area
2912 needs to be used by the HAL.<wbr> If the focusing region is
2913 outside the current android.<wbr>scaler.<wbr>crop<wbr>Region,<wbr> the HAL
2914 should ignore the sections outside the region and output the
2915 used sections in the frame metadata
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2916 </td>
2917
2918 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2919 <ul class="entry_tags">
2920 <li><a href="#tag_BC">BC</a></li>
2921 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2922 </td>
2923
2924 </tr> <!-- end of entry -->
2925
2926
2927 <tr class="entry" id="dynamic_android.control.afState">
2928 <td class="entry_name">android.<wbr>control.<wbr>af<wbr>State</td>
2929 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2930 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2931
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2932 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2933
2934 <ul class="entry_type_enum">
2935 <li>
2936 <span class="entry_type_enum_name">INACTIVE</span>
2937 <span class="entry_type_enum_notes">AF off or has not yet tried to scan/<wbr>been asked
Alex Ray7aeb05e2013-03-27 16:26:41 -0700[diff] [blame]2938 to scan.<wbr> When a camera device is opened,<wbr> it starts in
2939 this state.<wbr></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2940 </li>
2941 <li>
2942 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
2943 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr>* modes are supported AF is
2944 currently doing an AF scan initiated by a continuous
2945 autofocus mode</span>
2946 </li>
2947 <li>
2948 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
2949 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr>* modes are supported AF currently
2950 believes it is in focus,<wbr> but may restart scanning at
2951 any time.<wbr></span>
2952 </li>
2953 <li>
2954 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
2955 <span class="entry_type_enum_notes">if AUTO or MACRO modes are supported AF is doing
2956 an AF scan because it was triggered by AF
2957 trigger</span>
2958 </li>
2959 <li>
2960 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
2961 <span class="entry_type_enum_notes">if any AF mode besides OFF is supported AF
2962 believes it is focused correctly and is
2963 locked</span>
2964 </li>
2965 <li>
2966 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
2967 <span class="entry_type_enum_notes">if any AF mode besides OFF is supported AF has
2968 failed to focus successfully and is
2969 locked</span>
2970 </li>
2971 </ul>
2972
2973 </td> <!-- entry_type -->
2974
2975 <td class="entry_description">
2976 Current state of AF algorithm
2977 </td>
2978
2979 <td class="entry_units">
2980 </td>
2981
2982 <td class="entry_range">
2983 </td>
2984
2985 <td class="entry_notes">
2986 Whenever the AF algorithm state changes,<wbr> a
2987 MSG_<wbr>AUTOFOCUS notification must be send if a notification
2988 callback is registered.<wbr>
2989 </td>
2990
2991 <td class="entry_tags">
2992 </td>
2993
2994 </tr> <!-- end of entry -->
2995
2996
2997 <tr class="entry" id="dynamic_android.control.afTriggerId">
2998 <td class="entry_name">android.<wbr>control.<wbr>af<wbr>Trigger<wbr>Id</td>
2999 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3000 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3001
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3002 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3003
3004
3005 </td> <!-- entry_type -->
3006
3007 <td class="entry_description">
3008 The ID sent with the latest
3009 CAMERA2_<wbr>TRIGGER_<wbr>AUTOFOCUS call
3010 </td>
3011
3012 <td class="entry_units">
3013 </td>
3014
3015 <td class="entry_range">
3016 </td>
3017
3018 <td class="entry_notes">
3019 Must be 0 if no CAMERA2_<wbr>TRIGGER_<wbr>AUTOFOCUS trigger
3020 received yet by HAL.<wbr> Always updated even if AF algorithm
3021 ignores the trigger
3022 </td>
3023
3024 <td class="entry_tags">
3025 </td>
3026
3027 </tr> <!-- end of entry -->
3028
3029
3030 <tr class="entry" id="dynamic_android.control.awbMode">
3031 <td class="entry_name">android.<wbr>control.<wbr>awb<wbr>Mode</td>
3032 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3033 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3034
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3035 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3036
3037 <ul class="entry_type_enum">
3038 <li>
3039 <span class="entry_type_enum_name">OFF</span>
3040 </li>
3041 <li>
3042 <span class="entry_type_enum_name">AUTO</span>
3043 </li>
3044 <li>
3045 <span class="entry_type_enum_name">INCANDESCENT</span>
3046 </li>
3047 <li>
3048 <span class="entry_type_enum_name">FLUORESCENT</span>
3049 </li>
3050 <li>
3051 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
3052 </li>
3053 <li>
3054 <span class="entry_type_enum_name">DAYLIGHT</span>
3055 </li>
3056 <li>
3057 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
3058 </li>
3059 <li>
3060 <span class="entry_type_enum_name">TWILIGHT</span>
3061 </li>
3062 <li>
3063 <span class="entry_type_enum_name">SHADE</span>
3064 </li>
3065 </ul>
3066
3067 </td> <!-- entry_type -->
3068
3069 <td class="entry_description">
3070 Whether AWB is currently setting the color
3071 transform fields,<wbr> and what its illumination target
3072 is
3073 </td>
3074
3075 <td class="entry_units">
3076 </td>
3077
3078 <td class="entry_range">
3079 </td>
3080
3081 <td class="entry_notes">
3082 [BC - AWB lock,<wbr>AWB modes]
3083 </td>
3084
3085 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3086 <ul class="entry_tags">
3087 <li><a href="#tag_BC">BC</a></li>
3088 <li><a href="#tag_AWB">AWB</a></li>
3089 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3090 </td>
3091
3092 </tr> <!-- end of entry -->
3093
3094
3095 <tr class="entry" id="dynamic_android.control.awbRegions">
3096 <td class="entry_name">android.<wbr>control.<wbr>awb<wbr>Regions</td>
3097 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3098 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3099 <span class="entry_type_container">x</span>
3100
3101 <span class="entry_type_array">
3102 5 x area_count
3103 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3104 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3105
3106
3107 </td> <!-- entry_type -->
3108
3109 <td class="entry_description">
3110 List of areas to use for illuminant
3111 estimation
3112 </td>
3113
3114 <td class="entry_units">
3115 </td>
3116
3117 <td class="entry_range">
3118 </td>
3119
3120 <td class="entry_notes">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3121 Only used in AUTO mode.<wbr>
3122<br>
3123<br> Each area is a rectangle plus weight: xmin,<wbr> ymin,<wbr> xmax,<wbr>
3124 ymax,<wbr> weight.<wbr> The coordinate system is based on the active
3125 pixel array,<wbr> with (0,<wbr>0) being the top-left of the active
3126 pixel array,<wbr> and (android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size.<wbr>width,<wbr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3127 android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size.<wbr>height) being the
3128 bottom-right point of the active pixel array.<wbr> The weight
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3129 should be nonnegative.<wbr>
3130<br>
3131<br> If all regions have 0 weight,<wbr> then no specific metering area
3132 needs to be used by the HAL.<wbr> If the metering region is
3133 outside the current android.<wbr>scaler.<wbr>crop<wbr>Region,<wbr> the HAL
3134 should ignore the sections outside the region and output the
3135 used sections in the frame metadata
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3136 </td>
3137
3138 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3139 <ul class="entry_tags">
3140 <li><a href="#tag_BC">BC</a></li>
3141 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3142 </td>
3143
3144 </tr> <!-- end of entry -->
3145
3146
3147 <tr class="entry" id="dynamic_android.control.awbState">
3148 <td class="entry_name">android.<wbr>control.<wbr>awb<wbr>State</td>
3149 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3150 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3151
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3152 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3153
3154 <ul class="entry_type_enum">
3155 <li>
3156 <span class="entry_type_enum_name">INACTIVE</span>
Alex Ray7aeb05e2013-03-27 16:26:41 -0700[diff] [blame]3157 <span class="entry_type_enum_notes">AWB is not in auto mode.<wbr> When a camera device is opened,<wbr> it
3158 starts in this state.<wbr></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3159 </li>
3160 <li>
3161 <span class="entry_type_enum_name">SEARCHING</span>
3162 <span class="entry_type_enum_notes">AWB doesn't yet have a good set of control
3163 values for the current scene</span>
3164 </li>
3165 <li>
3166 <span class="entry_type_enum_name">CONVERGED</span>
3167 <span class="entry_type_enum_notes">AWB has a good set of control values for the
3168 current scene</span>
3169 </li>
3170 <li>
3171 <span class="entry_type_enum_name">LOCKED</span>
3172 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3173 LOCKED)</span>
3174 </li>
3175 </ul>
3176
3177 </td> <!-- entry_type -->
3178
3179 <td class="entry_description">
3180 Current state of AWB algorithm
3181 </td>
3182
3183 <td class="entry_units">
3184 </td>
3185
3186 <td class="entry_range">
3187 </td>
3188
3189 <td class="entry_notes">
3190 Whenever the AWB algorithm state changes,<wbr> a
3191 MSG_<wbr>AUTOWHITEBALANCE notification must be send if a
3192 notification callback is registered.<wbr>
3193 </td>
3194
3195 <td class="entry_tags">
3196 </td>
3197
3198 </tr> <!-- end of entry -->
3199
3200
3201 <tr class="entry" id="dynamic_android.control.mode">
3202 <td class="entry_name">android.<wbr>control.<wbr>mode</td>
3203 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3204 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3205
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3206 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3207
3208 <ul class="entry_type_enum">
3209 <li>
3210 <span class="entry_type_enum_name">OFF</span>
3211 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr> All 3A
3212 routines are disabled,<wbr> no other settings in
3213 android.<wbr>control.<wbr>* have any effect</span>
3214 </li>
3215 <li>
3216 <span class="entry_type_enum_name">AUTO</span>
3217 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr>
3218 Manual control of capture parameters is disabled.<wbr> All
3219 controls in android.<wbr>control.<wbr>* besides sceneMode take
3220 effect</span>
3221 </li>
3222 <li>
3223 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
3224 <span class="entry_type_enum_notes">Use specific scene mode.<wbr> Enabling this disables
3225 control.<wbr>aeMode,<wbr> control.<wbr>awbMode and control.<wbr>afMode
3226 controls; the HAL must ignore those settings while
3227 USE_<wbr>SCENE_<wbr>MODE is active (except for FACE_<wbr>PRIORITY
3228 scene mode).<wbr> Other control entries are still active.<wbr>
3229 This setting can only be used if availableSceneModes !=
3230 UNSUPPORTED</span>
3231 </li>
3232 </ul>
3233
3234 </td> <!-- entry_type -->
3235
3236 <td class="entry_description">
3237 Overall mode of 3A control
3238 routines
3239 </td>
3240
3241 <td class="entry_units">
3242 </td>
3243
3244 <td class="entry_range">
3245 all must be supported
3246 </td>
3247
3248 <td class="entry_notes">
3249 </td>
3250
3251 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3252 <ul class="entry_tags">
3253 <li><a href="#tag_BC">BC</a></li>
3254 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3255 </td>
3256
3257 </tr> <!-- end of entry -->
3258
3259
3260
3261 <!-- end of kind -->
3262 </tbody>
3263
3264 <!-- end of section -->
3265 <tr><td colspan="7" id="section_demosaic" class="section">demosaic</td></tr>
3266
3267
3268 <tr><td colspan="7" class="kind">controls</td></tr>
3269
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3270 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3271 <tr>
3272 <th class="th_name">Property Name</th>
3273 <th class="th_type">Type</th>
3274 <th class="th_description">Description</th>
3275 <th class="th_units">Units</th>
3276 <th class="th_range">Range</th>
3277 <th class="th_notes">Notes</th>
3278 <th class="th_tags">Tags</th>
3279 </tr>
3280 </thead>
3281
3282 <tbody>
3283
3284
3285
3286
3287
3288
3289
3290
3291
3292
3293 <tr class="entry" id="controls_android.demosaic.mode">
3294 <td class="entry_name">android.<wbr>demosaic.<wbr>mode</td>
3295 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3296 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3297
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3298 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3299
3300 <ul class="entry_type_enum">
3301 <li>
3302 <span class="entry_type_enum_name">FAST</span>
3303 <span class="entry_type_enum_notes">Minimal or no slowdown of frame rate compared to
3304 Bayer RAW output</span>
3305 </li>
3306 <li>
3307 <span class="entry_type_enum_name">HIGH_QUALITY</span>
3308 <span class="entry_type_enum_notes">High-quality may reduce output frame
3309 rate</span>
3310 </li>
3311 </ul>
3312
3313 </td> <!-- entry_type -->
3314
3315 <td class="entry_description">
3316 Controls the quality of the demosaicing
3317 processing
3318 </td>
3319
3320 <td class="entry_units">
3321 </td>
3322
3323 <td class="entry_range">
3324 </td>
3325
3326 <td class="entry_notes">
3327 </td>
3328
3329 <td class="entry_tags">
3330 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3331 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3332 </ul>
3333 </td>
3334
3335 </tr> <!-- end of entry -->
3336
3337
3338
3339 <!-- end of kind -->
3340 </tbody>
3341
3342 <!-- end of section -->
3343 <tr><td colspan="7" id="section_edge" class="section">edge</td></tr>
3344
3345
3346 <tr><td colspan="7" class="kind">controls</td></tr>
3347
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3348 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3349 <tr>
3350 <th class="th_name">Property Name</th>
3351 <th class="th_type">Type</th>
3352 <th class="th_description">Description</th>
3353 <th class="th_units">Units</th>
3354 <th class="th_range">Range</th>
3355 <th class="th_notes">Notes</th>
3356 <th class="th_tags">Tags</th>
3357 </tr>
3358 </thead>
3359
3360 <tbody>
3361
3362
3363
3364
3365
3366
3367
3368
3369
3370
3371 <tr class="entry" id="controls_android.edge.mode">
3372 <td class="entry_name">android.<wbr>edge.<wbr>mode</td>
3373 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3374 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3375
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3376 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3377
3378 <ul class="entry_type_enum">
3379 <li>
3380 <span class="entry_type_enum_name">OFF</span>
3381 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
3382 </li>
3383 <li>
3384 <span class="entry_type_enum_name">FAST</span>
3385 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
3386 bayer output</span>
3387 </li>
3388 <li>
3389 <span class="entry_type_enum_name">HIGH_QUALITY</span>
3390 <span class="entry_type_enum_notes">Frame rate may be reduced by high
3391 quality</span>
3392 </li>
3393 </ul>
3394
3395 </td> <!-- entry_type -->
3396
3397 <td class="entry_description">
3398 Operation mode for edge
3399 enhancement
3400 </td>
3401
3402 <td class="entry_units">
3403 </td>
3404
3405 <td class="entry_range">
3406 </td>
3407
3408 <td class="entry_notes">
3409 </td>
3410
3411 <td class="entry_tags">
3412 </td>
3413
3414 </tr> <!-- end of entry -->
3415
3416
3417 <tr class="entry" id="controls_android.edge.strength">
3418 <td class="entry_name">android.<wbr>edge.<wbr>strength</td>
3419 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3420 <span class="entry_type_name">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"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3423
3424
3425 </td> <!-- entry_type -->
3426
3427 <td class="entry_description">
3428 Control the amount of edge enhancement
3429 applied to the images
3430 </td>
3431
3432 <td class="entry_units">
3433 1-10; 10 is maximum sharpening
3434 </td>
3435
3436 <td class="entry_range">
3437 </td>
3438
3439 <td class="entry_notes">
3440 </td>
3441
3442 <td class="entry_tags">
3443 </td>
3444
3445 </tr> <!-- end of entry -->
3446
3447
3448
3449 <!-- end of kind -->
3450 </tbody>
3451 <tr><td colspan="7" class="kind">dynamic</td></tr>
3452
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3453 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3454 <tr>
3455 <th class="th_name">Property Name</th>
3456 <th class="th_type">Type</th>
3457 <th class="th_description">Description</th>
3458 <th class="th_units">Units</th>
3459 <th class="th_range">Range</th>
3460 <th class="th_notes">Notes</th>
3461 <th class="th_tags">Tags</th>
3462 </tr>
3463 </thead>
3464
3465 <tbody>
3466
3467
3468
3469
3470
3471
3472
3473
3474
3475
3476 <tr class="entry" id="dynamic_android.edge.mode">
3477 <td class="entry_name">android.<wbr>edge.<wbr>mode</td>
3478 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3479 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3480
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3481 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3482
3483 <ul class="entry_type_enum">
3484 <li>
3485 <span class="entry_type_enum_name">OFF</span>
3486 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
3487 </li>
3488 <li>
3489 <span class="entry_type_enum_name">FAST</span>
3490 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
3491 bayer output</span>
3492 </li>
3493 <li>
3494 <span class="entry_type_enum_name">HIGH_QUALITY</span>
3495 <span class="entry_type_enum_notes">Frame rate may be reduced by high
3496 quality</span>
3497 </li>
3498 </ul>
3499
3500 </td> <!-- entry_type -->
3501
3502 <td class="entry_description">
3503 Operation mode for edge
3504 enhancement
3505 </td>
3506
3507 <td class="entry_units">
3508 </td>
3509
3510 <td class="entry_range">
3511 </td>
3512
3513 <td class="entry_notes">
3514 </td>
3515
3516 <td class="entry_tags">
3517 </td>
3518
3519 </tr> <!-- end of entry -->
3520
3521
3522
3523 <!-- end of kind -->
3524 </tbody>
3525
3526 <!-- end of section -->
3527 <tr><td colspan="7" id="section_flash" class="section">flash</td></tr>
3528
3529
3530 <tr><td colspan="7" class="kind">controls</td></tr>
3531
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3532 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3533 <tr>
3534 <th class="th_name">Property Name</th>
3535 <th class="th_type">Type</th>
3536 <th class="th_description">Description</th>
3537 <th class="th_units">Units</th>
3538 <th class="th_range">Range</th>
3539 <th class="th_notes">Notes</th>
3540 <th class="th_tags">Tags</th>
3541 </tr>
3542 </thead>
3543
3544 <tbody>
3545
3546
3547
3548
3549
3550
3551
3552
3553
3554
3555 <tr class="entry" id="controls_android.flash.firingPower">
3556 <td class="entry_name">android.<wbr>flash.<wbr>firing<wbr>Power</td>
3557 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3558 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3559
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3560 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3561
3562
3563 </td> <!-- entry_type -->
3564
3565 <td class="entry_description">
3566 Power for flash firing/<wbr>torch
3567 </td>
3568
3569 <td class="entry_units">
3570 10 is max power; 0 is no flash.<wbr> Linear
3571 </td>
3572
3573 <td class="entry_range">
3574 0 - 10
3575 </td>
3576
3577 <td class="entry_notes">
3578 Power for snapshot may use a different scale than
3579 for torch mode.<wbr> Only one entry for torch mode will be
3580 used
3581 </td>
3582
3583 <td class="entry_tags">
3584 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3585 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3586 </ul>
3587 </td>
3588
3589 </tr> <!-- end of entry -->
3590
3591
3592 <tr class="entry" id="controls_android.flash.firingTime">
3593 <td class="entry_name">android.<wbr>flash.<wbr>firing<wbr>Time</td>
3594 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3595 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3596
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3597 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3598
3599
3600 </td> <!-- entry_type -->
3601
3602 <td class="entry_description">
3603 Firing time of flash relative to start of
3604 exposure
3605 </td>
3606
3607 <td class="entry_units">
3608 nanoseconds
3609 </td>
3610
3611 <td class="entry_range">
3612 0-(exposure time-flash duration)
3613 </td>
3614
3615 <td class="entry_notes">
3616 Clamped to (0,<wbr> exposure time - flash
3617 duration).<wbr>
3618 </td>
3619
3620 <td class="entry_tags">
3621 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3622 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3623 </ul>
3624 </td>
3625
3626 </tr> <!-- end of entry -->
3627
3628
3629 <tr class="entry" id="controls_android.flash.mode">
3630 <td class="entry_name">android.<wbr>flash.<wbr>mode</td>
3631 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3632 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3633
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3634 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3635
3636 <ul class="entry_type_enum">
3637 <li>
3638 <span class="entry_type_enum_name">OFF</span>
3639 <span class="entry_type_enum_notes">Do not fire the flash for this
3640 capture</span>
3641 </li>
3642 <li>
3643 <span class="entry_type_enum_name">SINGLE</span>
3644 <span class="entry_type_enum_notes">if android.<wbr>flash.<wbr>available is true Fire flash
3645 for this capture based on firingPower,<wbr>
3646 firingTime.<wbr></span>
3647 </li>
3648 <li>
3649 <span class="entry_type_enum_name">TORCH</span>
3650 <span class="entry_type_enum_notes">if android.<wbr>flash.<wbr>available is true Flash
3651 continuously on,<wbr> power set by
3652 firingPower</span>
3653 </li>
3654 </ul>
3655
3656 </td> <!-- entry_type -->
3657
3658 <td class="entry_description">
3659 Select flash operation mode
3660 </td>
3661
3662 <td class="entry_units">
3663 </td>
3664
3665 <td class="entry_range">
3666 </td>
3667
3668 <td class="entry_notes">
3669 </td>
3670
3671 <td class="entry_tags">
3672 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3673 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3674 </ul>
3675 </td>
3676
3677 </tr> <!-- end of entry -->
3678
3679
3680
3681 <!-- end of kind -->
3682 </tbody>
3683 <tr><td colspan="7" class="kind">static</td></tr>
3684
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3685 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3686 <tr>
3687 <th class="th_name">Property Name</th>
3688 <th class="th_type">Type</th>
3689 <th class="th_description">Description</th>
3690 <th class="th_units">Units</th>
3691 <th class="th_range">Range</th>
3692 <th class="th_notes">Notes</th>
3693 <th class="th_tags">Tags</th>
3694 </tr>
3695 </thead>
3696
3697 <tbody>
3698
3699
3700
3701
3702
3703
3704
3705
3706
3707
3708
3709
3710 <tr class="entry" id="static_android.flash.info.available">
3711 <td class="entry_name">android.<wbr>flash.<wbr>info.<wbr>available</td>
3712 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3713 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3714
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3715 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3716
3717
3718 </td> <!-- entry_type -->
3719
3720 <td class="entry_description">
3721 Whether this camera has a
3722 flash
3723 </td>
3724
3725 <td class="entry_units">
3726 boolean (0 = false,<wbr> otherwise true)
3727 </td>
3728
3729 <td class="entry_range">
3730 </td>
3731
3732 <td class="entry_notes">
3733 If no flash,<wbr> none of the flash controls do
3734 anything.<wbr> All other metadata should return 0
3735 </td>
3736
3737 <td class="entry_tags">
3738 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3739 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3740 </ul>
3741 </td>
3742
3743 </tr> <!-- end of entry -->
3744
3745
3746 <tr class="entry" id="static_android.flash.info.chargeDuration">
3747 <td class="entry_name">android.<wbr>flash.<wbr>info.<wbr>charge<wbr>Duration</td>
3748 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3749 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3750
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3751 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3752
3753
3754 </td> <!-- entry_type -->
3755
3756 <td class="entry_description">
3757 Time taken before flash can fire
3758 again
3759 </td>
3760
3761 <td class="entry_units">
3762 nanoseconds
3763 </td>
3764
3765 <td class="entry_range">
3766 0-1e9
3767 </td>
3768
3769 <td class="entry_notes">
3770 1 second too long/<wbr>too short for recharge? Should
3771 this be power-dependent?
3772 </td>
3773
3774 <td class="entry_tags">
3775 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3776 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3777 </ul>
3778 </td>
3779
3780 </tr> <!-- end of entry -->
3781
3782
3783
3784
3785
3786 <tr class="entry" id="static_android.flash.colorTemperature">
3787 <td class="entry_name">android.<wbr>flash.<wbr>color<wbr>Temperature</td>
3788 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3789 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3790
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3791 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3792
3793
3794 </td> <!-- entry_type -->
3795
3796 <td class="entry_description">
3797 The x,<wbr>y whitepoint of the
3798 flash
3799 </td>
3800
3801 <td class="entry_units">
3802 pair of floats
3803 </td>
3804
3805 <td class="entry_range">
3806 0-1 for both
3807 </td>
3808
3809 <td class="entry_notes">
3810 </td>
3811
3812 <td class="entry_tags">
3813 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3814 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3815 </ul>
3816 </td>
3817
3818 </tr> <!-- end of entry -->
3819
3820
3821 <tr class="entry" id="static_android.flash.maxEnergy">
3822 <td class="entry_name">android.<wbr>flash.<wbr>max<wbr>Energy</td>
3823 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3824 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3825
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3826 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3827
3828
3829 </td> <!-- entry_type -->
3830
3831 <td class="entry_description">
3832 Max energy output of the flash for a full
3833 power single flash
3834 </td>
3835
3836 <td class="entry_units">
3837 lumen-seconds
3838 </td>
3839
3840 <td class="entry_range">
3841 >= 0
3842 </td>
3843
3844 <td class="entry_notes">
3845 </td>
3846
3847 <td class="entry_tags">
3848 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3849 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3850 </ul>
3851 </td>
3852
3853 </tr> <!-- end of entry -->
3854
3855
3856
3857 <!-- end of kind -->
3858 </tbody>
3859 <tr><td colspan="7" class="kind">dynamic</td></tr>
3860
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3861 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3862 <tr>
3863 <th class="th_name">Property Name</th>
3864 <th class="th_type">Type</th>
3865 <th class="th_description">Description</th>
3866 <th class="th_units">Units</th>
3867 <th class="th_range">Range</th>
3868 <th class="th_notes">Notes</th>
3869 <th class="th_tags">Tags</th>
3870 </tr>
3871 </thead>
3872
3873 <tbody>
3874
3875
3876
3877
3878
3879
3880
3881
3882
3883
3884 <tr class="entry" id="dynamic_android.flash.firingPower">
3885 <td class="entry_name">android.<wbr>flash.<wbr>firing<wbr>Power</td>
3886 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3887 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3888
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3889 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3890
3891
3892 </td> <!-- entry_type -->
3893
3894 <td class="entry_description">
3895 Power for flash firing/<wbr>torch
3896 </td>
3897
3898 <td class="entry_units">
3899 10 is max power; 0 is no flash.<wbr> Linear
3900 </td>
3901
3902 <td class="entry_range">
3903 0 - 10
3904 </td>
3905
3906 <td class="entry_notes">
3907 Power for snapshot may use a different scale than
3908 for torch mode.<wbr> Only one entry for torch mode will be
3909 used
3910 </td>
3911
3912 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3913 <ul class="entry_tags">
3914 <li><a href="#tag_V1">V1</a></li>
3915 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3916 </td>
3917
3918 </tr> <!-- end of entry -->
3919
3920
3921 <tr class="entry" id="dynamic_android.flash.firingTime">
3922 <td class="entry_name">android.<wbr>flash.<wbr>firing<wbr>Time</td>
3923 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3924 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3925
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3926 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3927
3928
3929 </td> <!-- entry_type -->
3930
3931 <td class="entry_description">
3932 Firing time of flash relative to start of
3933 exposure
3934 </td>
3935
3936 <td class="entry_units">
3937 nanoseconds
3938 </td>
3939
3940 <td class="entry_range">
3941 0-(exposure time-flash duration)
3942 </td>
3943
3944 <td class="entry_notes">
3945 Clamped to (0,<wbr> exposure time - flash
3946 duration).<wbr>
3947 </td>
3948
3949 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3950 <ul class="entry_tags">
3951 <li><a href="#tag_V1">V1</a></li>
3952 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3953 </td>
3954
3955 </tr> <!-- end of entry -->
3956
3957
3958 <tr class="entry" id="dynamic_android.flash.mode">
3959 <td class="entry_name">android.<wbr>flash.<wbr>mode</td>
3960 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3961 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3962
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3963 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3964
3965 <ul class="entry_type_enum">
3966 <li>
3967 <span class="entry_type_enum_name">OFF</span>
3968 <span class="entry_type_enum_notes">Do not fire the flash for this
3969 capture</span>
3970 </li>
3971 <li>
3972 <span class="entry_type_enum_name">SINGLE</span>
3973 <span class="entry_type_enum_notes">if android.<wbr>flash.<wbr>available is true Fire flash
3974 for this capture based on firingPower,<wbr>
3975 firingTime.<wbr></span>
3976 </li>
3977 <li>
3978 <span class="entry_type_enum_name">TORCH</span>
3979 <span class="entry_type_enum_notes">if android.<wbr>flash.<wbr>available is true Flash
3980 continuously on,<wbr> power set by
3981 firingPower</span>
3982 </li>
3983 </ul>
3984
3985 </td> <!-- entry_type -->
3986
3987 <td class="entry_description">
3988 Select flash operation mode
3989 </td>
3990
3991 <td class="entry_units">
3992 </td>
3993
3994 <td class="entry_range">
3995 </td>
3996
3997 <td class="entry_notes">
3998 </td>
3999
4000 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4001 <ul class="entry_tags">
4002 <li><a href="#tag_BC">BC</a></li>
4003 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4004 </td>
4005
4006 </tr> <!-- end of entry -->
4007
4008
4009 <tr class="entry" id="dynamic_android.flash.state">
4010 <td class="entry_name">android.<wbr>flash.<wbr>state</td>
4011 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4012 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4013
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4014 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4015
4016 <ul class="entry_type_enum">
4017 <li>
4018 <span class="entry_type_enum_name">UNAVAILABLE</span>
4019 <span class="entry_type_enum_notes">No flash on camera</span>
4020 </li>
4021 <li>
4022 <span class="entry_type_enum_name">CHARGING</span>
4023 <span class="entry_type_enum_notes">if android.<wbr>flash.<wbr>available is true Flash is
4024 charging and cannot be fired</span>
4025 </li>
4026 <li>
4027 <span class="entry_type_enum_name">READY</span>
4028 <span class="entry_type_enum_notes">if android.<wbr>flash.<wbr>available is true Flash is
4029 ready to fire</span>
4030 </li>
4031 <li>
4032 <span class="entry_type_enum_name">FIRED</span>
4033 <span class="entry_type_enum_notes">if android.<wbr>flash.<wbr>available is true Flash fired
4034 for this capture</span>
4035 </li>
4036 </ul>
4037
4038 </td> <!-- entry_type -->
4039
4040 <td class="entry_description">
4041 Current state of the flash
4042 unit
4043 </td>
4044
4045 <td class="entry_units">
4046 </td>
4047
4048 <td class="entry_range">
4049 </td>
4050
4051 <td class="entry_notes">
4052 </td>
4053
4054 <td class="entry_tags">
4055 </td>
4056
4057 </tr> <!-- end of entry -->
4058
4059
4060
4061 <!-- end of kind -->
4062 </tbody>
4063
4064 <!-- end of section -->
4065 <tr><td colspan="7" id="section_geometric" class="section">geometric</td></tr>
4066
4067
4068 <tr><td colspan="7" class="kind">controls</td></tr>
4069
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4070 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4071 <tr>
4072 <th class="th_name">Property Name</th>
4073 <th class="th_type">Type</th>
4074 <th class="th_description">Description</th>
4075 <th class="th_units">Units</th>
4076 <th class="th_range">Range</th>
4077 <th class="th_notes">Notes</th>
4078 <th class="th_tags">Tags</th>
4079 </tr>
4080 </thead>
4081
4082 <tbody>
4083
4084
4085
4086
4087
4088
4089
4090
4091
4092
4093 <tr class="entry" id="controls_android.geometric.mode">
4094 <td class="entry_name">android.<wbr>geometric.<wbr>mode</td>
4095 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4096 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4097
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4098 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4099
4100 <ul class="entry_type_enum">
4101 <li>
4102 <span class="entry_type_enum_name">OFF</span>
4103 <span class="entry_type_enum_notes">No geometric correction is
4104 applied</span>
4105 </li>
4106 <li>
4107 <span class="entry_type_enum_name">FAST</span>
4108 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
4109 bayer output</span>
4110 </li>
4111 <li>
4112 <span class="entry_type_enum_name">HIGH_QUALITY</span>
4113 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4114 quality</span>
4115 </li>
4116 </ul>
4117
4118 </td> <!-- entry_type -->
4119
4120 <td class="entry_description">
4121 Operating mode of geometric
4122 correction
4123 </td>
4124
4125 <td class="entry_units">
4126 </td>
4127
4128 <td class="entry_range">
4129 </td>
4130
4131 <td class="entry_notes">
4132 </td>
4133
4134 <td class="entry_tags">
4135 </td>
4136
4137 </tr> <!-- end of entry -->
4138
4139
4140 <tr class="entry" id="controls_android.geometric.strength">
4141 <td class="entry_name">android.<wbr>geometric.<wbr>strength</td>
4142 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4143 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4144
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4145 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4146
4147
4148 </td> <!-- entry_type -->
4149
4150 <td class="entry_description">
4151 Control the amount of shading correction
4152 applied to the images
4153 </td>
4154
4155 <td class="entry_units">
4156 unitless: 1-10; 10 is full shading
4157 compensation
4158 </td>
4159
4160 <td class="entry_range">
4161 </td>
4162
4163 <td class="entry_notes">
4164 </td>
4165
4166 <td class="entry_tags">
4167 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4168 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4169 </ul>
4170 </td>
4171
4172 </tr> <!-- end of entry -->
4173
4174
4175
4176 <!-- end of kind -->
4177 </tbody>
4178
4179 <!-- end of section -->
4180 <tr><td colspan="7" id="section_hotPixel" class="section">hotPixel</td></tr>
4181
4182
4183 <tr><td colspan="7" class="kind">controls</td></tr>
4184
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4185 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4186 <tr>
4187 <th class="th_name">Property Name</th>
4188 <th class="th_type">Type</th>
4189 <th class="th_description">Description</th>
4190 <th class="th_units">Units</th>
4191 <th class="th_range">Range</th>
4192 <th class="th_notes">Notes</th>
4193 <th class="th_tags">Tags</th>
4194 </tr>
4195 </thead>
4196
4197 <tbody>
4198
4199
4200
4201
4202
4203
4204
4205
4206
4207
4208 <tr class="entry" id="controls_android.hotPixel.mode">
4209 <td class="entry_name">android.<wbr>hot<wbr>Pixel.<wbr>mode</td>
4210 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4211 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4212
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4213 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4214
4215 <ul class="entry_type_enum">
4216 <li>
4217 <span class="entry_type_enum_name">OFF</span>
4218 <span class="entry_type_enum_notes">No hot pixel correction can be
4219 applied</span>
4220 </li>
4221 <li>
4222 <span class="entry_type_enum_name">FAST</span>
4223 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
4224 Bayer output</span>
4225 </li>
4226 <li>
4227 <span class="entry_type_enum_name">HIGH_QUALITY</span>
4228 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4229 quality</span>
4230 </li>
4231 </ul>
4232
4233 </td> <!-- entry_type -->
4234
4235 <td class="entry_description">
4236 Set operational mode for hot pixel
4237 correction
4238 </td>
4239
4240 <td class="entry_units">
4241 </td>
4242
4243 <td class="entry_range">
4244 </td>
4245
4246 <td class="entry_notes">
4247 </td>
4248
4249 <td class="entry_tags">
4250 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4251 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4252 </ul>
4253 </td>
4254
4255 </tr> <!-- end of entry -->
4256
4257
4258
4259 <!-- end of kind -->
4260 </tbody>
4261 <tr><td colspan="7" class="kind">static</td></tr>
4262
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4263 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4264 <tr>
4265 <th class="th_name">Property Name</th>
4266 <th class="th_type">Type</th>
4267 <th class="th_description">Description</th>
4268 <th class="th_units">Units</th>
4269 <th class="th_range">Range</th>
4270 <th class="th_notes">Notes</th>
4271 <th class="th_tags">Tags</th>
4272 </tr>
4273 </thead>
4274
4275 <tbody>
4276
4277
4278
4279
4280
4281
4282
4283
4284
4285
4286
4287
4288 <tr class="entry" id="static_android.hotPixel.info.map">
4289 <td class="entry_name">android.<wbr>hot<wbr>Pixel.<wbr>info.<wbr>map</td>
4290 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4291 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4292 <span class="entry_type_container">x</span>
4293
4294 <span class="entry_type_array">
4295 2 x n
4296 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4297 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4298 <div class="entry_type_notes">list of coordinates based on android.<wbr>sensor.<wbr>pixel<wbr>Array<wbr>Size</div>
4299
4300
4301 </td> <!-- entry_type -->
4302
4303 <td class="entry_description">
4304 Location of hot/<wbr>defective pixels on
4305 sensor
4306 </td>
4307
4308 <td class="entry_units">
4309 </td>
4310
4311 <td class="entry_range">
4312 </td>
4313
4314 <td class="entry_notes">
4315 </td>
4316
4317 <td class="entry_tags">
4318 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4319 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4320 </ul>
4321 </td>
4322
4323 </tr> <!-- end of entry -->
4324
4325
4326
4327
4328
4329
4330 <!-- end of kind -->
4331 </tbody>
4332 <tr><td colspan="7" class="kind">dynamic</td></tr>
4333
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4334 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4335 <tr>
4336 <th class="th_name">Property Name</th>
4337 <th class="th_type">Type</th>
4338 <th class="th_description">Description</th>
4339 <th class="th_units">Units</th>
4340 <th class="th_range">Range</th>
4341 <th class="th_notes">Notes</th>
4342 <th class="th_tags">Tags</th>
4343 </tr>
4344 </thead>
4345
4346 <tbody>
4347
4348
4349
4350
4351
4352
4353
4354
4355
4356
4357 <tr class="entry" id="dynamic_android.hotPixel.mode">
4358 <td class="entry_name">android.<wbr>hot<wbr>Pixel.<wbr>mode</td>
4359 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4360 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4361
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4362 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4363
4364 <ul class="entry_type_enum">
4365 <li>
4366 <span class="entry_type_enum_name">OFF</span>
4367 <span class="entry_type_enum_notes">No hot pixel correction can be
4368 applied</span>
4369 </li>
4370 <li>
4371 <span class="entry_type_enum_name">FAST</span>
4372 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
4373 Bayer output</span>
4374 </li>
4375 <li>
4376 <span class="entry_type_enum_name">HIGH_QUALITY</span>
4377 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4378 quality</span>
4379 </li>
4380 </ul>
4381
4382 </td> <!-- entry_type -->
4383
4384 <td class="entry_description">
4385 Set operational mode for hot pixel
4386 correction
4387 </td>
4388
4389 <td class="entry_units">
4390 </td>
4391
4392 <td class="entry_range">
4393 </td>
4394
4395 <td class="entry_notes">
4396 </td>
4397
4398 <td class="entry_tags">
4399 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4400 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4401 </ul>
4402 </td>
4403
4404 </tr> <!-- end of entry -->
4405
4406
4407
4408 <!-- end of kind -->
4409 </tbody>
4410
4411 <!-- end of section -->
4412 <tr><td colspan="7" id="section_jpeg" class="section">jpeg</td></tr>
4413
4414
4415 <tr><td colspan="7" class="kind">controls</td></tr>
4416
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4417 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4418 <tr>
4419 <th class="th_name">Property Name</th>
4420 <th class="th_type">Type</th>
4421 <th class="th_description">Description</th>
4422 <th class="th_units">Units</th>
4423 <th class="th_range">Range</th>
4424 <th class="th_notes">Notes</th>
4425 <th class="th_tags">Tags</th>
4426 </tr>
4427 </thead>
4428
4429 <tbody>
4430
4431
4432
4433
4434
4435
4436
4437
4438
4439
4440 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
4441 <td class="entry_name">android.<wbr>jpeg.<wbr>gps<wbr>Coordinates</td>
4442 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4443 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4444 <span class="entry_type_container">x</span>
4445
4446 <span class="entry_type_array">
4447 3
4448 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4449 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4450 <div class="entry_type_notes">latitude,<wbr> longitude,<wbr> altitude.<wbr> First two in degrees,<wbr> the third in meters</div>
4451
4452
4453 </td> <!-- entry_type -->
4454
4455 <td class="entry_description">
4456 GPS coordinates to include in output JPEG
4457 EXIF
4458 </td>
4459
4460 <td class="entry_units">
4461 </td>
4462
4463 <td class="entry_range">
4464 (-180 - 180],<wbr> [-90,<wbr>90],<wbr> [-inf,<wbr> inf]
4465 </td>
4466
4467 <td class="entry_notes">
4468 </td>
4469
4470 <td class="entry_tags">
4471 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4472 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4473 </ul>
4474 </td>
4475
4476 </tr> <!-- end of entry -->
4477
4478
4479 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
4480 <td class="entry_name">android.<wbr>jpeg.<wbr>gps<wbr>Processing<wbr>Method</td>
4481 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4482 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4483
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]4484 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4485
4486
4487 </td> <!-- entry_type -->
4488
4489 <td class="entry_description">
4490 32 characters describing GPS algorithm to
4491 include in EXIF
4492 </td>
4493
4494 <td class="entry_units">
4495 UTF-8 null-terminated string
4496 </td>
4497
4498 <td class="entry_range">
4499 </td>
4500
4501 <td class="entry_notes">
4502 </td>
4503
4504 <td class="entry_tags">
4505 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4506 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4507 </ul>
4508 </td>
4509
4510 </tr> <!-- end of entry -->
4511
4512
4513 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
4514 <td class="entry_name">android.<wbr>jpeg.<wbr>gps<wbr>Timestamp</td>
4515 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4516 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4517
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4518 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4519
4520
4521 </td> <!-- entry_type -->
4522
4523 <td class="entry_description">
4524 Time GPS fix was made to include in
4525 EXIF
4526 </td>
4527
4528 <td class="entry_units">
4529 UTC in seconds since January 1,<wbr> 1970
4530 </td>
4531
4532 <td class="entry_range">
4533 </td>
4534
4535 <td class="entry_notes">
4536 </td>
4537
4538 <td class="entry_tags">
4539 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4540 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4541 </ul>
4542 </td>
4543
4544 </tr> <!-- end of entry -->
4545
4546
4547 <tr class="entry" id="controls_android.jpeg.orientation">
4548 <td class="entry_name">android.<wbr>jpeg.<wbr>orientation</td>
4549 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4550 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4551
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4552 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4553
4554
4555 </td> <!-- entry_type -->
4556
4557 <td class="entry_description">
4558 Orientation of JPEG image to
4559 write
4560 </td>
4561
4562 <td class="entry_units">
4563 Degrees in multiples of 90
4564 </td>
4565
4566 <td class="entry_range">
4567 0,<wbr> 90,<wbr> 180,<wbr> 270
4568 </td>
4569
4570 <td class="entry_notes">
4571 </td>
4572
4573 <td class="entry_tags">
4574 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4575 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4576 </ul>
4577 </td>
4578
4579 </tr> <!-- end of entry -->
4580
4581
4582 <tr class="entry" id="controls_android.jpeg.quality">
4583 <td class="entry_name">android.<wbr>jpeg.<wbr>quality</td>
4584 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4585 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4586
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4587 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4588
4589
4590 </td> <!-- entry_type -->
4591
4592 <td class="entry_description">
4593 Compression quality of the final JPEG
4594 image
4595 </td>
4596
4597 <td class="entry_units">
4598 </td>
4599
4600 <td class="entry_range">
4601 1-100; larger is higher quality
4602 </td>
4603
4604 <td class="entry_notes">
4605 85-95 is typical usage range
4606 </td>
4607
4608 <td class="entry_tags">
4609 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4610 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4611 </ul>
4612 </td>
4613
4614 </tr> <!-- end of entry -->
4615
4616
4617 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
4618 <td class="entry_name">android.<wbr>jpeg.<wbr>thumbnail<wbr>Quality</td>
4619 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4620 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4621
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4622 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4623
4624
4625 </td> <!-- entry_type -->
4626
4627 <td class="entry_description">
4628 Compression quality of JPEG
4629 thumbnail
4630 </td>
4631
4632 <td class="entry_units">
4633 </td>
4634
4635 <td class="entry_range">
4636 1-100; larger is higher quality
4637 </td>
4638
4639 <td class="entry_notes">
4640 </td>
4641
4642 <td class="entry_tags">
4643 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4644 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4645 </ul>
4646 </td>
4647
4648 </tr> <!-- end of entry -->
4649
4650
4651 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
4652 <td class="entry_name">android.<wbr>jpeg.<wbr>thumbnail<wbr>Size</td>
4653 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4654 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4655 <span class="entry_type_container">x</span>
4656
4657 <span class="entry_type_array">
4658 2
4659 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]4660 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4661
4662
4663 </td> <!-- entry_type -->
4664
4665 <td class="entry_description">
4666 Resolution of embedded JPEG
4667 thumbnail
4668 </td>
4669
4670 <td class="entry_units">
4671 </td>
4672
4673 <td class="entry_range">
4674 from android.<wbr>jpeg.<wbr>available<wbr>Thumbnail<wbr>Sizes
4675 </td>
4676
4677 <td class="entry_notes">
4678 </td>
4679
4680 <td class="entry_tags">
4681 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4682 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4683 </ul>
4684 </td>
4685
4686 </tr> <!-- end of entry -->
4687
4688
4689
4690 <!-- end of kind -->
4691 </tbody>
4692 <tr><td colspan="7" class="kind">static</td></tr>
4693
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4694 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4695 <tr>
4696 <th class="th_name">Property Name</th>
4697 <th class="th_type">Type</th>
4698 <th class="th_description">Description</th>
4699 <th class="th_units">Units</th>
4700 <th class="th_range">Range</th>
4701 <th class="th_notes">Notes</th>
4702 <th class="th_tags">Tags</th>
4703 </tr>
4704 </thead>
4705
4706 <tbody>
4707
4708
4709
4710
4711
4712
4713
4714
4715
4716
4717 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
4718 <td class="entry_name">android.<wbr>jpeg.<wbr>available<wbr>Thumbnail<wbr>Sizes</td>
4719 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4720 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4721 <span class="entry_type_container">x</span>
4722
4723 <span class="entry_type_array">
4724 2 x n
4725 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]4726 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4727 <div class="entry_type_notes">list of resolution pairs</div>
4728
4729
4730 </td> <!-- entry_type -->
4731
4732 <td class="entry_description">
4733 Supported resolutions for the JPEG
4734 thumbnail
4735 </td>
4736
4737 <td class="entry_units">
4738 </td>
4739
4740 <td class="entry_range">
4741 Must include at least one valid resolution,<wbr> plus
4742 (0,<wbr>0) for no thumbnail generation
4743 </td>
4744
4745 <td class="entry_notes">
4746 </td>
4747
4748 <td class="entry_tags">
4749 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4750 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4751 </ul>
4752 </td>
4753
4754 </tr> <!-- end of entry -->
4755
4756
4757 <tr class="entry" id="static_android.jpeg.maxSize">
4758 <td class="entry_name">android.<wbr>jpeg.<wbr>max<wbr>Size</td>
4759 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4760 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4761
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4762 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4763
4764
4765 </td> <!-- entry_type -->
4766
4767 <td class="entry_description">
4768 Maximum size in bytes for the compressed
4769 JPEG buffer
4770 </td>
4771
4772 <td class="entry_units">
4773 </td>
4774
4775 <td class="entry_range">
4776 Must be large enough to fit any JPEG produced by
4777 the camera
4778 </td>
4779
4780 <td class="entry_notes">
4781 This is used for sizing the gralloc buffers for
4782 JPEG
4783 </td>
4784
4785 <td class="entry_tags">
4786 </td>
4787
4788 </tr> <!-- end of entry -->
4789
4790
4791
4792 <!-- end of kind -->
4793 </tbody>
4794 <tr><td colspan="7" class="kind">dynamic</td></tr>
4795
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4796 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4797 <tr>
4798 <th class="th_name">Property Name</th>
4799 <th class="th_type">Type</th>
4800 <th class="th_description">Description</th>
4801 <th class="th_units">Units</th>
4802 <th class="th_range">Range</th>
4803 <th class="th_notes">Notes</th>
4804 <th class="th_tags">Tags</th>
4805 </tr>
4806 </thead>
4807
4808 <tbody>
4809
4810
4811
4812
4813
4814
4815
4816
4817
4818
4819 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
4820 <td class="entry_name">android.<wbr>jpeg.<wbr>gps<wbr>Coordinates</td>
4821 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4822 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4823 <span class="entry_type_container">x</span>
4824
4825 <span class="entry_type_array">
4826 3
4827 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4828 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4829 <div class="entry_type_notes">latitude,<wbr> longitude,<wbr> altitude.<wbr> First two in degrees,<wbr> the third in meters</div>
4830
4831
4832 </td> <!-- entry_type -->
4833
4834 <td class="entry_description">
4835 GPS coordinates to include in output JPEG
4836 EXIF
4837 </td>
4838
4839 <td class="entry_units">
4840 </td>
4841
4842 <td class="entry_range">
4843 (-180 - 180],<wbr> [-90,<wbr>90],<wbr> [-inf,<wbr> inf]
4844 </td>
4845
4846 <td class="entry_notes">
4847 </td>
4848
4849 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4850 <ul class="entry_tags">
4851 <li><a href="#tag_BC">BC</a></li>
4852 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4853 </td>
4854
4855 </tr> <!-- end of entry -->
4856
4857
4858 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
4859 <td class="entry_name">android.<wbr>jpeg.<wbr>gps<wbr>Processing<wbr>Method</td>
4860 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4861 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4862
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]4863 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4864
4865
4866 </td> <!-- entry_type -->
4867
4868 <td class="entry_description">
4869 32 characters describing GPS algorithm to
4870 include in EXIF
4871 </td>
4872
4873 <td class="entry_units">
4874 UTF-8 null-terminated string
4875 </td>
4876
4877 <td class="entry_range">
4878 </td>
4879
4880 <td class="entry_notes">
4881 </td>
4882
4883 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4884 <ul class="entry_tags">
4885 <li><a href="#tag_BC">BC</a></li>
4886 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4887 </td>
4888
4889 </tr> <!-- end of entry -->
4890
4891
4892 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
4893 <td class="entry_name">android.<wbr>jpeg.<wbr>gps<wbr>Timestamp</td>
4894 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4895 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4896
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4897 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4898
4899
4900 </td> <!-- entry_type -->
4901
4902 <td class="entry_description">
4903 Time GPS fix was made to include in
4904 EXIF
4905 </td>
4906
4907 <td class="entry_units">
4908 UTC in seconds since January 1,<wbr> 1970
4909 </td>
4910
4911 <td class="entry_range">
4912 </td>
4913
4914 <td class="entry_notes">
4915 </td>
4916
4917 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4918 <ul class="entry_tags">
4919 <li><a href="#tag_BC">BC</a></li>
4920 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4921 </td>
4922
4923 </tr> <!-- end of entry -->
4924
4925
4926 <tr class="entry" id="dynamic_android.jpeg.orientation">
4927 <td class="entry_name">android.<wbr>jpeg.<wbr>orientation</td>
4928 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4929 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4930
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4931 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4932
4933
4934 </td> <!-- entry_type -->
4935
4936 <td class="entry_description">
4937 Orientation of JPEG image to
4938 write
4939 </td>
4940
4941 <td class="entry_units">
4942 Degrees in multiples of 90
4943 </td>
4944
4945 <td class="entry_range">
4946 0,<wbr> 90,<wbr> 180,<wbr> 270
4947 </td>
4948
4949 <td class="entry_notes">
4950 </td>
4951
4952 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4953 <ul class="entry_tags">
4954 <li><a href="#tag_BC">BC</a></li>
4955 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4956 </td>
4957
4958 </tr> <!-- end of entry -->
4959
4960
4961 <tr class="entry" id="dynamic_android.jpeg.quality">
4962 <td class="entry_name">android.<wbr>jpeg.<wbr>quality</td>
4963 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4964 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4965
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4966 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4967
4968
4969 </td> <!-- entry_type -->
4970
4971 <td class="entry_description">
4972 Compression quality of the final JPEG
4973 image
4974 </td>
4975
4976 <td class="entry_units">
4977 </td>
4978
4979 <td class="entry_range">
4980 1-100; larger is higher quality
4981 </td>
4982
4983 <td class="entry_notes">
4984 85-95 is typical usage range
4985 </td>
4986
4987 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4988 <ul class="entry_tags">
4989 <li><a href="#tag_BC">BC</a></li>
4990 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4991 </td>
4992
4993 </tr> <!-- end of entry -->
4994
4995
4996 <tr class="entry" id="dynamic_android.jpeg.size">
4997 <td class="entry_name">android.<wbr>jpeg.<wbr>size</td>
4998 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4999 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5000
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5001 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5002
5003
5004 </td> <!-- entry_type -->
5005
5006 <td class="entry_description">
5007 The size of the compressed JPEG image,<wbr> in
5008 bytes
5009 </td>
5010
5011 <td class="entry_units">
5012 </td>
5013
5014 <td class="entry_range">
5015 >= 0
5016 </td>
5017
5018 <td class="entry_notes">
5019 If no JPEG output is produced for the request,<wbr>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5020 this must be 0.<wbr>
5021<br>
5022<br> Otherwise,<wbr> this describes the real size of the compressed
5023 JPEG image placed in the output stream.<wbr> More specifically,<wbr>
5024 if android.<wbr>jpeg.<wbr>max<wbr>Size = 1000000,<wbr> and a specific capture
5025 has android.<wbr>jpeg.<wbr>size = 500000,<wbr> then the output buffer from
5026 the JPEG stream will be 1000000 bytes,<wbr> of which the first
5027 500000 make up the real data.<wbr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5028 </td>
5029
5030 <td class="entry_tags">
5031 </td>
5032
5033 </tr> <!-- end of entry -->
5034
5035
5036 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
5037 <td class="entry_name">android.<wbr>jpeg.<wbr>thumbnail<wbr>Quality</td>
5038 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5039 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5040
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5041 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5042
5043
5044 </td> <!-- entry_type -->
5045
5046 <td class="entry_description">
5047 Compression quality of JPEG
5048 thumbnail
5049 </td>
5050
5051 <td class="entry_units">
5052 </td>
5053
5054 <td class="entry_range">
5055 1-100; larger is higher quality
5056 </td>
5057
5058 <td class="entry_notes">
5059 </td>
5060
5061 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5062 <ul class="entry_tags">
5063 <li><a href="#tag_BC">BC</a></li>
5064 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5065 </td>
5066
5067 </tr> <!-- end of entry -->
5068
5069
5070 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
5071 <td class="entry_name">android.<wbr>jpeg.<wbr>thumbnail<wbr>Size</td>
5072 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5073 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5074 <span class="entry_type_container">x</span>
5075
5076 <span class="entry_type_array">
5077 2
5078 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]5079 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5080
5081
5082 </td> <!-- entry_type -->
5083
5084 <td class="entry_description">
5085 Resolution of embedded JPEG
5086 thumbnail
5087 </td>
5088
5089 <td class="entry_units">
5090 </td>
5091
5092 <td class="entry_range">
5093 from android.<wbr>jpeg.<wbr>available<wbr>Thumbnail<wbr>Sizes
5094 </td>
5095
5096 <td class="entry_notes">
5097 </td>
5098
5099 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5100 <ul class="entry_tags">
5101 <li><a href="#tag_BC">BC</a></li>
5102 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5103 </td>
5104
5105 </tr> <!-- end of entry -->
5106
5107
5108
5109 <!-- end of kind -->
5110 </tbody>
5111
5112 <!-- end of section -->
5113 <tr><td colspan="7" id="section_lens" class="section">lens</td></tr>
5114
5115
5116 <tr><td colspan="7" class="kind">controls</td></tr>
5117
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5118 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5119 <tr>
5120 <th class="th_name">Property Name</th>
5121 <th class="th_type">Type</th>
5122 <th class="th_description">Description</th>
5123 <th class="th_units">Units</th>
5124 <th class="th_range">Range</th>
5125 <th class="th_notes">Notes</th>
5126 <th class="th_tags">Tags</th>
5127 </tr>
5128 </thead>
5129
5130 <tbody>
5131
5132
5133
5134
5135
5136
5137
5138
5139
5140
5141 <tr class="entry" id="controls_android.lens.aperture">
5142 <td class="entry_name">android.<wbr>lens.<wbr>aperture</td>
5143 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5144 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5145
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5146 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5147
5148
5149 </td> <!-- entry_type -->
5150
5151 <td class="entry_description">
5152 Size of the lens aperture
5153 </td>
5154
5155 <td class="entry_units">
5156 f-number (f/<wbr>NNN)
5157 </td>
5158
5159 <td class="entry_range">
5160 android.<wbr>lens.<wbr>info.<wbr>available<wbr>Apertures
5161 </td>
5162
5163 <td class="entry_notes">
5164 Will not be supported on most devices.<wbr> Can only
5165 pick from supported list
5166 </td>
5167
5168 <td class="entry_tags">
5169 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5170 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5171 </ul>
5172 </td>
5173
5174 </tr> <!-- end of entry -->
5175
5176
5177 <tr class="entry" id="controls_android.lens.filterDensity">
5178 <td class="entry_name">android.<wbr>lens.<wbr>filter<wbr>Density</td>
5179 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5180 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5181
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5182 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5183
5184
5185 </td> <!-- entry_type -->
5186
5187 <td class="entry_description">
5188 State of lens neutral density
5189 filter(s)
5190 </td>
5191
5192 <td class="entry_units">
5193 number of stops of filtering
5194 </td>
5195
5196 <td class="entry_range">
5197 android.<wbr>lens.<wbr>info.<wbr>available<wbr>Filter<wbr>Densities
5198 </td>
5199
5200 <td class="entry_notes">
5201 Will not be supported on most devices.<wbr> Can only
5202 pick from supported list
5203 </td>
5204
5205 <td class="entry_tags">
5206 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5207 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5208 </ul>
5209 </td>
5210
5211 </tr> <!-- end of entry -->
5212
5213
5214 <tr class="entry" id="controls_android.lens.focalLength">
5215 <td class="entry_name">android.<wbr>lens.<wbr>focal<wbr>Length</td>
5216 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5217 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5218
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5219 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5220
5221
5222 </td> <!-- entry_type -->
5223
5224 <td class="entry_description">
5225 Lens optical zoom setting
5226 </td>
5227
5228 <td class="entry_units">
5229 focal length in mm
5230 </td>
5231
5232 <td class="entry_range">
5233 > 0
5234 </td>
5235
5236 <td class="entry_notes">
5237 Will not be supported on most devices.<wbr>
5238 </td>
5239
5240 <td class="entry_tags">
5241 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5242 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5243 </ul>
5244 </td>
5245
5246 </tr> <!-- end of entry -->
5247
5248
5249 <tr class="entry" id="controls_android.lens.focusDistance">
5250 <td class="entry_name">android.<wbr>lens.<wbr>focus<wbr>Distance</td>
5251 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5252 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5253
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5254 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5255
5256
5257 </td> <!-- entry_type -->
5258
5259 <td class="entry_description">
5260 Distance to plane of sharpest focus,<wbr>
5261 measured from frontmost surface of the lens
5262 </td>
5263
5264 <td class="entry_units">
5265 diopters (1/<wbr>m)
5266 </td>
5267
5268 <td class="entry_range">
5269 >= 0
5270 </td>
5271
5272 <td class="entry_notes">
5273 0 = infinity focus.<wbr> Used value should be clamped
5274 to (0,<wbr>minimum focus distance)
5275 </td>
5276
5277 <td class="entry_tags">
5278 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5279 <li><a href="#tag_BC">BC</a></li>
5280 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5281 </ul>
5282 </td>
5283
5284 </tr> <!-- end of entry -->
5285
5286
5287 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
5288 <td class="entry_name">android.<wbr>lens.<wbr>optical<wbr>Stabilization<wbr>Mode</td>
5289 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5290 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5291
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5292 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5293
5294 <ul class="entry_type_enum">
5295 <li>
5296 <span class="entry_type_enum_name">OFF</span>
5297 </li>
5298 <li>
5299 <span class="entry_type_enum_name">ON</span>
5300 <span class="entry_type_enum_optional">optional</span>
5301 </li>
5302 </ul>
5303
5304 </td> <!-- entry_type -->
5305
5306 <td class="entry_description">
5307 Whether optical image stabilization is
5308 enabled.<wbr>
5309 </td>
5310
5311 <td class="entry_units">
5312 </td>
5313
5314 <td class="entry_range">
5315 android.<wbr>lens.<wbr>available<wbr>Optical<wbr>Stabilization
5316 </td>
5317
5318 <td class="entry_notes">
5319 Will not be supported on most devices.<wbr>
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_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5325 </ul>
5326 </td>
5327
5328 </tr> <!-- end of entry -->
5329
5330
5331
5332 <!-- end of kind -->
5333 </tbody>
5334 <tr><td colspan="7" class="kind">static</td></tr>
5335
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5336 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5337 <tr>
5338 <th class="th_name">Property Name</th>
5339 <th class="th_type">Type</th>
5340 <th class="th_description">Description</th>
5341 <th class="th_units">Units</th>
5342 <th class="th_range">Range</th>
5343 <th class="th_notes">Notes</th>
5344 <th class="th_tags">Tags</th>
5345 </tr>
5346 </thead>
5347
5348 <tbody>
5349
5350
5351
5352
5353
5354
5355
5356
5357
5358
5359
5360
5361 <tr class="entry" id="static_android.lens.info.availableApertures">
5362 <td class="entry_name">android.<wbr>lens.<wbr>info.<wbr>available<wbr>Apertures</td>
5363 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5364 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5365 <span class="entry_type_container">x</span>
5366
5367 <span class="entry_type_array">
5368 n
5369 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5370 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5371
5372
5373 </td> <!-- entry_type -->
5374
5375 <td class="entry_description">
5376 List of supported aperture
5377 values
5378 </td>
5379
5380 <td class="entry_units">
5381 </td>
5382
5383 <td class="entry_range">
5384 one entry required,<wbr> > 0
5385 </td>
5386
5387 <td class="entry_notes">
5388 If variable aperture not available,<wbr> only setting
5389 should be for the fixed aperture
5390 </td>
5391
5392 <td class="entry_tags">
5393 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5394 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5395 </ul>
5396 </td>
5397
5398 </tr> <!-- end of entry -->
5399
5400
5401 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
5402 <td class="entry_name">android.<wbr>lens.<wbr>info.<wbr>available<wbr>Filter<wbr>Densities</td>
5403 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5404 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5405 <span class="entry_type_container">x</span>
5406
5407 <span class="entry_type_array">
5408 n
5409 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5410 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5411
5412
5413 </td> <!-- entry_type -->
5414
5415 <td class="entry_description">
5416 List of supported ND filter
5417 values
5418 </td>
5419
5420 <td class="entry_units">
5421 </td>
5422
5423 <td class="entry_range">
5424 one entry required,<wbr> >= 0
5425 </td>
5426
5427 <td class="entry_notes">
5428 If not available,<wbr> only setting is 0.<wbr> Otherwise,<wbr>
5429 lists the available exposure index values for dimming
5430 (2 would mean the filter is set to reduce incoming
5431 light by two stops)
5432 </td>
5433
5434 <td class="entry_tags">
5435 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5436 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5437 </ul>
5438 </td>
5439
5440 </tr> <!-- end of entry -->
5441
5442
5443 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
5444 <td class="entry_name">android.<wbr>lens.<wbr>info.<wbr>available<wbr>Focal<wbr>Lengths</td>
5445 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5446 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5447 <span class="entry_type_container">x</span>
5448
5449 <span class="entry_type_array">
5450 n
5451 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5452 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5453 <div class="entry_type_notes">the list of available focal lengths</div>
5454
5455
5456 </td> <!-- entry_type -->
5457
5458 <td class="entry_description">
5459 If fitted with optical zoom,<wbr> what focal
5460 lengths are available.<wbr> If not,<wbr> the static focal
5461 length
5462 </td>
5463
5464 <td class="entry_units">
5465 </td>
5466
5467 <td class="entry_range">
5468 > 0
5469 </td>
5470
5471 <td class="entry_notes">
5472 If optical zoom not supported,<wbr> only one value
5473 should be reported
5474 </td>
5475
5476 <td class="entry_tags">
5477 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5478 <li><a href="#tag_BC">BC</a></li>
5479 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5480 </ul>
5481 </td>
5482
5483 </tr> <!-- end of entry -->
5484
5485
5486 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
5487 <td class="entry_name">android.<wbr>lens.<wbr>info.<wbr>available<wbr>Optical<wbr>Stabilization</td>
5488 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5489 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5490 <span class="entry_type_container">x</span>
5491
5492 <span class="entry_type_array">
5493 n
5494 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5495 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5496 <div class="entry_type_notes">list of enums</div>
5497
5498
5499 </td> <!-- entry_type -->
5500
5501 <td class="entry_description">
5502 List of supported optical image
5503 stabilization modes
5504 </td>
5505
5506 <td class="entry_units">
5507 </td>
5508
5509 <td class="entry_range">
5510 </td>
5511
5512 <td class="entry_notes">
5513 </td>
5514
5515 <td class="entry_tags">
5516 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5517 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5518 </ul>
5519 </td>
5520
5521 </tr> <!-- end of entry -->
5522
5523
5524 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
5525 <td class="entry_name">android.<wbr>lens.<wbr>info.<wbr>geometric<wbr>Correction<wbr>Map</td>
5526 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5527 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5528 <span class="entry_type_container">x</span>
5529
5530 <span class="entry_type_array">
5531 2 x 3 x n x m
5532 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5533 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5534 <div class="entry_type_notes">2D array of destination coordinate pairs for uniform grid points in source image,<wbr> per color channel.<wbr> Size in the range of 2x3x40x30</div>
5535
5536
5537 </td> <!-- entry_type -->
5538
5539 <td class="entry_description">
5540 A low-resolution map for correction of
5541 geometric distortions and chromatic aberrations,<wbr> per
5542 color channel
5543 </td>
5544
5545 <td class="entry_units">
5546 </td>
5547
5548 <td class="entry_range">
5549 N,<wbr> M >= 2
5550 </td>
5551
5552 <td class="entry_notes">
5553 [DNG wants a function instead].<wbr> What's easiest
5554 for implementers? With an array size (M,<wbr> N),<wbr> entry (i,<wbr>
5555 j) provides the destination for pixel (i/<wbr>(M-1) * width,<wbr>
5556 j/<wbr>(N-1) * height).<wbr> Data is row-major,<wbr> with each array
5557 entry being ( (X,<wbr> Y)_<wbr>r,<wbr> (X,<wbr> Y)_<wbr>g,<wbr> (X,<wbr> Y)_<wbr>b ) )
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_DNG">DNG</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.geometricCorrectionMapSize">
5570 <td class="entry_name">android.<wbr>lens.<wbr>info.<wbr>geometric<wbr>Correction<wbr>Map<wbr>Size</td>
5571 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5572 <span class="entry_type_name">int32</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
5577 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]5578 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5579 <div class="entry_type_notes">width and height of geometric correction map</div>
5580
5581
5582 </td> <!-- entry_type -->
5583
5584 <td class="entry_description">
5585 Dimensions of geometric correction
5586 map
5587 </td>
5588
5589 <td class="entry_units">
5590 </td>
5591
5592 <td class="entry_range">
5593 Both values >= 2
5594 </td>
5595
5596 <td class="entry_notes">
5597 </td>
5598
5599 <td class="entry_tags">
5600 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5601 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5602 </ul>
5603 </td>
5604
5605 </tr> <!-- end of entry -->
5606
5607
5608 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
5609 <td class="entry_name">android.<wbr>lens.<wbr>info.<wbr>hyperfocal<wbr>Distance</td>
5610 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5611 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5612
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5613 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5614
5615
5616 </td> <!-- entry_type -->
5617
5618 <td class="entry_description">
5619 Hyperfocal distance for this lens; set to
5620 0 if fixed focus
5621 </td>
5622
5623 <td class="entry_units">
5624 diopters
5625 </td>
5626
5627 <td class="entry_range">
5628 >= 0
5629 </td>
5630
5631 <td class="entry_notes">
5632 The hyperfocal distance is used for the old
5633 API's 'fixed' setting
5634 </td>
5635
5636 <td class="entry_tags">
5637 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5638 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5639 </ul>
5640 </td>
5641
5642 </tr> <!-- end of entry -->
5643
5644
5645 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
5646 <td class="entry_name">android.<wbr>lens.<wbr>info.<wbr>minimum<wbr>Focus<wbr>Distance</td>
5647 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5648 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5649
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5650 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5651
5652
5653 </td> <!-- entry_type -->
5654
5655 <td class="entry_description">
5656 Shortest distance from frontmost surface
5657 of the lens that can be focused correctly
5658 </td>
5659
5660 <td class="entry_units">
5661 diopters
5662 </td>
5663
5664 <td class="entry_range">
5665 >= 0
5666 </td>
5667
5668 <td class="entry_notes">
5669 If the lens is fixed-focus,<wbr> this should be
5670 0
5671 </td>
5672
5673 <td class="entry_tags">
5674 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5675 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5676 </ul>
5677 </td>
5678
5679 </tr> <!-- end of entry -->
5680
5681
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5682 <tr class="entry" id="static_android.lens.info.shadingMapSize">
5683 <td class="entry_name">android.<wbr>lens.<wbr>info.<wbr>shading<wbr>Map<wbr>Size</td>
5684 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5685 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5686 <span class="entry_type_container">x</span>
5687
5688 <span class="entry_type_array">
5689 2
5690 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]5691 <span class="entry_type_visibility"> [public as size]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]5692 <div class="entry_type_notes">width and height of lens shading map provided by the HAL.<wbr> (N,<wbr> M)</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5693
5694
5695 </td> <!-- entry_type -->
5696
5697 <td class="entry_description">
5698 Dimensions of lens shading
5699 map
5700 </td>
5701
5702 <td class="entry_units">
5703 </td>
5704
5705 <td class="entry_range">
5706 Both values >= 1
5707 </td>
5708
5709 <td class="entry_notes">
5710 </td>
5711
5712 <td class="entry_tags">
5713 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5714 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5715 </ul>
5716 </td>
5717
5718 </tr> <!-- end of entry -->
5719
5720
5721
5722
5723
5724 <tr class="entry" id="static_android.lens.facing">
5725 <td class="entry_name">android.<wbr>lens.<wbr>facing</td>
5726 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5727 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5728
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5729 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5730
5731 <ul class="entry_type_enum">
5732 <li>
5733 <span class="entry_type_enum_name">FRONT</span>
5734 </li>
5735 <li>
5736 <span class="entry_type_enum_name">BACK</span>
5737 </li>
5738 </ul>
5739
5740 </td> <!-- entry_type -->
5741
5742 <td class="entry_description">
5743 Direction the camera faces relative to
5744 device screen
5745 </td>
5746
5747 <td class="entry_units">
5748 </td>
5749
5750 <td class="entry_range">
5751 </td>
5752
5753 <td class="entry_notes">
5754 </td>
5755
5756 <td class="entry_tags">
5757 </td>
5758
5759 </tr> <!-- end of entry -->
5760
5761
5762 <tr class="entry" id="static_android.lens.opticalAxisAngle">
5763 <td class="entry_name">android.<wbr>lens.<wbr>optical<wbr>Axis<wbr>Angle</td>
5764 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5765 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5766 <span class="entry_type_container">x</span>
5767
5768 <span class="entry_type_array">
5769 2
5770 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5771 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5772 <div class="entry_type_notes">degrees.<wbr> First defines the angle of separation between the perpendicular to the screen and the camera optical axis.<wbr> The second then defines the clockwise rotation of the optical axis from native device up.<wbr></div>
5773
5774
5775 </td> <!-- entry_type -->
5776
5777 <td class="entry_description">
5778 Relative angle of camera optical axis to the
5779 perpendicular axis from the display
5780 </td>
5781
5782 <td class="entry_units">
5783 </td>
5784
5785 <td class="entry_range">
5786 [0-90) for first angle,<wbr> [0-360) for second
5787 </td>
5788
5789 <td class="entry_notes">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5790 Examples:
5791<br>
5792<br> (0,<wbr>0) means that the camera optical axis
5793 is perpendicular to the display surface;
5794<br>
5795<br> (45,<wbr>0) means that the camera points 45 degrees up when
5796 device is held upright;
5797<br>
5798<br> (45,<wbr>90) means the camera points 45 degrees to the right when
5799 the device is held upright.<wbr>
5800<br>
5801<br> Use FACING field to determine perpendicular outgoing
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5802 direction
5803 </td>
5804
5805 <td class="entry_tags">
5806 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5807 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5808 </ul>
5809 </td>
5810
5811 </tr> <!-- end of entry -->
5812
5813
5814 <tr class="entry" id="static_android.lens.position">
5815 <td class="entry_name">android.<wbr>lens.<wbr>position</td>
5816 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5817 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5818 <span class="entry_type_container">x</span>
5819
5820 <span class="entry_type_array">
5821 3, location in mm, in the sensor coordinate
5822 system
5823 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5824 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5825
5826
5827 </td> <!-- entry_type -->
5828
5829 <td class="entry_description">
5830 Coordinates of camera optical axis on
5831 device
5832 </td>
5833
5834 <td class="entry_units">
5835 </td>
5836
5837 <td class="entry_range">
5838 </td>
5839
5840 <td class="entry_notes">
5841 </td>
5842
5843 <td class="entry_tags">
5844 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5845 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5846 </ul>
5847 </td>
5848
5849 </tr> <!-- end of entry -->
5850
5851
5852
5853 <!-- end of kind -->
5854 </tbody>
5855 <tr><td colspan="7" class="kind">dynamic</td></tr>
5856
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5857 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5858 <tr>
5859 <th class="th_name">Property Name</th>
5860 <th class="th_type">Type</th>
5861 <th class="th_description">Description</th>
5862 <th class="th_units">Units</th>
5863 <th class="th_range">Range</th>
5864 <th class="th_notes">Notes</th>
5865 <th class="th_tags">Tags</th>
5866 </tr>
5867 </thead>
5868
5869 <tbody>
5870
5871
5872
5873
5874
5875
5876
5877
5878
5879
5880 <tr class="entry" id="dynamic_android.lens.aperture">
5881 <td class="entry_name">android.<wbr>lens.<wbr>aperture</td>
5882 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5883 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5884
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5885 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5886
5887
5888 </td> <!-- entry_type -->
5889
5890 <td class="entry_description">
5891 Size of the lens aperture
5892 </td>
5893
5894 <td class="entry_units">
5895 f-number (f/<wbr>NNN)
5896 </td>
5897
5898 <td class="entry_range">
5899 android.<wbr>lens.<wbr>info.<wbr>available<wbr>Apertures
5900 </td>
5901
5902 <td class="entry_notes">
5903 Will not be supported on most devices.<wbr> Can only
5904 pick from supported list
5905 </td>
5906
5907 <td class="entry_tags">
5908 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5909 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5910 </ul>
5911 </td>
5912
5913 </tr> <!-- end of entry -->
5914
5915
5916 <tr class="entry" id="dynamic_android.lens.filterDensity">
5917 <td class="entry_name">android.<wbr>lens.<wbr>filter<wbr>Density</td>
5918 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5919 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5920
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5921 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5922
5923
5924 </td> <!-- entry_type -->
5925
5926 <td class="entry_description">
5927 State of lens neutral density
5928 filter(s)
5929 </td>
5930
5931 <td class="entry_units">
5932 number of stops of filtering
5933 </td>
5934
5935 <td class="entry_range">
5936 android.<wbr>lens.<wbr>info.<wbr>available<wbr>Filter<wbr>Densities
5937 </td>
5938
5939 <td class="entry_notes">
5940 Will not be supported on most devices.<wbr> Can only
5941 pick from supported list
5942 </td>
5943
5944 <td class="entry_tags">
5945 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5946 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5947 </ul>
5948 </td>
5949
5950 </tr> <!-- end of entry -->
5951
5952
5953 <tr class="entry" id="dynamic_android.lens.focalLength">
5954 <td class="entry_name">android.<wbr>lens.<wbr>focal<wbr>Length</td>
5955 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5956 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5957
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5958 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5959
5960
5961 </td> <!-- entry_type -->
5962
5963 <td class="entry_description">
5964 Lens optical zoom setting
5965 </td>
5966
5967 <td class="entry_units">
5968 focal length in mm
5969 </td>
5970
5971 <td class="entry_range">
5972 > 0
5973 </td>
5974
5975 <td class="entry_notes">
5976 Will not be supported on most devices.<wbr>
5977 </td>
5978
5979 <td class="entry_tags">
5980 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5981 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5982 </ul>
5983 </td>
5984
5985 </tr> <!-- end of entry -->
5986
5987
5988 <tr class="entry" id="dynamic_android.lens.focusDistance">
5989 <td class="entry_name">android.<wbr>lens.<wbr>focus<wbr>Distance</td>
5990 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5991 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5992
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5993 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5994
5995
5996 </td> <!-- entry_type -->
5997
5998 <td class="entry_description">
5999 Distance to plane of sharpest focus,<wbr>
6000 measured from frontmost surface of the lens
6001 </td>
6002
6003 <td class="entry_units">
6004 diopters (1/<wbr>m)
6005 </td>
6006
6007 <td class="entry_range">
6008 >= 0
6009 </td>
6010
6011 <td class="entry_notes">
6012 Should be zero for fixed-focus cameras
6013 </td>
6014
6015 <td class="entry_tags">
6016 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6017 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6018 </ul>
6019 </td>
6020
6021 </tr> <!-- end of entry -->
6022
6023
6024 <tr class="entry" id="dynamic_android.lens.focusRange">
6025 <td class="entry_name">android.<wbr>lens.<wbr>focus<wbr>Range</td>
6026 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6027 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6028
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6029 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6030
6031
6032 </td> <!-- entry_type -->
6033
6034 <td class="entry_description">
6035 The range of scene distances that are in
6036 sharp focus (depth of field)
6037 </td>
6038
6039 <td class="entry_units">
6040 pair of focus distances in diopters: (near,<wbr>
6041 far)
6042 </td>
6043
6044 <td class="entry_range">
6045 >=0
6046 </td>
6047
6048 <td class="entry_notes">
6049 If variable focus not supported,<wbr> can still report
6050 fixed depth of field range
6051 </td>
6052
6053 <td class="entry_tags">
6054 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6055 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6056 </ul>
6057 </td>
6058
6059 </tr> <!-- end of entry -->
6060
6061
6062 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
6063 <td class="entry_name">android.<wbr>lens.<wbr>optical<wbr>Stabilization<wbr>Mode</td>
6064 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6065 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6066
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6067 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6068
6069 <ul class="entry_type_enum">
6070 <li>
6071 <span class="entry_type_enum_name">OFF</span>
6072 </li>
6073 <li>
6074 <span class="entry_type_enum_name">ON</span>
6075 <span class="entry_type_enum_optional">optional</span>
6076 </li>
6077 </ul>
6078
6079 </td> <!-- entry_type -->
6080
6081 <td class="entry_description">
6082 Whether optical image stabilization is
6083 enabled.<wbr>
6084 </td>
6085
6086 <td class="entry_units">
6087 </td>
6088
6089 <td class="entry_range">
6090 android.<wbr>lens.<wbr>available<wbr>Optical<wbr>Stabilization
6091 </td>
6092
6093 <td class="entry_notes">
6094 Will not be supported on most devices.<wbr>
6095 </td>
6096
6097 <td class="entry_tags">
6098 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6099 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6100 </ul>
6101 </td>
6102
6103 </tr> <!-- end of entry -->
6104
6105
6106 <tr class="entry" id="dynamic_android.lens.state">
6107 <td class="entry_name">android.<wbr>lens.<wbr>state</td>
6108 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6109 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6110
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6111 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6112
6113 <ul class="entry_type_enum">
6114 <li>
6115 <span class="entry_type_enum_name">STATIONARY</span>
6116 </li>
6117 </ul>
6118
6119 </td> <!-- entry_type -->
6120
6121 <td class="entry_description">
6122 Current lens status
6123 </td>
6124
6125 <td class="entry_units">
6126 </td>
6127
6128 <td class="entry_range">
6129 </td>
6130
6131 <td class="entry_notes">
6132 </td>
6133
6134 <td class="entry_tags">
6135 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6136 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6137 </ul>
6138 </td>
6139
6140 </tr> <!-- end of entry -->
6141
6142
6143
6144 <!-- end of kind -->
6145 </tbody>
6146
6147 <!-- end of section -->
6148 <tr><td colspan="7" id="section_noiseReduction" class="section">noiseReduction</td></tr>
6149
6150
6151 <tr><td colspan="7" class="kind">controls</td></tr>
6152
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6153 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6154 <tr>
6155 <th class="th_name">Property Name</th>
6156 <th class="th_type">Type</th>
6157 <th class="th_description">Description</th>
6158 <th class="th_units">Units</th>
6159 <th class="th_range">Range</th>
6160 <th class="th_notes">Notes</th>
6161 <th class="th_tags">Tags</th>
6162 </tr>
6163 </thead>
6164
6165 <tbody>
6166
6167
6168
6169
6170
6171
6172
6173
6174
6175
6176 <tr class="entry" id="controls_android.noiseReduction.mode">
6177 <td class="entry_name">android.<wbr>noise<wbr>Reduction.<wbr>mode</td>
6178 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6179 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6180
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6181 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6182
6183 <ul class="entry_type_enum">
6184 <li>
6185 <span class="entry_type_enum_name">OFF</span>
6186 <span class="entry_type_enum_notes">No noise reduction is applied</span>
6187 </li>
6188 <li>
6189 <span class="entry_type_enum_name">FAST</span>
6190 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
6191 bayer output</span>
6192 </li>
6193 <li>
6194 <span class="entry_type_enum_name">HIGH_QUALITY</span>
6195 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
6196 quality</span>
6197 </li>
6198 </ul>
6199
6200 </td> <!-- entry_type -->
6201
6202 <td class="entry_description">
6203 Mode of operation for the noise reduction
6204 algorithm
6205 </td>
6206
6207 <td class="entry_units">
6208 </td>
6209
6210 <td class="entry_range">
6211 android.<wbr>noise<wbr>Reduction.<wbr>available<wbr>Modes
6212 </td>
6213
6214 <td class="entry_notes">
6215 </td>
6216
6217 <td class="entry_tags">
6218 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6219 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6220 </ul>
6221 </td>
6222
6223 </tr> <!-- end of entry -->
6224
6225
6226 <tr class="entry" id="controls_android.noiseReduction.strength">
6227 <td class="entry_name">android.<wbr>noise<wbr>Reduction.<wbr>strength</td>
6228 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6229 <span class="entry_type_name">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"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6232
6233
6234 </td> <!-- entry_type -->
6235
6236 <td class="entry_description">
6237 Control the amount of noise reduction
6238 applied to the images
6239 </td>
6240
6241 <td class="entry_units">
6242 1-10; 10 is max noise reduction
6243 </td>
6244
6245 <td class="entry_range">
6246 1 - 10
6247 </td>
6248
6249 <td class="entry_notes">
6250 </td>
6251
6252 <td class="entry_tags">
6253 </td>
6254
6255 </tr> <!-- end of entry -->
6256
6257
6258
6259 <!-- end of kind -->
6260 </tbody>
6261 <tr><td colspan="7" class="kind">dynamic</td></tr>
6262
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6263 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6264 <tr>
6265 <th class="th_name">Property Name</th>
6266 <th class="th_type">Type</th>
6267 <th class="th_description">Description</th>
6268 <th class="th_units">Units</th>
6269 <th class="th_range">Range</th>
6270 <th class="th_notes">Notes</th>
6271 <th class="th_tags">Tags</th>
6272 </tr>
6273 </thead>
6274
6275 <tbody>
6276
6277
6278
6279
6280
6281
6282
6283
6284
6285
6286 <tr class="entry" id="dynamic_android.noiseReduction.mode">
6287 <td class="entry_name">android.<wbr>noise<wbr>Reduction.<wbr>mode</td>
6288 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6289 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6290
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6291 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6292
6293 <ul class="entry_type_enum">
6294 <li>
6295 <span class="entry_type_enum_name">OFF</span>
6296 <span class="entry_type_enum_notes">No noise reduction is applied</span>
6297 </li>
6298 <li>
6299 <span class="entry_type_enum_name">FAST</span>
6300 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
6301 bayer output</span>
6302 </li>
6303 <li>
6304 <span class="entry_type_enum_name">HIGH_QUALITY</span>
6305 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
6306 quality</span>
6307 </li>
6308 </ul>
6309
6310 </td> <!-- entry_type -->
6311
6312 <td class="entry_description">
6313 Mode of operation for the noise reduction
6314 algorithm
6315 </td>
6316
6317 <td class="entry_units">
6318 </td>
6319
6320 <td class="entry_range">
6321 android.<wbr>noise<wbr>Reduction.<wbr>available<wbr>Modes
6322 </td>
6323
6324 <td class="entry_notes">
6325 </td>
6326
6327 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6328 <ul class="entry_tags">
6329 <li><a href="#tag_V1">V1</a></li>
6330 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6331 </td>
6332
6333 </tr> <!-- end of entry -->
6334
6335
6336
6337 <!-- end of kind -->
6338 </tbody>
6339
6340 <!-- end of section -->
6341 <tr><td colspan="7" id="section_quirks" class="section">quirks</td></tr>
6342
6343
6344 <tr><td colspan="7" class="kind">static</td></tr>
6345
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6346 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6347 <tr>
6348 <th class="th_name">Property Name</th>
6349 <th class="th_type">Type</th>
6350 <th class="th_description">Description</th>
6351 <th class="th_units">Units</th>
6352 <th class="th_range">Range</th>
6353 <th class="th_notes">Notes</th>
6354 <th class="th_tags">Tags</th>
6355 </tr>
6356 </thead>
6357
6358 <tbody>
6359
6360
6361
6362
6363
6364
6365
6366
6367
6368
6369 <tr class="entry" id="static_android.quirks.meteringCropRegion">
6370 <td class="entry_name">android.<wbr>quirks.<wbr>metering<wbr>Crop<wbr>Region</td>
6371 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6372 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6373
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6374 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6375
6376
6377 </td> <!-- entry_type -->
6378
6379 <td class="entry_description">
6380 If set to 1,<wbr> the camera service does not
6381 scale 'normalized' coordinates with respect to the crop
6382 region.<wbr> This applies to metering input (a{e,<wbr>f,<wbr>wb}Region
6383 and output (face rectangles).<wbr>
6384 </td>
6385
6386 <td class="entry_units">
6387 </td>
6388
6389 <td class="entry_range">
6390 </td>
6391
6392 <td class="entry_notes">
6393 Normalized coordinates refer to those in the
6394 (-1000,<wbr>1000) range mentioned in the
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6395 android.<wbr>hardware.<wbr><wbr>Camera API.<wbr>
6396<br>
6397<br> HAL implementations should instead always use and emit
6398 sensor array-relative coordinates for all region data.<wbr> Does
6399 not need to be listed in static metadata.<wbr> Support will be
6400 removed in future versions of camera service.<wbr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6401 </td>
6402
6403 <td class="entry_tags">
6404 </td>
6405
6406 </tr> <!-- end of entry -->
6407
6408
6409 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
6410 <td class="entry_name">android.<wbr>quirks.<wbr>trigger<wbr>Af<wbr>With<wbr>Auto</td>
6411 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6412 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6413
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6414 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6415
6416
6417 </td> <!-- entry_type -->
6418
6419 <td class="entry_description">
6420 If set to 1,<wbr> then the camera service always
6421 switches to FOCUS_<wbr>MODE_<wbr>AUTO before issuing a AF
6422 trigger.<wbr>
6423 </td>
6424
6425 <td class="entry_units">
6426 </td>
6427
6428 <td class="entry_range">
6429 </td>
6430
6431 <td class="entry_notes">
6432 HAL implementations should implement AF trigger
6433 modes for AUTO,<wbr> MACRO,<wbr> CONTINUOUS_<wbr>FOCUS,<wbr> and
6434 CONTINUOUS_<wbr>PICTURE modes instead of using this flag.<wbr> Does
6435 not need to be listed in static metadata.<wbr> Support will be
6436 removed in future versions of camera service
6437 </td>
6438
6439 <td class="entry_tags">
6440 </td>
6441
6442 </tr> <!-- end of entry -->
6443
6444
6445 <tr class="entry" id="static_android.quirks.useZslFormat">
6446 <td class="entry_name">android.<wbr>quirks.<wbr>use<wbr>Zsl<wbr>Format</td>
6447 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6448 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6449
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6450 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6451
6452
6453 </td> <!-- entry_type -->
6454
6455 <td class="entry_description">
6456 If set to 1,<wbr> the camera service uses
6457 CAMERA2_<wbr>PIXEL_<wbr>FORMAT_<wbr>ZSL instead of
6458 HAL_<wbr>PIXEL_<wbr>FORMAT_<wbr>IMPLEMENTATION_<wbr>DEFINED for the zero
6459 shutter lag stream
6460 </td>
6461
6462 <td class="entry_units">
6463 </td>
6464
6465 <td class="entry_range">
6466 </td>
6467
6468 <td class="entry_notes">
6469 HAL implementations should use gralloc usage flags
6470 to determine that a stream will be used for
6471 zero-shutter-lag,<wbr> instead of relying on an explicit
6472 format setting.<wbr> Does not need to be listed in static
6473 metadata.<wbr> Support will be removed in future versions of
6474 camera service.<wbr>
6475 </td>
6476
6477 <td class="entry_tags">
6478 </td>
6479
6480 </tr> <!-- end of entry -->
6481
6482
6483
6484 <!-- end of kind -->
6485 </tbody>
6486
6487 <!-- end of section -->
6488 <tr><td colspan="7" id="section_request" class="section">request</td></tr>
6489
6490
6491 <tr><td colspan="7" class="kind">controls</td></tr>
6492
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6493 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6494 <tr>
6495 <th class="th_name">Property Name</th>
6496 <th class="th_type">Type</th>
6497 <th class="th_description">Description</th>
6498 <th class="th_units">Units</th>
6499 <th class="th_range">Range</th>
6500 <th class="th_notes">Notes</th>
6501 <th class="th_tags">Tags</th>
6502 </tr>
6503 </thead>
6504
6505 <tbody>
6506
6507
6508
6509
6510
6511
6512
6513
6514
6515
6516 <tr class="entry" id="controls_android.request.frameCount">
6517 <td class="entry_name">android.<wbr>request.<wbr>frame<wbr>Count</td>
6518 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6519 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6520
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6521 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6522
6523
6524 </td> <!-- entry_type -->
6525
6526 <td class="entry_description">
6527 A frame counter set by the framework.<wbr> Must
6528 be maintained unchanged in output frame
6529 </td>
6530
6531 <td class="entry_units">
6532 incrementing integer
6533 </td>
6534
6535 <td class="entry_range">
6536 Any int
6537 </td>
6538
6539 <td class="entry_notes">
6540 </td>
6541
6542 <td class="entry_tags">
6543 </td>
6544
6545 </tr> <!-- end of entry -->
6546
6547
6548 <tr class="entry" id="controls_android.request.id">
6549 <td class="entry_name">android.<wbr>request.<wbr>id</td>
6550 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6551 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6552
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6553 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6554
6555
6556 </td> <!-- entry_type -->
6557
6558 <td class="entry_description">
6559 An application-specified ID for the current
6560 request.<wbr> Must be maintained unchanged in output
6561 frame
6562 </td>
6563
6564 <td class="entry_units">
6565 arbitrary integer assigned by application
6566 </td>
6567
6568 <td class="entry_range">
6569 Any int
6570 </td>
6571
6572 <td class="entry_notes">
6573 </td>
6574
6575 <td class="entry_tags">
6576 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6577 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6578 </ul>
6579 </td>
6580
6581 </tr> <!-- end of entry -->
6582
6583
6584 <tr class="entry" id="controls_android.request.inputStreams">
6585 <td class="entry_name">android.<wbr>request.<wbr>input<wbr>Streams</td>
6586 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6587 <span class="entry_type_name">byte</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6588 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6589
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6590 <span class="entry_type_array">
6591 n
6592 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6593 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6594
6595
6596 </td> <!-- entry_type -->
6597
6598 <td class="entry_description">
6599 List which camera reprocess stream is used
6600 for the source of reprocessing data.<wbr>
6601 </td>
6602
6603 <td class="entry_units">
6604 List of camera reprocess stream IDs
6605 </td>
6606
6607 <td class="entry_range">
6608 Typically,<wbr> only one entry allowed,<wbr> must be a valid
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6609 reprocess stream ID.<wbr>
6610
6611 If android.<wbr>jpeg.<wbr>needs<wbr>Thumbnail is set,<wbr> then multiple
6612 reprocess streams may be included in a single request; they
6613 must be different scaled versions of the same image.<wbr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6614 </td>
6615
6616 <td class="entry_notes">
6617 Only meaningful when android.<wbr>request.<wbr>type ==
6618 REPROCESS.<wbr> Ignored otherwise
6619 </td>
6620
6621 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6622 <ul class="entry_tags">
6623 <li><a href="#tag_HAL2">HAL2</a></li>
6624 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6625 </td>
6626
6627 </tr> <!-- end of entry -->
6628
6629
6630 <tr class="entry" id="controls_android.request.metadataMode">
6631 <td class="entry_name">android.<wbr>request.<wbr>metadata<wbr>Mode</td>
6632 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6633 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6634
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6635 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6636
6637 <ul class="entry_type_enum">
6638 <li>
6639 <span class="entry_type_enum_name">NONE</span>
6640 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr> except
6641 for application-bound buffer data.<wbr> If no
6642 application-bound streams exist,<wbr> no frame should be
6643 placed in the output frame queue.<wbr> If such streams
6644 exist,<wbr> a frame should be placed on the output queue
6645 with null metadata but with the necessary output buffer
6646 information.<wbr> Timestamp information should still be
6647 included with any output stream buffers</span>
6648 </li>
6649 <li>
6650 <span class="entry_type_enum_name">FULL</span>
6651 <span class="entry_type_enum_notes">All metadata should be produced.<wbr> Statistics will
6652 only be produced if they are separately
6653 enabled</span>
6654 </li>
6655 </ul>
6656
6657 </td> <!-- entry_type -->
6658
6659 <td class="entry_description">
6660 How much metadata to produce on
6661 output
6662 </td>
6663
6664 <td class="entry_units">
6665 </td>
6666
6667 <td class="entry_range">
6668 </td>
6669
6670 <td class="entry_notes">
6671 </td>
6672
6673 <td class="entry_tags">
6674 </td>
6675
6676 </tr> <!-- end of entry -->
6677
6678
6679 <tr class="entry" id="controls_android.request.outputStreams">
6680 <td class="entry_name">android.<wbr>request.<wbr>output<wbr>Streams</td>
6681 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6682 <span class="entry_type_name">byte</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6683 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6684
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6685 <span class="entry_type_array">
6686 n
6687 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6688 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6689
6690
6691 </td> <!-- entry_type -->
6692
6693 <td class="entry_description">
6694 Lists which camera output streams image data
6695 from this capture must be sent to
6696 </td>
6697
6698 <td class="entry_units">
6699 List of camera stream IDs
6700 </td>
6701
6702 <td class="entry_range">
6703 List must only include streams that have been
6704 created
6705 </td>
6706
6707 <td class="entry_notes">
6708 If no output streams are listed,<wbr> then the image
6709 data should simply be discarded.<wbr> The image data must
6710 still be captured for metadata and statistics production,<wbr>
6711 and the lens and flash must operate as requested.<wbr>
6712 </td>
6713
6714 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6715 <ul class="entry_tags">
6716 <li><a href="#tag_HAL2">HAL2</a></li>
6717 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6718 </td>
6719
6720 </tr> <!-- end of entry -->
6721
6722
6723 <tr class="entry" id="controls_android.request.type">
6724 <td class="entry_name">android.<wbr>request.<wbr>type</td>
6725 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6726 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6727
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6728 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6729
6730 <ul class="entry_type_enum">
6731 <li>
6732 <span class="entry_type_enum_name">CAPTURE</span>
6733 <span class="entry_type_enum_notes">Capture a new image from the imaging hardware,<wbr>
6734 and process it according to the
6735 settings</span>
6736 </li>
6737 <li>
6738 <span class="entry_type_enum_name">REPROCESS</span>
6739 <span class="entry_type_enum_notes">Process previously captured data; the
6740 android.<wbr>request.<wbr>input<wbr>Stream parameter determines the
6741 source reprocessing stream.<wbr> TODO: Mark dynamic metadata
6742 needed for reprocessing with [RP]</span>
6743 </li>
6744 </ul>
6745
6746 </td> <!-- entry_type -->
6747
6748 <td class="entry_description">
6749 The type of the request; either CAPTURE or
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6750 REPROCESS.<wbr> For HAL3,<wbr> this tag is redundant.<wbr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6751 </td>
6752
6753 <td class="entry_units">
6754 </td>
6755
6756 <td class="entry_range">
6757 </td>
6758
6759 <td class="entry_notes">
6760 </td>
6761
6762 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]6763 <ul class="entry_tags">
6764 <li><a href="#tag_HAL2">HAL2</a></li>
6765 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6766 </td>
6767
6768 </tr> <!-- end of entry -->
6769
6770
6771
6772 <!-- end of kind -->
6773 </tbody>
6774 <tr><td colspan="7" class="kind">static</td></tr>
6775
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6776 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6777 <tr>
6778 <th class="th_name">Property Name</th>
6779 <th class="th_type">Type</th>
6780 <th class="th_description">Description</th>
6781 <th class="th_units">Units</th>
6782 <th class="th_range">Range</th>
6783 <th class="th_notes">Notes</th>
6784 <th class="th_tags">Tags</th>
6785 </tr>
6786 </thead>
6787
6788 <tbody>
6789
6790
6791
6792
6793
6794
6795
6796
6797
6798
6799 <tr class="entry" id="static_android.request.maxNumOutputStreams">
6800 <td class="entry_name">android.<wbr>request.<wbr>max<wbr>Num<wbr>Output<wbr>Streams</td>
6801 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6802 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6803 <span class="entry_type_container">x</span>
6804
6805 <span class="entry_type_array">
6806 3
6807 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6808 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6809
6810
6811 </td> <!-- entry_type -->
6812
6813 <td class="entry_description">
6814 How many output streams can be allocated at
6815 the same time for each type of stream
6816 </td>
6817
6818 <td class="entry_units">
6819 The number of raw sensor streams; the number of
6820 processed,<wbr> uncompressed streams; and the number of
6821 JPEG-compressed streams
6822 </td>
6823
6824 <td class="entry_range">
6825 >=1 for Raw and JPEG-compressed stream.<wbr> >= 3
6826 for processed,<wbr> uncompressed streams
6827 </td>
6828
6829 <td class="entry_notes">
6830 Video snapshot with preview callbacks requires 3
6831 processed streams (preview,<wbr> record,<wbr> app callbacks) and
6832 one JPEG stream (snapshot)
6833 </td>
6834
6835 <td class="entry_tags">
6836 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6837 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6838 </ul>
6839 </td>
6840
6841 </tr> <!-- end of entry -->
6842
6843
6844 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
6845 <td class="entry_name">android.<wbr>request.<wbr>max<wbr>Num<wbr>Reprocess<wbr>Streams</td>
6846 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6847 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6848 <span class="entry_type_container">x</span>
6849
6850 <span class="entry_type_array">
6851 1
6852 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6853 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6854
6855
6856 </td> <!-- entry_type -->
6857
6858 <td class="entry_description">
6859 How many reprocessing streams of any type
6860 can be allocated at the same time
6861 </td>
6862
6863 <td class="entry_units">
6864 </td>
6865
6866 <td class="entry_range">
6867 >= 1
6868 </td>
6869
6870 <td class="entry_notes">
6871 </td>
6872
6873 <td class="entry_tags">
6874 </td>
6875
6876 </tr> <!-- end of entry -->
6877
6878
6879
6880 <!-- end of kind -->
6881 </tbody>
6882 <tr><td colspan="7" class="kind">dynamic</td></tr>
6883
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6884 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6885 <tr>
6886 <th class="th_name">Property Name</th>
6887 <th class="th_type">Type</th>
6888 <th class="th_description">Description</th>
6889 <th class="th_units">Units</th>
6890 <th class="th_range">Range</th>
6891 <th class="th_notes">Notes</th>
6892 <th class="th_tags">Tags</th>
6893 </tr>
6894 </thead>
6895
6896 <tbody>
6897
6898
6899
6900
6901
6902
6903
6904
6905
6906
6907 <tr class="entry" id="dynamic_android.request.frameCount">
6908 <td class="entry_name">android.<wbr>request.<wbr>frame<wbr>Count</td>
6909 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6910 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6911
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6912 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6913
6914
6915 </td> <!-- entry_type -->
6916
6917 <td class="entry_description">
6918 Number of frames captured since
6919 open()
6920 </td>
6921
6922 <td class="entry_units">
6923 count of frames
6924 </td>
6925
6926 <td class="entry_range">
6927 > 0
6928 </td>
6929
6930 <td class="entry_notes">
6931 Reset on release()
6932 </td>
6933
6934 <td class="entry_tags">
6935 </td>
6936
6937 </tr> <!-- end of entry -->
6938
6939
6940 <tr class="entry" id="dynamic_android.request.id">
6941 <td class="entry_name">android.<wbr>request.<wbr>id</td>
6942 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6943 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6944
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6945 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6946
6947
6948 </td> <!-- entry_type -->
6949
6950 <td class="entry_description">
6951 An application-specified ID for the current
6952 request.<wbr> Must be maintained unchanged in output
6953 frame
6954 </td>
6955
6956 <td class="entry_units">
6957 arbitrary integer assigned by application
6958 </td>
6959
6960 <td class="entry_range">
6961 Any int
6962 </td>
6963
6964 <td class="entry_notes">
6965 </td>
6966
6967 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6968 <ul class="entry_tags">
6969 <li><a href="#tag_V1">V1</a></li>
6970 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6971 </td>
6972
6973 </tr> <!-- end of entry -->
6974
6975
6976 <tr class="entry" id="dynamic_android.request.metadataMode">
6977 <td class="entry_name">android.<wbr>request.<wbr>metadata<wbr>Mode</td>
6978 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6979 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6980
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6981 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6982
6983 <ul class="entry_type_enum">
6984 <li>
6985 <span class="entry_type_enum_name">NONE</span>
6986 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr> except
6987 for application-bound buffer data.<wbr> If no
6988 application-bound streams exist,<wbr> no frame should be
6989 placed in the output frame queue.<wbr> If such streams
6990 exist,<wbr> a frame should be placed on the output queue
6991 with null metadata but with the necessary output buffer
6992 information.<wbr> Timestamp information should still be
6993 included with any output stream buffers</span>
6994 </li>
6995 <li>
6996 <span class="entry_type_enum_name">FULL</span>
6997 <span class="entry_type_enum_notes">All metadata should be produced.<wbr> Statistics will
6998 only be produced if they are separately
6999 enabled</span>
7000 </li>
7001 </ul>
7002
7003 </td> <!-- entry_type -->
7004
7005 <td class="entry_description">
7006 How much metadata to produce on
7007 output
7008 </td>
7009
7010 <td class="entry_units">
7011 </td>
7012
7013 <td class="entry_range">
7014 </td>
7015
7016 <td class="entry_notes">
7017 </td>
7018
7019 <td class="entry_tags">
7020 </td>
7021
7022 </tr> <!-- end of entry -->
7023
7024
7025 <tr class="entry" id="dynamic_android.request.outputStreams">
7026 <td class="entry_name">android.<wbr>request.<wbr>output<wbr>Streams</td>
7027 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7028 <span class="entry_type_name">byte</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7029 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7030
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7031 <span class="entry_type_array">
7032 n
7033 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7034 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7035
7036
7037 </td> <!-- entry_type -->
7038
7039 <td class="entry_description">
7040 Lists which camera output streams image data
7041 from this capture must be sent to
7042 </td>
7043
7044 <td class="entry_units">
7045 List of camera stream IDs
7046 </td>
7047
7048 <td class="entry_range">
7049 List must only include streams that have been
7050 created
7051 </td>
7052
7053 <td class="entry_notes">
7054 If no output streams are listed,<wbr> then the image
7055 data should simply be discarded.<wbr> The image data must
7056 still be captured for metadata and statistics production,<wbr>
7057 and the lens and flash must operate as requested.<wbr>
7058 </td>
7059
7060 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7061 <ul class="entry_tags">
7062 <li><a href="#tag_HAL2">HAL2</a></li>
7063 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7064 </td>
7065
7066 </tr> <!-- end of entry -->
7067
7068
7069
7070 <!-- end of kind -->
7071 </tbody>
7072
7073 <!-- end of section -->
7074 <tr><td colspan="7" id="section_scaler" class="section">scaler</td></tr>
7075
7076
7077 <tr><td colspan="7" class="kind">controls</td></tr>
7078
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7079 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7080 <tr>
7081 <th class="th_name">Property Name</th>
7082 <th class="th_type">Type</th>
7083 <th class="th_description">Description</th>
7084 <th class="th_units">Units</th>
7085 <th class="th_range">Range</th>
7086 <th class="th_notes">Notes</th>
7087 <th class="th_tags">Tags</th>
7088 </tr>
7089 </thead>
7090
7091 <tbody>
7092
7093
7094
7095
7096
7097
7098
7099
7100
7101
7102 <tr class="entry" id="controls_android.scaler.cropRegion">
7103 <td class="entry_name">android.<wbr>scaler.<wbr>crop<wbr>Region</td>
7104 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7105 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7106 <span class="entry_type_container">x</span>
7107
7108 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7109 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7110 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]7111 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7112
7113
7114 </td> <!-- entry_type -->
7115
7116 <td class="entry_description">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7117 (x,<wbr> y,<wbr> width,<wbr> height).<wbr>
7118<br>
7119<br> A rectangle with the top-level corner of (x,<wbr>y) and size
7120 (width,<wbr> height).<wbr> The region of the sensor that is used for
7121 output.<wbr> Each stream must use this rectangle to produce its
7122 output,<wbr> cropping to a smaller region if necessary to
7123 maintain the stream's aspect ratio.<wbr>
7124<br>
7125<br> HAL2.<wbr>x uses only (x,<wbr> y,<wbr> width)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7126 </td>
7127
7128 <td class="entry_units">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7129 (x,<wbr>y) of top-left corner,<wbr> width and height of region
7130 in pixels; (0,<wbr>0) is top-left corner of
Zhijun Hebd7f15b2013-05-13 16:59:51 -0700[diff] [blame]7131 android.<wbr>sensor.<wbr>active<wbr>Array<wbr>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7132 </td>
7133
7134 <td class="entry_range">
7135 </td>
7136
7137 <td class="entry_notes">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7138
7139 Any additional per-stream cropping must be done to
7140 maximize the final pixel area of the stream.<wbr>
7141<br>
7142<br> For example,<wbr> if the crop region is set to a 4:3 aspect
7143 ratio,<wbr> then 4:3 streams should use the exact crop
7144 region.<wbr> 16:9 streams should further crop vertically
7145 (letterbox).<wbr>
7146<br>
7147<br> Conversely,<wbr> if the crop region is set to a 16:9,<wbr> then 4:3
7148 outputs should crop horizontally (pillarbox),<wbr> and 16:9
7149 streams should match exactly.<wbr> These additional crops must
7150 be centered within the crop region.<wbr>
7151<br>
7152<br> The output streams must maintain square pixels at all
7153 times,<wbr> no matter what the relative aspect ratios of the
7154 crop region and the stream are.<wbr> Negative values for
7155 corner are allowed for raw output if full pixel array is
7156 larger than active pixel array.<wbr> Width and height may be
7157 rounded to nearest larger supportable width,<wbr> especially
7158 for raw output,<wbr> where only a few fixed scales may be
7159 possible.<wbr> The width and height of the crop region cannot
Zhijun Hebd7f15b2013-05-13 16:59:51 -0700[diff] [blame]7160 be set to be smaller than floor( activeArraySize.<wbr>width /<wbr>
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7161 android.<wbr>scaler.<wbr>max<wbr>Digital<wbr>Zoom ) and floor(
Zhijun Hebd7f15b2013-05-13 16:59:51 -0700[diff] [blame]7162 activeArraySize.<wbr>height /<wbr> android.<wbr>scaler.<wbr>max<wbr>Digital<wbr>Zoom),<wbr>
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7163 respectively.<wbr>
7164
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7165 </td>
7166
7167 <td class="entry_tags">
7168 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7169 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7170 </ul>
7171 </td>
7172
7173 </tr> <!-- end of entry -->
7174
7175
7176
7177 <!-- end of kind -->
7178 </tbody>
7179 <tr><td colspan="7" class="kind">static</td></tr>
7180
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7181 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7182 <tr>
7183 <th class="th_name">Property Name</th>
7184 <th class="th_type">Type</th>
7185 <th class="th_description">Description</th>
7186 <th class="th_units">Units</th>
7187 <th class="th_range">Range</th>
7188 <th class="th_notes">Notes</th>
7189 <th class="th_tags">Tags</th>
7190 </tr>
7191 </thead>
7192
7193 <tbody>
7194
7195
7196
7197
7198
7199
7200
7201
7202
7203
7204 <tr class="entry" id="static_android.scaler.availableFormats">
7205 <td class="entry_name">android.<wbr>scaler.<wbr>available<wbr>Formats</td>
7206 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7207 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7208 <span class="entry_type_container">x</span>
7209
7210 <span class="entry_type_array">
7211 n
7212 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7213 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7214 <div class="entry_type_notes">values from HAL_<wbr>PIXEL_<wbr>FORMAT_<wbr>* in /<wbr>system/<wbr>core/<wbr>include/<wbr>system/<wbr>graphics.<wbr>h</div>
7215
7216 <ul class="entry_type_enum">
7217 <li>
7218 <span class="entry_type_enum_name">RAW_SENSOR</span>
7219 <span class="entry_type_enum_value">0x20</span>
7220 </li>
7221 <li>
7222 <span class="entry_type_enum_name">YV12</span>
7223 <span class="entry_type_enum_value">0x32315659</span>
7224 <span class="entry_type_enum_notes">YCrCb 4:2:0 Planar</span>
7225 </li>
7226 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]7227 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7228 <span class="entry_type_enum_value">0x11</span>
7229 <span class="entry_type_enum_notes">NV21</span>
7230 </li>
7231 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]7232 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
7233 <span class="entry_type_enum_value">0x22</span>
7234 <span class="entry_type_enum_notes">Hal Implementation Defined</span>
7235 </li>
7236 <li>
7237 <span class="entry_type_enum_name">YCbCr_420_888</span>
7238 <span class="entry_type_enum_value">0x23</span>
7239 <span class="entry_type_enum_notes">Flexible YUV420 Format</span>
7240 </li>
7241 <li>
7242 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7243 <span class="entry_type_enum_value">0x21</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]7244 <span class="entry_type_enum_notes">JPEG</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7245 </li>
7246 </ul>
7247
7248 </td> <!-- entry_type -->
7249
7250 <td class="entry_description">
7251 List of app-visible formats
7252 </td>
7253
7254 <td class="entry_units">
7255 </td>
7256
7257 <td class="entry_range">
7258 </td>
7259
7260 <td class="entry_notes">
7261 </td>
7262
7263 <td class="entry_tags">
7264 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7265 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7266 </ul>
7267 </td>
7268
7269 </tr> <!-- end of entry -->
7270
7271
7272 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
7273 <td class="entry_name">android.<wbr>scaler.<wbr>available<wbr>Jpeg<wbr>Min<wbr>Durations</td>
7274 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7275 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7276 <span class="entry_type_container">x</span>
7277
7278 <span class="entry_type_array">
7279 n
7280 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7281 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7282
7283
7284 </td> <!-- entry_type -->
7285
7286 <td class="entry_description">
7287 The minimum frame duration that is supported
7288 for each resolution in availableJpegSizes.<wbr> Should
7289 correspond to the frame duration when only that JPEG
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]7290 stream is active and captured in a burst,<wbr> with all
7291 processing set to FAST
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7292 </td>
7293
7294 <td class="entry_units">
7295 </td>
7296
7297 <td class="entry_range">
7298 </td>
7299
7300 <td class="entry_notes">
7301 When multiple streams are configured,<wbr> the minimum
7302 frame duration will be >= max(individual stream min
7303 durations)
7304 </td>
7305
7306 <td class="entry_tags">
7307 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7308 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7309 </ul>
7310 </td>
7311
7312 </tr> <!-- end of entry -->
7313
7314
7315 <tr class="entry" id="static_android.scaler.availableJpegSizes">
7316 <td class="entry_name">android.<wbr>scaler.<wbr>available<wbr>Jpeg<wbr>Sizes</td>
7317 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7318 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7319 <span class="entry_type_container">x</span>
7320
7321 <span class="entry_type_array">
7322 n x 2
7323 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]7324 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7325
7326
7327 </td> <!-- entry_type -->
7328
7329 <td class="entry_description">
7330 The resolutions available for output from
7331 the JPEG block.<wbr> Listed as width x height
7332 </td>
7333
7334 <td class="entry_units">
7335 </td>
7336
7337 <td class="entry_range">
7338 Must include: - sensor maximum resolution Should
7339 include: - half/<wbr>quarter max resolution
7340 </td>
7341
7342 <td class="entry_notes">
7343 </td>
7344
7345 <td class="entry_tags">
7346 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7347 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7348 </ul>
7349 </td>
7350
7351 </tr> <!-- end of entry -->
7352
7353
7354 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
7355 <td class="entry_name">android.<wbr>scaler.<wbr>available<wbr>Max<wbr>Digital<wbr>Zoom</td>
7356 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]7357 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7358
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7359 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7360
7361
7362 </td> <!-- entry_type -->
7363
7364 <td class="entry_description">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]7365 The maximum ratio between active area width
7366 and crop region width,<wbr> or between active area height and
7367 crop region height,<wbr> if the crop region height is larger
7368 than width
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7369 </td>
7370
7371 <td class="entry_units">
7372 </td>
7373
7374 <td class="entry_range">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]7375 >=1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7376 </td>
7377
7378 <td class="entry_notes">
7379 </td>
7380
7381 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]7382 <ul class="entry_tags">
7383 <li><a href="#tag_BC">BC</a></li>
7384 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7385 </td>
7386
7387 </tr> <!-- end of entry -->
7388
7389
7390 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
7391 <td class="entry_name">android.<wbr>scaler.<wbr>available<wbr>Processed<wbr>Min<wbr>Durations</td>
7392 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7393 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7394 <span class="entry_type_container">x</span>
7395
7396 <span class="entry_type_array">
7397 n
7398 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7399 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7400
7401
7402 </td> <!-- entry_type -->
7403
7404 <td class="entry_description">
7405 The minimum frame duration that is supported
7406 for each resolution in availableProcessedSizes.<wbr> Should
7407 correspond to the frame duration when only that processed
7408 stream is active,<wbr> with all processing set to
7409 FAST
7410 </td>
7411
7412 <td class="entry_units">
7413 </td>
7414
7415 <td class="entry_range">
7416 </td>
7417
7418 <td class="entry_notes">
7419 When multiple streams are configured,<wbr> the minimum
7420 frame duration will be >= max(individual stream min
7421 durations)
7422 </td>
7423
7424 <td class="entry_tags">
7425 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7426 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7427 </ul>
7428 </td>
7429
7430 </tr> <!-- end of entry -->
7431
7432
7433 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
7434 <td class="entry_name">android.<wbr>scaler.<wbr>available<wbr>Processed<wbr>Sizes</td>
7435 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7436 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7437 <span class="entry_type_container">x</span>
7438
7439 <span class="entry_type_array">
7440 n x 2
7441 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]7442 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7443
7444
7445 </td> <!-- entry_type -->
7446
7447 <td class="entry_description">
7448 The resolutions available for use with
7449 processed output streams,<wbr> such as YV12,<wbr> NV12,<wbr> and
7450 platform opaque YUV/<wbr>RGB streams to the GPU or video
7451 encoders.<wbr> Listed as width,<wbr> height
7452 </td>
7453
7454 <td class="entry_units">
7455 </td>
7456
7457 <td class="entry_range">
7458 Must include: - sensor maximum resolution -
7459 standard QCIF,<wbr> 240p,<wbr> 480p,<wbr> 720p,<wbr> and 1080p
7460 resolutions
7461 </td>
7462
7463 <td class="entry_notes">
7464 </td>
7465
7466 <td class="entry_tags">
7467 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7468 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7469 </ul>
7470 </td>
7471
7472 </tr> <!-- end of entry -->
7473
7474
7475 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
7476 <td class="entry_name">android.<wbr>scaler.<wbr>available<wbr>Raw<wbr>Min<wbr>Durations</td>
7477 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7478 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7479 <span class="entry_type_container">x</span>
7480
7481 <span class="entry_type_array">
7482 n
7483 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7484 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7485
7486
7487 </td> <!-- entry_type -->
7488
7489 <td class="entry_description">
7490 The minimum frame duration that is supported
7491 for each raw resolution in availableRawSizes.<wbr> Should
7492 correspond to the frame duration when only the raw stream
7493 is active.<wbr>
7494 </td>
7495
7496 <td class="entry_units">
7497 </td>
7498
7499 <td class="entry_range">
7500 </td>
7501
7502 <td class="entry_notes">
7503 When multiple streams are configured,<wbr> the minimum
7504 frame duration will be >= max(individual stream min
7505 durations)
7506 </td>
7507
7508 <td class="entry_tags">
7509 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7510 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7511 </ul>
7512 </td>
7513
7514 </tr> <!-- end of entry -->
7515
7516
7517 <tr class="entry" id="static_android.scaler.availableRawSizes">
7518 <td class="entry_name">android.<wbr>scaler.<wbr>available<wbr>Raw<wbr>Sizes</td>
7519 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7520 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7521 <span class="entry_type_container">x</span>
7522
7523 <span class="entry_type_array">
7524 n x 2
7525 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]7526 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7527
7528
7529 </td> <!-- entry_type -->
7530
7531 <td class="entry_description">
7532 The resolutions available for use with raw
7533 sensor output streams,<wbr> listed as width,<wbr>
7534 height
7535 </td>
7536
7537 <td class="entry_units">
7538 </td>
7539
7540 <td class="entry_range">
7541 Must include: - sensor maximum resolution
7542 </td>
7543
7544 <td class="entry_notes">
7545 </td>
7546
7547 <td class="entry_tags">
7548 </td>
7549
7550 </tr> <!-- end of entry -->
7551
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7552
7553
7554 <!-- end of kind -->
7555 </tbody>
7556 <tr><td colspan="7" class="kind">dynamic</td></tr>
7557
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7558 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7559 <tr>
7560 <th class="th_name">Property Name</th>
7561 <th class="th_type">Type</th>
7562 <th class="th_description">Description</th>
7563 <th class="th_units">Units</th>
7564 <th class="th_range">Range</th>
7565 <th class="th_notes">Notes</th>
7566 <th class="th_tags">Tags</th>
7567 </tr>
7568 </thead>
7569
7570 <tbody>
7571
7572
7573
7574
7575
7576
7577
7578
7579
7580
7581 <tr class="entry" id="dynamic_android.scaler.cropRegion">
7582 <td class="entry_name">android.<wbr>scaler.<wbr>crop<wbr>Region</td>
7583 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7584 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7585 <span class="entry_type_container">x</span>
7586
7587 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7588 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7589 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]7590 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7591
7592
7593 </td> <!-- entry_type -->
7594
7595 <td class="entry_description">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7596 (x,<wbr> y,<wbr> width,<wbr> height).<wbr>
7597<br>
7598<br> A rectangle with the top-level corner of (x,<wbr>y) and size
7599 (width,<wbr> height).<wbr> The region of the sensor that is used for
7600 output.<wbr> Each stream must use this rectangle to produce its
7601 output,<wbr> cropping to a smaller region if necessary to
7602 maintain the stream's aspect ratio.<wbr>
7603<br>
7604<br> HAL2.<wbr>x uses only (x,<wbr> y,<wbr> width)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7605 </td>
7606
7607 <td class="entry_units">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7608 (x,<wbr>y) of top-left corner,<wbr> width and height of region
7609 in pixels; (0,<wbr>0) is top-left corner of
Zhijun Hebd7f15b2013-05-13 16:59:51 -0700[diff] [blame]7610 android.<wbr>sensor.<wbr>active<wbr>Array<wbr>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7611 </td>
7612
7613 <td class="entry_range">
7614 </td>
7615
7616 <td class="entry_notes">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7617
7618 Any additional per-stream cropping must be done to
7619 maximize the final pixel area of the stream.<wbr>
7620<br>
7621<br> For example,<wbr> if the crop region is set to a 4:3 aspect
7622 ratio,<wbr> then 4:3 streams should use the exact crop
7623 region.<wbr> 16:9 streams should further crop vertically
7624 (letterbox).<wbr>
7625<br>
7626<br> Conversely,<wbr> if the crop region is set to a 16:9,<wbr> then 4:3
7627 outputs should crop horizontally (pillarbox),<wbr> and 16:9
7628 streams should match exactly.<wbr> These additional crops must
7629 be centered within the crop region.<wbr>
7630<br>
7631<br> The output streams must maintain square pixels at all
7632 times,<wbr> no matter what the relative aspect ratios of the
7633 crop region and the stream are.<wbr> Negative values for
7634 corner are allowed for raw output if full pixel array is
7635 larger than active pixel array.<wbr> Width and height may be
7636 rounded to nearest larger supportable width,<wbr> especially
7637 for raw output,<wbr> where only a few fixed scales may be
7638 possible.<wbr> The width and height of the crop region cannot
Zhijun Hebd7f15b2013-05-13 16:59:51 -0700[diff] [blame]7639 be set to be smaller than floor( activeArraySize.<wbr>width /<wbr>
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7640 android.<wbr>scaler.<wbr>max<wbr>Digital<wbr>Zoom ) and floor(
Zhijun Hebd7f15b2013-05-13 16:59:51 -0700[diff] [blame]7641 activeArraySize.<wbr>height /<wbr> android.<wbr>scaler.<wbr>max<wbr>Digital<wbr>Zoom),<wbr>
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]7642 respectively.<wbr>
7643
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7644 </td>
7645
7646 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7647 <ul class="entry_tags">
7648 <li><a href="#tag_BC">BC</a></li>
7649 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7650 </td>
7651
7652 </tr> <!-- end of entry -->
7653
7654
7655
7656 <!-- end of kind -->
7657 </tbody>
7658
7659 <!-- end of section -->
7660 <tr><td colspan="7" id="section_sensor" class="section">sensor</td></tr>
7661
7662
7663 <tr><td colspan="7" class="kind">controls</td></tr>
7664
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7665 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7666 <tr>
7667 <th class="th_name">Property Name</th>
7668 <th class="th_type">Type</th>
7669 <th class="th_description">Description</th>
7670 <th class="th_units">Units</th>
7671 <th class="th_range">Range</th>
7672 <th class="th_notes">Notes</th>
7673 <th class="th_tags">Tags</th>
7674 </tr>
7675 </thead>
7676
7677 <tbody>
7678
7679
7680
7681
7682
7683
7684
7685
7686
7687
7688 <tr class="entry" id="controls_android.sensor.exposureTime">
7689 <td class="entry_name">android.<wbr>sensor.<wbr>exposure<wbr>Time</td>
7690 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7691 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7692
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7693 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7694
7695
7696 </td> <!-- entry_type -->
7697
7698 <td class="entry_description">
7699 Duration each pixel is exposed to
7700 light
7701 </td>
7702
7703 <td class="entry_units">
7704 nanoseconds
7705 </td>
7706
7707 <td class="entry_range">
7708 android.<wbr>sensor.<wbr>info.<wbr>exposure<wbr>Time<wbr>Range
7709 </td>
7710
7711 <td class="entry_notes">
7712 1/<wbr>10000 - 30 sec range.<wbr> No bulb mode
7713 </td>
7714
7715 <td class="entry_tags">
7716 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7717 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7718 </ul>
7719 </td>
7720
7721 </tr> <!-- end of entry -->
7722
7723
7724 <tr class="entry" id="controls_android.sensor.frameDuration">
7725 <td class="entry_name">android.<wbr>sensor.<wbr>frame<wbr>Duration</td>
7726 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7727 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7728
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7729 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7730
7731
7732 </td> <!-- entry_type -->
7733
7734 <td class="entry_description">
7735 Duration from start of frame exposure to
7736 start of next frame exposure
7737 </td>
7738
7739 <td class="entry_units">
7740 nanoseconds
7741 </td>
7742
7743 <td class="entry_range">
7744 see android.<wbr>sensor.<wbr>info.<wbr>max<wbr>Frame<wbr>Duration,<wbr>
7745 android.<wbr>scaler.<wbr>info.<wbr>available<wbr>Min<wbr>Frame<wbr>Durations
7746 </td>
7747
7748 <td class="entry_notes">
7749 Exposure time has priority,<wbr> so duration is set to
7750 max(duration,<wbr> exposure time + overhead)
7751 </td>
7752
7753 <td class="entry_tags">
7754 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7755 <li><a href="#tag_V1">V1</a></li>
7756 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7757 </ul>
7758 </td>
7759
7760 </tr> <!-- end of entry -->
7761
7762
7763 <tr class="entry" id="controls_android.sensor.sensitivity">
7764 <td class="entry_name">android.<wbr>sensor.<wbr>sensitivity</td>
7765 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7766 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7767
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7768 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7769
7770
7771 </td> <!-- entry_type -->
7772
7773 <td class="entry_description">
7774 Gain applied to image data.<wbr> Must be
7775 implemented through analog gain only if set to values
7776 below 'maximum analog sensitivity'.<wbr>
7777 </td>
7778
7779 <td class="entry_units">
7780 ISO arithmetic units
7781 </td>
7782
7783 <td class="entry_range">
7784 android.<wbr>sensor.<wbr>info.<wbr>sensitivity<wbr>Range
7785 </td>
7786
7787 <td class="entry_notes">
7788 ISO 12232:2006 REI method
7789 </td>
7790
7791 <td class="entry_tags">
7792 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7793 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7794 </ul>
7795 </td>
7796
7797 </tr> <!-- end of entry -->
7798
7799
7800
7801 <!-- end of kind -->
7802 </tbody>
7803 <tr><td colspan="7" class="kind">static</td></tr>
7804
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7805 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7806 <tr>
7807 <th class="th_name">Property Name</th>
7808 <th class="th_type">Type</th>
7809 <th class="th_description">Description</th>
7810 <th class="th_units">Units</th>
7811 <th class="th_range">Range</th>
7812 <th class="th_notes">Notes</th>
7813 <th class="th_tags">Tags</th>
7814 </tr>
7815 </thead>
7816
7817 <tbody>
7818
7819
7820
7821
7822
7823
7824
7825
7826
7827
7828
7829
7830 <tr class="entry" id="static_android.sensor.info.activeArraySize">
7831 <td class="entry_name">android.<wbr>sensor.<wbr>info.<wbr>active<wbr>Array<wbr>Size</td>
7832 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7833 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7834 <span class="entry_type_container">x</span>
7835
7836 <span class="entry_type_array">
7837 4
7838 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]7839 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7840 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
7841
7842
7843 </td> <!-- entry_type -->
7844
7845 <td class="entry_description">
7846 Area of raw data which corresponds to only
7847 active pixels; smaller or equal to
7848 pixelArraySize.<wbr>
7849 </td>
7850
7851 <td class="entry_units">
7852 xmin,<wbr> ymin,<wbr> width,<wbr> height.<wbr> Top left of full
7853 pixel array is (0,<wbr>0)
7854 </td>
7855
7856 <td class="entry_range">
7857 </td>
7858
7859 <td class="entry_notes">
7860 </td>
7861
7862 <td class="entry_tags">
7863 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7864 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7865 </ul>
7866 </td>
7867
7868 </tr> <!-- end of entry -->
7869
7870
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]7871 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
7872 <td class="entry_name">android.<wbr>sensor.<wbr>info.<wbr>sensitivity<wbr>Range</td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7873 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7874 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7875 <span class="entry_type_container">x</span>
7876
7877 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]7878 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7879 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7880 <span class="entry_type_visibility"> [public]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]7881 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7882
7883
7884 </td> <!-- entry_type -->
7885
7886 <td class="entry_description">
7887 Range of valid sensitivities
7888 </td>
7889
7890 <td class="entry_units">
7891 </td>
7892
7893 <td class="entry_range">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]7894 Min <= 100,<wbr> Max >= 1600
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7895 </td>
7896
7897 <td class="entry_notes">
7898 </td>
7899
7900 <td class="entry_tags">
7901 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7902 <li><a href="#tag_BC">BC</a></li>
7903 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7904 </ul>
7905 </td>
7906
7907 </tr> <!-- end of entry -->
7908
7909
7910 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
7911 <td class="entry_name">android.<wbr>sensor.<wbr>info.<wbr>color<wbr>Filter<wbr>Arrangement</td>
7912 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7913 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7914
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7915 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7916
7917 <ul class="entry_type_enum">
7918 <li>
7919 <span class="entry_type_enum_name">RGGB</span>
7920 </li>
7921 <li>
7922 <span class="entry_type_enum_name">GRBG</span>
7923 </li>
7924 <li>
7925 <span class="entry_type_enum_name">GBRG</span>
7926 </li>
7927 <li>
7928 <span class="entry_type_enum_name">BGGR</span>
7929 </li>
7930 <li>
7931 <span class="entry_type_enum_name">RGB</span>
7932 <span class="entry_type_enum_notes">Sensor is not Bayer; output has 3 16-bit
7933 values for each pixel,<wbr> instead of just 1 16-bit value
7934 per pixel.<wbr></span>
7935 </li>
7936 </ul>
7937
7938 </td> <!-- entry_type -->
7939
7940 <td class="entry_description">
7941 Arrangement of color filters on sensor;
7942 represents the colors in the top-left 2x2 section of
7943 the sensor,<wbr> in reading order
7944 </td>
7945
7946 <td class="entry_units">
7947 </td>
7948
7949 <td class="entry_range">
7950 </td>
7951
7952 <td class="entry_notes">
7953 </td>
7954
7955 <td class="entry_tags">
7956 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7957 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7958 </ul>
7959 </td>
7960
7961 </tr> <!-- end of entry -->
7962
7963
7964 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
7965 <td class="entry_name">android.<wbr>sensor.<wbr>info.<wbr>exposure<wbr>Time<wbr>Range</td>
7966 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7967 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7968 <span class="entry_type_container">x</span>
7969
7970 <span class="entry_type_array">
7971 2
7972 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7973 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7974 <div class="entry_type_notes">nanoseconds</div>
7975
7976
7977 </td> <!-- entry_type -->
7978
7979 <td class="entry_description">
7980 Range of valid exposure
7981 times
7982 </td>
7983
7984 <td class="entry_units">
7985 </td>
7986
7987 <td class="entry_range">
7988 Min <= 100e3 (100 us),<wbr> Max >= 30e9 (30
7989 sec)
7990 </td>
7991
7992 <td class="entry_notes">
7993 </td>
7994
7995 <td class="entry_tags">
7996 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7997 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7998 </ul>
7999 </td>
8000
8001 </tr> <!-- end of entry -->
8002
8003
8004 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
8005 <td class="entry_name">android.<wbr>sensor.<wbr>info.<wbr>max<wbr>Frame<wbr>Duration</td>
8006 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8007 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8008
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8009 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8010
8011
8012 </td> <!-- entry_type -->
8013
8014 <td class="entry_description">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]8015 Maximum possible frame duration (minimum frame
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8016 rate)
8017 </td>
8018
8019 <td class="entry_units">
8020 nanoseconds
8021 </td>
8022
8023 <td class="entry_range">
8024 >= 30e9
8025 </td>
8026
8027 <td class="entry_notes">
8028 Minimum duration is a function of resolution,<wbr>
8029 processing settings.<wbr> See
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]8030 android.<wbr>scaler.<wbr>available<wbr>Processed<wbr>Min<wbr>Durations
8031 android.<wbr>scaler.<wbr>available<wbr>Jpeg<wbr>Min<wbr>Durations
8032 android.<wbr>scaler.<wbr>available<wbr>Raw<wbr>Min<wbr>Durations
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8033 </td>
8034
8035 <td class="entry_tags">
8036 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8037 <li><a href="#tag_BC">BC</a></li>
8038 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8039 </ul>
8040 </td>
8041
8042 </tr> <!-- end of entry -->
8043
8044
8045 <tr class="entry" id="static_android.sensor.info.physicalSize">
8046 <td class="entry_name">android.<wbr>sensor.<wbr>info.<wbr>physical<wbr>Size</td>
8047 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8048 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8049 <span class="entry_type_container">x</span>
8050
8051 <span class="entry_type_array">
8052 2
8053 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]8054 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8055 <div class="entry_type_notes">width x height in millimeters</div>
8056
8057
8058 </td> <!-- entry_type -->
8059
8060 <td class="entry_description">
8061 The physical dimensions of the full pixel
8062 array
8063 </td>
8064
8065 <td class="entry_units">
8066 </td>
8067
8068 <td class="entry_range">
8069 </td>
8070
8071 <td class="entry_notes">
8072 Needed for FOV calculation for old API
8073 </td>
8074
8075 <td class="entry_tags">
8076 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8077 <li><a href="#tag_V1">V1</a></li>
8078 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8079 </ul>
8080 </td>
8081
8082 </tr> <!-- end of entry -->
8083
8084
8085 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
8086 <td class="entry_name">android.<wbr>sensor.<wbr>info.<wbr>pixel<wbr>Array<wbr>Size</td>
8087 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8088 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8089 <span class="entry_type_container">x</span>
8090
8091 <span class="entry_type_array">
8092 2
8093 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]8094 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8095
8096
8097 </td> <!-- entry_type -->
8098
8099 <td class="entry_description">
8100 Dimensions of full pixel array,<wbr> possibly
8101 including black calibration pixels
8102 </td>
8103
8104 <td class="entry_units">
8105 </td>
8106
8107 <td class="entry_range">
8108 </td>
8109
8110 <td class="entry_notes">
8111 Maximum output resolution for raw format must
8112 match this in
8113 android.<wbr>scaler.<wbr>info.<wbr>available<wbr>Sizes<wbr>Per<wbr>Format
8114 </td>
8115
8116 <td class="entry_tags">
8117 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8118 <li><a href="#tag_DNG">DNG</a></li>
8119 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8120 </ul>
8121 </td>
8122
8123 </tr> <!-- end of entry -->
8124
8125
8126 <tr class="entry" id="static_android.sensor.info.whiteLevel">
8127 <td class="entry_name">android.<wbr>sensor.<wbr>info.<wbr>white<wbr>Level</td>
8128 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8129 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8130
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8131 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8132
8133
8134 </td> <!-- entry_type -->
8135
8136 <td class="entry_description">
8137 Maximum raw value output by
8138 sensor
8139 </td>
8140
8141 <td class="entry_units">
8142 </td>
8143
8144 <td class="entry_range">
8145 > 1024 (10-bit output)
8146 </td>
8147
8148 <td class="entry_notes">
8149 Defines sensor bit depth (10-14 bits is
8150 expected)
8151 </td>
8152
8153 <td class="entry_tags">
8154 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8155 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8156 </ul>
8157 </td>
8158
8159 </tr> <!-- end of entry -->
8160
8161
8162
8163
8164
8165 <tr class="entry" id="static_android.sensor.baseGainFactor">
8166 <td class="entry_name">android.<wbr>sensor.<wbr>base<wbr>Gain<wbr>Factor</td>
8167 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8168 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8169
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8170 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8171
8172
8173 </td> <!-- entry_type -->
8174
8175 <td class="entry_description">
8176 Gain factor from electrons to raw units when
8177 ISO=100
8178 </td>
8179
8180 <td class="entry_units">
8181 </td>
8182
8183 <td class="entry_range">
8184 </td>
8185
8186 <td class="entry_notes">
8187 </td>
8188
8189 <td class="entry_tags">
8190 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8191 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8192 </ul>
8193 </td>
8194
8195 </tr> <!-- end of entry -->
8196
8197
8198 <tr class="entry" id="static_android.sensor.blackLevelPattern">
8199 <td class="entry_name">android.<wbr>sensor.<wbr>black<wbr>Level<wbr>Pattern</td>
8200 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8201 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8202 <span class="entry_type_container">x</span>
8203
8204 <span class="entry_type_array">
8205 4
8206 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8207 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8208 <div class="entry_type_notes">2x2 raw count block</div>
8209
8210
8211 </td> <!-- entry_type -->
8212
8213 <td class="entry_description">
8214 A fixed black level offset for each of the
8215 Bayer mosaic channels
8216 </td>
8217
8218 <td class="entry_units">
8219 </td>
8220
8221 <td class="entry_range">
8222 >= 0 each
8223 </td>
8224
8225 <td class="entry_notes">
8226 As per DNG BlackLevelRepeatDim /<wbr> BlackLevel
8227 tags
8228 </td>
8229
8230 <td class="entry_tags">
8231 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8232 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8233 </ul>
8234 </td>
8235
8236 </tr> <!-- end of entry -->
8237
8238
8239 <tr class="entry" id="static_android.sensor.calibrationTransform1">
8240 <td class="entry_name">android.<wbr>sensor.<wbr>calibration<wbr>Transform1</td>
8241 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8242 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8243 <span class="entry_type_container">x</span>
8244
8245 <span class="entry_type_array">
8246 9
8247 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8248 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8249 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
8250
8251
8252 </td> <!-- entry_type -->
8253
8254 <td class="entry_description">
8255 Per-device calibration on top of color space
8256 transform 1
8257 </td>
8258
8259 <td class="entry_units">
8260 </td>
8261
8262 <td class="entry_range">
8263 </td>
8264
8265 <td class="entry_notes">
8266 </td>
8267
8268 <td class="entry_tags">
8269 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8270 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8271 </ul>
8272 </td>
8273
8274 </tr> <!-- end of entry -->
8275
8276
8277 <tr class="entry" id="static_android.sensor.calibrationTransform2">
8278 <td class="entry_name">android.<wbr>sensor.<wbr>calibration<wbr>Transform2</td>
8279 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8280 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8281 <span class="entry_type_container">x</span>
8282
8283 <span class="entry_type_array">
8284 9
8285 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8286 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8287 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
8288
8289
8290 </td> <!-- entry_type -->
8291
8292 <td class="entry_description">
8293 Per-device calibration on top of color space
8294 transform 2
8295 </td>
8296
8297 <td class="entry_units">
8298 </td>
8299
8300 <td class="entry_range">
8301 </td>
8302
8303 <td class="entry_notes">
8304 </td>
8305
8306 <td class="entry_tags">
8307 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8308 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8309 </ul>
8310 </td>
8311
8312 </tr> <!-- end of entry -->
8313
8314
8315 <tr class="entry" id="static_android.sensor.colorTransform1">
8316 <td class="entry_name">android.<wbr>sensor.<wbr>color<wbr>Transform1</td>
8317 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8318 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8319 <span class="entry_type_container">x</span>
8320
8321 <span class="entry_type_array">
8322 9
8323 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8324 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8325 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
8326
8327
8328 </td> <!-- entry_type -->
8329
8330 <td class="entry_description">
8331 Linear mapping from XYZ (D50) color space to
8332 reference linear sensor color,<wbr> for first reference
8333 illuminant
8334 </td>
8335
8336 <td class="entry_units">
8337 </td>
8338
8339 <td class="entry_range">
8340 </td>
8341
8342 <td class="entry_notes">
8343 Use as follows XYZ = inv(transform) * clip( (raw -
8344 black level(raw) ) /<wbr> ( white level - max black level) ).<wbr>
8345 At least in the simple case
8346 </td>
8347
8348 <td class="entry_tags">
8349 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8350 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8351 </ul>
8352 </td>
8353
8354 </tr> <!-- end of entry -->
8355
8356
8357 <tr class="entry" id="static_android.sensor.colorTransform2">
8358 <td class="entry_name">android.<wbr>sensor.<wbr>color<wbr>Transform2</td>
8359 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8360 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8361 <span class="entry_type_container">x</span>
8362
8363 <span class="entry_type_array">
8364 9
8365 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8366 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8367 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
8368
8369
8370 </td> <!-- entry_type -->
8371
8372 <td class="entry_description">
8373 Linear mapping from XYZ (D50) color space to
8374 reference linear sensor color,<wbr> for second reference
8375 illuminant
8376 </td>
8377
8378 <td class="entry_units">
8379 </td>
8380
8381 <td class="entry_range">
8382 </td>
8383
8384 <td class="entry_notes">
8385 </td>
8386
8387 <td class="entry_tags">
8388 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8389 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8390 </ul>
8391 </td>
8392
8393 </tr> <!-- end of entry -->
8394
8395
8396 <tr class="entry" id="static_android.sensor.forwardMatrix1">
8397 <td class="entry_name">android.<wbr>sensor.<wbr>forward<wbr>Matrix1</td>
8398 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8399 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8400 <span class="entry_type_container">x</span>
8401
8402 <span class="entry_type_array">
8403 9
8404 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8405 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8406 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
8407
8408
8409 </td> <!-- entry_type -->
8410
8411 <td class="entry_description">
8412 Used by DNG for better WB
8413 adaptation
8414 </td>
8415
8416 <td class="entry_units">
8417 </td>
8418
8419 <td class="entry_range">
8420 </td>
8421
8422 <td class="entry_notes">
8423 </td>
8424
8425 <td class="entry_tags">
8426 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8427 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8428 </ul>
8429 </td>
8430
8431 </tr> <!-- end of entry -->
8432
8433
8434 <tr class="entry" id="static_android.sensor.forwardMatrix2">
8435 <td class="entry_name">android.<wbr>sensor.<wbr>forward<wbr>Matrix2</td>
8436 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8437 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8438 <span class="entry_type_container">x</span>
8439
8440 <span class="entry_type_array">
8441 9
8442 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8443 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8444 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
8445
8446
8447 </td> <!-- entry_type -->
8448
8449 <td class="entry_description">
8450 Used by DNG for better WB
8451 adaptation
8452 </td>
8453
8454 <td class="entry_units">
8455 </td>
8456
8457 <td class="entry_range">
8458 </td>
8459
8460 <td class="entry_notes">
8461 </td>
8462
8463 <td class="entry_tags">
8464 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8465 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8466 </ul>
8467 </td>
8468
8469 </tr> <!-- end of entry -->
8470
8471
8472 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
8473 <td class="entry_name">android.<wbr>sensor.<wbr>max<wbr>Analog<wbr>Sensitivity</td>
8474 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8475 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8476
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8477 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8478
8479
8480 </td> <!-- entry_type -->
8481
8482 <td class="entry_description">
8483 Maximum sensitivity that is implemented
8484 purely through analog gain
8485 </td>
8486
8487 <td class="entry_units">
8488 </td>
8489
8490 <td class="entry_range">
8491 </td>
8492
8493 <td class="entry_notes">
8494 For android.<wbr>sensor.<wbr>sensitivity values less than or
8495 equal to this,<wbr> all applied gain must be analog.<wbr> For
8496 values above this,<wbr> it can be a mix of analog and
8497 digital
8498 </td>
8499
8500 <td class="entry_tags">
8501 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8502 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8503 </ul>
8504 </td>
8505
8506 </tr> <!-- end of entry -->
8507
8508
8509 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
8510 <td class="entry_name">android.<wbr>sensor.<wbr>noise<wbr>Model<wbr>Coefficients</td>
8511 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8512 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8513 <span class="entry_type_container">x</span>
8514
8515 <span class="entry_type_array">
8516 2
8517 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8518 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8519 <div class="entry_type_notes">float constants A,<wbr> B for the noise variance model</div>
8520
8521
8522 </td> <!-- entry_type -->
8523
8524 <td class="entry_description">
8525 Estimation of sensor noise
8526 characteristics
8527 </td>
8528
8529 <td class="entry_units">
8530 var(raw pixel value) = electrons * (baseGainFactor
8531 * iso/<wbr>100)^2 + A * (baseGainFactor * iso/<wbr>100)^2 +
8532 B
8533 </td>
8534
8535 <td class="entry_range">
8536 </td>
8537
8538 <td class="entry_notes">
8539 A represents sensor read noise before analog
8540 amplification; B represents noise from A/<wbr>D conversion and
8541 other circuits after amplification.<wbr> Both noise sources
8542 are assumed to be gaussian,<wbr> independent,<wbr> and not to vary
8543 across the sensor
8544 </td>
8545
8546 <td class="entry_tags">
8547 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8548 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8549 </ul>
8550 </td>
8551
8552 </tr> <!-- end of entry -->
8553
8554
8555 <tr class="entry" id="static_android.sensor.orientation">
8556 <td class="entry_name">android.<wbr>sensor.<wbr>orientation</td>
8557 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8558 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8559
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8560 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8561
8562
8563 </td> <!-- entry_type -->
8564
8565 <td class="entry_description">
8566 Clockwise angle through which the output
8567 image needs to be rotated to be upright on the device
8568 screen in its native orientation.<wbr> Also defines the
8569 direction of rolling shutter readout,<wbr> which is from top
8570 to bottom in the sensor's coordinate system
8571 </td>
8572
8573 <td class="entry_units">
8574 degrees clockwise rotation,<wbr> only multiples of
8575 90
8576 </td>
8577
8578 <td class="entry_range">
8579 0,<wbr>90,<wbr>180,<wbr>270
8580 </td>
8581
8582 <td class="entry_notes">
8583 </td>
8584
8585 <td class="entry_tags">
8586 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8587 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8588 </ul>
8589 </td>
8590
8591 </tr> <!-- end of entry -->
8592
8593
8594 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
8595 <td class="entry_name">android.<wbr>sensor.<wbr>reference<wbr>Illuminant1</td>
8596 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8597 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8598
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8599 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8600
8601 <ul class="entry_type_enum">
8602 <li>
8603 <span class="entry_type_enum_name">DAYLIGHT</span>
8604 <span class="entry_type_enum_value">1</span>
8605 </li>
8606 <li>
8607 <span class="entry_type_enum_name">FLUORESCENT</span>
8608 <span class="entry_type_enum_value">2</span>
8609 </li>
8610 <li>
8611 <span class="entry_type_enum_name">TUNGSTEN</span>
8612 <span class="entry_type_enum_value">3</span>
8613 <span class="entry_type_enum_notes">Incandescent light</span>
8614 </li>
8615 <li>
8616 <span class="entry_type_enum_name">FLASH</span>
8617 <span class="entry_type_enum_value">4</span>
8618 </li>
8619 <li>
8620 <span class="entry_type_enum_name">FINE_WEATHER</span>
8621 <span class="entry_type_enum_value">9</span>
8622 </li>
8623 <li>
8624 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
8625 <span class="entry_type_enum_value">10</span>
8626 </li>
8627 <li>
8628 <span class="entry_type_enum_name">SHADE</span>
8629 <span class="entry_type_enum_value">11</span>
8630 </li>
8631 <li>
8632 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
8633 <span class="entry_type_enum_value">12</span>
8634 <span class="entry_type_enum_notes">D 5700 - 7100K</span>
8635 </li>
8636 <li>
8637 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
8638 <span class="entry_type_enum_value">13</span>
8639 <span class="entry_type_enum_notes">N 4600 - 5400K</span>
8640 </li>
8641 <li>
8642 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
8643 <span class="entry_type_enum_value">14</span>
8644 <span class="entry_type_enum_notes">W 3900 - 4500K</span>
8645 </li>
8646 <li>
8647 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
8648 <span class="entry_type_enum_value">15</span>
8649 <span class="entry_type_enum_notes">WW 3200 - 3700K</span>
8650 </li>
8651 <li>
8652 <span class="entry_type_enum_name">STANDARD_A</span>
8653 <span class="entry_type_enum_value">17</span>
8654 </li>
8655 <li>
8656 <span class="entry_type_enum_name">STANDARD_B</span>
8657 <span class="entry_type_enum_value">18</span>
8658 </li>
8659 <li>
8660 <span class="entry_type_enum_name">STANDARD_C</span>
8661 <span class="entry_type_enum_value">19</span>
8662 </li>
8663 <li>
8664 <span class="entry_type_enum_name">D55</span>
8665 <span class="entry_type_enum_value">20</span>
8666 </li>
8667 <li>
8668 <span class="entry_type_enum_name">D65</span>
8669 <span class="entry_type_enum_value">21</span>
8670 </li>
8671 <li>
8672 <span class="entry_type_enum_name">D75</span>
8673 <span class="entry_type_enum_value">22</span>
8674 </li>
8675 <li>
8676 <span class="entry_type_enum_name">D50</span>
8677 <span class="entry_type_enum_value">23</span>
8678 </li>
8679 <li>
8680 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
8681 <span class="entry_type_enum_value">24</span>
8682 </li>
8683 </ul>
8684
8685 </td> <!-- entry_type -->
8686
8687 <td class="entry_description">
8688 Light source used to define transform
8689 1
8690 </td>
8691
8692 <td class="entry_units">
8693 </td>
8694
8695 <td class="entry_range">
8696 </td>
8697
8698 <td class="entry_notes">
8699 [EXIF LightSource tag] Must all these be
8700 supported? Need CCT for each!
8701 </td>
8702
8703 <td class="entry_tags">
8704 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8705 <li><a href="#tag_DNG">DNG</a></li>
8706 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8707 </ul>
8708 </td>
8709
8710 </tr> <!-- end of entry -->
8711
8712
8713 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
8714 <td class="entry_name">android.<wbr>sensor.<wbr>reference<wbr>Illuminant2</td>
8715 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8716 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8717
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8718 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8719
8720
8721 </td> <!-- entry_type -->
8722
8723 <td class="entry_description">
8724 Light source used to define transform
8725 2
8726 </td>
8727
8728 <td class="entry_units">
8729 Same as illuminant 1
8730 </td>
8731
8732 <td class="entry_range">
8733 </td>
8734
8735 <td class="entry_notes">
8736 </td>
8737
8738 <td class="entry_tags">
8739 </td>
8740
8741 </tr> <!-- end of entry -->
8742
8743
8744
8745 <!-- end of kind -->
8746 </tbody>
8747 <tr><td colspan="7" class="kind">dynamic</td></tr>
8748
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8749 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8750 <tr>
8751 <th class="th_name">Property Name</th>
8752 <th class="th_type">Type</th>
8753 <th class="th_description">Description</th>
8754 <th class="th_units">Units</th>
8755 <th class="th_range">Range</th>
8756 <th class="th_notes">Notes</th>
8757 <th class="th_tags">Tags</th>
8758 </tr>
8759 </thead>
8760
8761 <tbody>
8762
8763
8764
8765
8766
8767
8768
8769
8770
8771
8772 <tr class="entry" id="dynamic_android.sensor.exposureTime">
8773 <td class="entry_name">android.<wbr>sensor.<wbr>exposure<wbr>Time</td>
8774 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8775 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8776
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8777 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8778
8779
8780 </td> <!-- entry_type -->
8781
8782 <td class="entry_description">
8783 Duration each pixel is exposed to
8784 light
8785 </td>
8786
8787 <td class="entry_units">
8788 nanoseconds
8789 </td>
8790
8791 <td class="entry_range">
8792 android.<wbr>sensor.<wbr>info.<wbr>exposure<wbr>Time<wbr>Range
8793 </td>
8794
8795 <td class="entry_notes">
8796 1/<wbr>10000 - 30 sec range.<wbr> No bulb mode
8797 </td>
8798
8799 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8800 <ul class="entry_tags">
8801 <li><a href="#tag_V1">V1</a></li>
8802 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8803 </td>
8804
8805 </tr> <!-- end of entry -->
8806
8807
8808 <tr class="entry" id="dynamic_android.sensor.frameDuration">
8809 <td class="entry_name">android.<wbr>sensor.<wbr>frame<wbr>Duration</td>
8810 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8811 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8812
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8813 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8814
8815
8816 </td> <!-- entry_type -->
8817
8818 <td class="entry_description">
8819 Duration from start of frame exposure to
8820 start of next frame exposure
8821 </td>
8822
8823 <td class="entry_units">
8824 nanoseconds
8825 </td>
8826
8827 <td class="entry_range">
8828 see android.<wbr>sensor.<wbr>info.<wbr>max<wbr>Frame<wbr>Duration,<wbr>
8829 android.<wbr>scaler.<wbr>info.<wbr>available<wbr>Min<wbr>Frame<wbr>Durations
8830 </td>
8831
8832 <td class="entry_notes">
8833 Exposure time has priority,<wbr> so duration is set to
8834 max(duration,<wbr> exposure time + overhead)
8835 </td>
8836
8837 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8838 <ul class="entry_tags">
8839 <li><a href="#tag_V1">V1</a></li>
8840 <li><a href="#tag_BC">BC</a></li>
8841 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8842 </td>
8843
8844 </tr> <!-- end of entry -->
8845
8846
8847 <tr class="entry" id="dynamic_android.sensor.sensitivity">
8848 <td class="entry_name">android.<wbr>sensor.<wbr>sensitivity</td>
8849 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8850 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8851
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8852 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8853
8854
8855 </td> <!-- entry_type -->
8856
8857 <td class="entry_description">
8858 Gain applied to image data.<wbr> Must be
8859 implemented through analog gain only if set to values
8860 below 'maximum analog sensitivity'.<wbr>
8861 </td>
8862
8863 <td class="entry_units">
8864 ISO arithmetic units
8865 </td>
8866
8867 <td class="entry_range">
8868 android.<wbr>sensor.<wbr>info.<wbr>sensitivity<wbr>Range
8869 </td>
8870
8871 <td class="entry_notes">
8872 ISO 12232:2006 REI method
8873 </td>
8874
8875 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8876 <ul class="entry_tags">
8877 <li><a href="#tag_V1">V1</a></li>
8878 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8879 </td>
8880
8881 </tr> <!-- end of entry -->
8882
8883
8884 <tr class="entry" id="dynamic_android.sensor.timestamp">
8885 <td class="entry_name">android.<wbr>sensor.<wbr>timestamp</td>
8886 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8887 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8888
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8889 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8890
8891
8892 </td> <!-- entry_type -->
8893
8894 <td class="entry_description">
8895 Time at start of exposure of first
8896 row
8897 </td>
8898
8899 <td class="entry_units">
8900 nanoseconds
8901 </td>
8902
8903 <td class="entry_range">
8904 > 0
8905 </td>
8906
8907 <td class="entry_notes">
8908 Monotonic,<wbr> should be synced to other timestamps in
8909 system
8910 </td>
8911
8912 <td class="entry_tags">
8913 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8914 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8915 </ul>
8916 </td>
8917
8918 </tr> <!-- end of entry -->
8919
8920
8921
8922 <!-- end of kind -->
8923 </tbody>
8924
8925 <!-- end of section -->
8926 <tr><td colspan="7" id="section_shading" class="section">shading</td></tr>
8927
8928
8929 <tr><td colspan="7" class="kind">controls</td></tr>
8930
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8931 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8932 <tr>
8933 <th class="th_name">Property Name</th>
8934 <th class="th_type">Type</th>
8935 <th class="th_description">Description</th>
8936 <th class="th_units">Units</th>
8937 <th class="th_range">Range</th>
8938 <th class="th_notes">Notes</th>
8939 <th class="th_tags">Tags</th>
8940 </tr>
8941 </thead>
8942
8943 <tbody>
8944
8945
8946
8947
8948
8949
8950
8951
8952
8953
8954 <tr class="entry" id="controls_android.shading.mode">
8955 <td class="entry_name">android.<wbr>shading.<wbr>mode</td>
8956 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8957 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8958
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8959 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8960
8961 <ul class="entry_type_enum">
8962 <li>
8963 <span class="entry_type_enum_name">OFF</span>
8964 <span class="entry_type_enum_notes">No shading correction is applied</span>
8965 </li>
8966 <li>
8967 <span class="entry_type_enum_name">FAST</span>
8968 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
8969 bayer output</span>
8970 </li>
8971 <li>
8972 <span class="entry_type_enum_name">HIGH_QUALITY</span>
8973 <span class="entry_type_enum_notes">Frame rate may be reduced by high
8974 quality</span>
8975 </li>
8976 </ul>
8977
8978 </td> <!-- entry_type -->
8979
8980 <td class="entry_description">
8981 Quality of lens shading correction applied
8982 to the image data
8983 </td>
8984
8985 <td class="entry_units">
8986 </td>
8987
8988 <td class="entry_range">
8989 </td>
8990
8991 <td class="entry_notes">
8992 </td>
8993
8994 <td class="entry_tags">
8995 </td>
8996
8997 </tr> <!-- end of entry -->
8998
8999
9000 <tr class="entry" id="controls_android.shading.strength">
9001 <td class="entry_name">android.<wbr>shading.<wbr>strength</td>
9002 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9003 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9004
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9005 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9006
9007
9008 </td> <!-- entry_type -->
9009
9010 <td class="entry_description">
9011 Control the amount of shading correction
9012 applied to the images
9013 </td>
9014
9015 <td class="entry_units">
9016 unitless: 1-10; 10 is full shading
9017 compensation
9018 </td>
9019
9020 <td class="entry_range">
9021 </td>
9022
9023 <td class="entry_notes">
9024 </td>
9025
9026 <td class="entry_tags">
9027 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9028 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9029 </ul>
9030 </td>
9031
9032 </tr> <!-- end of entry -->
9033
9034
9035
9036 <!-- end of kind -->
9037 </tbody>
9038 <tr><td colspan="7" class="kind">dynamic</td></tr>
9039
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9040 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9041 <tr>
9042 <th class="th_name">Property Name</th>
9043 <th class="th_type">Type</th>
9044 <th class="th_description">Description</th>
9045 <th class="th_units">Units</th>
9046 <th class="th_range">Range</th>
9047 <th class="th_notes">Notes</th>
9048 <th class="th_tags">Tags</th>
9049 </tr>
9050 </thead>
9051
9052 <tbody>
9053
9054
9055
9056
9057
9058
9059
9060
9061
9062
9063 <tr class="entry" id="dynamic_android.shading.mode">
9064 <td class="entry_name">android.<wbr>shading.<wbr>mode</td>
9065 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9066 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9067
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9068 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9069
9070 <ul class="entry_type_enum">
9071 <li>
9072 <span class="entry_type_enum_name">OFF</span>
9073 <span class="entry_type_enum_notes">No shading correction is applied</span>
9074 </li>
9075 <li>
9076 <span class="entry_type_enum_name">FAST</span>
9077 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
9078 bayer output</span>
9079 </li>
9080 <li>
9081 <span class="entry_type_enum_name">HIGH_QUALITY</span>
9082 <span class="entry_type_enum_notes">Frame rate may be reduced by high
9083 quality</span>
9084 </li>
9085 </ul>
9086
9087 </td> <!-- entry_type -->
9088
9089 <td class="entry_description">
9090 Quality of lens shading correction applied
9091 to the image data
9092 </td>
9093
9094 <td class="entry_units">
9095 </td>
9096
9097 <td class="entry_range">
9098 </td>
9099
9100 <td class="entry_notes">
9101 </td>
9102
9103 <td class="entry_tags">
9104 </td>
9105
9106 </tr> <!-- end of entry -->
9107
9108
9109
9110 <!-- end of kind -->
9111 </tbody>
9112
9113 <!-- end of section -->
9114 <tr><td colspan="7" id="section_statistics" class="section">statistics</td></tr>
9115
9116
9117 <tr><td colspan="7" class="kind">controls</td></tr>
9118
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9119 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9120 <tr>
9121 <th class="th_name">Property Name</th>
9122 <th class="th_type">Type</th>
9123 <th class="th_description">Description</th>
9124 <th class="th_units">Units</th>
9125 <th class="th_range">Range</th>
9126 <th class="th_notes">Notes</th>
9127 <th class="th_tags">Tags</th>
9128 </tr>
9129 </thead>
9130
9131 <tbody>
9132
9133
9134
9135
9136
9137
9138
9139
9140
9141
9142 <tr class="entry" id="controls_android.statistics.faceDetectMode">
9143 <td class="entry_name">android.<wbr>statistics.<wbr>face<wbr>Detect<wbr>Mode</td>
9144 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9145 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9146
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9147 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9148
9149 <ul class="entry_type_enum">
9150 <li>
9151 <span class="entry_type_enum_name">OFF</span>
9152 </li>
9153 <li>
9154 <span class="entry_type_enum_name">SIMPLE</span>
9155 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
9156 only</span>
9157 </li>
9158 <li>
9159 <span class="entry_type_enum_name">FULL</span>
9160 <span class="entry_type_enum_notes">Optional Return all face
9161 metadata</span>
9162 </li>
9163 </ul>
9164
9165 </td> <!-- entry_type -->
9166
9167 <td class="entry_description">
9168 State of the face detector
9169 unit
9170 </td>
9171
9172 <td class="entry_units">
9173 </td>
9174
9175 <td class="entry_range">
9176
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9177 android.<wbr>statistics.<wbr>info.<wbr>available<wbr>Face<wbr>Detect<wbr>Modes
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9178 </td>
9179
9180 <td class="entry_notes">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9181 Whether face detection is enabled,<wbr> and whether it
9182 should output just the basic fields or the full set of
9183 fields.<wbr> Value must be one of the
9184 android.<wbr>statistics.<wbr>info.<wbr>available<wbr>Face<wbr>Detect<wbr>Modes.<wbr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9185 </td>
9186
9187 <td class="entry_tags">
9188 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9189 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9190 </ul>
9191 </td>
9192
9193 </tr> <!-- end of entry -->
9194
9195
9196 <tr class="entry" id="controls_android.statistics.histogramMode">
9197 <td class="entry_name">android.<wbr>statistics.<wbr>histogram<wbr>Mode</td>
9198 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9199 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9200
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]9201 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9202
9203 <ul class="entry_type_enum">
9204 <li>
9205 <span class="entry_type_enum_name">OFF</span>
9206 </li>
9207 <li>
9208 <span class="entry_type_enum_name">ON</span>
9209 </li>
9210 </ul>
9211
9212 </td> <!-- entry_type -->
9213
9214 <td class="entry_description">
9215 Operating mode for histogram
9216 generation
9217 </td>
9218
9219 <td class="entry_units">
9220 </td>
9221
9222 <td class="entry_range">
9223 </td>
9224
9225 <td class="entry_notes">
9226 </td>
9227
9228 <td class="entry_tags">
9229 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9230 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9231 </ul>
9232 </td>
9233
9234 </tr> <!-- end of entry -->
9235
9236
9237 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
9238 <td class="entry_name">android.<wbr>statistics.<wbr>sharpness<wbr>Map<wbr>Mode</td>
9239 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9240 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9241
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]9242 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9243
9244 <ul class="entry_type_enum">
9245 <li>
9246 <span class="entry_type_enum_name">OFF</span>
9247 </li>
9248 <li>
9249 <span class="entry_type_enum_name">ON</span>
9250 </li>
9251 </ul>
9252
9253 </td> <!-- entry_type -->
9254
9255 <td class="entry_description">
9256 Operating mode for sharpness map
9257 generation
9258 </td>
9259
9260 <td class="entry_units">
9261 </td>
9262
9263 <td class="entry_range">
9264 </td>
9265
9266 <td class="entry_notes">
9267 </td>
9268
9269 <td class="entry_tags">
9270 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9271 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9272 </ul>
9273 </td>
9274
9275 </tr> <!-- end of entry -->
9276
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9277
9278 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
9279 <td class="entry_name">android.<wbr>statistics.<wbr>lens<wbr>Shading<wbr>Map<wbr>Mode</td>
9280 <td class="entry_type">
9281 <span class="entry_type_name entry_type_name_enum">byte</span>
9282
9283 <span class="entry_type_visibility"> [public]</span>
9284
9285 <ul class="entry_type_enum">
9286 <li>
9287 <span class="entry_type_enum_name">OFF</span>
9288 </li>
9289 <li>
9290 <span class="entry_type_enum_name">ON</span>
9291 </li>
9292 </ul>
9293
9294 </td> <!-- entry_type -->
9295
9296 <td class="entry_description">
9297 Whether the HAL needs to output the lens
9298 shading map in output result metadata
9299 </td>
9300
9301 <td class="entry_units">
9302 </td>
9303
9304 <td class="entry_range">
9305 </td>
9306
9307 <td class="entry_notes">
9308 When set to ON,<wbr>
9309 android.<wbr>statistics.<wbr>lens<wbr>Shading<wbr>Map must be provided in
9310 the output result metdata.<wbr>
9311 </td>
9312
9313 <td class="entry_tags">
9314 </td>
9315
9316 </tr> <!-- end of entry -->
9317
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9318
9319
9320 <!-- end of kind -->
9321 </tbody>
9322 <tr><td colspan="7" class="kind">static</td></tr>
9323
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9324 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9325 <tr>
9326 <th class="th_name">Property Name</th>
9327 <th class="th_type">Type</th>
9328 <th class="th_description">Description</th>
9329 <th class="th_units">Units</th>
9330 <th class="th_range">Range</th>
9331 <th class="th_notes">Notes</th>
9332 <th class="th_tags">Tags</th>
9333 </tr>
9334 </thead>
9335
9336 <tbody>
9337
9338
9339
9340
9341
9342
9343
9344
9345
9346
9347
9348
9349 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
9350 <td class="entry_name">android.<wbr>statistics.<wbr>info.<wbr>available<wbr>Face<wbr>Detect<wbr>Modes</td>
9351 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9352 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9353 <span class="entry_type_container">x</span>
9354
9355 <span class="entry_type_array">
9356 n
9357 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9358 <span class="entry_type_visibility"> [public]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9359 <div class="entry_type_notes">List of enums from android.<wbr>statistics.<wbr>face<wbr>Detect<wbr>Mode</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9360
9361
9362 </td> <!-- entry_type -->
9363
9364 <td class="entry_description">
9365 Which face detection modes are available,<wbr>
9366 if any
9367 </td>
9368
9369 <td class="entry_units">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9370 List of enum:
9371 OFF
9372 SIMPLE
9373 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9374 </td>
9375
9376 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9377 </td>
9378
9379 <td class="entry_notes">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9380 OFF means face detection is disabled,<wbr> it must
9381 be included in the list.<wbr>
9382<br>
9383<br> SIMPLE means the device supports the
9384 android.<wbr>statistics.<wbr>face<wbr>Rectangles and
9385 android.<wbr>statistics.<wbr>face<wbr>Scores outputs.<wbr>
9386<br>
9387<br> FULL means the device additionally supports the
9388 android.<wbr>statistics.<wbr>face<wbr>Ids and
9389 android.<wbr>statistics.<wbr>face<wbr>Landmarks outputs.<wbr>
9390
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9391 </td>
9392
9393 <td class="entry_tags">
9394 </td>
9395
9396 </tr> <!-- end of entry -->
9397
9398
9399 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
9400 <td class="entry_name">android.<wbr>statistics.<wbr>info.<wbr>histogram<wbr>Bucket<wbr>Count</td>
9401 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9402 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9403
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9404 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9405
9406
9407 </td> <!-- entry_type -->
9408
9409 <td class="entry_description">
9410 Number of histogram buckets
9411 supported
9412 </td>
9413
9414 <td class="entry_units">
9415 </td>
9416
9417 <td class="entry_range">
9418 >= 64
9419 </td>
9420
9421 <td class="entry_notes">
9422 </td>
9423
9424 <td class="entry_tags">
9425 </td>
9426
9427 </tr> <!-- end of entry -->
9428
9429
9430 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
9431 <td class="entry_name">android.<wbr>statistics.<wbr>info.<wbr>max<wbr>Face<wbr>Count</td>
9432 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9433 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9434
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9435 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9436
9437
9438 </td> <!-- entry_type -->
9439
9440 <td class="entry_description">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9441 Maximum number of simultaneously detectable
9442 faces
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9443 </td>
9444
9445 <td class="entry_units">
9446 </td>
9447
9448 <td class="entry_range">
9449 >= 4 if availableFaceDetectionModes lists
9450 modes besides OFF,<wbr> otherwise 0
9451 </td>
9452
9453 <td class="entry_notes">
9454 </td>
9455
9456 <td class="entry_tags">
9457 </td>
9458
9459 </tr> <!-- end of entry -->
9460
9461
9462 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
9463 <td class="entry_name">android.<wbr>statistics.<wbr>info.<wbr>max<wbr>Histogram<wbr>Count</td>
9464 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9465 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9466
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9467 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9468
9469
9470 </td> <!-- entry_type -->
9471
9472 <td class="entry_description">
9473 Maximum value possible for a histogram
9474 bucket
9475 </td>
9476
9477 <td class="entry_units">
9478 </td>
9479
9480 <td class="entry_range">
9481 </td>
9482
9483 <td class="entry_notes">
9484 </td>
9485
9486 <td class="entry_tags">
9487 </td>
9488
9489 </tr> <!-- end of entry -->
9490
9491
9492 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
9493 <td class="entry_name">android.<wbr>statistics.<wbr>info.<wbr>max<wbr>Sharpness<wbr>Map<wbr>Value</td>
9494 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9495 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9496
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9497 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9498
9499
9500 </td> <!-- entry_type -->
9501
9502 <td class="entry_description">
9503 Maximum value possible for a sharpness map
9504 region.<wbr>
9505 </td>
9506
9507 <td class="entry_units">
9508 </td>
9509
9510 <td class="entry_range">
9511 </td>
9512
9513 <td class="entry_notes">
9514 </td>
9515
9516 <td class="entry_tags">
9517 </td>
9518
9519 </tr> <!-- end of entry -->
9520
9521
9522 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
9523 <td class="entry_name">android.<wbr>statistics.<wbr>info.<wbr>sharpness<wbr>Map<wbr>Size</td>
9524 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9525 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9526 <span class="entry_type_container">x</span>
9527
9528 <span class="entry_type_array">
9529 2
9530 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]9531 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9532 <div class="entry_type_notes">width x height</div>
9533
9534
9535 </td> <!-- entry_type -->
9536
9537 <td class="entry_description">
9538 Dimensions of the sharpness
9539 map
9540 </td>
9541
9542 <td class="entry_units">
9543 </td>
9544
9545 <td class="entry_range">
9546 Must be at least 32 x 32
9547 </td>
9548
9549 <td class="entry_notes">
9550 </td>
9551
9552 <td class="entry_tags">
9553 </td>
9554
9555 </tr> <!-- end of entry -->
9556
9557
9558
9559
9560
9561
9562 <!-- end of kind -->
9563 </tbody>
9564 <tr><td colspan="7" class="kind">dynamic</td></tr>
9565
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9566 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9567 <tr>
9568 <th class="th_name">Property Name</th>
9569 <th class="th_type">Type</th>
9570 <th class="th_description">Description</th>
9571 <th class="th_units">Units</th>
9572 <th class="th_range">Range</th>
9573 <th class="th_notes">Notes</th>
9574 <th class="th_tags">Tags</th>
9575 </tr>
9576 </thead>
9577
9578 <tbody>
9579
9580
9581
9582
9583
9584
9585
9586
9587
9588
9589 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
9590 <td class="entry_name">android.<wbr>statistics.<wbr>face<wbr>Detect<wbr>Mode</td>
9591 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9592 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9593
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9594 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9595
9596 <ul class="entry_type_enum">
9597 <li>
9598 <span class="entry_type_enum_name">OFF</span>
9599 </li>
9600 <li>
9601 <span class="entry_type_enum_name">SIMPLE</span>
9602 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
9603 only</span>
9604 </li>
9605 <li>
9606 <span class="entry_type_enum_name">FULL</span>
9607 <span class="entry_type_enum_notes">Optional Return all face
9608 metadata</span>
9609 </li>
9610 </ul>
9611
9612 </td> <!-- entry_type -->
9613
9614 <td class="entry_description">
9615 State of the face detector
9616 unit
9617 </td>
9618
9619 <td class="entry_units">
9620 </td>
9621
9622 <td class="entry_range">
9623
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9624 android.<wbr>statistics.<wbr>info.<wbr>available<wbr>Face<wbr>Detect<wbr>Modes
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9625 </td>
9626
9627 <td class="entry_notes">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9628 Whether face detection is enabled,<wbr> and whether it
9629 should output just the basic fields or the full set of
9630 fields.<wbr> Value must be one of the
9631 android.<wbr>statistics.<wbr>info.<wbr>available<wbr>Face<wbr>Detect<wbr>Modes.<wbr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9632 </td>
9633
9634 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9635 <ul class="entry_tags">
9636 <li><a href="#tag_BC">BC</a></li>
9637 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9638 </td>
9639
9640 </tr> <!-- end of entry -->
9641
9642
9643 <tr class="entry" id="dynamic_android.statistics.faceIds">
9644 <td class="entry_name">android.<wbr>statistics.<wbr>face<wbr>Ids</td>
9645 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9646 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9647 <span class="entry_type_container">x</span>
9648
9649 <span class="entry_type_array">
9650 n
9651 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9652 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9653
9654
9655 </td> <!-- entry_type -->
9656
9657 <td class="entry_description">
9658 List of unique IDs for detected
9659 faces
9660 </td>
9661
9662 <td class="entry_units">
9663 </td>
9664
9665 <td class="entry_range">
9666 </td>
9667
9668 <td class="entry_notes">
9669 Only available if faceDetectMode == FULL
9670 </td>
9671
9672 <td class="entry_tags">
9673 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9674 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9675 </ul>
9676 </td>
9677
9678 </tr> <!-- end of entry -->
9679
9680
9681 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
9682 <td class="entry_name">android.<wbr>statistics.<wbr>face<wbr>Landmarks</td>
9683 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9684 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9685 <span class="entry_type_container">x</span>
9686
9687 <span class="entry_type_array">
9688 n x 6
9689 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9690 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9691 <div class="entry_type_notes">(leftEyeX,<wbr> leftEyeY,<wbr> rightEyeX,<wbr> rightEyeY,<wbr> mouthX,<wbr> mouthY)</div>
9692
9693
9694 </td> <!-- entry_type -->
9695
9696 <td class="entry_description">
9697 List of landmarks for detected
9698 faces
9699 </td>
9700
9701 <td class="entry_units">
9702 </td>
9703
9704 <td class="entry_range">
9705 </td>
9706
9707 <td class="entry_notes">
9708 Only available if faceDetectMode == FULL
9709 </td>
9710
9711 <td class="entry_tags">
9712 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9713 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9714 </ul>
9715 </td>
9716
9717 </tr> <!-- end of entry -->
9718
9719
9720 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
9721 <td class="entry_name">android.<wbr>statistics.<wbr>face<wbr>Rectangles</td>
9722 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9723 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9724 <span class="entry_type_container">x</span>
9725
9726 <span class="entry_type_array">
9727 n x 4
9728 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]9729 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9730 <div class="entry_type_notes">(xmin,<wbr> ymin,<wbr> xmax,<wbr> ymax).<wbr> (0,<wbr>0) is top-left of active pixel area</div>
9731
9732
9733 </td> <!-- entry_type -->
9734
9735 <td class="entry_description">
9736 List of the bounding rectangles for detected
9737 faces
9738 </td>
9739
9740 <td class="entry_units">
9741 </td>
9742
9743 <td class="entry_range">
9744 </td>
9745
9746 <td class="entry_notes">
9747 Only available if faceDetectMode != OFF
9748 </td>
9749
9750 <td class="entry_tags">
9751 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9752 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9753 </ul>
9754 </td>
9755
9756 </tr> <!-- end of entry -->
9757
9758
9759 <tr class="entry" id="dynamic_android.statistics.faceScores">
9760 <td class="entry_name">android.<wbr>statistics.<wbr>face<wbr>Scores</td>
9761 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9762 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9763 <span class="entry_type_container">x</span>
9764
9765 <span class="entry_type_array">
9766 n
9767 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9768 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9769
9770
9771 </td> <!-- entry_type -->
9772
9773 <td class="entry_description">
9774 List of the face confidence scores for
9775 detected faces
9776 </td>
9777
9778 <td class="entry_units">
9779 </td>
9780
9781 <td class="entry_range">
9782 0-100
9783 </td>
9784
9785 <td class="entry_notes">
9786 Only available if faceDetectMode != OFF
9787 </td>
9788
9789 <td class="entry_tags">
9790 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9791 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9792 </ul>
9793 </td>
9794
9795 </tr> <!-- end of entry -->
9796
9797
9798 <tr class="entry" id="dynamic_android.statistics.histogram">
9799 <td class="entry_name">android.<wbr>statistics.<wbr>histogram</td>
9800 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9801 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9802 <span class="entry_type_container">x</span>
9803
9804 <span class="entry_type_array">
9805 n x 3
9806 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9807 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9808 <div class="entry_type_notes">count of pixels for each color channel that fall into each histogram bucket,<wbr> scaled to be between 0 and maxHistogramCount</div>
9809
9810
9811 </td> <!-- entry_type -->
9812
9813 <td class="entry_description">
9814 A 3-channel histogram based on the raw
9815 sensor data
9816 </td>
9817
9818 <td class="entry_units">
9819 </td>
9820
9821 <td class="entry_range">
9822 </td>
9823
9824 <td class="entry_notes">
9825 The k'th bucket (0-based) covers the input range
9826 (with w = android.<wbr>sensor.<wbr>info.<wbr>white<wbr>Level) of [ k * w/<wbr>N,<wbr>
9827 (k + 1) * w /<wbr> N ).<wbr> If only a monochrome sharpness map is
9828 supported,<wbr> all channels should have the same data
9829 </td>
9830
9831 <td class="entry_tags">
9832 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9833 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9834 </ul>
9835 </td>
9836
9837 </tr> <!-- end of entry -->
9838
9839
9840 <tr class="entry" id="dynamic_android.statistics.histogramMode">
9841 <td class="entry_name">android.<wbr>statistics.<wbr>histogram<wbr>Mode</td>
9842 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9843 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9844
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]9845 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9846
9847 <ul class="entry_type_enum">
9848 <li>
9849 <span class="entry_type_enum_name">OFF</span>
9850 </li>
9851 <li>
9852 <span class="entry_type_enum_name">ON</span>
9853 </li>
9854 </ul>
9855
9856 </td> <!-- entry_type -->
9857
9858 <td class="entry_description">
9859 Operating mode for histogram
9860 generation
9861 </td>
9862
9863 <td class="entry_units">
9864 </td>
9865
9866 <td class="entry_range">
9867 </td>
9868
9869 <td class="entry_notes">
9870 </td>
9871
9872 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9873 <ul class="entry_tags">
9874 <li><a href="#tag_V1">V1</a></li>
9875 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9876 </td>
9877
9878 </tr> <!-- end of entry -->
9879
9880
9881 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
9882 <td class="entry_name">android.<wbr>statistics.<wbr>sharpness<wbr>Map</td>
9883 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9884 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9885 <span class="entry_type_container">x</span>
9886
9887 <span class="entry_type_array">
9888 n x m x 3
9889 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9890 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9891 <div class="entry_type_notes">estimated sharpness for each region of the input image.<wbr> Normalized to be between 0 and maxSharpnessMapValue.<wbr> Higher values mean sharper (better focused)</div>
9892
9893
9894 </td> <!-- entry_type -->
9895
9896 <td class="entry_description">
9897 A 3-channel sharpness map,<wbr> based on the raw
9898 sensor data
9899 </td>
9900
9901 <td class="entry_units">
9902 </td>
9903
9904 <td class="entry_range">
9905 </td>
9906
9907 <td class="entry_notes">
9908 If only a monochrome sharpness map is supported,<wbr>
9909 all channels should have the same data
9910 </td>
9911
9912 <td class="entry_tags">
9913 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9914 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9915 </ul>
9916 </td>
9917
9918 </tr> <!-- end of entry -->
9919
9920
9921 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
9922 <td class="entry_name">android.<wbr>statistics.<wbr>sharpness<wbr>Map<wbr>Mode</td>
9923 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9924 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9925
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]9926 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9927
9928 <ul class="entry_type_enum">
9929 <li>
9930 <span class="entry_type_enum_name">OFF</span>
9931 </li>
9932 <li>
9933 <span class="entry_type_enum_name">ON</span>
9934 </li>
9935 </ul>
9936
9937 </td> <!-- entry_type -->
9938
9939 <td class="entry_description">
9940 Operating mode for sharpness map
9941 generation
9942 </td>
9943
9944 <td class="entry_units">
9945 </td>
9946
9947 <td class="entry_range">
9948 </td>
9949
9950 <td class="entry_notes">
9951 </td>
9952
9953 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9954 <ul class="entry_tags">
9955 <li><a href="#tag_V1">V1</a></li>
9956 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9957 </td>
9958
9959 </tr> <!-- end of entry -->
9960
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9961
9962 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
9963 <td class="entry_name">android.<wbr>statistics.<wbr>lens<wbr>Shading<wbr>Map</td>
9964 <td class="entry_type">
9965 <span class="entry_type_name">float</span>
9966 <span class="entry_type_container">x</span>
9967
9968 <span class="entry_type_array">
9969 4 x n x m
9970 </span>
9971 <span class="entry_type_visibility"> [public]</span>
9972 <div class="entry_type_notes">2D array of float gain factors per channel to correct lens shading</div>
9973
9974
9975 </td> <!-- entry_type -->
9976
9977 <td class="entry_description">
9978 A low-resolution map of lens shading,<wbr> per
9979 color channel
9980 </td>
9981
9982 <td class="entry_units">
9983 </td>
9984
9985 <td class="entry_range">
9986 Each gain factor is >= 1
9987 </td>
9988
9989 <td class="entry_notes">
9990 Assume bilinear interpolation of map.<wbr> The least
9991 shaded section of the image should have a gain factor
9992 of 1; all other sections should have gains above 1.<wbr>
9993 the map should be on the order of 30-40 rows,<wbr> and
9994 must be smaller than 64x64.<wbr>
9995 </td>
9996
9997 <td class="entry_tags">
9998 </td>
9999
10000 </tr> <!-- end of entry -->
10001
10002
10003 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
10004 <td class="entry_name">android.<wbr>statistics.<wbr>predicted<wbr>Color<wbr>Gains</td>
10005 <td class="entry_type">
10006 <span class="entry_type_name">float</span>
10007 <span class="entry_type_container">x</span>
10008
10009 <span class="entry_type_array">
10010 4
10011 </span>
10012 <span class="entry_type_visibility"> [public]</span>
10013 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
10014
10015
10016 </td> <!-- entry_type -->
10017
10018 <td class="entry_description">
10019 The best-fit color channel gains calculated
10020 by the HAL's statistics units for the current output frame
10021
10022 </td>
10023
10024 <td class="entry_units">
10025 </td>
10026
10027 <td class="entry_range">
10028 </td>
10029
10030 <td class="entry_notes">
10031
10032 This may be different than the gains used for this frame,<wbr>
10033 since statistics processing on data from a new frame
10034 typically completes after the transform has already been
10035 applied to that frame.<wbr>
10036<br>
10037<br> The 4 channel gains are defined in Bayer domain,<wbr>
10038 see android.<wbr>color<wbr>Correction.<wbr>gains for details.<wbr>
10039 </td>
10040
10041 <td class="entry_tags">
10042 </td>
10043
10044 </tr> <!-- end of entry -->
10045
10046
10047 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
10048 <td class="entry_name">android.<wbr>statistics.<wbr>predicted<wbr>Color<wbr>Transform</td>
10049 <td class="entry_type">
10050 <span class="entry_type_name">rational</span>
10051 <span class="entry_type_container">x</span>
10052
10053 <span class="entry_type_array">
10054 3 x 3
10055 </span>
10056 <span class="entry_type_visibility"> [public]</span>
10057 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
10058
10059
10060 </td> <!-- entry_type -->
10061
10062 <td class="entry_description">
10063 The best-fit color transform matrix estimate
10064 calculated by the HAL's statistics units for the current
10065 output frame
10066 </td>
10067
10068 <td class="entry_units">
10069 </td>
10070
10071 <td class="entry_range">
10072 </td>
10073
10074 <td class="entry_notes">
10075 The HAL must provide the estimate from its
10076 statistics unit on the white balance transforms to use
10077 for the next frame.<wbr> These are the values the HAL believes
10078 are the best fit for the current output frame.<wbr> This may
10079 be different than the transform used for this frame,<wbr> since
10080 statistics processing on data from a new frame typically
10081 completes after the transform has already been applied to
10082 that frame.<wbr>
10083<br>
10084<br> These estimates must be provided for all frames,<wbr> even if
10085 capture settings and color transforms are set by the application.<wbr>
10086
10087 </td>
10088
10089 <td class="entry_tags">
10090 </td>
10091
10092 </tr> <!-- end of entry -->
10093
10094
10095 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
10096 <td class="entry_name">android.<wbr>statistics.<wbr>scene<wbr>Flicker</td>
10097 <td class="entry_type">
10098 <span class="entry_type_name entry_type_name_enum">byte</span>
10099
10100 <span class="entry_type_visibility"> [public]</span>
10101
10102 <ul class="entry_type_enum">
10103 <li>
10104 <span class="entry_type_enum_name">NONE</span>
10105 </li>
10106 <li>
10107 <span class="entry_type_enum_name">50HZ</span>
10108 </li>
10109 <li>
10110 <span class="entry_type_enum_name">60HZ</span>
10111 </li>
10112 </ul>
10113
10114 </td> <!-- entry_type -->
10115
10116 <td class="entry_description">
10117 The HAL estimated scene illumination lighting
10118 frequency
10119 </td>
10120
10121 <td class="entry_units">
10122 </td>
10123
10124 <td class="entry_range">
10125 </td>
10126
10127 <td class="entry_notes">
10128 Report NONE if there doesn't appear to be flickering
10129 illumination
10130 </td>
10131
10132 <td class="entry_tags">
10133 </td>
10134
10135 </tr> <!-- end of entry -->
10136
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10137
10138
10139 <!-- end of kind -->
10140 </tbody>
10141
10142 <!-- end of section -->
10143 <tr><td colspan="7" id="section_tonemap" class="section">tonemap</td></tr>
10144
10145
10146 <tr><td colspan="7" class="kind">controls</td></tr>
10147
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10148 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10149 <tr>
10150 <th class="th_name">Property Name</th>
10151 <th class="th_type">Type</th>
10152 <th class="th_description">Description</th>
10153 <th class="th_units">Units</th>
10154 <th class="th_range">Range</th>
10155 <th class="th_notes">Notes</th>
10156 <th class="th_tags">Tags</th>
10157 </tr>
10158 </thead>
10159
10160 <tbody>
10161
10162
10163
10164
10165
10166
10167
10168
10169
10170
10171 <tr class="entry" id="controls_android.tonemap.curveBlue">
10172 <td class="entry_name">android.<wbr>tonemap.<wbr>curve<wbr>Blue</td>
10173 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]10174 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10175
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10176 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10177
10178
10179 </td> <!-- entry_type -->
10180
10181 <td class="entry_description">
10182 Table mapping blue input values to output
10183 values
10184 </td>
10185
10186 <td class="entry_units">
10187 same as android.<wbr>tonemap.<wbr>curve<wbr>Red
10188 </td>
10189
10190 <td class="entry_range">
10191 same as android.<wbr>tonemap.<wbr>curve<wbr>Red
10192 </td>
10193
10194 <td class="entry_notes">
10195 </td>
10196
10197 <td class="entry_tags">
10198 </td>
10199
10200 </tr> <!-- end of entry -->
10201
10202
10203 <tr class="entry" id="controls_android.tonemap.curveGreen">
10204 <td class="entry_name">android.<wbr>tonemap.<wbr>curve<wbr>Green</td>
10205 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]10206 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10207
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10208 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10209
10210
10211 </td> <!-- entry_type -->
10212
10213 <td class="entry_description">
10214 Table mapping green input values to output
10215 values
10216 </td>
10217
10218 <td class="entry_units">
10219 same as android.<wbr>tonemap.<wbr>curve<wbr>Red
10220 </td>
10221
10222 <td class="entry_range">
10223 same as android.<wbr>tonemap.<wbr>curve<wbr>Red
10224 </td>
10225
10226 <td class="entry_notes">
10227 </td>
10228
10229 <td class="entry_tags">
10230 </td>
10231
10232 </tr> <!-- end of entry -->
10233
10234
10235 <tr class="entry" id="controls_android.tonemap.curveRed">
10236 <td class="entry_name">android.<wbr>tonemap.<wbr>curve<wbr>Red</td>
10237 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10238 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10239 <span class="entry_type_container">x</span>
10240
10241 <span class="entry_type_array">
10242 n x 2
10243 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10244 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10245 <div class="entry_type_notes">A 1D array of pairs of floats.<wbr> mapping a 0-1 input range to a 0-1 output range.<wbr></div>
10246
10247
10248 </td> <!-- entry_type -->
10249
10250 <td class="entry_description">
10251 Table mapping red input values to output
10252 values
10253 </td>
10254
10255 <td class="entry_units">
10256 </td>
10257
10258 <td class="entry_range">
10259 0-1 on input and output coordinates.<wbr> Max entry
10260 count speciied by android.<wbr>tonemap.<wbr>max<wbr>Curve<wbr>Points
10261 </td>
10262
10263 <td class="entry_notes">
10264 .<wbr>The input range must be monotonically increasing
10265 with N,<wbr> and values between entries should be linearly
10266 interpolated.<wbr> For example,<wbr> if the array is: [0.<wbr>0,<wbr> 0.<wbr>0,<wbr>
10267 0.<wbr>3,<wbr> 0.<wbr>5,<wbr> 1.<wbr>0,<wbr> 1.<wbr>0],<wbr> then the input->output mapping
10268 for a few sample points would be: 0 -> 0,<wbr> 0.<wbr>15 ->
10269 0.<wbr>25,<wbr> 0.<wbr>3 -> 0.<wbr>5,<wbr> 0.<wbr>5 -> 0.<wbr>64
10270 </td>
10271
10272 <td class="entry_tags">
10273 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10274 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10275 </ul>
10276 </td>
10277
10278 </tr> <!-- end of entry -->
10279
10280
10281 <tr class="entry" id="controls_android.tonemap.mode">
10282 <td class="entry_name">android.<wbr>tonemap.<wbr>mode</td>
10283 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10284 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10285
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10286 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10287
10288 <ul class="entry_type_enum">
10289 <li>
10290 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
10291 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
10292 android.<wbr>tonemap.<wbr>curve</span>
10293 </li>
10294 <li>
10295 <span class="entry_type_enum_name">FAST</span>
10296 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10297 bayer output</span>
10298 </li>
10299 <li>
10300 <span class="entry_type_enum_name">HIGH_QUALITY</span>
10301 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10302 quality</span>
10303 </li>
10304 </ul>
10305
10306 </td> <!-- entry_type -->
10307
10308 <td class="entry_description">
10309 </td>
10310
10311 <td class="entry_units">
10312 </td>
10313
10314 <td class="entry_range">
10315 </td>
10316
10317 <td class="entry_notes">
10318 </td>
10319
10320 <td class="entry_tags">
10321 </td>
10322
10323 </tr> <!-- end of entry -->
10324
10325
10326
10327 <!-- end of kind -->
10328 </tbody>
10329 <tr><td colspan="7" class="kind">static</td></tr>
10330
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10331 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10332 <tr>
10333 <th class="th_name">Property Name</th>
10334 <th class="th_type">Type</th>
10335 <th class="th_description">Description</th>
10336 <th class="th_units">Units</th>
10337 <th class="th_range">Range</th>
10338 <th class="th_notes">Notes</th>
10339 <th class="th_tags">Tags</th>
10340 </tr>
10341 </thead>
10342
10343 <tbody>
10344
10345
10346
10347
10348
10349
10350
10351
10352
10353
10354 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
10355 <td class="entry_name">android.<wbr>tonemap.<wbr>max<wbr>Curve<wbr>Points</td>
10356 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10357 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10358
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10359 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10360
10361
10362 </td> <!-- entry_type -->
10363
10364 <td class="entry_description">
10365 Maximum number of supported points in the
10366 tonemap curve
10367 </td>
10368
10369 <td class="entry_units">
10370 </td>
10371
10372 <td class="entry_range">
10373 >= 128
10374 </td>
10375
10376 <td class="entry_notes">
10377 </td>
10378
10379 <td class="entry_tags">
10380 </td>
10381
10382 </tr> <!-- end of entry -->
10383
10384
10385
10386 <!-- end of kind -->
10387 </tbody>
10388 <tr><td colspan="7" class="kind">dynamic</td></tr>
10389
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10390 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10391 <tr>
10392 <th class="th_name">Property Name</th>
10393 <th class="th_type">Type</th>
10394 <th class="th_description">Description</th>
10395 <th class="th_units">Units</th>
10396 <th class="th_range">Range</th>
10397 <th class="th_notes">Notes</th>
10398 <th class="th_tags">Tags</th>
10399 </tr>
10400 </thead>
10401
10402 <tbody>
10403
10404
10405
10406
10407
10408
10409
10410
10411
10412
10413 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
10414 <td class="entry_name">android.<wbr>tonemap.<wbr>curve<wbr>Blue</td>
10415 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]10416 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10417
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10418 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10419
10420
10421 </td> <!-- entry_type -->
10422
10423 <td class="entry_description">
10424 Table mapping blue input values to output
10425 values
10426 </td>
10427
10428 <td class="entry_units">
10429 same as android.<wbr>tonemap.<wbr>curve<wbr>Red
10430 </td>
10431
10432 <td class="entry_range">
10433 same as android.<wbr>tonemap.<wbr>curve<wbr>Red
10434 </td>
10435
10436 <td class="entry_notes">
10437 </td>
10438
10439 <td class="entry_tags">
10440 </td>
10441
10442 </tr> <!-- end of entry -->
10443
10444
10445 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
10446 <td class="entry_name">android.<wbr>tonemap.<wbr>curve<wbr>Green</td>
10447 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]10448 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10449
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10450 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10451
10452
10453 </td> <!-- entry_type -->
10454
10455 <td class="entry_description">
10456 Table mapping green input values to output
10457 values
10458 </td>
10459
10460 <td class="entry_units">
10461 same as android.<wbr>tonemap.<wbr>curve<wbr>Red
10462 </td>
10463
10464 <td class="entry_range">
10465 same as android.<wbr>tonemap.<wbr>curve<wbr>Red
10466 </td>
10467
10468 <td class="entry_notes">
10469 </td>
10470
10471 <td class="entry_tags">
10472 </td>
10473
10474 </tr> <!-- end of entry -->
10475
10476
10477 <tr class="entry" id="dynamic_android.tonemap.curveRed">
10478 <td class="entry_name">android.<wbr>tonemap.<wbr>curve<wbr>Red</td>
10479 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10480 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10481 <span class="entry_type_container">x</span>
10482
10483 <span class="entry_type_array">
10484 n x 2
10485 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10486 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10487 <div class="entry_type_notes">A 1D array of pairs of floats.<wbr> mapping a 0-1 input range to a 0-1 output range.<wbr></div>
10488
10489
10490 </td> <!-- entry_type -->
10491
10492 <td class="entry_description">
10493 Table mapping red input values to output
10494 values
10495 </td>
10496
10497 <td class="entry_units">
10498 </td>
10499
10500 <td class="entry_range">
10501 0-1 on input and output coordinates.<wbr> Max entry
10502 count speciied by android.<wbr>tonemap.<wbr>max<wbr>Curve<wbr>Points
10503 </td>
10504
10505 <td class="entry_notes">
10506 .<wbr>The input range must be monotonically increasing
10507 with N,<wbr> and values between entries should be linearly
10508 interpolated.<wbr> For example,<wbr> if the array is: [0.<wbr>0,<wbr> 0.<wbr>0,<wbr>
10509 0.<wbr>3,<wbr> 0.<wbr>5,<wbr> 1.<wbr>0,<wbr> 1.<wbr>0],<wbr> then the input->output mapping
10510 for a few sample points would be: 0 -> 0,<wbr> 0.<wbr>15 ->
10511 0.<wbr>25,<wbr> 0.<wbr>3 -> 0.<wbr>5,<wbr> 0.<wbr>5 -> 0.<wbr>64
10512 </td>
10513
10514 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10515 <ul class="entry_tags">
10516 <li><a href="#tag_DNG">DNG</a></li>
10517 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10518 </td>
10519
10520 </tr> <!-- end of entry -->
10521
10522
10523 <tr class="entry" id="dynamic_android.tonemap.mode">
10524 <td class="entry_name">android.<wbr>tonemap.<wbr>mode</td>
10525 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10526 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10527
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10528 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10529
10530 <ul class="entry_type_enum">
10531 <li>
10532 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
10533 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
10534 android.<wbr>tonemap.<wbr>curve</span>
10535 </li>
10536 <li>
10537 <span class="entry_type_enum_name">FAST</span>
10538 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10539 bayer output</span>
10540 </li>
10541 <li>
10542 <span class="entry_type_enum_name">HIGH_QUALITY</span>
10543 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10544 quality</span>
10545 </li>
10546 </ul>
10547
10548 </td> <!-- entry_type -->
10549
10550 <td class="entry_description">
10551 </td>
10552
10553 <td class="entry_units">
10554 </td>
10555
10556 <td class="entry_range">
10557 </td>
10558
10559 <td class="entry_notes">
10560 </td>
10561
10562 <td class="entry_tags">
10563 </td>
10564
10565 </tr> <!-- end of entry -->
10566
10567
10568
10569 <!-- end of kind -->
10570 </tbody>
10571
10572 <!-- end of section -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10573 <tr><td colspan="7" id="section_led" class="section">led</td></tr>
10574
10575
10576 <tr><td colspan="7" class="kind">controls</td></tr>
10577
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10578 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10579 <tr>
10580 <th class="th_name">Property Name</th>
10581 <th class="th_type">Type</th>
10582 <th class="th_description">Description</th>
10583 <th class="th_units">Units</th>
10584 <th class="th_range">Range</th>
10585 <th class="th_notes">Notes</th>
10586 <th class="th_tags">Tags</th>
10587 </tr>
10588 </thead>
10589
10590 <tbody>
10591
10592
10593
10594
10595
10596
10597
10598
10599
10600
10601 <tr class="entry" id="controls_android.led.transmit">
10602 <td class="entry_name">android.<wbr>led.<wbr>transmit</td>
10603 <td class="entry_type">
10604 <span class="entry_type_name entry_type_name_enum">byte</span>
10605
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]10606 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10607
10608 <ul class="entry_type_enum">
10609 <li>
10610 <span class="entry_type_enum_name">OFF</span>
10611 </li>
10612 <li>
10613 <span class="entry_type_enum_name">ON</span>
10614 </li>
10615 </ul>
10616
10617 </td> <!-- entry_type -->
10618
10619 <td class="entry_description">
10620 This LED is nominally used to indicate to the user
10621 that the camera is powered on and may be streaming images back to the
10622 Application Processor.<wbr> In certain rare circumstances,<wbr> the OS may
10623 disable this when video is processed locally and not transmitted to
10624 any untrusted applications.<wbr>
10625<br>
10626<br> In particular,<wbr> the LED *must* always be on when the data could be
10627 transmitted off the device.<wbr> The LED *should* always be on whenever
10628 data is stored locally on the device.<wbr>
10629<br>
10630<br> The LED *may* be off if a trusted application is using the data that
10631 doesn't violate the above rules.<wbr>
10632
10633 </td>
10634
10635 <td class="entry_units">
10636 </td>
10637
10638 <td class="entry_range">
10639 </td>
10640
10641 <td class="entry_notes">
10642 </td>
10643
10644 <td class="entry_tags">
10645 </td>
10646
10647 </tr> <!-- end of entry -->
10648
10649
10650
10651 <!-- end of kind -->
10652 </tbody>
10653 <tr><td colspan="7" class="kind">dynamic</td></tr>
10654
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10655 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10656 <tr>
10657 <th class="th_name">Property Name</th>
10658 <th class="th_type">Type</th>
10659 <th class="th_description">Description</th>
10660 <th class="th_units">Units</th>
10661 <th class="th_range">Range</th>
10662 <th class="th_notes">Notes</th>
10663 <th class="th_tags">Tags</th>
10664 </tr>
10665 </thead>
10666
10667 <tbody>
10668
10669
10670
10671
10672
10673
10674
10675
10676
10677
10678 <tr class="entry" id="dynamic_android.led.transmit">
10679 <td class="entry_name">android.<wbr>led.<wbr>transmit</td>
10680 <td class="entry_type">
10681 <span class="entry_type_name entry_type_name_enum">byte</span>
10682
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]10683 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10684
10685 <ul class="entry_type_enum">
10686 <li>
10687 <span class="entry_type_enum_name">OFF</span>
10688 </li>
10689 <li>
10690 <span class="entry_type_enum_name">ON</span>
10691 </li>
10692 </ul>
10693
10694 </td> <!-- entry_type -->
10695
10696 <td class="entry_description">
10697 This LED is nominally used to indicate to the user
10698 that the camera is powered on and may be streaming images back to the
10699 Application Processor.<wbr> In certain rare circumstances,<wbr> the OS may
10700 disable this when video is processed locally and not transmitted to
10701 any untrusted applications.<wbr>
10702<br>
10703<br> In particular,<wbr> the LED *must* always be on when the data could be
10704 transmitted off the device.<wbr> The LED *should* always be on whenever
10705 data is stored locally on the device.<wbr>
10706<br>
10707<br> The LED *may* be off if a trusted application is using the data that
10708 doesn't violate the above rules.<wbr>
10709
10710 </td>
10711
10712 <td class="entry_units">
10713 </td>
10714
10715 <td class="entry_range">
10716 </td>
10717
10718 <td class="entry_notes">
10719 </td>
10720
10721 <td class="entry_tags">
10722 </td>
10723
10724 </tr> <!-- end of entry -->
10725
10726
10727
10728 <!-- end of kind -->
10729 </tbody>
10730 <tr><td colspan="7" class="kind">static</td></tr>
10731
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10732 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10733 <tr>
10734 <th class="th_name">Property Name</th>
10735 <th class="th_type">Type</th>
10736 <th class="th_description">Description</th>
10737 <th class="th_units">Units</th>
10738 <th class="th_range">Range</th>
10739 <th class="th_notes">Notes</th>
10740 <th class="th_tags">Tags</th>
10741 </tr>
10742 </thead>
10743
10744 <tbody>
10745
10746
10747
10748
10749
10750
10751
10752
10753
10754
10755 <tr class="entry" id="static_android.led.availableLeds">
10756 <td class="entry_name">android.<wbr>led.<wbr>available<wbr>Leds</td>
10757 <td class="entry_type">
10758 <span class="entry_type_name entry_type_name_enum">byte</span>
10759 <span class="entry_type_container">x</span>
10760
10761 <span class="entry_type_array">
10762 n
10763 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10764 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]10765
10766 <ul class="entry_type_enum">
10767 <li>
10768 <span class="entry_type_enum_name">TRANSMIT</span>
10769 <span class="entry_type_enum_notes">android.<wbr>led.<wbr>transmit control is used</span>
10770 </li>
10771 </ul>
10772
10773 </td> <!-- entry_type -->
10774
10775 <td class="entry_description">
10776 A list of camera LEDs that are available on this system.<wbr>
10777
10778 </td>
10779
10780 <td class="entry_units">
10781 </td>
10782
10783 <td class="entry_range">
10784 </td>
10785
10786 <td class="entry_notes">
10787 </td>
10788
10789 <td class="entry_tags">
10790 </td>
10791
10792 </tr> <!-- end of entry -->
10793
10794
10795
10796 <!-- end of kind -->
10797 </tbody>
10798
10799 <!-- end of section -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]10800 <tr><td colspan="7" id="section_info" class="section">info</td></tr>
10801
10802
10803 <tr><td colspan="7" class="kind">static</td></tr>
10804
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10805 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]10806 <tr>
10807 <th class="th_name">Property Name</th>
10808 <th class="th_type">Type</th>
10809 <th class="th_description">Description</th>
10810 <th class="th_units">Units</th>
10811 <th class="th_range">Range</th>
10812 <th class="th_notes">Notes</th>
10813 <th class="th_tags">Tags</th>
10814 </tr>
10815 </thead>
10816
10817 <tbody>
10818
10819
10820
10821
10822
10823
10824
10825
10826
10827
10828 <tr class="entry" id="static_android.info.supportedHardwareLevel">
10829 <td class="entry_name">android.<wbr>info.<wbr>supported<wbr>Hardware<wbr>Level</td>
10830 <td class="entry_type">
10831 <span class="entry_type_name entry_type_name_enum">byte</span>
10832
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10833 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]10834
10835 <ul class="entry_type_enum">
10836 <li>
10837 <span class="entry_type_enum_name">LIMITED</span>
10838 </li>
10839 <li>
10840 <span class="entry_type_enum_name">FULL</span>
10841 </li>
10842 </ul>
10843
10844 </td> <!-- entry_type -->
10845
10846 <td class="entry_description">
10847
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10848 The camera 3 HAL device can implement one of two possible
10849 operational modes; limited and full.<wbr> Full support is
10850 expected from new higher-end devices.<wbr> Limited mode has
10851 hardware requirements roughly in line with those for a
10852 camera HAL device v1 implementation,<wbr> and is expected from
10853 older or inexpensive devices.<wbr> Full is a strict superset of
10854 limited,<wbr> and they share the same essential operational flow.<wbr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]10855<br>
10856<br> For full details refer to "S3.<wbr> Operational Modes" in camera3.<wbr>h
10857
10858 </td>
10859
10860 <td class="entry_units">
10861 </td>
10862
10863 <td class="entry_range">
10864 Optional.<wbr> Default value is LIMITED.<wbr>
10865 </td>
10866
10867 <td class="entry_notes">
10868 </td>
10869
10870 <td class="entry_tags">
10871 </td>
10872
10873 </tr> <!-- end of entry -->
10874
10875
10876
10877 <!-- end of kind -->
10878 </tbody>
10879
10880 <!-- end of section -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10881 <tr><td colspan="7" id="section_blackLevel" class="section">blackLevel</td></tr>
10882
10883
10884 <tr><td colspan="7" class="kind">controls</td></tr>
10885
10886 <thead class="entries_header">
10887 <tr>
10888 <th class="th_name">Property Name</th>
10889 <th class="th_type">Type</th>
10890 <th class="th_description">Description</th>
10891 <th class="th_units">Units</th>
10892 <th class="th_range">Range</th>
10893 <th class="th_notes">Notes</th>
10894 <th class="th_tags">Tags</th>
10895 </tr>
10896 </thead>
10897
10898 <tbody>
10899
10900
10901
10902
10903
10904
10905
10906
10907
10908
10909 <tr class="entry" id="controls_android.blackLevel.lock">
10910 <td class="entry_name">android.<wbr>black<wbr>Level.<wbr>lock</td>
10911 <td class="entry_type">
10912 <span class="entry_type_name entry_type_name_enum">byte</span>
10913
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]10914 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10915
10916 <ul class="entry_type_enum">
10917 <li>
10918 <span class="entry_type_enum_name">OFF</span>
10919 </li>
10920 <li>
10921 <span class="entry_type_enum_name">ON</span>
10922 </li>
10923 </ul>
10924
10925 </td> <!-- entry_type -->
10926
10927 <td class="entry_description">
10928 Whether black-level compensation is locked
10929 to its current values,<wbr> or is free to vary
10930 </td>
10931
10932 <td class="entry_units">
10933 </td>
10934
10935 <td class="entry_range">
10936 </td>
10937
10938 <td class="entry_notes">
10939 When set to ON,<wbr> the values used for black-level
10940 compensation must not change until the lock is set to
10941 OFF
10942<br>
10943<br> Since changes to certain capture parameters (such as
10944 exposure time) may require resetting of black level
10945 compensation,<wbr> the HAL must report whether setting the
10946 black level lock was successful in the output result
10947 metadata.<wbr>
10948 </td>
10949
10950 <td class="entry_tags">
10951 <ul class="entry_tags">
10952 <li><a href="#tag_HAL2">HAL2</a></li>
10953 </ul>
10954 </td>
10955
10956 </tr> <!-- end of entry -->
10957
10958
10959
10960 <!-- end of kind -->
10961 </tbody>
10962 <tr><td colspan="7" class="kind">dynamic</td></tr>
10963
10964 <thead class="entries_header">
10965 <tr>
10966 <th class="th_name">Property Name</th>
10967 <th class="th_type">Type</th>
10968 <th class="th_description">Description</th>
10969 <th class="th_units">Units</th>
10970 <th class="th_range">Range</th>
10971 <th class="th_notes">Notes</th>
10972 <th class="th_tags">Tags</th>
10973 </tr>
10974 </thead>
10975
10976 <tbody>
10977
10978
10979
10980
10981
10982
10983
10984
10985
10986
10987 <tr class="entry" id="dynamic_android.blackLevel.lock">
10988 <td class="entry_name">android.<wbr>black<wbr>Level.<wbr>lock</td>
10989 <td class="entry_type">
10990 <span class="entry_type_name entry_type_name_enum">byte</span>
10991
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame^]10992 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10993
10994 <ul class="entry_type_enum">
10995 <li>
10996 <span class="entry_type_enum_name">OFF</span>
10997 </li>
10998 <li>
10999 <span class="entry_type_enum_name">ON</span>
11000 </li>
11001 </ul>
11002
11003 </td> <!-- entry_type -->
11004
11005 <td class="entry_description">
11006 Whether black-level compensation is locked
11007 to its current values,<wbr> or is free to vary
11008 </td>
11009
11010 <td class="entry_units">
11011 </td>
11012
11013 <td class="entry_range">
11014 </td>
11015
11016 <td class="entry_notes">
11017 When set to ON,<wbr> the values used for black-level
11018 compensation must not change until the lock is set to
11019 OFF
11020<br>
11021<br> Since changes to certain capture parameters (such as
11022 exposure time) may require resetting of black level
11023 compensation,<wbr> the HAL must report whether setting the
11024 black level lock was successful in the output result
11025 metadata.<wbr>
11026 </td>
11027
11028 <td class="entry_tags">
11029 <ul class="entry_tags">
11030 <li><a href="#tag_HAL2">HAL2</a></li>
11031 </ul>
11032 </td>
11033
11034 </tr> <!-- end of entry -->
11035
11036
11037
11038 <!-- end of kind -->
11039 </tbody>
11040
11041 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11042<!-- </namespace> -->
11043 </table>
11044
11045 <div class="tags" id="tag_index">
11046 <h2>Tags</h2>
11047 <ul>
11048 <li id="tag_AWB">AWB -
11049 Needed for auto white balance
11050
11051 <ul class="tags_entries">
11052 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
11053 </ul>
11054 </li> <!-- tag_AWB -->
11055 <li id="tag_BC">BC -
11056 Needed for backwards compatibility with old Java API
11057
11058 <ul class="tags_entries">
11059 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
11060 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
11061 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
11062 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
11063 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]11064 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11065 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
11066 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]11067 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11068 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
11069 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
11070 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
11071 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
11072 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
11073 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
11074 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
11075 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
11076 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
11077 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
11078 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
11079 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
11080 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
11081 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
11082 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
11083 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
11084 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
11085 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
11086 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
11087 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
11088 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
11089 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
11090 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
11091 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
11092 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
11093 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
11094 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
11095 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
11096 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
11097 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
11098 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
11099 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
11100 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
11101 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
11102 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
11103 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]11104 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11105 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
11106 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
11107 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11108 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11109 <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]11110 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
11111 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
11112 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
11113 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
11114 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
11115 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
11116 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
11117 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
11118 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
11119 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
11120 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
11121 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
11122 </ul>
11123 </li> <!-- tag_BC -->
11124 <li id="tag_V1">V1 -
11125 New features for first camera 2 release (API1)
11126
11127 <ul class="tags_entries">
11128 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
11129 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
11130 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
11131 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
11132 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
11133 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
11134 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
11135 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
11136 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
11137 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
11138 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
11139 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
11140 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
11141 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
11142 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
11143 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
11144 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
11145 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
11146 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
11147 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
11148 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
11149 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
11150 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
11151 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11152 <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]11153 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
11154 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
11155 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
11156 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
11157 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
11158 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
11159 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
11160 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
11161 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
11162 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
11163 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
11164 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
11165 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
11166 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
11167 </ul>
11168 </li> <!-- tag_V1 -->
11169 <li id="tag_ADV">ADV - None
11170 <ul class="tags_entries">
11171 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
11172 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
11173 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
11174 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
11175 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
11176 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
11177 </ul>
11178 </li> <!-- tag_ADV -->
11179 <li id="tag_DNG">DNG -
11180 Needed for DNG file support
11181
11182 <ul class="tags_entries">
11183 <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]11184 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
11185 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
11186 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
11187 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
11188 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
11189 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
11190 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
11191 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
11192 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
11193 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
11194 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
11195 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
11196 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
11197 </ul>
11198 </li> <!-- tag_DNG -->
11199 <li id="tag_EXIF">EXIF - None
11200 <ul class="tags_entries">
11201 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
11202 </ul>
11203 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]11204 <li id="tag_HAL2">HAL2 -
11205 Tag only used by camera device HAL 2.x
11206
11207 <ul class="tags_entries">
11208 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
11209 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
11210 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11211 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]11212 </ul>
11213 </li> <!-- tag_HAL2 -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11214 </ul>
11215 </div>
11216
11217 [ <a href="#">top</a> ]
11218
11219</body>
11220</html>