Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / system / media / a5532df2877d918824c064f77a9b5725c493a558 / . / camera / docs / docs.html
blob: 54ceda3d8db02dbddf44e8478ce5d81e05b227e3 [file] [log] [blame]
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1<!DOCTYPE html>
2<html>
3<!-- Copyright (C) 2012 The Android Open Source Project
4
5 Licensed under the Apache License, Version 2.0 (the "License");
6 you may not use this file except in compliance with the License.
7 You may obtain a copy of the License at
8
9 http://www.apache.org/licenses/LICENSE-2.0
10
11 Unless required by applicable law or agreed to in writing, software
12 distributed under the License is distributed on an "AS IS" BASIS,
13 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 See the License for the specific language governing permissions and
15 limitations under the License.
16-->
17<head>
18 <!-- automatically generated from html.mako. do NOT edit directly -->
19 <meta charset="utf-8" />
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]20 <title>Android Camera HAL3.0 Properties</title>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]21 <style type="text/css">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]22 body { background-color: #f7f7f7; font-family: Roboto, sans-serif;}
23 h1 { color: #333333; }
24 h2 { color: #333333; }
25 a:link { color: #258aaf; text-decoration: none}
26 a:hover { color: #459aaf; text-decoration: underline }
27 a:visited { color: #154a5f; text-decoration: none}
28 .section { color: #eeeeee; font-size: 1.5em; font-weight: bold; background-color: #888888; padding: 0.5em 0em 0.5em 0.5em; border-width: thick thin thin thin; border-color: #111111 #777777 #777777 #777777}
29 .kind { color: #eeeeee; font-size: 1.2em; font-weight: bold; padding-left: 1.5em; background-color: #aaaaaa }
30 .entry { background-color: #f0f0f0 }
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]31 .entry_cont { background-color: #f0f0f0 }
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]32 .entries_header { background-color: #dddddd; text-align: center}
33
34 /* toc style */
35 .toc_section_header { font-size:1.3em; }
36 .toc_kind_header { font-size:1.2em; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]37
38 /* table column sizes */
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]39 table { border-collapse:collapse; table-layout: fixed; width: 100%; word-wrap: break-word }
40 td,th { border: 1px solid; border-color: #aaaaaa; padding-left: 0.5em; padding-right: 0.5em }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]41 .th_name { width: 20% }
42 .th_units { width: 10% }
43 .th_tags { width: 5% }
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]44 .th_details { width: 25% }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]45 .th_type { width: 20% }
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]46 .th_description { width: 20% }
47 .th_range { width: 10% }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]48 td { font-size: 0.9em; }
49
50 /* hide the first thead, we need it there only to enforce column sizes */
51 .thead_dummy { visibility: hidden; }
52
53 /* Entry flair */
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]54 .entry_name { color: #333333; padding-left:1.0em; font-size:1.1em; font-family: monospace; vertical-align:top; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]55
56 /* Entry type flair */
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]57 .entry_type_name { font-size:1.1em; color: #669900; font-weight: bold;}
58 .entry_type_name_enum:after { color: #669900; font-weight: bold; content:" (enum)" }
59 .entry_type_visibility { font-weight: bolder; padding-left:1em}
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]60 .entry_type_enum_name { font-family: monospace; font-weight: bolder; }
61 .entry_type_enum_notes:before { content:" - " }
62 .entry_type_enum_value:before { content:" = " }
63 .entry_type_enum_value { font-family: monospace; }
64 .entry ul { margin: 0 0 0 0; list-style-position: inside; padding-left: 0.5em; }
65 .entry ul li { padding: 0 0 0 0; margin: 0 0 0 0;}
66
67 /* Entry tags flair */
68 .entry_tags ul { list-style-type: none; }
69
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]70 /* Entry details (full docs) flair */
71 .entry_details_header { font-weight: bold; background-color: #dddddd;
72 text-align: center; font-size: 1.1em; margin-left: 0em; margin-right: 0em; }
73
74 /* Entry spacer flair */
75 .entry_spacer { background-color: transparent; border-style: none; height: 0.5em; }
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]76
77 /* TODO: generate abbr element for each tag link? */
78 /* TODO for each x.y.z try to link it to the entry */
79
80 </style>
81
82 <style>
83
84 {
85 /* broken...
86 supposedly there is a bug in chrome that it lays out tables before
87 it knows its being printed, so the page-break-* styles are ignored
88 */
89 tr { page-break-after: always; page-break-inside: avoid; }
90 }
91
92 </style>
93</head>
94
95
96
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]97<body>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]98 <h1>Android Camera HAL3.0 Properties</h1>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]99
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]100
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]101 <h2>Table of Contents</h2>
102 <ul class="toc">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]103 <li><a href="#tag_index" class="toc_section_header">Tags</a></li>
104 <li>
105 <span class="toc_section_header"><a href="#section_colorCorrection">colorCorrection</a></span>
106 <ul class="toc_section">
107 <li>
108 <span class="toc_kind_header">controls</span>
109 <ul class="toc_section">
110 <li><a href="#controls_android.colorCorrection.mode">android.colorCorrection.mode</a></li>
111 <li><a href="#controls_android.colorCorrection.transform">android.colorCorrection.transform</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]112 <li><a href="#controls_android.colorCorrection.gains">android.colorCorrection.gains</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]113 </ul>
114 </li>
115 <li>
116 <span class="toc_kind_header">dynamic</span>
117 <ul class="toc_section">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]118 <li><a href="#dynamic_android.colorCorrection.transform">android.colorCorrection.transform</a></li>
119 <li><a href="#dynamic_android.colorCorrection.gains">android.colorCorrection.gains</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]120 </ul>
121 </li>
122 </ul> <!-- toc_section -->
123 </li>
124 <li>
125 <span class="toc_section_header"><a href="#section_control">control</a></span>
126 <ul class="toc_section">
127 <li>
128 <span class="toc_kind_header">controls</span>
129 <ul class="toc_section">
130 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a></li>
131 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a></li>
132 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a></li>
133 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a></li>
134 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a></li>
135 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a></li>
136 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a></li>
137 <li><a href="#controls_android.control.afMode">android.control.afMode</a></li>
138 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a></li>
139 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a></li>
140 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a></li>
141 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a></li>
142 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a></li>
143 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a></li>
144 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a></li>
145 <li><a href="#controls_android.control.mode">android.control.mode</a></li>
146 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a></li>
147 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a></li>
148 </ul>
149 </li>
150 <li>
151 <span class="toc_kind_header">static</span>
152 <ul class="toc_section">
153 <li><a href="#static_android.control.aeAvailableAntibandingModes">android.control.aeAvailableAntibandingModes</a></li>
154 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a></li>
155 <li><a href="#static_android.control.aeAvailableTargetFpsRanges">android.control.aeAvailableTargetFpsRanges</a></li>
156 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a></li>
157 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a></li>
158 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a></li>
159 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a></li>
160 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a></li>
161 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a></li>
162 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a></li>
163 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a></li>
164 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a></li>
165 </ul>
166 </li>
167 <li>
168 <span class="toc_kind_header">dynamic</span>
169 <ul class="toc_section">
170 <li><a href="#dynamic_android.control.aePrecaptureId">android.control.aePrecaptureId</a></li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]171 <li><a href="#dynamic_android.control.aeMode">android.control.aeMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]172 <li><a href="#dynamic_android.control.aeRegions">android.control.aeRegions</a></li>
173 <li><a href="#dynamic_android.control.aeState">android.control.aeState</a></li>
174 <li><a href="#dynamic_android.control.afMode">android.control.afMode</a></li>
175 <li><a href="#dynamic_android.control.afRegions">android.control.afRegions</a></li>
176 <li><a href="#dynamic_android.control.afState">android.control.afState</a></li>
177 <li><a href="#dynamic_android.control.afTriggerId">android.control.afTriggerId</a></li>
178 <li><a href="#dynamic_android.control.awbMode">android.control.awbMode</a></li>
179 <li><a href="#dynamic_android.control.awbRegions">android.control.awbRegions</a></li>
180 <li><a href="#dynamic_android.control.awbState">android.control.awbState</a></li>
181 <li><a href="#dynamic_android.control.mode">android.control.mode</a></li>
182 </ul>
183 </li>
184 </ul> <!-- toc_section -->
185 </li>
186 <li>
187 <span class="toc_section_header"><a href="#section_demosaic">demosaic</a></span>
188 <ul class="toc_section">
189 <li>
190 <span class="toc_kind_header">controls</span>
191 <ul class="toc_section">
192 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a></li>
193 </ul>
194 </li>
195 </ul> <!-- toc_section -->
196 </li>
197 <li>
198 <span class="toc_section_header"><a href="#section_edge">edge</a></span>
199 <ul class="toc_section">
200 <li>
201 <span class="toc_kind_header">controls</span>
202 <ul class="toc_section">
203 <li><a href="#controls_android.edge.mode">android.edge.mode</a></li>
204 <li><a href="#controls_android.edge.strength">android.edge.strength</a></li>
205 </ul>
206 </li>
207 <li>
208 <span class="toc_kind_header">dynamic</span>
209 <ul class="toc_section">
210 <li><a href="#dynamic_android.edge.mode">android.edge.mode</a></li>
211 </ul>
212 </li>
213 </ul> <!-- toc_section -->
214 </li>
215 <li>
216 <span class="toc_section_header"><a href="#section_flash">flash</a></span>
217 <ul class="toc_section">
218 <li>
219 <span class="toc_kind_header">controls</span>
220 <ul class="toc_section">
221 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a></li>
222 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a></li>
223 <li><a href="#controls_android.flash.mode">android.flash.mode</a></li>
224 </ul>
225 </li>
226 <li>
227 <span class="toc_kind_header">static</span>
228 <ul class="toc_section">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]229
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]230 <li><a href="#static_android.flash.info.available">android.flash.info.available</a></li>
231 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]232
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]233 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a></li>
234 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a></li>
235 </ul>
236 </li>
237 <li>
238 <span class="toc_kind_header">dynamic</span>
239 <ul class="toc_section">
240 <li><a href="#dynamic_android.flash.firingPower">android.flash.firingPower</a></li>
241 <li><a href="#dynamic_android.flash.firingTime">android.flash.firingTime</a></li>
242 <li><a href="#dynamic_android.flash.mode">android.flash.mode</a></li>
243 <li><a href="#dynamic_android.flash.state">android.flash.state</a></li>
244 </ul>
245 </li>
246 </ul> <!-- toc_section -->
247 </li>
248 <li>
249 <span class="toc_section_header"><a href="#section_geometric">geometric</a></span>
250 <ul class="toc_section">
251 <li>
252 <span class="toc_kind_header">controls</span>
253 <ul class="toc_section">
254 <li><a href="#controls_android.geometric.mode">android.geometric.mode</a></li>
255 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a></li>
256 </ul>
257 </li>
258 </ul> <!-- toc_section -->
259 </li>
260 <li>
261 <span class="toc_section_header"><a href="#section_hotPixel">hotPixel</a></span>
262 <ul class="toc_section">
263 <li>
264 <span class="toc_kind_header">controls</span>
265 <ul class="toc_section">
266 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a></li>
267 </ul>
268 </li>
269 <li>
270 <span class="toc_kind_header">static</span>
271 <ul class="toc_section">
272
273 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a></li>
274
275 </ul>
276 </li>
277 <li>
278 <span class="toc_kind_header">dynamic</span>
279 <ul class="toc_section">
280 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a></li>
281 </ul>
282 </li>
283 </ul> <!-- toc_section -->
284 </li>
285 <li>
286 <span class="toc_section_header"><a href="#section_jpeg">jpeg</a></span>
287 <ul class="toc_section">
288 <li>
289 <span class="toc_kind_header">controls</span>
290 <ul class="toc_section">
291 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
292 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
293 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
294 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a></li>
295 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a></li>
296 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
297 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
298 </ul>
299 </li>
300 <li>
301 <span class="toc_kind_header">static</span>
302 <ul class="toc_section">
303 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a></li>
304 <li><a href="#static_android.jpeg.maxSize">android.jpeg.maxSize</a></li>
305 </ul>
306 </li>
307 <li>
308 <span class="toc_kind_header">dynamic</span>
309 <ul class="toc_section">
310 <li><a href="#dynamic_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a></li>
311 <li><a href="#dynamic_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a></li>
312 <li><a href="#dynamic_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a></li>
313 <li><a href="#dynamic_android.jpeg.orientation">android.jpeg.orientation</a></li>
314 <li><a href="#dynamic_android.jpeg.quality">android.jpeg.quality</a></li>
315 <li><a href="#dynamic_android.jpeg.size">android.jpeg.size</a></li>
316 <li><a href="#dynamic_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a></li>
317 <li><a href="#dynamic_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a></li>
318 </ul>
319 </li>
320 </ul> <!-- toc_section -->
321 </li>
322 <li>
323 <span class="toc_section_header"><a href="#section_lens">lens</a></span>
324 <ul class="toc_section">
325 <li>
326 <span class="toc_kind_header">controls</span>
327 <ul class="toc_section">
328 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a></li>
329 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a></li>
330 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a></li>
331 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a></li>
332 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
333 </ul>
334 </li>
335 <li>
336 <span class="toc_kind_header">static</span>
337 <ul class="toc_section">
338
339 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a></li>
340 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a></li>
341 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a></li>
342 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a></li>
343 <li><a href="#static_android.lens.info.geometricCorrectionMap">android.lens.info.geometricCorrectionMap</a></li>
344 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a></li>
345 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a></li>
346 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]347 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a></li>
348
349 <li><a href="#static_android.lens.facing">android.lens.facing</a></li>
350 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a></li>
351 <li><a href="#static_android.lens.position">android.lens.position</a></li>
352 </ul>
353 </li>
354 <li>
355 <span class="toc_kind_header">dynamic</span>
356 <ul class="toc_section">
357 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a></li>
358 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a></li>
359 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a></li>
360 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a></li>
361 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a></li>
362 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a></li>
363 <li><a href="#dynamic_android.lens.state">android.lens.state</a></li>
364 </ul>
365 </li>
366 </ul> <!-- toc_section -->
367 </li>
368 <li>
369 <span class="toc_section_header"><a href="#section_noiseReduction">noiseReduction</a></span>
370 <ul class="toc_section">
371 <li>
372 <span class="toc_kind_header">controls</span>
373 <ul class="toc_section">
374 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
375 <li><a href="#controls_android.noiseReduction.strength">android.noiseReduction.strength</a></li>
376 </ul>
377 </li>
378 <li>
379 <span class="toc_kind_header">dynamic</span>
380 <ul class="toc_section">
381 <li><a href="#dynamic_android.noiseReduction.mode">android.noiseReduction.mode</a></li>
382 </ul>
383 </li>
384 </ul> <!-- toc_section -->
385 </li>
386 <li>
387 <span class="toc_section_header"><a href="#section_quirks">quirks</a></span>
388 <ul class="toc_section">
389 <li>
390 <span class="toc_kind_header">static</span>
391 <ul class="toc_section">
392 <li><a href="#static_android.quirks.meteringCropRegion">android.quirks.meteringCropRegion</a></li>
393 <li><a href="#static_android.quirks.triggerAfWithAuto">android.quirks.triggerAfWithAuto</a></li>
394 <li><a href="#static_android.quirks.useZslFormat">android.quirks.useZslFormat</a></li>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]395 <li><a href="#static_android.quirks.usePartialResult">android.quirks.usePartialResult</a></li>
396 </ul>
397 </li>
398 <li>
399 <span class="toc_kind_header">dynamic</span>
400 <ul class="toc_section">
401 <li><a href="#dynamic_android.quirks.partialResult">android.quirks.partialResult</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]402 </ul>
403 </li>
404 </ul> <!-- toc_section -->
405 </li>
406 <li>
407 <span class="toc_section_header"><a href="#section_request">request</a></span>
408 <ul class="toc_section">
409 <li>
410 <span class="toc_kind_header">controls</span>
411 <ul class="toc_section">
412 <li><a href="#controls_android.request.frameCount">android.request.frameCount</a></li>
413 <li><a href="#controls_android.request.id">android.request.id</a></li>
414 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a></li>
415 <li><a href="#controls_android.request.metadataMode">android.request.metadataMode</a></li>
416 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a></li>
417 <li><a href="#controls_android.request.type">android.request.type</a></li>
418 </ul>
419 </li>
420 <li>
421 <span class="toc_kind_header">static</span>
422 <ul class="toc_section">
423 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a></li>
424 <li><a href="#static_android.request.maxNumReprocessStreams">android.request.maxNumReprocessStreams</a></li>
425 </ul>
426 </li>
427 <li>
428 <span class="toc_kind_header">dynamic</span>
429 <ul class="toc_section">
430 <li><a href="#dynamic_android.request.frameCount">android.request.frameCount</a></li>
431 <li><a href="#dynamic_android.request.id">android.request.id</a></li>
432 <li><a href="#dynamic_android.request.metadataMode">android.request.metadataMode</a></li>
433 <li><a href="#dynamic_android.request.outputStreams">android.request.outputStreams</a></li>
434 </ul>
435 </li>
436 </ul> <!-- toc_section -->
437 </li>
438 <li>
439 <span class="toc_section_header"><a href="#section_scaler">scaler</a></span>
440 <ul class="toc_section">
441 <li>
442 <span class="toc_kind_header">controls</span>
443 <ul class="toc_section">
444 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
445 </ul>
446 </li>
447 <li>
448 <span class="toc_kind_header">static</span>
449 <ul class="toc_section">
450 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a></li>
451 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a></li>
452 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a></li>
453 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a></li>
454 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a></li>
455 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a></li>
456 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a></li>
457 <li><a href="#static_android.scaler.availableRawSizes">android.scaler.availableRawSizes</a></li>
458 </ul>
459 </li>
460 <li>
461 <span class="toc_kind_header">dynamic</span>
462 <ul class="toc_section">
463 <li><a href="#dynamic_android.scaler.cropRegion">android.scaler.cropRegion</a></li>
464 </ul>
465 </li>
466 </ul> <!-- toc_section -->
467 </li>
468 <li>
469 <span class="toc_section_header"><a href="#section_sensor">sensor</a></span>
470 <ul class="toc_section">
471 <li>
472 <span class="toc_kind_header">controls</span>
473 <ul class="toc_section">
474 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
475 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
476 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
477 </ul>
478 </li>
479 <li>
480 <span class="toc_kind_header">static</span>
481 <ul class="toc_section">
482
483 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]484 <li><a href="#static_android.sensor.info.sensitivityRange">android.sensor.info.sensitivityRange</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]485 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a></li>
486 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a></li>
487 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a></li>
488 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a></li>
489 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a></li>
490 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a></li>
491
492 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a></li>
493 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a></li>
494 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a></li>
495 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a></li>
496 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a></li>
497 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a></li>
498 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a></li>
499 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a></li>
500 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a></li>
501 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a></li>
502 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a></li>
503 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a></li>
504 <li><a href="#static_android.sensor.referenceIlluminant2">android.sensor.referenceIlluminant2</a></li>
505 </ul>
506 </li>
507 <li>
508 <span class="toc_kind_header">dynamic</span>
509 <ul class="toc_section">
510 <li><a href="#dynamic_android.sensor.exposureTime">android.sensor.exposureTime</a></li>
511 <li><a href="#dynamic_android.sensor.frameDuration">android.sensor.frameDuration</a></li>
512 <li><a href="#dynamic_android.sensor.sensitivity">android.sensor.sensitivity</a></li>
513 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a></li>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]514 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]515 </ul>
516 </li>
517 </ul> <!-- toc_section -->
518 </li>
519 <li>
520 <span class="toc_section_header"><a href="#section_shading">shading</a></span>
521 <ul class="toc_section">
522 <li>
523 <span class="toc_kind_header">controls</span>
524 <ul class="toc_section">
525 <li><a href="#controls_android.shading.mode">android.shading.mode</a></li>
526 <li><a href="#controls_android.shading.strength">android.shading.strength</a></li>
527 </ul>
528 </li>
529 <li>
530 <span class="toc_kind_header">dynamic</span>
531 <ul class="toc_section">
532 <li><a href="#dynamic_android.shading.mode">android.shading.mode</a></li>
533 </ul>
534 </li>
535 </ul> <!-- toc_section -->
536 </li>
537 <li>
538 <span class="toc_section_header"><a href="#section_statistics">statistics</a></span>
539 <ul class="toc_section">
540 <li>
541 <span class="toc_kind_header">controls</span>
542 <ul class="toc_section">
543 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
544 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
545 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]546 <li><a href="#controls_android.statistics.lensShadingMapMode">android.statistics.lensShadingMapMode</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]547 </ul>
548 </li>
549 <li>
550 <span class="toc_kind_header">static</span>
551 <ul class="toc_section">
552
553 <li><a href="#static_android.statistics.info.availableFaceDetectModes">android.statistics.info.availableFaceDetectModes</a></li>
554 <li><a href="#static_android.statistics.info.histogramBucketCount">android.statistics.info.histogramBucketCount</a></li>
555 <li><a href="#static_android.statistics.info.maxFaceCount">android.statistics.info.maxFaceCount</a></li>
556 <li><a href="#static_android.statistics.info.maxHistogramCount">android.statistics.info.maxHistogramCount</a></li>
557 <li><a href="#static_android.statistics.info.maxSharpnessMapValue">android.statistics.info.maxSharpnessMapValue</a></li>
558 <li><a href="#static_android.statistics.info.sharpnessMapSize">android.statistics.info.sharpnessMapSize</a></li>
559
560 </ul>
561 </li>
562 <li>
563 <span class="toc_kind_header">dynamic</span>
564 <ul class="toc_section">
565 <li><a href="#dynamic_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a></li>
566 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a></li>
567 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a></li>
568 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a></li>
569 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a></li>
570 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a></li>
571 <li><a href="#dynamic_android.statistics.histogramMode">android.statistics.histogramMode</a></li>
572 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a></li>
573 <li><a href="#dynamic_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a></li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]574 <li><a href="#dynamic_android.statistics.lensShadingMap">android.statistics.lensShadingMap</a></li>
575 <li><a href="#dynamic_android.statistics.predictedColorGains">android.statistics.predictedColorGains</a></li>
576 <li><a href="#dynamic_android.statistics.predictedColorTransform">android.statistics.predictedColorTransform</a></li>
577 <li><a href="#dynamic_android.statistics.sceneFlicker">android.statistics.sceneFlicker</a></li>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]578 </ul>
579 </li>
580 </ul> <!-- toc_section -->
581 </li>
582 <li>
583 <span class="toc_section_header"><a href="#section_tonemap">tonemap</a></span>
584 <ul class="toc_section">
585 <li>
586 <span class="toc_kind_header">controls</span>
587 <ul class="toc_section">
588 <li><a href="#controls_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
589 <li><a href="#controls_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
590 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
591 <li><a href="#controls_android.tonemap.mode">android.tonemap.mode</a></li>
592 </ul>
593 </li>
594 <li>
595 <span class="toc_kind_header">static</span>
596 <ul class="toc_section">
597 <li><a href="#static_android.tonemap.maxCurvePoints">android.tonemap.maxCurvePoints</a></li>
598 </ul>
599 </li>
600 <li>
601 <span class="toc_kind_header">dynamic</span>
602 <ul class="toc_section">
603 <li><a href="#dynamic_android.tonemap.curveBlue">android.tonemap.curveBlue</a></li>
604 <li><a href="#dynamic_android.tonemap.curveGreen">android.tonemap.curveGreen</a></li>
605 <li><a href="#dynamic_android.tonemap.curveRed">android.tonemap.curveRed</a></li>
606 <li><a href="#dynamic_android.tonemap.mode">android.tonemap.mode</a></li>
607 </ul>
608 </li>
609 </ul> <!-- toc_section -->
610 </li>
611 <li>
612 <span class="toc_section_header"><a href="#section_led">led</a></span>
613 <ul class="toc_section">
614 <li>
615 <span class="toc_kind_header">controls</span>
616 <ul class="toc_section">
617 <li><a href="#controls_android.led.transmit">android.led.transmit</a></li>
618 </ul>
619 </li>
620 <li>
621 <span class="toc_kind_header">dynamic</span>
622 <ul class="toc_section">
623 <li><a href="#dynamic_android.led.transmit">android.led.transmit</a></li>
624 </ul>
625 </li>
626 <li>
627 <span class="toc_kind_header">static</span>
628 <ul class="toc_section">
629 <li><a href="#static_android.led.availableLeds">android.led.availableLeds</a></li>
630 </ul>
631 </li>
632 </ul> <!-- toc_section -->
633 </li>
634 <li>
635 <span class="toc_section_header"><a href="#section_info">info</a></span>
636 <ul class="toc_section">
637 <li>
638 <span class="toc_kind_header">static</span>
639 <ul class="toc_section">
640 <li><a href="#static_android.info.supportedHardwareLevel">android.info.supportedHardwareLevel</a></li>
641 </ul>
642 </li>
643 </ul> <!-- toc_section -->
644 </li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]645 <li>
646 <span class="toc_section_header"><a href="#section_blackLevel">blackLevel</a></span>
647 <ul class="toc_section">
648 <li>
649 <span class="toc_kind_header">controls</span>
650 <ul class="toc_section">
651 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a></li>
652 </ul>
653 </li>
654 <li>
655 <span class="toc_kind_header">dynamic</span>
656 <ul class="toc_section">
657 <li><a href="#dynamic_android.blackLevel.lock">android.blackLevel.lock</a></li>
658 </ul>
659 </li>
660 </ul> <!-- toc_section -->
661 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]662 </ul>
663
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]664
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]665 <h1>Properties</h1>
666 <table class="properties">
667
668 <thead class="thead_dummy">
669 <tr>
670 <th class="th_name">Property Name</th>
671 <th class="th_type">Type</th>
672 <th class="th_description">Description</th>
673 <th class="th_units">Units</th>
674 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]675 <th class="th_tags">Tags</th>
676 </tr>
677 </thead> <!-- so that the first occurrence of thead is not
678 above the first occurrence of tr -->
679<!-- <namespace name="android"> -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]680 <tr><td colspan="6" id="section_colorCorrection" class="section">colorCorrection</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]681
682
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]683 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]684
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]685 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]686 <tr>
687 <th class="th_name">Property Name</th>
688 <th class="th_type">Type</th>
689 <th class="th_description">Description</th>
690 <th class="th_units">Units</th>
691 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]692 <th class="th_tags">Tags</th>
693 </tr>
694 </thead>
695
696 <tbody>
697
698
699
700
701
702
703
704
705
706
707 <tr class="entry" id="controls_android.colorCorrection.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]708 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]709 android.<wbr/>color<wbr/>Correction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]710 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]711 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]712 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]713
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]714 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]715
716 <ul class="entry_type_enum">
717 <li>
718 <span class="entry_type_enum_name">TRANSFORM_MATRIX</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]719 <span class="entry_type_enum_notes">Use the android.<wbr/>color<wbr/>Correction.<wbr/>transform matrix
720 and android.<wbr/>color<wbr/>Correction.<wbr/>gains to do color conversion</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]721 </li>
722 <li>
723 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]724 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
725 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]726 </li>
727 <li>
728 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]729 <span class="entry_type_enum_notes">Frame rate may be reduced by high
730 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]731 </li>
732 </ul>
733
734 </td> <!-- entry_type -->
735
736 <td class="entry_description">
737 </td>
738
739 <td class="entry_units">
740 </td>
741
742 <td class="entry_range">
743 </td>
744
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]745 <td class="entry_tags">
746 </td>
747
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]748 </tr>
749 <tr class="entries_header">
750 <th class="th_details" colspan="5">Details</th>
751 </tr>
752 <tr class="entry_cont">
753 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]754 <p>When <a href="#controls_android.control.awbMode">android.<wbr/>control.<wbr/>awb<wbr/>Mode</a> is not OFF,<wbr/> TRANSFORM_<wbr/>MATRIX
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]755should be ignored.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]756 </td>
757 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]758
759
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]760 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
761 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]762
763
764 <tr class="entry" id="controls_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]765 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]766 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]767 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]768 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]769 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]770 <span class="entry_type_container">x</span>
771
772 <span class="entry_type_array">
773 3 x 3
774 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]775 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]776 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]777
778
779 </td> <!-- entry_type -->
780
781 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]782 <p>A color transform matrix to use to transform
783from sensor RGB color space to output linear sRGB color space</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]784 </td>
785
786 <td class="entry_units">
787 </td>
788
789 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]790 <p>Output values are expected to be in the range
791(0,<wbr/>1)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]792 </td>
793
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]794 <td class="entry_tags">
795 </td>
796
797 </tr>
798 <tr class="entries_header">
799 <th class="th_details" colspan="5">Details</th>
800 </tr>
801 <tr class="entry_cont">
802 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]803 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]804<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]805directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]806<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]807<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]808for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]809reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]810 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]811 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]812
813
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]814 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
815 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]816
817
818 <tr class="entry" id="controls_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]819 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]820 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]821 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]822 <td class="entry_type">
823 <span class="entry_type_name">float</span>
824 <span class="entry_type_container">x</span>
825
826 <span class="entry_type_array">
827 4
828 </span>
829 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]830 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]831
832
833 </td> <!-- entry_type -->
834
835 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]836 <p>Gains applying to Bayer color channels for
837white-balance</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]838 </td>
839
840 <td class="entry_units">
841 </td>
842
843 <td class="entry_range">
844 </td>
845
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]846 <td class="entry_tags">
847 </td>
848
849 </tr>
850 <tr class="entries_header">
851 <th class="th_details" colspan="5">Details</th>
852 </tr>
853 <tr class="entry_cont">
854 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]855 <p>The 4-channel white-balance gains are defined in
856the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
857for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
858is the gain for greenpixels on the odd rows.<wbr/> if a HAL
859does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
860it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
861G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]862<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]863<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]864directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]865<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]866<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]867the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]868 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]869 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]870
871
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]872 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
873 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]874
875
876
877 <!-- end of kind -->
878 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]879 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]880
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]881 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]882 <tr>
883 <th class="th_name">Property Name</th>
884 <th class="th_type">Type</th>
885 <th class="th_description">Description</th>
886 <th class="th_units">Units</th>
887 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]888 <th class="th_tags">Tags</th>
889 </tr>
890 </thead>
891
892 <tbody>
893
894
895
896
897
898
899
900
901
902
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]903 <tr class="entry" id="dynamic_android.colorCorrection.transform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]904 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]905 android.<wbr/>color<wbr/>Correction.<wbr/>transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]906 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]907 <td class="entry_type">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]908 <span class="entry_type_name">rational</span>
909 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]910
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]911 <span class="entry_type_array">
912 3 x 3
913 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]914 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]915 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]916
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]917
918 </td> <!-- entry_type -->
919
920 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]921 <p>A color transform matrix to use to transform
922from sensor RGB color space to output linear sRGB color space</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]923 </td>
924
925 <td class="entry_units">
926 </td>
927
928 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]929 <p>Output values are expected to be in the range
930(0,<wbr/>1)</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]931 </td>
932
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]933 <td class="entry_tags">
934 </td>
935
936 </tr>
937 <tr class="entries_header">
938 <th class="th_details" colspan="5">Details</th>
939 </tr>
940 <tr class="entry_cont">
941 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]942 <p>This matrix is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]943<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]944directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]945<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]946<p>In the latter case,<wbr/> the HAL may round the matrix to account
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]947for precision issues; the final rounded matrix should be
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]948reported back in this matrix result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]949 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]950 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]951
952
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]953 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
954 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]955
956
957 <tr class="entry" id="dynamic_android.colorCorrection.gains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]958 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]959 android.<wbr/>color<wbr/>Correction.<wbr/>gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]960 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]961 <td class="entry_type">
962 <span class="entry_type_name">float</span>
963 <span class="entry_type_container">x</span>
964
965 <span class="entry_type_array">
966 4
967 </span>
968 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]969 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]970
971
972 </td> <!-- entry_type -->
973
974 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]975 <p>Gains applying to Bayer color channels for
976white-balance</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]977 </td>
978
979 <td class="entry_units">
980 </td>
981
982 <td class="entry_range">
983 </td>
984
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]985 <td class="entry_tags">
986 </td>
987
988 </tr>
989 <tr class="entries_header">
990 <th class="th_details" colspan="5">Details</th>
991 </tr>
992 <tr class="entry_cont">
993 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]994 <p>The 4-channel white-balance gains are defined in
995the order of [R G_<wbr/>even G_<wbr/>odd B],<wbr/> where G_<wbr/>even is the gain
996for green pixels on even rows of the output,<wbr/> and G_<wbr/>odd
997is the gain for greenpixels on the odd rows.<wbr/> if a HAL
998does not support a separate gain for even/<wbr/>odd green channels,<wbr/>
999it should use the G_<wbr/>even value,<wbr/>and write G_<wbr/>odd equal to
1000G_<wbr/>even in the output result metadata.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1001<p>This array is either set by HAL when the request
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1002<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is not TRANSFORM_<wbr/>MATRIX,<wbr/> or
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1003directly by the application in the request when the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1004<a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> is TRANSFORM_<wbr/>MATRIX.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1005<p>The ouput should be the gains actually applied by the HAL to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1006the current frame.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1007 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1008 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1009
1010
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1011 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1012 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1013
1014
1015
1016 <!-- end of kind -->
1017 </tbody>
1018
1019 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1020 <tr><td colspan="6" id="section_control" class="section">control</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1021
1022
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1023 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1024
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1025 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1026 <tr>
1027 <th class="th_name">Property Name</th>
1028 <th class="th_type">Type</th>
1029 <th class="th_description">Description</th>
1030 <th class="th_units">Units</th>
1031 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1032 <th class="th_tags">Tags</th>
1033 </tr>
1034 </thead>
1035
1036 <tbody>
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047 <tr class="entry" id="controls_android.control.aeAntibandingMode">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1048 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1049 android.<wbr/>control.<wbr/>ae<wbr/>Antibanding<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1050 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1051 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1052 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1053
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1054 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1055
1056 <ul class="entry_type_enum">
1057 <li>
1058 <span class="entry_type_enum_name">OFF</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1059 <span class="entry_type_enum_notes">
1060 The camera device will not adjust exposure duration to
1061 avoid banding problems.<wbr/>
1062 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1063 </li>
1064 <li>
1065 <span class="entry_type_enum_name">50HZ</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1066 <span class="entry_type_enum_notes">
1067 The camera device will adjust exposure duration to
1068 avoid banding problems with 50Hz illumination sources.<wbr/>
1069 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1070 </li>
1071 <li>
1072 <span class="entry_type_enum_name">60HZ</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1073 <span class="entry_type_enum_notes">
1074 The camera device will adjust exposure duration to
1075 avoid banding problems with 60Hz illumination
1076 sources.<wbr/>
1077 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1078 </li>
1079 <li>
1080 <span class="entry_type_enum_name">AUTO</span>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1081 <span class="entry_type_enum_notes">
1082 The camera device will automatically adapt its
1083 antibanding routine to the current illumination
1084 conditions.<wbr/> This is the default.<wbr/>
1085 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1086 </li>
1087 </ul>
1088
1089 </td> <!-- entry_type -->
1090
1091 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1092 <p>The desired setting for the camera device's auto-exposure
1093algorithm's antibanding compensation.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1094 </td>
1095
1096 <td class="entry_units">
1097 </td>
1098
1099 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1100 <p><a href="#static_android.control.aeAvailableAntibandingModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1101 </td>
1102
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1103 <td class="entry_tags">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1104 <ul class="entry_tags">
1105 <li><a href="#tag_BC">BC</a></li>
1106 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1107 </td>
1108
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1109 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1110 <tr class="entries_header">
1111 <th class="th_details" colspan="5">Details</th>
1112 </tr>
1113 <tr class="entry_cont">
1114 <td class="entry_details" colspan="5">
1115 <p>Some kinds of lighting fixtures,<wbr/> such as some fluorescent
1116lights,<wbr/> flicker at the rate of the power supply frequency
1117(60Hz or 50Hz,<wbr/> depending on country).<wbr/> While this is
1118typically not noticeable to a person,<wbr/> it can be visible to
1119a camera device.<wbr/> If a camera sets its exposure time to the
1120wrong value,<wbr/> the flicker may become visible in the
1121viewfinder as flicker or in a final captured image,<wbr/> as a
1122set of variable-brightness bands across the image.<wbr/></p>
1123<p>Therefore,<wbr/> the auto-exposure routines of camera devices
1124include antibanding routines that ensure that the chosen
1125exposure value will not cause such banding.<wbr/> The choice of
1126exposure time depends on the rate of flicker,<wbr/> which the
1127camera device can detect automatically,<wbr/> or the expected
1128rate can be selected by the application using this
1129control.<wbr/></p>
1130<p>A given camera device may not support all of the possible
1131options for the antibanding mode.<wbr/> The
1132<a href="#static_android.control.aeAvailableAntibandingModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes</a> key contains
1133the available modes for a given camera device.<wbr/></p>
1134<p>The default mode is AUTO,<wbr/> which must be supported by all
1135camera devices.<wbr/></p>
1136<p>If manual exposure control is enabled (by setting
1137<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> or <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> to OFF),<wbr/>
1138then this setting has no effect,<wbr/> and the application must
1139ensure it selects exposure times that do not cause banding
1140issues.<wbr/> The <a href="#dynamic_android.statistics.sceneFlicker">android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker</a> key can assist
1141the application in this.<wbr/></p>
1142 </td>
1143 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1144
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]1145 <tr class="entries_header">
1146 <th class="th_details" colspan="5">HAL Implementation Details</th>
1147 </tr>
1148 <tr class="entry_cont">
1149 <td class="entry_details" colspan="5">
1150 <p>For all capture request templates,<wbr/> this field must be set
1151to AUTO.<wbr/> AUTO is the only mode that must supported;
1152OFF,<wbr/> 50HZ,<wbr/> 60HZ are all optional.<wbr/></p>
1153<p>If manual exposure control is enabled (by setting
1154<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> or <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> to OFF),<wbr/>
1155then the exposure values provided by the application must not be
1156adjusted for antibanding.<wbr/></p>
1157 </td>
1158 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1160 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1161 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1162
1163
1164 <tr class="entry" id="controls_android.control.aeExposureCompensation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1165 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1166 android.<wbr/>control.<wbr/>ae<wbr/>Exposure<wbr/>Compensation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1167 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1168 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1169 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1170
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1171 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1172
1173
1174 </td> <!-- entry_type -->
1175
1176 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1177 <p>Adjustment to AE target image
1178brightness</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1179 </td>
1180
1181 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1182 count of positive/<wbr/>negative EV steps
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1183 </td>
1184
1185 <td class="entry_range">
1186 </td>
1187
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1188 <td class="entry_tags">
1189 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1190 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1191 </ul>
1192 </td>
1193
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1194 </tr>
1195 <tr class="entries_header">
1196 <th class="th_details" colspan="5">Details</th>
1197 </tr>
1198 <tr class="entry_cont">
1199 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1200 <p>For example,<wbr/> if EV step is 0.<wbr/>333,<wbr/> '6' will mean an
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1201exposure compensation of +2 EV; -3 will mean an exposure
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1202compensation of -1</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1203 </td>
1204 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1205
1206
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1207 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1208 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1209
1210
1211 <tr class="entry" id="controls_android.control.aeLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1212 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1213 android.<wbr/>control.<wbr/>ae<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1214 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1215 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1216 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1217
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1218 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1219
1220 <ul class="entry_type_enum">
1221 <li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1222 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1223 <span class="entry_type_enum_notes">Autoexposure lock is disabled; the AE algorithm
1224 is free to update its parameters.<wbr/></span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1225 </li>
1226 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1227 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1228 <span class="entry_type_enum_notes">Autoexposure lock is enabled; the AE algorithm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1229 must not update the exposure and sensitivity parameters
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1230 while the lock is active</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1231 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1232 </ul>
1233
1234 </td> <!-- entry_type -->
1235
1236 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1237 <p>Whether AE is currently locked to its latest
1238calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1239 </td>
1240
1241 <td class="entry_units">
1242 </td>
1243
1244 <td class="entry_range">
1245 </td>
1246
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1247 <td class="entry_tags">
1248 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1249 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1250 </ul>
1251 </td>
1252
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1253 </tr>
1254 <tr class="entries_header">
1255 <th class="th_details" colspan="5">Details</th>
1256 </tr>
1257 <tr class="entry_cont">
1258 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1259 <p>Note that even when AE is locked,<wbr/> the flash may be
1260fired if the AE mode is ON_<wbr/>AUTO_<wbr/>FLASH /<wbr/> ON_<wbr/>ALWAYS_<wbr/>FLASH /<wbr/>
1261ON_<wbr/>AUTO_<wbr/>FLASH_<wbr/>REDEYE.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1262 </td>
1263 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1264
1265
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1266 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1267 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1268
1269
1270 <tr class="entry" id="controls_android.control.aeMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1271 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1272 android.<wbr/>control.<wbr/>ae<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1273 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1274 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1275 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1276
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1277 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1278
1279 <ul class="entry_type_enum">
1280 <li>
1281 <span class="entry_type_enum_name">OFF</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1282 <span class="entry_type_enum_notes">
1283 The camera device's autoexposure routine is disabled;
1284 the application-selected android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
1285 android.<wbr/>sensor.<wbr/>sensitivity and
1286 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are used by the camera
1287 device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
1288 a flash unit for this camera device.<wbr/>
1289 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1290 </li>
1291 <li>
1292 <span class="entry_type_enum_name">ON</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1293 <span class="entry_type_enum_notes">
1294 The camera device's autoexposure routine is active,<wbr/>
1295 with no flash control.<wbr/> The application's values for
1296 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
1297 android.<wbr/>sensor.<wbr/>sensitivity,<wbr/> and
1298 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are ignored.<wbr/> The
1299 application has control over the various
1300 android.<wbr/>flash.<wbr/>* fields.<wbr/>
1301 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1302 </li>
1303 <li>
1304 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1305 <span class="entry_type_enum_notes">
1306 Like ON,<wbr/> except that the camera device also controls
1307 the camera's flash unit,<wbr/> firing it in low-light
1308 conditions.<wbr/> The flash may be fired during a
1309 precapture sequence (triggered by
1310 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and may be fired
1311 for captures for which the
1312 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
1313 STILL_<wbr/>CAPTURE
1314 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1315 </li>
1316 <li>
1317 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1318 <span class="entry_type_enum_notes">
1319 Like ON,<wbr/> except that the camera device also controls
1320 the camera's flash unit,<wbr/> always firing it for still
1321 captures.<wbr/> The flash may be fired during a precapture
1322 sequence (triggered by
1323 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and will always
1324 be fired for captures for which the
1325 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
1326 STILL_<wbr/>CAPTURE
1327 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1328 </li>
1329 <li>
1330 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1331 <span class="entry_type_enum_notes">
1332 Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
1333 reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
1334 a red eye reduction flash will fire during the
1335 precapture sequence.<wbr/>
1336 </span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1337 </li>
1338 </ul>
1339
1340 </td> <!-- entry_type -->
1341
1342 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1343 <p>The desired mode for the camera device's
1344auto-exposure routine.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1345 </td>
1346
1347 <td class="entry_units">
1348 </td>
1349
1350 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1351 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1352 </td>
1353
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1354 <td class="entry_tags">
1355 <ul class="entry_tags">
1356 <li><a href="#tag_BC">BC</a></li>
1357 </ul>
1358 </td>
1359
1360 </tr>
1361 <tr class="entries_header">
1362 <th class="th_details" colspan="5">Details</th>
1363 </tr>
1364 <tr class="entry_cont">
1365 <td class="entry_details" colspan="5">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]1366 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
1367AUTO.<wbr/></p>
1368<p>When set to any of the ON modes,<wbr/> the camera device's
1369auto-exposure routine is enabled,<wbr/> overriding the
1370application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
1371and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
1372<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
1373<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
1374is selected,<wbr/> the camera device's flash unit controls are
1375also overridden.<wbr/></p>
1376<p>The FLASH modes are only available if the camera device
1377has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
1378<p>If flash TORCH mode is desired,<wbr/> this field must be set to
1379ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
1380<p>When set to any of the ON modes,<wbr/> the values chosen by the
1381camera device auto-exposure routine for the overridden
1382fields for a given capture will be available in its
1383CaptureResult.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1384 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1385 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1386
1387
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1388 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1389 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1390
1391
1392 <tr class="entry" id="controls_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1393 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1394 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1395 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1396 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1397 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1398 <span class="entry_type_container">x</span>
1399
1400 <span class="entry_type_array">
1401 5 x area_count
1402 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1403 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1404
1405
1406 </td> <!-- entry_type -->
1407
1408 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1409 <p>List of areas to use for
1410metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1411 </td>
1412
1413 <td class="entry_units">
1414 </td>
1415
1416 <td class="entry_range">
1417 </td>
1418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1419 <td class="entry_tags">
1420 <ul class="entry_tags">
1421 <li><a href="#tag_BC">BC</a></li>
1422 </ul>
1423 </td>
1424
1425 </tr>
1426 <tr class="entries_header">
1427 <th class="th_details" colspan="5">Details</th>
1428 </tr>
1429 <tr class="entry_cont">
1430 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1431 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1432xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1433specified coordinates.<wbr/></p>
1434<p>The coordinate system is based on the active pixel array,<wbr/>
1435with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1436(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1437<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1438bottom-right pixel in the active pixel array.<wbr/> The weight
1439should be nonnegative.<wbr/></p>
1440<p>If all regions have 0 weight,<wbr/> then no specific metering area
1441needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1442outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1443should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1444used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1445 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1446 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1447
1448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1449 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1450 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1451
1452
1453 <tr class="entry" id="controls_android.control.aeTargetFpsRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1454 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1455 android.<wbr/>control.<wbr/>ae<wbr/>Target<wbr/>Fps<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1456 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1457 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1458 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1459 <span class="entry_type_container">x</span>
1460
1461 <span class="entry_type_array">
1462 2
1463 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1464 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1465
1466
1467 </td> <!-- entry_type -->
1468
1469 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1470 <p>Range over which fps can be adjusted to
1471maintain exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1472 </td>
1473
1474 <td class="entry_units">
1475 </td>
1476
1477 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1478 <p><a href="#static_android.control.aeAvailableTargetFpsRanges">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1479 </td>
1480
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1481 <td class="entry_tags">
1482 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1483 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1484 </ul>
1485 </td>
1486
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1487 </tr>
1488 <tr class="entries_header">
1489 <th class="th_details" colspan="5">Details</th>
1490 </tr>
1491 <tr class="entry_cont">
1492 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1493 <p>Only constrains AE algorithm,<wbr/> not manual control
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1494of <a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1495 </td>
1496 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1497
1498
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1499 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1500 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1501
1502
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1503 <tr class="entry" id="controls_android.control.aePrecaptureTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1504 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1505 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1506 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1507 <td class="entry_type">
1508 <span class="entry_type_name entry_type_name_enum">byte</span>
1509
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1510 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1511
1512 <ul class="entry_type_enum">
1513 <li>
1514 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1515 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1516 </li>
1517 <li>
1518 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1519 <span class="entry_type_enum_notes">The precapture metering sequence
1520 must be started.<wbr/> The exact effect of the precapture
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1521 trigger depends on the current AE mode and
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1522 state.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1523 </li>
1524 </ul>
1525
1526 </td> <!-- entry_type -->
1527
1528 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1529 <p>Whether the HAL must trigger precapture
1530metering.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1531 </td>
1532
1533 <td class="entry_units">
1534 </td>
1535
1536 <td class="entry_range">
1537 </td>
1538
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1539 <td class="entry_tags">
1540 <ul class="entry_tags">
1541 <li><a href="#tag_BC">BC</a></li>
1542 </ul>
1543 </td>
1544
1545 </tr>
1546 <tr class="entries_header">
1547 <th class="th_details" colspan="5">Details</th>
1548 </tr>
1549 <tr class="entry_cont">
1550 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1551 <p>This entry is normally set to IDLE,<wbr/> or is not
1552included at all in the request settings.<wbr/> When included and
1553set to START,<wbr/> the HAL must trigger the autoexposure
1554precapture metering sequence.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1555<p>The effect of AE precapture trigger depends on the current
1556AE mode and state; see the camera HAL device v3 header for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1557details.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1558 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1559 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1560
1561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1562 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1563 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1564
1565
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1566 <tr class="entry" id="controls_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1567 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1568 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1569 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1570 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1571 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1572
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1573 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1574
1575 <ul class="entry_type_enum">
1576 <li>
1577 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1578 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
1579 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
1580 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1581 </li>
1582 <li>
1583 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1584 <span class="entry_type_enum_notes">
1585 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1586
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1587 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
1588 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
1589 the autofocus trigger action is called.<wbr/> When that trigger
1590 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
1591 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1592
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1593 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
1594 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1595 </li>
1596 <li>
1597 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1598 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
1599 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1600
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1601 When that trigger is activated,<wbr/> AF must transition to
1602 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
1603 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
1604 position to default,<wbr/> and sets the AF state to
1605 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1606 </li>
1607 <li>
1608 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1609 <span class="entry_type_enum_notes">In this mode,<wbr/> the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1610 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1611 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1612
1613 The focusing behavior should be suitable for good quality
1614 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1615 movement and no overshoots.<wbr/> When the AF trigger is not
1616 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
1617 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
1618 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1619 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1620 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1621 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1622
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1623 Once cancel is received,<wbr/> the algorithm should transition
1624 back to INACTIVE and resume passive scan.<wbr/> Note that this
1625 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
1626 ongoing PASSIVE_<wbr/>SCAN must immediately be
1627 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1628 </li>
1629 <li>
1630 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1631 <span class="entry_type_enum_notes">In this mode,<wbr/> the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1632 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1633 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1634
1635 The focusing behavior should be suitable for still image
1636 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1637 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
1638 algorithm should start in INACTIVE state,<wbr/> and then
1639 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
1640 appropriate as it attempts to maintain focus.<wbr/> When the AF
1641 trigger is activated,<wbr/> the algorithm should finish its
1642 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
1643 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
1644 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1645
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1646 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1647 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1648 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1649 </li>
1650 <li>
1651 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1652 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
1653 trigger is ignored,<wbr/> AF state should always be
1654 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1655 </li>
1656 </ul>
1657
1658 </td> <!-- entry_type -->
1659
1660 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1661 <p>Whether AF is currently enabled,<wbr/> and what
1662mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1663 </td>
1664
1665 <td class="entry_units">
1666 </td>
1667
1668 <td class="entry_range">
1669 </td>
1670
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1671 <td class="entry_tags">
1672 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1673 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1674 </ul>
1675 </td>
1676
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1677 </tr>
1678 <tr class="entries_header">
1679 <th class="th_details" colspan="5">Details</th>
1680 </tr>
1681 <tr class="entry_cont">
1682 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1683 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1684<p>If lens is controlled by HAL auto-focus algorithm,<wbr/> the HAL should
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1685report the current AF status in <a href="#dynamic_android.control.afState">android.<wbr/>control.<wbr/>af<wbr/>State</a> in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1686result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1687 </td>
1688 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1689
1690
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1691 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1692 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1693
1694
1695 <tr class="entry" id="controls_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1696 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1697 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1698 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1699 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1700 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1701 <span class="entry_type_container">x</span>
1702
1703 <span class="entry_type_array">
1704 5 x area_count
1705 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1706 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1707
1708
1709 </td> <!-- entry_type -->
1710
1711 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1712 <p>List of areas to use for focus
1713estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1714 </td>
1715
1716 <td class="entry_units">
1717 </td>
1718
1719 <td class="entry_range">
1720 </td>
1721
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1722 <td class="entry_tags">
1723 <ul class="entry_tags">
1724 <li><a href="#tag_BC">BC</a></li>
1725 </ul>
1726 </td>
1727
1728 </tr>
1729 <tr class="entries_header">
1730 <th class="th_details" colspan="5">Details</th>
1731 </tr>
1732 <tr class="entry_cont">
1733 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1734 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1735xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1736specified coordinates.<wbr/></p>
1737<p>The coordinate system is based on the active pixel array,<wbr/>
1738with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1739(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
1740<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1741bottom-right pixel in the active pixel array.<wbr/> The weight
1742should be nonnegative.<wbr/></p>
1743<p>If all regions have 0 weight,<wbr/> then no specific focus area
1744needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1745outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1746should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1747used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1748 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1749 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1750
1751
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1752 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1753 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1754
1755
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1756 <tr class="entry" id="controls_android.control.afTrigger">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1757 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1758 android.<wbr/>control.<wbr/>af<wbr/>Trigger
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1759 </td>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1760 <td class="entry_type">
1761 <span class="entry_type_name entry_type_name_enum">byte</span>
1762
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1763 <span class="entry_type_visibility"> [public]</span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1764
1765 <ul class="entry_type_enum">
1766 <li>
1767 <span class="entry_type_enum_name">IDLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1768 <span class="entry_type_enum_notes">The trigger is idle.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1769 </li>
1770 <li>
1771 <span class="entry_type_enum_name">START</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1772 <span class="entry_type_enum_notes">Autofocus must trigger now.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1773 </li>
1774 <li>
1775 <span class="entry_type_enum_name">CANCEL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1776 <span class="entry_type_enum_notes">Autofocus must return to initial
1777 state,<wbr/> and cancel any active trigger.<wbr/></span>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1778 </li>
1779 </ul>
1780
1781 </td> <!-- entry_type -->
1782
1783 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1784 <p>Whether the HAL must trigger autofocus.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1785 </td>
1786
1787 <td class="entry_units">
1788 </td>
1789
1790 <td class="entry_range">
1791 </td>
1792
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1793 <td class="entry_tags">
1794 <ul class="entry_tags">
1795 <li><a href="#tag_BC">BC</a></li>
1796 </ul>
1797 </td>
1798
1799 </tr>
1800 <tr class="entries_header">
1801 <th class="th_details" colspan="5">Details</th>
1802 </tr>
1803 <tr class="entry_cont">
1804 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1805 <p>This entry is normally set to IDLE,<wbr/> or is not
1806included at all in the request settings.<wbr/></p>
1807<p>When included and set to START,<wbr/> the HAL must trigger the
1808autofocus algorithm.<wbr/> The effect of AF trigger depends on the
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]1809current AF mode and state; see the camera HAL device v3
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1810header for details.<wbr/> When set to CANCEL,<wbr/> the HAL must cancel
1811any active trigger,<wbr/> and return to initial AF state.<wbr/></p>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1812 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1813 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1814
1815
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1816 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1817 <!-- end of entry -->
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]1818
1819
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1820 <tr class="entry" id="controls_android.control.awbLock">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1821 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1822 android.<wbr/>control.<wbr/>awb<wbr/>Lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1823 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1824 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1825 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1826
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]1827 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1828
1829 <ul class="entry_type_enum">
1830 <li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1831 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1832 <span class="entry_type_enum_notes">Auto-whitebalance lock is disabled; the AWB
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1833 algorithm is free to update its parameters if in AUTO
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1834 mode.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1835 </li>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1836 <li>
1837 <span class="entry_type_enum_name">ON</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1838 <span class="entry_type_enum_notes">Auto-whitebalance lock is enabled; the AWB
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1839 algorithm must not update the exposure and sensitivity
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1840 parameters while the lock is active</span>
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]1841 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1842 </ul>
1843
1844 </td> <!-- entry_type -->
1845
1846 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1847 <p>Whether AWB is currently locked to its
1848latest calculated values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1849 </td>
1850
1851 <td class="entry_units">
1852 </td>
1853
1854 <td class="entry_range">
1855 </td>
1856
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1857 <td class="entry_tags">
1858 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1859 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1860 </ul>
1861 </td>
1862
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1863 </tr>
1864 <tr class="entries_header">
1865 <th class="th_details" colspan="5">Details</th>
1866 </tr>
1867 <tr class="entry_cont">
1868 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1869 <p>Note that AWB lock is only meaningful for AUTO
1870mode; in other modes,<wbr/> AWB is already fixed to a specific
1871setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1872 </td>
1873 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1874
1875
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1876 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1877 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1878
1879
1880 <tr class="entry" id="controls_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1881 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1882 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1883 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1884 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1885 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1886
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1887 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1888
1889 <ul class="entry_type_enum">
1890 <li>
1891 <span class="entry_type_enum_name">OFF</span>
1892 </li>
1893 <li>
1894 <span class="entry_type_enum_name">AUTO</span>
1895 </li>
1896 <li>
1897 <span class="entry_type_enum_name">INCANDESCENT</span>
1898 </li>
1899 <li>
1900 <span class="entry_type_enum_name">FLUORESCENT</span>
1901 </li>
1902 <li>
1903 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
1904 </li>
1905 <li>
1906 <span class="entry_type_enum_name">DAYLIGHT</span>
1907 </li>
1908 <li>
1909 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
1910 </li>
1911 <li>
1912 <span class="entry_type_enum_name">TWILIGHT</span>
1913 </li>
1914 <li>
1915 <span class="entry_type_enum_name">SHADE</span>
1916 </li>
1917 </ul>
1918
1919 </td> <!-- entry_type -->
1920
1921 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1922 <p>Whether AWB is currently setting the color
1923transform fields,<wbr/> and what its illumination target
1924is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1925 </td>
1926
1927 <td class="entry_units">
1928 </td>
1929
1930 <td class="entry_range">
1931 </td>
1932
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1933 <td class="entry_tags">
1934 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]1935 <li><a href="#tag_BC">BC</a></li>
1936 <li><a href="#tag_AWB">AWB</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1937 </ul>
1938 </td>
1939
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1940 </tr>
1941 <tr class="entries_header">
1942 <th class="th_details" colspan="5">Details</th>
1943 </tr>
1944 <tr class="entry_cont">
1945 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1946 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]1947<p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1948 </td>
1949 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1950
1951
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1952 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
1953 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1954
1955
1956 <tr class="entry" id="controls_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1957 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1958 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]1959 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1960 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]1961 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1962 <span class="entry_type_container">x</span>
1963
1964 <span class="entry_type_array">
1965 5 x area_count
1966 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]1967 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1968
1969
1970 </td> <!-- entry_type -->
1971
1972 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1973 <p>List of areas to use for illuminant
1974estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]1975 </td>
1976
1977 <td class="entry_units">
1978 </td>
1979
1980 <td class="entry_range">
1981 </td>
1982
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]1983 <td class="entry_tags">
1984 <ul class="entry_tags">
1985 <li><a href="#tag_BC">BC</a></li>
1986 </ul>
1987 </td>
1988
1989 </tr>
1990 <tr class="entries_header">
1991 <th class="th_details" colspan="5">Details</th>
1992 </tr>
1993 <tr class="entry_cont">
1994 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]1995 <p>Only used in AUTO mode.<wbr/></p>
1996<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
1997xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
1998specified coordinates.<wbr/></p>
1999<p>The coordinate system is based on the active pixel array,<wbr/>
2000with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2001(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
2002<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2003bottom-right pixel in the active pixel array.<wbr/> The weight
2004should be nonnegative.<wbr/></p>
2005<p>If all regions have 0 weight,<wbr/> then no specific metering area
2006needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2007outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]2008should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2009used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2010 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2011 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2012
2013
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2014 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2015 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2016
2017
2018 <tr class="entry" id="controls_android.control.captureIntent">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2019 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2020 android.<wbr/>control.<wbr/>capture<wbr/>Intent
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2021 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2022 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2023 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2024
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2025 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2026
2027 <ul class="entry_type_enum">
2028 <li>
2029 <span class="entry_type_enum_name">CUSTOM</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2030 <span class="entry_type_enum_notes">This request doesn't fall into the other
2031 categories.<wbr/> Default to preview-like
2032 behavior.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2033 </li>
2034 <li>
2035 <span class="entry_type_enum_name">PREVIEW</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2036 <span class="entry_type_enum_notes">This request is for a preview-like usecase.<wbr/> The
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2037 precapture trigger may be used to start off a metering
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2038 w/<wbr/>flash sequence</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2039 </li>
2040 <li>
2041 <span class="entry_type_enum_name">STILL_CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2042 <span class="entry_type_enum_notes">This request is for a still capture-type
2043 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2044 </li>
2045 <li>
2046 <span class="entry_type_enum_name">VIDEO_RECORD</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2047 <span class="entry_type_enum_notes">This request is for a video recording
2048 usecase.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2049 </li>
2050 <li>
2051 <span class="entry_type_enum_name">VIDEO_SNAPSHOT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2052 <span class="entry_type_enum_notes">This request is for a video snapshot (still
2053 image while recording video) usecase</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2054 </li>
2055 <li>
2056 <span class="entry_type_enum_name">ZERO_SHUTTER_LAG</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2057 <span class="entry_type_enum_notes">This request is for a ZSL usecase; the
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2058 application will stream full-resolution images and
2059 reprocess one or several later for a final
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2060 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2061 </li>
2062 </ul>
2063
2064 </td> <!-- entry_type -->
2065
2066 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2067 <p>Information to 3A routines about the purpose
2068of this capture,<wbr/> to help decide optimal 3A
2069strategy</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2070 </td>
2071
2072 <td class="entry_units">
2073 </td>
2074
2075 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2076 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2077 </td>
2078
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2079 <td class="entry_tags">
2080 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2081 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2082 </ul>
2083 </td>
2084
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2085 </tr>
2086 <tr class="entries_header">
2087 <th class="th_details" colspan="5">Details</th>
2088 </tr>
2089 <tr class="entry_cont">
2090 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2091 <p>Only used if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2092 </td>
2093 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2094
2095
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2096 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2097 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2098
2099
2100 <tr class="entry" id="controls_android.control.effectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2101 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2102 android.<wbr/>control.<wbr/>effect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2103 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2104 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2105 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2106
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2107 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2108
2109 <ul class="entry_type_enum">
2110 <li>
2111 <span class="entry_type_enum_name">OFF</span>
2112 </li>
2113 <li>
2114 <span class="entry_type_enum_name">MONO</span>
2115 <span class="entry_type_enum_optional">optional</span>
2116 </li>
2117 <li>
2118 <span class="entry_type_enum_name">NEGATIVE</span>
2119 <span class="entry_type_enum_optional">optional</span>
2120 </li>
2121 <li>
2122 <span class="entry_type_enum_name">SOLARIZE</span>
2123 <span class="entry_type_enum_optional">optional</span>
2124 </li>
2125 <li>
2126 <span class="entry_type_enum_name">SEPIA</span>
2127 <span class="entry_type_enum_optional">optional</span>
2128 </li>
2129 <li>
2130 <span class="entry_type_enum_name">POSTERIZE</span>
2131 <span class="entry_type_enum_optional">optional</span>
2132 </li>
2133 <li>
2134 <span class="entry_type_enum_name">WHITEBOARD</span>
2135 <span class="entry_type_enum_optional">optional</span>
2136 </li>
2137 <li>
2138 <span class="entry_type_enum_name">BLACKBOARD</span>
2139 <span class="entry_type_enum_optional">optional</span>
2140 </li>
2141 <li>
2142 <span class="entry_type_enum_name">AQUA</span>
2143 <span class="entry_type_enum_optional">optional</span>
2144 </li>
2145 </ul>
2146
2147 </td> <!-- entry_type -->
2148
2149 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2150 <p>Whether any special color effect is in use.<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2151Only used if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> != OFF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2152 </td>
2153
2154 <td class="entry_units">
2155 </td>
2156
2157 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2158 <p><a href="#static_android.control.availableEffects">android.<wbr/>control.<wbr/>available<wbr/>Effects</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2159 </td>
2160
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2161 <td class="entry_tags">
2162 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2163 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2164 </ul>
2165 </td>
2166
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2167 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2168
2169
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2170 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2171 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2172
2173
2174 <tr class="entry" id="controls_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2175 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2176 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2177 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2178 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2179 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2180
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2181 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2182
2183 <ul class="entry_type_enum">
2184 <li>
2185 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2186 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
2187 routines are disabled,<wbr/> no other settings in
2188 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2189 </li>
2190 <li>
2191 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2192 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
2193 Manual control of capture parameters is disabled.<wbr/> All
2194 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
2195 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2196 </li>
2197 <li>
2198 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2199 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
2200 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2201 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2202 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
2203 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2204 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2205 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2206 </li>
2207 </ul>
2208
2209 </td> <!-- entry_type -->
2210
2211 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2212 <p>Overall mode of 3A control
2213routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2214 </td>
2215
2216 <td class="entry_units">
2217 </td>
2218
2219 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2220 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2221 </td>
2222
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2223 <td class="entry_tags">
2224 <ul class="entry_tags">
2225 <li><a href="#tag_BC">BC</a></li>
2226 </ul>
2227 </td>
2228
2229 </tr>
2230 <tr class="entries_header">
2231 <th class="th_details" colspan="5">Details</th>
2232 </tr>
2233 <tr class="entry_cont">
2234 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2235 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
2236by the HAL is disabled.<wbr/> The application must set the fields for
2237capture parameters itself.<wbr/></p>
2238<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2239android.<wbr/>control.<wbr/>* are in effect,<wbr/> such as <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2240<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
2241android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
2242one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
2243as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2244<a href="#static_android.control.sceneModeOverrides">android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2245 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2246 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2247
2248
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2249 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2250 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2251
2252
2253 <tr class="entry" id="controls_android.control.sceneMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2254 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2255 android.<wbr/>control.<wbr/>scene<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2256 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2257 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2258 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2259
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2260 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2261
2262 <ul class="entry_type_enum">
2263 <li>
2264 <span class="entry_type_enum_name">UNSUPPORTED</span>
2265 <span class="entry_type_enum_value">0</span>
2266 </li>
2267 <li>
2268 <span class="entry_type_enum_name">FACE_PRIORITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2269 <span class="entry_type_enum_notes">if face detection support exists Use face
2270 detection data to drive 3A routines.<wbr/> If face detection
2271 statistics are disabled,<wbr/> should still operate correctly
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2272 (but not return face detection statistics to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2273 framework).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2274
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2275 Unlike the other scene modes,<wbr/> aeMode,<wbr/> awbMode,<wbr/> and afMode
2276 remain active when FACE_<wbr/>PRIORITY is set.<wbr/> This is due to
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2277 compatibility concerns with the old camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2278 API</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2279 </li>
2280 <li>
2281 <span class="entry_type_enum_name">ACTION</span>
2282 <span class="entry_type_enum_optional">optional</span>
2283 </li>
2284 <li>
2285 <span class="entry_type_enum_name">PORTRAIT</span>
2286 <span class="entry_type_enum_optional">optional</span>
2287 </li>
2288 <li>
2289 <span class="entry_type_enum_name">LANDSCAPE</span>
2290 <span class="entry_type_enum_optional">optional</span>
2291 </li>
2292 <li>
2293 <span class="entry_type_enum_name">NIGHT</span>
2294 <span class="entry_type_enum_optional">optional</span>
2295 </li>
2296 <li>
2297 <span class="entry_type_enum_name">NIGHT_PORTRAIT</span>
2298 <span class="entry_type_enum_optional">optional</span>
2299 </li>
2300 <li>
2301 <span class="entry_type_enum_name">THEATRE</span>
2302 <span class="entry_type_enum_optional">optional</span>
2303 </li>
2304 <li>
2305 <span class="entry_type_enum_name">BEACH</span>
2306 <span class="entry_type_enum_optional">optional</span>
2307 </li>
2308 <li>
2309 <span class="entry_type_enum_name">SNOW</span>
2310 <span class="entry_type_enum_optional">optional</span>
2311 </li>
2312 <li>
2313 <span class="entry_type_enum_name">SUNSET</span>
2314 <span class="entry_type_enum_optional">optional</span>
2315 </li>
2316 <li>
2317 <span class="entry_type_enum_name">STEADYPHOTO</span>
2318 <span class="entry_type_enum_optional">optional</span>
2319 </li>
2320 <li>
2321 <span class="entry_type_enum_name">FIREWORKS</span>
2322 <span class="entry_type_enum_optional">optional</span>
2323 </li>
2324 <li>
2325 <span class="entry_type_enum_name">SPORTS</span>
2326 <span class="entry_type_enum_optional">optional</span>
2327 </li>
2328 <li>
2329 <span class="entry_type_enum_name">PARTY</span>
2330 <span class="entry_type_enum_optional">optional</span>
2331 </li>
2332 <li>
2333 <span class="entry_type_enum_name">CANDLELIGHT</span>
2334 <span class="entry_type_enum_optional">optional</span>
2335 </li>
2336 <li>
2337 <span class="entry_type_enum_name">BARCODE</span>
2338 <span class="entry_type_enum_optional">optional</span>
2339 </li>
2340 </ul>
2341
2342 </td> <!-- entry_type -->
2343
2344 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2345 <p>Which scene mode is active when
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2346<a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = SCENE_<wbr/>MODE</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2347 </td>
2348
2349 <td class="entry_units">
2350 </td>
2351
2352 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2353 <p><a href="#static_android.control.availableSceneModes">android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2354 </td>
2355
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2356 <td class="entry_tags">
2357 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2358 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2359 </ul>
2360 </td>
2361
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2362 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2363
2364
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2365 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2366 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2367
2368
2369 <tr class="entry" id="controls_android.control.videoStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2370 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2371 android.<wbr/>control.<wbr/>video<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2372 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2373 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2374 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2375
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]2376 <span class="entry_type_visibility"> [public as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2377
2378 <ul class="entry_type_enum">
2379 <li>
2380 <span class="entry_type_enum_name">OFF</span>
2381 </li>
2382 <li>
2383 <span class="entry_type_enum_name">ON</span>
2384 </li>
2385 </ul>
2386
2387 </td> <!-- entry_type -->
2388
2389 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2390 <p>Whether video stabilization is
2391active</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2392 </td>
2393
2394 <td class="entry_units">
2395 </td>
2396
2397 <td class="entry_range">
2398 </td>
2399
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2400 <td class="entry_tags">
2401 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2402 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2403 </ul>
2404 </td>
2405
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2406 </tr>
2407 <tr class="entries_header">
2408 <th class="th_details" colspan="5">Details</th>
2409 </tr>
2410 <tr class="entry_cont">
2411 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2412 <p>If enabled,<wbr/> video stabilization can modify the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2413<a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a> to keep the video stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2414stabilized</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2415 </td>
2416 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2417
2418
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2419 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2420 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2421
2422
2423
2424 <!-- end of kind -->
2425 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2426 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2427
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2428 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2429 <tr>
2430 <th class="th_name">Property Name</th>
2431 <th class="th_type">Type</th>
2432 <th class="th_description">Description</th>
2433 <th class="th_units">Units</th>
2434 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2435 <th class="th_tags">Tags</th>
2436 </tr>
2437 </thead>
2438
2439 <tbody>
2440
2441
2442
2443
2444
2445
2446
2447
2448
2449
2450 <tr class="entry" id="static_android.control.aeAvailableAntibandingModes">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2451 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2452 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Antibanding<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2453 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2454 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2455 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2456 <span class="entry_type_container">x</span>
2457
2458 <span class="entry_type_array">
2459 n
2460 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2461 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2462 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2463
2464
2465 </td> <!-- entry_type -->
2466
2467 <td class="entry_description">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2468 <p>The set of auto-exposure antibanding modes that are
2469supported by this camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2470 </td>
2471
2472 <td class="entry_units">
2473 </td>
2474
2475 <td class="entry_range">
2476 </td>
2477
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2478 <td class="entry_tags">
2479 </td>
2480
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2481 </tr>
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]2482 <tr class="entries_header">
2483 <th class="th_details" colspan="5">Details</th>
2484 </tr>
2485 <tr class="entry_cont">
2486 <td class="entry_details" colspan="5">
2487 <p>Not all of the auto-exposure anti-banding modes may be
2488supported by a given camera device.<wbr/> This field lists the
2489valid anti-banding modes that the application may request
2490for this camera device; they must include AUTO.<wbr/></p>
2491 </td>
2492 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2493
2494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2495 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2496 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2497
2498
2499 <tr class="entry" id="static_android.control.aeAvailableModes">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2500 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2501 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2502 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2503 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2504 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2505 <span class="entry_type_container">x</span>
2506
2507 <span class="entry_type_array">
2508 n
2509 </span>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2510 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2511 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2512
2513
2514 </td> <!-- entry_type -->
2515
2516 <td class="entry_description">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2517 <p>The set of auto-exposure modes that are supported by this
2518camera device.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2519 </td>
2520
2521 <td class="entry_units">
2522 </td>
2523
2524 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2525 </td>
2526
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2527 <td class="entry_tags">
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2528 <ul class="entry_tags">
2529 <li><a href="#tag_BC">BC</a></li>
2530 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2531 </td>
2532
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2533 </tr>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]2534 <tr class="entries_header">
2535 <th class="th_details" colspan="5">Details</th>
2536 </tr>
2537 <tr class="entry_cont">
2538 <td class="entry_details" colspan="5">
2539 <p>Not all the auto-exposure modes may be supported by a
2540given camera device,<wbr/> especially if no flash unit is
2541available.<wbr/> This entry lists the valid modes for
2542<a href="#controls_android.control.aeMode">android.<wbr/>control.<wbr/>ae<wbr/>Mode</a> for this camera device.<wbr/></p>
2543<p>All camera devices support ON,<wbr/> and all camera devices with
2544flash units support ON_<wbr/>AUTO_<wbr/>FLASH and
2545ON_<wbr/>ALWAYS_<wbr/>FLASH.<wbr/></p>
2546<p>Full-capability camera devices always support OFF mode,<wbr/>
2547which enables application control of camera exposure time,<wbr/>
2548sensitivity,<wbr/> and frame duration.<wbr/></p>
2549 </td>
2550 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2551
2552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2553 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2554 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2555
2556
2557 <tr class="entry" id="static_android.control.aeAvailableTargetFpsRanges">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2558 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2559 android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Target<wbr/>Fps<wbr/>Ranges
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2560 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2561 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2562 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2563 <span class="entry_type_container">x</span>
2564
2565 <span class="entry_type_array">
2566 2 x n
2567 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2568 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2569 <div class="entry_type_notes">list of pairs of frame rates</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2570
2571
2572 </td> <!-- entry_type -->
2573
2574 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2575 <p>List of frame rate ranges supported by the
2576AE algorithm/<wbr/>hardware</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2577 </td>
2578
2579 <td class="entry_units">
2580 </td>
2581
2582 <td class="entry_range">
2583 </td>
2584
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2585 <td class="entry_tags">
2586 </td>
2587
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2588 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2589
2590
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2591 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2592 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2593
2594
2595 <tr class="entry" id="static_android.control.aeCompensationRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2596 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2597 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2598 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2599 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2600 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2601 <span class="entry_type_container">x</span>
2602
2603 <span class="entry_type_array">
2604 2
2605 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2606 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2607
2608
2609 </td> <!-- entry_type -->
2610
2611 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2612 <p>Maximum and minimum exposure compensation
2613setting,<wbr/> in counts of
2614android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step<wbr/>Size</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2615 </td>
2616
2617 <td class="entry_units">
2618 </td>
2619
2620 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2621 <p>At least (-2,<wbr/>2)/<wbr/>(exp compensation step
2622size)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2623 </td>
2624
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2625 <td class="entry_tags">
2626 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2627 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2628 </ul>
2629 </td>
2630
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2631 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2632
2633
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2634 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2635 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2636
2637
2638 <tr class="entry" id="static_android.control.aeCompensationStep">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2639 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2640 android.<wbr/>control.<wbr/>ae<wbr/>Compensation<wbr/>Step
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2641 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2642 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2643 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2644
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2645 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2646
2647
2648 </td> <!-- entry_type -->
2649
2650 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2651 <p>Smallest step by which exposure compensation
2652can be changed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2653 </td>
2654
2655 <td class="entry_units">
2656 </td>
2657
2658 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2659 <p>&lt;= 1/<wbr/>2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2660 </td>
2661
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2662 <td class="entry_tags">
2663 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2664 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2665 </ul>
2666 </td>
2667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2668 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2669
2670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2671 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2672 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2673
2674
2675 <tr class="entry" id="static_android.control.afAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2676 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2677 android.<wbr/>control.<wbr/>af<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2678 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2679 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2680 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2681 <span class="entry_type_container">x</span>
2682
2683 <span class="entry_type_array">
2684 n
2685 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2686 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2687 <div class="entry_type_notes">List of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2688
2689
2690 </td> <!-- entry_type -->
2691
2692 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2693 <p>List of AF modes that can be
2694selected</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2695 </td>
2696
2697 <td class="entry_units">
2698 </td>
2699
2700 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2701 <p>OFF must be included.<wbr/> AUTO must be supported if
2702lens allows for changing focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2703 </td>
2704
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2705 <td class="entry_tags">
2706 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2707 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2708 </ul>
2709 </td>
2710
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2711 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2712
2713
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2714 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2715 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2716
2717
2718 <tr class="entry" id="static_android.control.availableEffects">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2719 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2720 android.<wbr/>control.<wbr/>available<wbr/>Effects
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2721 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2722 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2723 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2724 <span class="entry_type_container">x</span>
2725
2726 <span class="entry_type_array">
2727 n
2728 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2729 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2730 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2731
2732
2733 </td> <!-- entry_type -->
2734
2735 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2736 <p>what subset of the full color effect enum
2737list is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2738 </td>
2739
2740 <td class="entry_units">
2741 </td>
2742
2743 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2744 <p>OFF must be listed</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2745 </td>
2746
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2747 <td class="entry_tags">
2748 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2749 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2750 </ul>
2751 </td>
2752
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2753 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2754
2755
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2756 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2757 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2758
2759
2760 <tr class="entry" id="static_android.control.availableSceneModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2761 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2762 android.<wbr/>control.<wbr/>available<wbr/>Scene<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2763 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2764 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2765 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2766 <span class="entry_type_container">x</span>
2767
2768 <span class="entry_type_array">
2769 n
2770 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2771 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2772 <div class="entry_type_notes">list of enums from android.<wbr/>control.<wbr/>scene<wbr/>Mode,<wbr/> plus UNSUPPORTED to indicate no scene modes are supported</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2773
2774
2775 </td> <!-- entry_type -->
2776
2777 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2778 <p>what subset of the scene mode enum list is
2779supported.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2780 </td>
2781
2782 <td class="entry_units">
2783 </td>
2784
2785 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2786 <p>SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY must be supported if face
2787detection is supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2788 </td>
2789
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2790 <td class="entry_tags">
2791 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2792 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2793 </ul>
2794 </td>
2795
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2796 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2797
2798
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2799 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2800 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2801
2802
2803 <tr class="entry" id="static_android.control.availableVideoStabilizationModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2804 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2805 android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2806 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2807 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2808 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2809 <span class="entry_type_container">x</span>
2810
2811 <span class="entry_type_array">
2812 n
2813 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2814 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2815 <div class="entry_type_notes">List of enums.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2816
2817
2818 </td> <!-- entry_type -->
2819
2820 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2821 <p>List of video stabilization modes that can
2822be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2823 </td>
2824
2825 <td class="entry_units">
2826 </td>
2827
2828 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2829 <p>OFF must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2830 </td>
2831
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2832 <td class="entry_tags">
2833 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2834 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2835 </ul>
2836 </td>
2837
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2838 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2839
2840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2841 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2842 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2843
2844
2845 <tr class="entry" id="static_android.control.awbAvailableModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2846 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2847 android.<wbr/>control.<wbr/>awb<wbr/>Available<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2848 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2849 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2850 <span class="entry_type_name">byte</span>
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2851 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2852
Alex Raya4251d92013-04-30 16:43:44 -0700[diff] [blame]2853 <span class="entry_type_array">
2854 n
2855 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2856 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2857 <div class="entry_type_notes">List of enums (android.<wbr/>control.<wbr/>awb<wbr/>Mode)</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2858
2859
2860 </td> <!-- entry_type -->
2861
2862 <td class="entry_description">
2863 </td>
2864
2865 <td class="entry_units">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2866 </td>
2867
2868 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2869 <p>OFF,<wbr/> AUTO must be included</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2870 </td>
2871
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2872 <td class="entry_tags">
2873 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2874 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2875 </ul>
2876 </td>
2877
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2878 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2879
2880
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2881 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2882 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2883
2884
2885 <tr class="entry" id="static_android.control.maxRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2886 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2887 android.<wbr/>control.<wbr/>max<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2888 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2889 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2890 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2891
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2892 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2893
2894
2895 </td> <!-- entry_type -->
2896
2897 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2898 <p>For AE,<wbr/> AWB,<wbr/> and AF,<wbr/> how many individual
2899regions can be listed for metering?</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2900 </td>
2901
2902 <td class="entry_units">
2903 </td>
2904
2905 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]2906 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2907 </td>
2908
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2909 <td class="entry_tags">
2910 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]2911 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2912 </ul>
2913 </td>
2914
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2915 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2916
2917
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2918 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2919 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2920
2921
2922 <tr class="entry" id="static_android.control.sceneModeOverrides">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2923 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2924 android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2925 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2926 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]2927 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2928 <span class="entry_type_container">x</span>
2929
2930 <span class="entry_type_array">
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2931 3 x length(availableSceneModes)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2932 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2933 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2934
2935
2936 </td> <!-- entry_type -->
2937
2938 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2939 <p>List of AE,<wbr/> AWB,<wbr/> and AF modes to use for
2940each available scene mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2941 </td>
2942
2943 <td class="entry_units">
2944 </td>
2945
2946 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2947 <p>For each listed scene mode,<wbr/> lists the aeMode,<wbr/>
2948awbMode,<wbr/> and afMode that the HAL wants to use for that
2949scene mode.<wbr/></p>
2950<p>For each entry,<wbr/> the order is {aeMode,<wbr/> awbMode,<wbr/> afMode} in
2951order of increasing index</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2952 </td>
2953
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2954 <td class="entry_tags">
2955 <ul class="entry_tags">
2956 <li><a href="#tag_BC">BC</a></li>
2957 </ul>
2958 </td>
2959
2960 </tr>
2961 <tr class="entries_header">
2962 <th class="th_details" colspan="5">Details</th>
2963 </tr>
2964 <tr class="entry_cont">
2965 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2966 <p>When a scene mode is enabled,<wbr/> the HAL is expected
2967to override aeMode,<wbr/> awbMode,<wbr/> and afMode with its
2968preferred settings for that scene mode.<wbr/></p>
2969<p>To simplify communication with old camera API applications,<wbr/>
2970the service wants this override list in the static metadata.<wbr/>
2971The order of this list matches that of availableSceneModes,<wbr/>
2972with 3 entires for each scene mode.<wbr/> The overrides listed
2973for SCENE_<wbr/>MODE_<wbr/>FACE_<wbr/>PRIORITY are ignored,<wbr/> since for that
2974mode,<wbr/> the application-set aeMode,<wbr/> awbMode,<wbr/> and afMode are
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]2975used instead,<wbr/> like they are when <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]2976AUTO.<wbr/></p>
2977<p>It is recommended that for FACE_<wbr/>PRIORITY,<wbr/> the overrides
2978should be set to 0.<wbr/> As an example,<wbr/> if availableSceneModes is
2979{ FACE_<wbr/>PRIORITY,<wbr/> ACTION,<wbr/> NIGHT },<wbr/> then the service expects
2980this field to have 9 entries; for example { 0 ,<wbr/> 0,<wbr/> 0,<wbr/>
2981ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> AUTO,<wbr/> CONTINUOUS_<wbr/>PICTURE,<wbr/> ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/>
2982INCANDESCENT,<wbr/> AUTO }</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2983 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2984 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]2985
2986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2987 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
2988 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2989
2990
2991
2992 <!-- end of kind -->
2993 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]2994 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2995
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]2996 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]2997 <tr>
2998 <th class="th_name">Property Name</th>
2999 <th class="th_type">Type</th>
3000 <th class="th_description">Description</th>
3001 <th class="th_units">Units</th>
3002 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3003 <th class="th_tags">Tags</th>
3004 </tr>
3005 </thead>
3006
3007 <tbody>
3008
3009
3010
3011
3012
3013
3014
3015
3016
3017
3018 <tr class="entry" id="dynamic_android.control.aePrecaptureId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3019 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3020 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3021 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3022 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3023 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3024
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3025 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3026
3027
3028 </td> <!-- entry_type -->
3029
3030 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3031 <p>The ID sent with the latest
3032CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3033 </td>
3034
3035 <td class="entry_units">
3036 </td>
3037
3038 <td class="entry_range">
3039 </td>
3040
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3041 <td class="entry_tags">
3042 </td>
3043
3044 </tr>
3045 <tr class="entries_header">
3046 <th class="th_details" colspan="5">Details</th>
3047 </tr>
3048 <tr class="entry_cont">
3049 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3050 <p>Must be 0 if no
3051CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING trigger received yet
3052by HAL.<wbr/> Always updated even if AE algorithm ignores the
3053trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3054 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3055 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3056
3057
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3058 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3059 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3060
3061
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]3062 <tr class="entry" id="dynamic_android.control.aeMode">
3063 <td class="entry_name" rowspan="3">
3064 android.<wbr/>control.<wbr/>ae<wbr/>Mode
3065 </td>
3066 <td class="entry_type">
3067 <span class="entry_type_name entry_type_name_enum">byte</span>
3068
3069 <span class="entry_type_visibility"> [public]</span>
3070
3071 <ul class="entry_type_enum">
3072 <li>
3073 <span class="entry_type_enum_name">OFF</span>
3074 <span class="entry_type_enum_notes">
3075 The camera device's autoexposure routine is disabled;
3076 the application-selected android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
3077 android.<wbr/>sensor.<wbr/>sensitivity and
3078 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are used by the camera
3079 device,<wbr/> along with android.<wbr/>flash.<wbr/>* fields,<wbr/> if there's
3080 a flash unit for this camera device.<wbr/>
3081 </span>
3082 </li>
3083 <li>
3084 <span class="entry_type_enum_name">ON</span>
3085 <span class="entry_type_enum_notes">
3086 The camera device's autoexposure routine is active,<wbr/>
3087 with no flash control.<wbr/> The application's values for
3088 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time,<wbr/>
3089 android.<wbr/>sensor.<wbr/>sensitivity,<wbr/> and
3090 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration are ignored.<wbr/> The
3091 application has control over the various
3092 android.<wbr/>flash.<wbr/>* fields.<wbr/>
3093 </span>
3094 </li>
3095 <li>
3096 <span class="entry_type_enum_name">ON_AUTO_FLASH</span>
3097 <span class="entry_type_enum_notes">
3098 Like ON,<wbr/> except that the camera device also controls
3099 the camera's flash unit,<wbr/> firing it in low-light
3100 conditions.<wbr/> The flash may be fired during a
3101 precapture sequence (triggered by
3102 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and may be fired
3103 for captures for which the
3104 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
3105 STILL_<wbr/>CAPTURE
3106 </span>
3107 </li>
3108 <li>
3109 <span class="entry_type_enum_name">ON_ALWAYS_FLASH</span>
3110 <span class="entry_type_enum_notes">
3111 Like ON,<wbr/> except that the camera device also controls
3112 the camera's flash unit,<wbr/> always firing it for still
3113 captures.<wbr/> The flash may be fired during a precapture
3114 sequence (triggered by
3115 android.<wbr/>control.<wbr/>ae<wbr/>Precapture<wbr/>Trigger) and will always
3116 be fired for captures for which the
3117 android.<wbr/>control.<wbr/>capture<wbr/>Intent field is set to
3118 STILL_<wbr/>CAPTURE
3119 </span>
3120 </li>
3121 <li>
3122 <span class="entry_type_enum_name">ON_AUTO_FLASH_REDEYE</span>
3123 <span class="entry_type_enum_notes">
3124 Like ON_<wbr/>AUTO_<wbr/>FLASH,<wbr/> but with automatic red eye
3125 reduction.<wbr/> If deemed necessary by the camera device,<wbr/>
3126 a red eye reduction flash will fire during the
3127 precapture sequence.<wbr/>
3128 </span>
3129 </li>
3130 </ul>
3131
3132 </td> <!-- entry_type -->
3133
3134 <td class="entry_description">
3135 <p>The desired mode for the camera device's
3136auto-exposure routine.<wbr/></p>
3137 </td>
3138
3139 <td class="entry_units">
3140 </td>
3141
3142 <td class="entry_range">
3143 <p><a href="#static_android.control.aeAvailableModes">android.<wbr/>control.<wbr/>ae<wbr/>Available<wbr/>Modes</a></p>
3144 </td>
3145
3146 <td class="entry_tags">
3147 <ul class="entry_tags">
3148 <li><a href="#tag_BC">BC</a></li>
3149 </ul>
3150 </td>
3151
3152 </tr>
3153 <tr class="entries_header">
3154 <th class="th_details" colspan="5">Details</th>
3155 </tr>
3156 <tr class="entry_cont">
3157 <td class="entry_details" colspan="5">
3158 <p>This control is only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> is
3159AUTO.<wbr/></p>
3160<p>When set to any of the ON modes,<wbr/> the camera device's
3161auto-exposure routine is enabled,<wbr/> overriding the
3162application's selected exposure time,<wbr/> sensor sensitivity,<wbr/>
3163and frame duration (<a href="#controls_android.sensor.exposureTime">android.<wbr/>sensor.<wbr/>exposure<wbr/>Time</a>,<wbr/>
3164<a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a>,<wbr/> and
3165<a href="#controls_android.sensor.frameDuration">android.<wbr/>sensor.<wbr/>frame<wbr/>Duration</a>).<wbr/> If one of the FLASH modes
3166is selected,<wbr/> the camera device's flash unit controls are
3167also overridden.<wbr/></p>
3168<p>The FLASH modes are only available if the camera device
3169has a flash unit (<a href="#static_android.flash.info.available">android.<wbr/>flash.<wbr/>info.<wbr/>available</a> is <code>true</code>).<wbr/></p>
3170<p>If flash TORCH mode is desired,<wbr/> this field must be set to
3171ON or OFF,<wbr/> and <a href="#controls_android.flash.mode">android.<wbr/>flash.<wbr/>mode</a> set to TORCH.<wbr/></p>
3172<p>When set to any of the ON modes,<wbr/> the values chosen by the
3173camera device auto-exposure routine for the overridden
3174fields for a given capture will be available in its
3175CaptureResult.<wbr/></p>
3176 </td>
3177 </tr>
3178
3179
3180 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3181 <!-- end of entry -->
3182
3183
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3184 <tr class="entry" id="dynamic_android.control.aeRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3185 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3186 android.<wbr/>control.<wbr/>ae<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3187 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3188 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3189 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3190 <span class="entry_type_container">x</span>
3191
3192 <span class="entry_type_array">
3193 5 x area_count
3194 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3195 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3196
3197
3198 </td> <!-- entry_type -->
3199
3200 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3201 <p>List of areas to use for
3202metering</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3203 </td>
3204
3205 <td class="entry_units">
3206 </td>
3207
3208 <td class="entry_range">
3209 </td>
3210
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3211 <td class="entry_tags">
3212 <ul class="entry_tags">
3213 <li><a href="#tag_BC">BC</a></li>
3214 </ul>
3215 </td>
3216
3217 </tr>
3218 <tr class="entries_header">
3219 <th class="th_details" colspan="5">Details</th>
3220 </tr>
3221 <tr class="entry_cont">
3222 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3223 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3224xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3225specified coordinates.<wbr/></p>
3226<p>The coordinate system is based on the active pixel array,<wbr/>
3227with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3228(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3229<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3230bottom-right pixel in the active pixel array.<wbr/> The weight
3231should be nonnegative.<wbr/></p>
3232<p>If all regions have 0 weight,<wbr/> then no specific metering area
3233needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3234outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]3235should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3236used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3237 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3238 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3239
3240
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3241 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3242 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3243
3244
3245 <tr class="entry" id="dynamic_android.control.aeState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3246 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3247 android.<wbr/>control.<wbr/>ae<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3248 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3249 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3250 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3251
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3252 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3253
3254 <ul class="entry_type_enum">
3255 <li>
3256 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3257 <span class="entry_type_enum_notes">AE is off.<wbr/> When a camera device is opened,<wbr/> it starts in
3258 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3259 </li>
3260 <li>
3261 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3262 <span class="entry_type_enum_notes">AE doesn't yet have a good set of control values
3263 for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3264 </li>
3265 <li>
3266 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3267 <span class="entry_type_enum_notes">AE has a good set of control values for the
3268 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3269 </li>
3270 <li>
3271 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3272 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3273 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3274 </li>
3275 <li>
3276 <span class="entry_type_enum_name">FLASH_REQUIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3277 <span class="entry_type_enum_notes">AE has a good set of control values,<wbr/> but flash
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3278 needs to be fired for good quality still
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3279 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3280 </li>
3281 <li>
3282 <span class="entry_type_enum_name">PRECAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3283 <span class="entry_type_enum_notes">AE has been asked to do a precapture sequence
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3284 (through the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3285 trigger_<wbr/>action(CAMERA2_<wbr/>TRIGGER_<wbr/>PRECAPTURE_<wbr/>METERING)
3286 call),<wbr/> and is currently executing it.<wbr/> Once PRECAPTURE
3287 completes,<wbr/> AE will transition to CONVERGED or
3288 FLASH_<wbr/>REQUIRED as appropriate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3289 </li>
3290 </ul>
3291
3292 </td> <!-- entry_type -->
3293
3294 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3295 <p>Current state of AE algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3296 </td>
3297
3298 <td class="entry_units">
3299 </td>
3300
3301 <td class="entry_range">
3302 </td>
3303
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3304 <td class="entry_tags">
3305 </td>
3306
3307 </tr>
3308 <tr class="entries_header">
3309 <th class="th_details" colspan="5">Details</th>
3310 </tr>
3311 <tr class="entry_cont">
3312 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3313 <p>Whenever the AE algorithm state changes,<wbr/> a
3314MSG_<wbr/>AUTOEXPOSURE notification must be send if a
3315notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3316 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3317 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3318
3319
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3320 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3321 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3322
3323
3324 <tr class="entry" id="dynamic_android.control.afMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3325 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3326 android.<wbr/>control.<wbr/>af<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3327 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3328 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3329 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3330
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3331 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3332
3333 <ul class="entry_type_enum">
3334 <li>
3335 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3336 <span class="entry_type_enum_notes">The auto-focus routine does not control the lens;
3337 android.<wbr/>lens.<wbr/>focus<wbr/>Distance is controlled by the
3338 application</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3339 </li>
3340 <li>
3341 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3342 <span class="entry_type_enum_notes">
3343 If lens is not fixed focus.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3344
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3345 Use android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance to determine if lens
3346 is fixed-focus.<wbr/> In this mode,<wbr/> the lens does not move unless
3347 the autofocus trigger action is called.<wbr/> When that trigger
3348 is activated,<wbr/> AF must transition to ACTIVE_<wbr/>SCAN,<wbr/> then to
3349 the outcome of the scan (FOCUSED or NOT_<wbr/>FOCUSED).<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3350
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3351 Triggering AF_<wbr/>CANCEL resets the lens position to default,<wbr/>
3352 and sets the AF state to INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3353 </li>
3354 <li>
3355 <span class="entry_type_enum_name">MACRO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3356 <span class="entry_type_enum_notes">In this mode,<wbr/> the lens does not move unless the
3357 autofocus trigger action is called.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3358
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3359 When that trigger is activated,<wbr/> AF must transition to
3360 ACTIVE_<wbr/>SCAN,<wbr/> then to the outcome of the scan (FOCUSED or
3361 NOT_<wbr/>FOCUSED).<wbr/> Triggering cancel AF resets the lens
3362 position to default,<wbr/> and sets the AF state to
3363 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3364 </li>
3365 <li>
3366 <span class="entry_type_enum_name">CONTINUOUS_VIDEO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3367 <span class="entry_type_enum_notes">In this mode,<wbr/> the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3368 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3369 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3370
3371 The focusing behavior should be suitable for good quality
3372 video recording; typically this means slower focus
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3373 movement and no overshoots.<wbr/> When the AF trigger is not
3374 involved,<wbr/> the AF algorithm should start in INACTIVE state,<wbr/>
3375 and then transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED
3376 states as appropriate.<wbr/> When the AF trigger is activated,<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3377 the algorithm should immediately transition into
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3378 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3379 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3380
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3381 Once cancel is received,<wbr/> the algorithm should transition
3382 back to INACTIVE and resume passive scan.<wbr/> Note that this
3383 behavior is not identical to CONTINUOUS_<wbr/>PICTURE,<wbr/> since an
3384 ongoing PASSIVE_<wbr/>SCAN must immediately be
3385 canceled.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3386 </li>
3387 <li>
3388 <span class="entry_type_enum_name">CONTINUOUS_PICTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3389 <span class="entry_type_enum_notes">In this mode,<wbr/> the AF algorithm modifies the lens
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3390 position continually to attempt to provide a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3391 constantly-in-focus image stream.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3392
3393 The focusing behavior should be suitable for still image
3394 capture; typically this means focusing as fast as
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3395 possible.<wbr/> When the AF trigger is not involved,<wbr/> the AF
3396 algorithm should start in INACTIVE state,<wbr/> and then
3397 transition into PASSIVE_<wbr/>SCAN and PASSIVE_<wbr/>FOCUSED states as
3398 appropriate as it attempts to maintain focus.<wbr/> When the AF
3399 trigger is activated,<wbr/> the algorithm should finish its
3400 PASSIVE_<wbr/>SCAN if active,<wbr/> and then transition into
3401 AF_<wbr/>FOCUSED or AF_<wbr/>NOT_<wbr/>FOCUSED as appropriate,<wbr/> and lock the
3402 lens position until a cancel AF trigger is received.<wbr/>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3403
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3404 When the AF cancel trigger is activated,<wbr/> the algorithm
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3405 should transition back to INACTIVE and then act as if it
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3406 has just been started.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3407 </li>
3408 <li>
3409 <span class="entry_type_enum_name">EDOF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3410 <span class="entry_type_enum_notes">Extended depth of field (digital focus).<wbr/> AF
3411 trigger is ignored,<wbr/> AF state should always be
3412 INACTIVE.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3413 </li>
3414 </ul>
3415
3416 </td> <!-- entry_type -->
3417
3418 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3419 <p>Whether AF is currently enabled,<wbr/> and what
3420mode it is set to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3421 </td>
3422
3423 <td class="entry_units">
3424 </td>
3425
3426 <td class="entry_range">
3427 </td>
3428
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3429 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3430 <ul class="entry_tags">
3431 <li><a href="#tag_BC">BC</a></li>
3432 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3433 </td>
3434
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3435 </tr>
3436 <tr class="entries_header">
3437 <th class="th_details" colspan="5">Details</th>
3438 </tr>
3439 <tr class="entry_cont">
3440 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3441 <p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3442<p>If lens is controlled by HAL auto-focus algorithm,<wbr/> the HAL should
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3443report the current AF status in <a href="#dynamic_android.control.afState">android.<wbr/>control.<wbr/>af<wbr/>State</a> in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3444result metadata.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3445 </td>
3446 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3447
3448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3449 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3450 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3451
3452
3453 <tr class="entry" id="dynamic_android.control.afRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3454 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3455 android.<wbr/>control.<wbr/>af<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3456 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3457 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3458 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3459 <span class="entry_type_container">x</span>
3460
3461 <span class="entry_type_array">
3462 5 x area_count
3463 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3464 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3465
3466
3467 </td> <!-- entry_type -->
3468
3469 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3470 <p>List of areas to use for focus
3471estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3472 </td>
3473
3474 <td class="entry_units">
3475 </td>
3476
3477 <td class="entry_range">
3478 </td>
3479
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3480 <td class="entry_tags">
3481 <ul class="entry_tags">
3482 <li><a href="#tag_BC">BC</a></li>
3483 </ul>
3484 </td>
3485
3486 </tr>
3487 <tr class="entries_header">
3488 <th class="th_details" colspan="5">Details</th>
3489 </tr>
3490 <tr class="entry_cont">
3491 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3492 <p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3493xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3494specified coordinates.<wbr/></p>
3495<p>The coordinate system is based on the active pixel array,<wbr/>
3496with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3497(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3498<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3499bottom-right pixel in the active pixel array.<wbr/> The weight
3500should be nonnegative.<wbr/></p>
3501<p>If all regions have 0 weight,<wbr/> then no specific focus area
3502needs to be used by the HAL.<wbr/> If the focusing region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3503outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]3504should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3505used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3506 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3507 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3508
3509
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3510 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3511 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3512
3513
3514 <tr class="entry" id="dynamic_android.control.afState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3515 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3516 android.<wbr/>control.<wbr/>af<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3517 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3518 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3519 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3520
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3521 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3522
3523 <ul class="entry_type_enum">
3524 <li>
3525 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3526 <span class="entry_type_enum_notes">AF off or has not yet tried to scan/<wbr/>been asked
3527 to scan.<wbr/> When a camera device is opened,<wbr/> it starts in
3528 this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3529 </li>
3530 <li>
3531 <span class="entry_type_enum_name">PASSIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3532 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF is
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3533 currently doing an AF scan initiated by a continuous
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3534 autofocus mode</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3535 </li>
3536 <li>
3537 <span class="entry_type_enum_name">PASSIVE_FOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3538 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF currently
3539 believes it is in focus,<wbr/> but may restart scanning at
3540 any time.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3541 </li>
3542 <li>
3543 <span class="entry_type_enum_name">ACTIVE_SCAN</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3544 <span class="entry_type_enum_notes">if AUTO or MACRO modes are supported.<wbr/> AF is doing
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3545 an AF scan because it was triggered by AF
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3546 trigger</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3547 </li>
3548 <li>
3549 <span class="entry_type_enum_name">FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3550 <span class="entry_type_enum_notes">if any AF mode besides OFF is supported.<wbr/> AF
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3551 believes it is focused correctly and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3552 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3553 </li>
3554 <li>
3555 <span class="entry_type_enum_name">NOT_FOCUSED_LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3556 <span class="entry_type_enum_notes">if any AF mode besides OFF is supported.<wbr/> AF has
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3557 failed to focus successfully and is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3558 locked</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3559 </li>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3560 <li>
3561 <span class="entry_type_enum_name">PASSIVE_UNFOCUSED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3562 <span class="entry_type_enum_notes">if CONTINUOUS_<wbr/>* modes are supported.<wbr/> AF finished a
3563 passive scan without finding focus,<wbr/> and may restart
3564 scanning at any time.<wbr/></span>
Eino-Ville Talvala492ba7c2013-09-20 17:24:00 -0700[diff] [blame]3565 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3566 </ul>
3567
3568 </td> <!-- entry_type -->
3569
3570 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3571 <p>Current state of AF algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3572 </td>
3573
3574 <td class="entry_units">
3575 </td>
3576
3577 <td class="entry_range">
3578 </td>
3579
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3580 <td class="entry_tags">
3581 </td>
3582
3583 </tr>
3584 <tr class="entries_header">
3585 <th class="th_details" colspan="5">Details</th>
3586 </tr>
3587 <tr class="entry_cont">
3588 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3589 <p>Whenever the AF algorithm state changes,<wbr/> a
3590MSG_<wbr/>AUTOFOCUS notification must be send if a notification
3591callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3592 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3593 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3594
3595
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3596 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3597 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3598
3599
3600 <tr class="entry" id="dynamic_android.control.afTriggerId">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3601 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3602 android.<wbr/>control.<wbr/>af<wbr/>Trigger<wbr/>Id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3603 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3604 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3605 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3606
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3607 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3608
3609
3610 </td> <!-- entry_type -->
3611
3612 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3613 <p>The ID sent with the latest
3614CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS call</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3615 </td>
3616
3617 <td class="entry_units">
3618 </td>
3619
3620 <td class="entry_range">
3621 </td>
3622
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3623 <td class="entry_tags">
3624 </td>
3625
3626 </tr>
3627 <tr class="entries_header">
3628 <th class="th_details" colspan="5">Details</th>
3629 </tr>
3630 <tr class="entry_cont">
3631 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3632 <p>Must be 0 if no CAMERA2_<wbr/>TRIGGER_<wbr/>AUTOFOCUS trigger
3633received yet by HAL.<wbr/> Always updated even if AF algorithm
3634ignores the trigger</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3635 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3636 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3637
3638
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3639 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3640 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3641
3642
3643 <tr class="entry" id="dynamic_android.control.awbMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3644 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3645 android.<wbr/>control.<wbr/>awb<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3646 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3647 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3648 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3649
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3650 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3651
3652 <ul class="entry_type_enum">
3653 <li>
3654 <span class="entry_type_enum_name">OFF</span>
3655 </li>
3656 <li>
3657 <span class="entry_type_enum_name">AUTO</span>
3658 </li>
3659 <li>
3660 <span class="entry_type_enum_name">INCANDESCENT</span>
3661 </li>
3662 <li>
3663 <span class="entry_type_enum_name">FLUORESCENT</span>
3664 </li>
3665 <li>
3666 <span class="entry_type_enum_name">WARM_FLUORESCENT</span>
3667 </li>
3668 <li>
3669 <span class="entry_type_enum_name">DAYLIGHT</span>
3670 </li>
3671 <li>
3672 <span class="entry_type_enum_name">CLOUDY_DAYLIGHT</span>
3673 </li>
3674 <li>
3675 <span class="entry_type_enum_name">TWILIGHT</span>
3676 </li>
3677 <li>
3678 <span class="entry_type_enum_name">SHADE</span>
3679 </li>
3680 </ul>
3681
3682 </td> <!-- entry_type -->
3683
3684 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3685 <p>Whether AWB is currently setting the color
3686transform fields,<wbr/> and what its illumination target
3687is</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3688 </td>
3689
3690 <td class="entry_units">
3691 </td>
3692
3693 <td class="entry_range">
3694 </td>
3695
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3696 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3697 <ul class="entry_tags">
3698 <li><a href="#tag_BC">BC</a></li>
3699 <li><a href="#tag_AWB">AWB</a></li>
3700 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3701 </td>
3702
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3703 </tr>
3704 <tr class="entries_header">
3705 <th class="th_details" colspan="5">Details</th>
3706 </tr>
3707 <tr class="entry_cont">
3708 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3709 <p>[BC - AWB lock,<wbr/>AWB modes]</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3710<p>Only effective if <a href="#controls_android.control.mode">android.<wbr/>control.<wbr/>mode</a> = AUTO.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3711 </td>
3712 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3713
3714
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3715 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3716 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3717
3718
3719 <tr class="entry" id="dynamic_android.control.awbRegions">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3720 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3721 android.<wbr/>control.<wbr/>awb<wbr/>Regions
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3722 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3723 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3724 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3725 <span class="entry_type_container">x</span>
3726
3727 <span class="entry_type_array">
3728 5 x area_count
3729 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3730 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3731
3732
3733 </td> <!-- entry_type -->
3734
3735 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3736 <p>List of areas to use for illuminant
3737estimation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3738 </td>
3739
3740 <td class="entry_units">
3741 </td>
3742
3743 <td class="entry_range">
3744 </td>
3745
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3746 <td class="entry_tags">
3747 <ul class="entry_tags">
3748 <li><a href="#tag_BC">BC</a></li>
3749 </ul>
3750 </td>
3751
3752 </tr>
3753 <tr class="entries_header">
3754 <th class="th_details" colspan="5">Details</th>
3755 </tr>
3756 <tr class="entry_cont">
3757 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3758 <p>Only used in AUTO mode.<wbr/></p>
3759<p>Each area is a rectangle plus weight: xmin,<wbr/> ymin,<wbr/>
3760xmax,<wbr/> ymax,<wbr/> weight.<wbr/> The rectangle is defined inclusive of the
3761specified coordinates.<wbr/></p>
3762<p>The coordinate system is based on the active pixel array,<wbr/>
3763with (0,<wbr/>0) being the top-left pixel in the active pixel array,<wbr/> and
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3764(<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>width - 1,<wbr/>
3765<a href="#static_android.sensor.info.activeArraySize">android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size</a>.<wbr/>height - 1) being the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3766bottom-right pixel in the active pixel array.<wbr/> The weight
3767should be nonnegative.<wbr/></p>
3768<p>If all regions have 0 weight,<wbr/> then no specific metering area
3769needs to be used by the HAL.<wbr/> If the metering region is
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3770outside the current <a href="#controls_android.scaler.cropRegion">android.<wbr/>scaler.<wbr/>crop<wbr/>Region</a>,<wbr/> the HAL
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]3771should ignore the sections outside the region and output the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3772used sections in the frame metadata</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3773 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3774 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3775
3776
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3777 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3778 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3779
3780
3781 <tr class="entry" id="dynamic_android.control.awbState">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3782 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3783 android.<wbr/>control.<wbr/>awb<wbr/>State
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3784 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3785 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3786 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3787
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3788 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3789
3790 <ul class="entry_type_enum">
3791 <li>
3792 <span class="entry_type_enum_name">INACTIVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3793 <span class="entry_type_enum_notes">AWB is not in auto mode.<wbr/> When a camera device is opened,<wbr/> it
3794 starts in this state.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3795 </li>
3796 <li>
3797 <span class="entry_type_enum_name">SEARCHING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3798 <span class="entry_type_enum_notes">AWB doesn't yet have a good set of control
3799 values for the current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3800 </li>
3801 <li>
3802 <span class="entry_type_enum_name">CONVERGED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3803 <span class="entry_type_enum_notes">AWB has a good set of control values for the
3804 current scene</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3805 </li>
3806 <li>
3807 <span class="entry_type_enum_name">LOCKED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3808 <span class="entry_type_enum_notes">AE has been locked (aeMode =
3809 LOCKED)</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3810 </li>
3811 </ul>
3812
3813 </td> <!-- entry_type -->
3814
3815 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3816 <p>Current state of AWB algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3817 </td>
3818
3819 <td class="entry_units">
3820 </td>
3821
3822 <td class="entry_range">
3823 </td>
3824
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3825 <td class="entry_tags">
3826 </td>
3827
3828 </tr>
3829 <tr class="entries_header">
3830 <th class="th_details" colspan="5">Details</th>
3831 </tr>
3832 <tr class="entry_cont">
3833 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3834 <p>Whenever the AWB algorithm state changes,<wbr/> a
3835MSG_<wbr/>AUTOWHITEBALANCE notification must be send if a
3836notification callback is registered.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3837 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3838 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3839
3840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3841 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3842 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3843
3844
3845 <tr class="entry" id="dynamic_android.control.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3846 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3847 android.<wbr/>control.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3848 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3849 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]3850 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3851
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3852 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3853
3854 <ul class="entry_type_enum">
3855 <li>
3856 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3857 <span class="entry_type_enum_notes">Full application control of pipeline.<wbr/> All 3A
3858 routines are disabled,<wbr/> no other settings in
3859 android.<wbr/>control.<wbr/>* have any effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3860 </li>
3861 <li>
3862 <span class="entry_type_enum_name">AUTO</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3863 <span class="entry_type_enum_notes">Use settings for each individual 3A routine.<wbr/>
3864 Manual control of capture parameters is disabled.<wbr/> All
3865 controls in android.<wbr/>control.<wbr/>* besides sceneMode take
3866 effect</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3867 </li>
3868 <li>
3869 <span class="entry_type_enum_name">USE_SCENE_MODE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3870 <span class="entry_type_enum_notes">Use specific scene mode.<wbr/> Enabling this disables
3871 control.<wbr/>aeMode,<wbr/> control.<wbr/>awbMode and control.<wbr/>afMode
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3872 controls; the HAL must ignore those settings while
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3873 USE_<wbr/>SCENE_<wbr/>MODE is active (except for FACE_<wbr/>PRIORITY
3874 scene mode).<wbr/> Other control entries are still active.<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3875 This setting can only be used if availableSceneModes !=
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3876 UNSUPPORTED</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3877 </li>
3878 </ul>
3879
3880 </td> <!-- entry_type -->
3881
3882 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3883 <p>Overall mode of 3A control
3884routines</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3885 </td>
3886
3887 <td class="entry_units">
3888 </td>
3889
3890 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3891 <p>all must be supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3892 </td>
3893
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3894 <td class="entry_tags">
3895 <ul class="entry_tags">
3896 <li><a href="#tag_BC">BC</a></li>
3897 </ul>
3898 </td>
3899
3900 </tr>
3901 <tr class="entries_header">
3902 <th class="th_details" colspan="5">Details</th>
3903 </tr>
3904 <tr class="entry_cont">
3905 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3906 <p>High-level 3A control.<wbr/> When set to OFF,<wbr/> all 3A control
3907by the HAL is disabled.<wbr/> The application must set the fields for
3908capture parameters itself.<wbr/></p>
3909<p>When set to AUTO,<wbr/> the individual algorithm controls in
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3910android.<wbr/>control.<wbr/>* are in effect,<wbr/> such as <a href="#controls_android.control.afMode">android.<wbr/>control.<wbr/>af<wbr/>Mode</a>.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3911<p>When set to USE_<wbr/>SCENE_<wbr/>MODE,<wbr/> the individual controls in
3912android.<wbr/>control.<wbr/>* are mostly disabled,<wbr/> and the HAL implements
3913one of the scene mode settings (such as ACTION,<wbr/> SUNSET,<wbr/> or PARTY)
3914as it wishes.<wbr/> The HAL scene mode 3A settings are provided by
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]3915<a href="#static_android.control.sceneModeOverrides">android.<wbr/>control.<wbr/>scene<wbr/>Mode<wbr/>Overrides</a>.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3916 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3917 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3918
3919
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3920 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
3921 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3922
3923
3924
3925 <!-- end of kind -->
3926 </tbody>
3927
3928 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3929 <tr><td colspan="6" id="section_demosaic" class="section">demosaic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3930
3931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3932 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3933
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]3934 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3935 <tr>
3936 <th class="th_name">Property Name</th>
3937 <th class="th_type">Type</th>
3938 <th class="th_description">Description</th>
3939 <th class="th_units">Units</th>
3940 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3941 <th class="th_tags">Tags</th>
3942 </tr>
3943 </thead>
3944
3945 <tbody>
3946
3947
3948
3949
3950
3951
3952
3953
3954
3955
3956 <tr class="entry" id="controls_android.demosaic.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3957 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3958 android.<wbr/>demosaic.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3959 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]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"> [system]</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">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3968 <span class="entry_type_enum_notes">Minimal or no slowdown of frame rate compared to
3969 Bayer RAW output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3970 </li>
3971 <li>
3972 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3973 <span class="entry_type_enum_notes">High-quality may reduce output frame
3974 rate</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3975 </li>
3976 </ul>
3977
3978 </td> <!-- entry_type -->
3979
3980 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]3981 <p>Controls the quality of the demosaicing
3982processing</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3983 </td>
3984
3985 <td class="entry_units">
3986 </td>
3987
3988 <td class="entry_range">
3989 </td>
3990
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3991 <td class="entry_tags">
3992 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]3993 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]3994 </ul>
3995 </td>
3996
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]3997 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]3998
3999
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4000 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4001 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4002
4003
4004
4005 <!-- end of kind -->
4006 </tbody>
4007
4008 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4009 <tr><td colspan="6" id="section_edge" class="section">edge</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4010
4011
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4012 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4013
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4014 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4015 <tr>
4016 <th class="th_name">Property Name</th>
4017 <th class="th_type">Type</th>
4018 <th class="th_description">Description</th>
4019 <th class="th_units">Units</th>
4020 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4021 <th class="th_tags">Tags</th>
4022 </tr>
4023 </thead>
4024
4025 <tbody>
4026
4027
4028
4029
4030
4031
4032
4033
4034
4035
4036 <tr class="entry" id="controls_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4037 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4038 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4039 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4040 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4041 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4042
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4043 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4044
4045 <ul class="entry_type_enum">
4046 <li>
4047 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4048 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4049 </li>
4050 <li>
4051 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4052 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
4053 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4054 </li>
4055 <li>
4056 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4057 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4058 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4059 </li>
4060 </ul>
4061
4062 </td> <!-- entry_type -->
4063
4064 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4065 <p>Operation mode for edge
4066enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4067 </td>
4068
4069 <td class="entry_units">
4070 </td>
4071
4072 <td class="entry_range">
4073 </td>
4074
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4075 <td class="entry_tags">
4076 </td>
4077
4078 </tr>
4079 <tr class="entries_header">
4080 <th class="th_details" colspan="5">Details</th>
4081 </tr>
4082 <tr class="entry_cont">
4083 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4084 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4085enhancement will be applied by the HAL.<wbr/></p>
4086<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
4087will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
4088HAL should use the highest-quality enhancement algorithms,<wbr/>
4089even if it slows down capture rate.<wbr/> FAST means the HAL should
4090not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4091 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4092 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4093
4094
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4095 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4096 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4097
4098
4099 <tr class="entry" id="controls_android.edge.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4100 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4101 android.<wbr/>edge.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4102 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4103 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4104 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4105
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4106 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4107
4108
4109 </td> <!-- entry_type -->
4110
4111 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4112 <p>Control the amount of edge enhancement
4113applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4114 </td>
4115
4116 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4117 1-10; 10 is maximum sharpening
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4118 </td>
4119
4120 <td class="entry_range">
4121 </td>
4122
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4123 <td class="entry_tags">
4124 </td>
4125
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4126 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4127
4128
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4129 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4130 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4131
4132
4133
4134 <!-- end of kind -->
4135 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4136 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4137
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4138 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4139 <tr>
4140 <th class="th_name">Property Name</th>
4141 <th class="th_type">Type</th>
4142 <th class="th_description">Description</th>
4143 <th class="th_units">Units</th>
4144 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4145 <th class="th_tags">Tags</th>
4146 </tr>
4147 </thead>
4148
4149 <tbody>
4150
4151
4152
4153
4154
4155
4156
4157
4158
4159
4160 <tr class="entry" id="dynamic_android.edge.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4161 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4162 android.<wbr/>edge.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4163 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4164 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4165 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4166
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4167 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4168
4169 <ul class="entry_type_enum">
4170 <li>
4171 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4172 <span class="entry_type_enum_notes">No edge enhancement is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4173 </li>
4174 <li>
4175 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4176 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
4177 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4178 </li>
4179 <li>
4180 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4181 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4182 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4183 </li>
4184 </ul>
4185
4186 </td> <!-- entry_type -->
4187
4188 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4189 <p>Operation mode for edge
4190enhancement</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4191 </td>
4192
4193 <td class="entry_units">
4194 </td>
4195
4196 <td class="entry_range">
4197 </td>
4198
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4199 <td class="entry_tags">
4200 </td>
4201
4202 </tr>
4203 <tr class="entries_header">
4204 <th class="th_details" colspan="5">Details</th>
4205 </tr>
4206 <tr class="entry_cont">
4207 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4208 <p>Edge/<wbr/>sharpness/<wbr/>detail enhancement.<wbr/> OFF means no
4209enhancement will be applied by the HAL.<wbr/></p>
4210<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined enhancement
4211will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the
4212HAL should use the highest-quality enhancement algorithms,<wbr/>
4213even if it slows down capture rate.<wbr/> FAST means the HAL should
4214not slow down capture rate when applying edge enhancement.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4215 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4216 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4217
4218
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4219 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4220 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4221
4222
4223
4224 <!-- end of kind -->
4225 </tbody>
4226
4227 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4228 <tr><td colspan="6" id="section_flash" class="section">flash</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4229
4230
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4231 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4232
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4233 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4234 <tr>
4235 <th class="th_name">Property Name</th>
4236 <th class="th_type">Type</th>
4237 <th class="th_description">Description</th>
4238 <th class="th_units">Units</th>
4239 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4240 <th class="th_tags">Tags</th>
4241 </tr>
4242 </thead>
4243
4244 <tbody>
4245
4246
4247
4248
4249
4250
4251
4252
4253
4254
4255 <tr class="entry" id="controls_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4256 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4257 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4258 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4259 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4260 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4261
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4262 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4263
4264
4265 </td> <!-- entry_type -->
4266
4267 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4268 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4269 </td>
4270
4271 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4272 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4273 </td>
4274
4275 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4276 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4277 </td>
4278
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4279 <td class="entry_tags">
4280 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4281 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4282 </ul>
4283 </td>
4284
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4285 </tr>
4286 <tr class="entries_header">
4287 <th class="th_details" colspan="5">Details</th>
4288 </tr>
4289 <tr class="entry_cont">
4290 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4291 <p>Power for snapshot may use a different scale than
4292for torch mode.<wbr/> Only one entry for torch mode will be
4293used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4294 </td>
4295 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4296
4297
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4298 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4299 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4300
4301
4302 <tr class="entry" id="controls_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4303 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4304 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4305 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4306 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4307 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4308
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4309 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4310
4311
4312 </td> <!-- entry_type -->
4313
4314 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4315 <p>Firing time of flash relative to start of
4316exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4317 </td>
4318
4319 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4320 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4321 </td>
4322
4323 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4324 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4325 </td>
4326
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4327 <td class="entry_tags">
4328 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4329 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4330 </ul>
4331 </td>
4332
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4333 </tr>
4334 <tr class="entries_header">
4335 <th class="th_details" colspan="5">Details</th>
4336 </tr>
4337 <tr class="entry_cont">
4338 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4339 <p>Clamped to (0,<wbr/> exposure time - flash
4340duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4341 </td>
4342 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4343
4344
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4345 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4346 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4347
4348
4349 <tr class="entry" id="controls_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4350 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4351 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4352 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4353 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4354 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4355
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4356 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4357
4358 <ul class="entry_type_enum">
4359 <li>
4360 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4361 <span class="entry_type_enum_notes">Do not fire the flash for this
4362 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4363 </li>
4364 <li>
4365 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4366 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4367 for this capture based on firingPower,<wbr/>
4368 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4369 </li>
4370 <li>
4371 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4372 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4373 continuously on,<wbr/> power set by
4374 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4375 </li>
4376 </ul>
4377
4378 </td> <!-- entry_type -->
4379
4380 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4381 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4382 </td>
4383
4384 <td class="entry_units">
4385 </td>
4386
4387 <td class="entry_range">
4388 </td>
4389
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4390 <td class="entry_tags">
4391 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4392 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4393 </ul>
4394 </td>
4395
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4396 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4397
4398
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4399 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4400 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4401
4402
4403
4404 <!-- end of kind -->
4405 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4406 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4407
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4408 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4409 <tr>
4410 <th class="th_name">Property Name</th>
4411 <th class="th_type">Type</th>
4412 <th class="th_description">Description</th>
4413 <th class="th_units">Units</th>
4414 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4415 <th class="th_tags">Tags</th>
4416 </tr>
4417 </thead>
4418
4419 <tbody>
4420
4421
4422
4423
4424
4425
4426
4427
4428
4429
4430
4431
4432 <tr class="entry" id="static_android.flash.info.available">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4433 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4434 android.<wbr/>flash.<wbr/>info.<wbr/>available
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4435 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4436 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4437 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4438
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4439 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4440
4441
4442 </td> <!-- entry_type -->
4443
4444 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4445 <p>Whether this camera has a
4446flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4447 </td>
4448
4449 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4450 boolean (0 = false,<wbr/> otherwise true)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4451 </td>
4452
4453 <td class="entry_range">
4454 </td>
4455
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4456 <td class="entry_tags">
4457 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4458 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4459 </ul>
4460 </td>
4461
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4462 </tr>
4463 <tr class="entries_header">
4464 <th class="th_details" colspan="5">Details</th>
4465 </tr>
4466 <tr class="entry_cont">
4467 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4468 <p>If no flash,<wbr/> none of the flash controls do
4469anything.<wbr/> All other metadata should return 0</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4470 </td>
4471 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4472
4473
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4474 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4475 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4476
4477
4478 <tr class="entry" id="static_android.flash.info.chargeDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4479 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4480 android.<wbr/>flash.<wbr/>info.<wbr/>charge<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4481 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4482 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4483 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4484
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4485 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4486
4487
4488 </td> <!-- entry_type -->
4489
4490 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4491 <p>Time taken before flash can fire
4492again</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4493 </td>
4494
4495 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4496 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4497 </td>
4498
4499 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4500 <p>0-1e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4501 </td>
4502
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4503 <td class="entry_tags">
4504 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4505 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4506 </ul>
4507 </td>
4508
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4509 </tr>
4510 <tr class="entries_header">
4511 <th class="th_details" colspan="5">Details</th>
4512 </tr>
4513 <tr class="entry_cont">
4514 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4515 <p>1 second too long/<wbr/>too short for recharge? Should
4516this be power-dependent?</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4517 </td>
4518 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4519
4520
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4521 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4522 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4523
4524
4525
4526
4527
4528 <tr class="entry" id="static_android.flash.colorTemperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4529 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4530 android.<wbr/>flash.<wbr/>color<wbr/>Temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4531 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4532 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4533 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4534
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4535 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4536
4537
4538 </td> <!-- entry_type -->
4539
4540 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4541 <p>The x,<wbr/>y whitepoint of the
4542flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4543 </td>
4544
4545 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4546 pair of floats
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4547 </td>
4548
4549 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4550 <p>0-1 for both</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4551 </td>
4552
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4553 <td class="entry_tags">
4554 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4555 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4556 </ul>
4557 </td>
4558
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4559 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4560
4561
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4562 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4563 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4564
4565
4566 <tr class="entry" id="static_android.flash.maxEnergy">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4567 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4568 android.<wbr/>flash.<wbr/>max<wbr/>Energy
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4569 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4570 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4571 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4572
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4573 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4574
4575
4576 </td> <!-- entry_type -->
4577
4578 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4579 <p>Max energy output of the flash for a full
4580power single flash</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4581 </td>
4582
4583 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4584 lumen-seconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4585 </td>
4586
4587 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]4588 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4589 </td>
4590
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4591 <td class="entry_tags">
4592 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4593 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4594 </ul>
4595 </td>
4596
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4597 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4598
4599
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4600 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4601 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4602
4603
4604
4605 <!-- end of kind -->
4606 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4607 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4608
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4609 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4610 <tr>
4611 <th class="th_name">Property Name</th>
4612 <th class="th_type">Type</th>
4613 <th class="th_description">Description</th>
4614 <th class="th_units">Units</th>
4615 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4616 <th class="th_tags">Tags</th>
4617 </tr>
4618 </thead>
4619
4620 <tbody>
4621
4622
4623
4624
4625
4626
4627
4628
4629
4630
4631 <tr class="entry" id="dynamic_android.flash.firingPower">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4632 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4633 android.<wbr/>flash.<wbr/>firing<wbr/>Power
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4634 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4635 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4636 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4637
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4638 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4639
4640
4641 </td> <!-- entry_type -->
4642
4643 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4644 <p>Power for flash firing/<wbr/>torch</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4645 </td>
4646
4647 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4648 10 is max power; 0 is no flash.<wbr/> Linear
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4649 </td>
4650
4651 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4652 <p>0 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4653 </td>
4654
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4655 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4656 <ul class="entry_tags">
4657 <li><a href="#tag_V1">V1</a></li>
4658 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4659 </td>
4660
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4661 </tr>
4662 <tr class="entries_header">
4663 <th class="th_details" colspan="5">Details</th>
4664 </tr>
4665 <tr class="entry_cont">
4666 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4667 <p>Power for snapshot may use a different scale than
4668for torch mode.<wbr/> Only one entry for torch mode will be
4669used</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4670 </td>
4671 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4672
4673
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4674 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4675 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4676
4677
4678 <tr class="entry" id="dynamic_android.flash.firingTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4679 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4680 android.<wbr/>flash.<wbr/>firing<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4681 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4682 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4683 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4684
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4685 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4686
4687
4688 </td> <!-- entry_type -->
4689
4690 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4691 <p>Firing time of flash relative to start of
4692exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4693 </td>
4694
4695 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4696 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4697 </td>
4698
4699 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]4700 <p>0-(exposure time-flash duration)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4701 </td>
4702
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4703 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4704 <ul class="entry_tags">
4705 <li><a href="#tag_V1">V1</a></li>
4706 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4707 </td>
4708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4709 </tr>
4710 <tr class="entries_header">
4711 <th class="th_details" colspan="5">Details</th>
4712 </tr>
4713 <tr class="entry_cont">
4714 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4715 <p>Clamped to (0,<wbr/> exposure time - flash
4716duration).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4717 </td>
4718 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4719
4720
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4721 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4722 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4723
4724
4725 <tr class="entry" id="dynamic_android.flash.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4726 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4727 android.<wbr/>flash.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4728 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4729 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4730 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4731
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4732 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4733
4734 <ul class="entry_type_enum">
4735 <li>
4736 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4737 <span class="entry_type_enum_notes">Do not fire the flash for this
4738 capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4739 </li>
4740 <li>
4741 <span class="entry_type_enum_name">SINGLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4742 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Fire flash
4743 for this capture based on firingPower,<wbr/>
4744 firingTime.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4745 </li>
4746 <li>
4747 <span class="entry_type_enum_name">TORCH</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4748 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash
4749 continuously on,<wbr/> power set by
4750 firingPower</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4751 </li>
4752 </ul>
4753
4754 </td> <!-- entry_type -->
4755
4756 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4757 <p>Select flash operation mode</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4758 </td>
4759
4760 <td class="entry_units">
4761 </td>
4762
4763 <td class="entry_range">
4764 </td>
4765
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4766 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4767 <ul class="entry_tags">
4768 <li><a href="#tag_BC">BC</a></li>
4769 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4770 </td>
4771
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4772 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4773
4774
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4775 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4776 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4777
4778
4779 <tr class="entry" id="dynamic_android.flash.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4780 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4781 android.<wbr/>flash.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4782 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4783 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4784 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4785
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4786 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4787
4788 <ul class="entry_type_enum">
4789 <li>
4790 <span class="entry_type_enum_name">UNAVAILABLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4791 <span class="entry_type_enum_notes">No flash on camera</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4792 </li>
4793 <li>
4794 <span class="entry_type_enum_name">CHARGING</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4795 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4796 charging and cannot be fired</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4797 </li>
4798 <li>
4799 <span class="entry_type_enum_name">READY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4800 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash is
4801 ready to fire</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4802 </li>
4803 <li>
4804 <span class="entry_type_enum_name">FIRED</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4805 <span class="entry_type_enum_notes">if android.<wbr/>flash.<wbr/>available is true Flash fired
4806 for this capture</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4807 </li>
4808 </ul>
4809
4810 </td> <!-- entry_type -->
4811
4812 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4813 <p>Current state of the flash
4814unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4815 </td>
4816
4817 <td class="entry_units">
4818 </td>
4819
4820 <td class="entry_range">
4821 </td>
4822
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4823 <td class="entry_tags">
4824 </td>
4825
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4826 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4827
4828
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4829 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4830 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4831
4832
4833
4834 <!-- end of kind -->
4835 </tbody>
4836
4837 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4838 <tr><td colspan="6" id="section_geometric" class="section">geometric</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4839
4840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4841 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4842
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4843 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4844 <tr>
4845 <th class="th_name">Property Name</th>
4846 <th class="th_type">Type</th>
4847 <th class="th_description">Description</th>
4848 <th class="th_units">Units</th>
4849 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4850 <th class="th_tags">Tags</th>
4851 </tr>
4852 </thead>
4853
4854 <tbody>
4855
4856
4857
4858
4859
4860
4861
4862
4863
4864
4865 <tr class="entry" id="controls_android.geometric.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4866 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4867 android.<wbr/>geometric.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4868 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4869 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4870 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4871
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4872 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4873
4874 <ul class="entry_type_enum">
4875 <li>
4876 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4877 <span class="entry_type_enum_notes">No geometric correction is
4878 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4879 </li>
4880 <li>
4881 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4882 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
4883 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4884 </li>
4885 <li>
4886 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4887 <span class="entry_type_enum_notes">Frame rate may be reduced by high
4888 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4889 </li>
4890 </ul>
4891
4892 </td> <!-- entry_type -->
4893
4894 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4895 <p>Operating mode of geometric
4896correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4897 </td>
4898
4899 <td class="entry_units">
4900 </td>
4901
4902 <td class="entry_range">
4903 </td>
4904
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4905 <td class="entry_tags">
4906 </td>
4907
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4908 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4909
4910
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4911 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4912 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4913
4914
4915 <tr class="entry" id="controls_android.geometric.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4916 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4917 android.<wbr/>geometric.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4918 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4919 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4920 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4921
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4922 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4923
4924
4925 </td> <!-- entry_type -->
4926
4927 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4928 <p>Control the amount of shading correction
4929applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4930 </td>
4931
4932 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4933 unitless: 1-10; 10 is full shading
4934 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4935 </td>
4936
4937 <td class="entry_range">
4938 </td>
4939
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4940 <td class="entry_tags">
4941 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]4942 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4943 </ul>
4944 </td>
4945
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4946 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4947
4948
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4949 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
4950 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4951
4952
4953
4954 <!-- end of kind -->
4955 </tbody>
4956
4957 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4958 <tr><td colspan="6" id="section_hotPixel" class="section">hotPixel</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4959
4960
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]4961 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4962
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4963 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4964 <tr>
4965 <th class="th_name">Property Name</th>
4966 <th class="th_type">Type</th>
4967 <th class="th_description">Description</th>
4968 <th class="th_units">Units</th>
4969 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4970 <th class="th_tags">Tags</th>
4971 </tr>
4972 </thead>
4973
4974 <tbody>
4975
4976
4977
4978
4979
4980
4981
4982
4983
4984
4985 <tr class="entry" id="controls_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4986 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4987 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]4988 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4989 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]4990 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4991
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]4992 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4993
4994 <ul class="entry_type_enum">
4995 <li>
4996 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]4997 <span class="entry_type_enum_notes">No hot pixel correction can be
4998 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]4999 </li>
5000 <li>
5001 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5002 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
5003 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5004 </li>
5005 <li>
5006 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5007 <span class="entry_type_enum_notes">Frame rate may be reduced by high
5008 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5009 </li>
5010 </ul>
5011
5012 </td> <!-- entry_type -->
5013
5014 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5015 <p>Set operational mode for hot pixel
5016correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5017 </td>
5018
5019 <td class="entry_units">
5020 </td>
5021
5022 <td class="entry_range">
5023 </td>
5024
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5025 <td class="entry_tags">
5026 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5027 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5028 </ul>
5029 </td>
5030
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5031 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5032
5033
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5034 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5035 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5036
5037
5038
5039 <!-- end of kind -->
5040 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5041 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5042
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5043 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5044 <tr>
5045 <th class="th_name">Property Name</th>
5046 <th class="th_type">Type</th>
5047 <th class="th_description">Description</th>
5048 <th class="th_units">Units</th>
5049 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5050 <th class="th_tags">Tags</th>
5051 </tr>
5052 </thead>
5053
5054 <tbody>
5055
5056
5057
5058
5059
5060
5061
5062
5063
5064
5065
5066
5067 <tr class="entry" id="static_android.hotPixel.info.map">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5068 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5069 android.<wbr/>hot<wbr/>Pixel.<wbr/>info.<wbr/>map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5070 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5071 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5072 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5073 <span class="entry_type_container">x</span>
5074
5075 <span class="entry_type_array">
5076 2 x n
5077 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5078 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5079 <div class="entry_type_notes">list of coordinates based on android.<wbr/>sensor.<wbr/>pixel<wbr/>Array<wbr/>Size</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5080
5081
5082 </td> <!-- entry_type -->
5083
5084 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5085 <p>Location of hot/<wbr/>defective pixels on
5086sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5087 </td>
5088
5089 <td class="entry_units">
5090 </td>
5091
5092 <td class="entry_range">
5093 </td>
5094
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5095 <td class="entry_tags">
5096 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5097 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5098 </ul>
5099 </td>
5100
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5101 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5102
5103
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5104 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5105 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5106
5107
5108
5109
5110
5111
5112 <!-- end of kind -->
5113 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5114 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5115
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5116 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5117 <tr>
5118 <th class="th_name">Property Name</th>
5119 <th class="th_type">Type</th>
5120 <th class="th_description">Description</th>
5121 <th class="th_units">Units</th>
5122 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5123 <th class="th_tags">Tags</th>
5124 </tr>
5125 </thead>
5126
5127 <tbody>
5128
5129
5130
5131
5132
5133
5134
5135
5136
5137
5138 <tr class="entry" id="dynamic_android.hotPixel.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5139 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5140 android.<wbr/>hot<wbr/>Pixel.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5141 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5142 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5143 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5144
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5145 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5146
5147 <ul class="entry_type_enum">
5148 <li>
5149 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5150 <span class="entry_type_enum_notes">No hot pixel correction can be
5151 applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5152 </li>
5153 <li>
5154 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5155 <span class="entry_type_enum_notes">Frame rate must not be reduced compared to raw
5156 Bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5157 </li>
5158 <li>
5159 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5160 <span class="entry_type_enum_notes">Frame rate may be reduced by high
5161 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5162 </li>
5163 </ul>
5164
5165 </td> <!-- entry_type -->
5166
5167 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5168 <p>Set operational mode for hot pixel
5169correction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5170 </td>
5171
5172 <td class="entry_units">
5173 </td>
5174
5175 <td class="entry_range">
5176 </td>
5177
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5178 <td class="entry_tags">
5179 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5180 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5181 </ul>
5182 </td>
5183
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5184 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5185
5186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5187 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5188 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5189
5190
5191
5192 <!-- end of kind -->
5193 </tbody>
5194
5195 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5196 <tr><td colspan="6" id="section_jpeg" class="section">jpeg</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5197
5198
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5199 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5200
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5201 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5202 <tr>
5203 <th class="th_name">Property Name</th>
5204 <th class="th_type">Type</th>
5205 <th class="th_description">Description</th>
5206 <th class="th_units">Units</th>
5207 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5208 <th class="th_tags">Tags</th>
5209 </tr>
5210 </thead>
5211
5212 <tbody>
5213
5214
5215
5216
5217
5218
5219
5220
5221
5222
5223 <tr class="entry" id="controls_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5224 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5225 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5226 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5227 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5228 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5229 <span class="entry_type_container">x</span>
5230
5231 <span class="entry_type_array">
5232 3
5233 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5234 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5235 <div class="entry_type_notes">latitude,<wbr/> longitude,<wbr/> altitude.<wbr/> First two in degrees,<wbr/> the third in meters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5236
5237
5238 </td> <!-- entry_type -->
5239
5240 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5241 <p>GPS coordinates to include in output JPEG
5242EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5243 </td>
5244
5245 <td class="entry_units">
5246 </td>
5247
5248 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5249 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5250 </td>
5251
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5252 <td class="entry_tags">
5253 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5254 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5255 </ul>
5256 </td>
5257
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5258 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5259
5260
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5261 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5262 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5263
5264
5265 <tr class="entry" id="controls_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5266 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5267 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5268 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5269 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5270 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5271
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5272 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5273
5274
5275 </td> <!-- entry_type -->
5276
5277 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5278 <p>32 characters describing GPS algorithm to
5279include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5280 </td>
5281
5282 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5283 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5284 </td>
5285
5286 <td class="entry_range">
5287 </td>
5288
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5289 <td class="entry_tags">
5290 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5291 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5292 </ul>
5293 </td>
5294
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5295 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5296
5297
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5298 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5299 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5300
5301
5302 <tr class="entry" id="controls_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5303 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5304 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5305 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5306 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5307 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5308
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5309 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5310
5311
5312 </td> <!-- entry_type -->
5313
5314 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5315 <p>Time GPS fix was made to include in
5316EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5317 </td>
5318
5319 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5320 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5321 </td>
5322
5323 <td class="entry_range">
5324 </td>
5325
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5326 <td class="entry_tags">
5327 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5328 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5329 </ul>
5330 </td>
5331
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5332 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5333
5334
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5335 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5336 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5337
5338
5339 <tr class="entry" id="controls_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5340 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5341 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5342 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5343 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5344 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5345
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5346 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5347
5348
5349 </td> <!-- entry_type -->
5350
5351 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5352 <p>Orientation of JPEG image to
5353write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5354 </td>
5355
5356 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5357 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5358 </td>
5359
5360 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5361 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5362 </td>
5363
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5364 <td class="entry_tags">
5365 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5366 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5367 </ul>
5368 </td>
5369
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5370 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5371
5372
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5373 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5374 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5375
5376
5377 <tr class="entry" id="controls_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5378 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5379 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5380 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5381 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5382 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5383
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5384 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5385
5386
5387 </td> <!-- entry_type -->
5388
5389 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5390 <p>Compression quality of the final JPEG
5391image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5392 </td>
5393
5394 <td class="entry_units">
5395 </td>
5396
5397 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5398 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5399 </td>
5400
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5401 <td class="entry_tags">
5402 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5403 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5404 </ul>
5405 </td>
5406
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5407 </tr>
5408 <tr class="entries_header">
5409 <th class="th_details" colspan="5">Details</th>
5410 </tr>
5411 <tr class="entry_cont">
5412 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5413 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5414 </td>
5415 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5416
5417
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5418 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5419 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5420
5421
5422 <tr class="entry" id="controls_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5423 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5424 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5425 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5426 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5427 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5428
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5429 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5430
5431
5432 </td> <!-- entry_type -->
5433
5434 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5435 <p>Compression quality of JPEG
5436thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5437 </td>
5438
5439 <td class="entry_units">
5440 </td>
5441
5442 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5443 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5444 </td>
5445
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5446 <td class="entry_tags">
5447 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5448 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5449 </ul>
5450 </td>
5451
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5452 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5453
5454
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5455 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5456 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5457
5458
5459 <tr class="entry" id="controls_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5460 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5461 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5462 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5463 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5464 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5465 <span class="entry_type_container">x</span>
5466
5467 <span class="entry_type_array">
5468 2
5469 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5470 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5471
5472
5473 </td> <!-- entry_type -->
5474
5475 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5476 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5477 </td>
5478
5479 <td class="entry_units">
5480 </td>
5481
5482 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5483 <p>Size must be one of the size from <a href="#static_android.jpeg.availableThumbnailSizes">android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5484 </td>
5485
5486 <td class="entry_tags">
5487 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5488 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5489 </ul>
5490 </td>
5491
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5492 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5493 <tr class="entries_header">
5494 <th class="th_details" colspan="5">Details</th>
5495 </tr>
5496 <tr class="entry_cont">
5497 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5498 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5499but the captured JPEG must still be a valid image.<wbr/></p>
5500<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5501the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5502 </td>
5503 </tr>
5504
5505
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5506 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5507 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5508
5509
5510
5511 <!-- end of kind -->
5512 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5513 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5514
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5515 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5516 <tr>
5517 <th class="th_name">Property Name</th>
5518 <th class="th_type">Type</th>
5519 <th class="th_description">Description</th>
5520 <th class="th_units">Units</th>
5521 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5522 <th class="th_tags">Tags</th>
5523 </tr>
5524 </thead>
5525
5526 <tbody>
5527
5528
5529
5530
5531
5532
5533
5534
5535
5536
5537 <tr class="entry" id="static_android.jpeg.availableThumbnailSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5538 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5539 android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5540 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5541 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5542 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5543 <span class="entry_type_container">x</span>
5544
5545 <span class="entry_type_array">
5546 2 x n
5547 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5548 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5549
5550
5551 </td> <!-- entry_type -->
5552
5553 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5554 <p>Supported resolutions for the JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5555 </td>
5556
5557 <td class="entry_units">
5558 </td>
5559
5560 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5561 <p>Must include at least one valid resolution,<wbr/> plus
5562(0,<wbr/>0) for no thumbnail generation,<wbr/> and each size must be distinct.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5563 </td>
5564
5565 <td class="entry_tags">
5566 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5567 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5568 </ul>
5569 </td>
5570
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5571 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5572 <tr class="entries_header">
5573 <th class="th_details" colspan="5">Details</th>
5574 </tr>
5575 <tr class="entry_cont">
5576 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5577 <p>Below condiditions must be satisfied for this size list:</p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5578<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5579<li>The sizes must be sorted by increasing pixel area (width x height).<wbr/>
5580If several resolutions have the same area,<wbr/> they must be sorted by increasing width.<wbr/></li>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5581<li>The aspect ratio of the largest thumbnail size must be same as the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5582aspect ratio of largest size in <a href="#static_android.scaler.availableJpegSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes</a>.<wbr/>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5583The largest size is defined as the size that has the largest pixel area
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5584in a given size list.<wbr/></li>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5585<li>Each size in <a href="#static_android.scaler.availableJpegSizes">android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes</a> must have at least
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5586one corresponding size that has the same aspect ratio in availableThumbnailSizes,<wbr/>
5587and vice versa.<wbr/></li>
5588<li>All non (0,<wbr/> 0) sizes must have non-zero widths and heights.<wbr/></li>
5589</ul>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5590 </td>
5591 </tr>
5592
5593
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5594 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5595 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5596
5597
5598 <tr class="entry" id="static_android.jpeg.maxSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5599 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5600 android.<wbr/>jpeg.<wbr/>max<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5601 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5602 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5603 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5604
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5605 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5606
5607
5608 </td> <!-- entry_type -->
5609
5610 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5611 <p>Maximum size in bytes for the compressed
5612JPEG buffer</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5613 </td>
5614
5615 <td class="entry_units">
5616 </td>
5617
5618 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5619 <p>Must be large enough to fit any JPEG produced by
5620the camera</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5621 </td>
5622
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5623 <td class="entry_tags">
5624 </td>
5625
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5626 </tr>
5627 <tr class="entries_header">
5628 <th class="th_details" colspan="5">Details</th>
5629 </tr>
5630 <tr class="entry_cont">
5631 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5632 <p>This is used for sizing the gralloc buffers for
5633JPEG</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5634 </td>
5635 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5636
5637
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5638 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5639 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5640
5641
5642
5643 <!-- end of kind -->
5644 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5645 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5646
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5647 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5648 <tr>
5649 <th class="th_name">Property Name</th>
5650 <th class="th_type">Type</th>
5651 <th class="th_description">Description</th>
5652 <th class="th_units">Units</th>
5653 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5654 <th class="th_tags">Tags</th>
5655 </tr>
5656 </thead>
5657
5658 <tbody>
5659
5660
5661
5662
5663
5664
5665
5666
5667
5668
5669 <tr class="entry" id="dynamic_android.jpeg.gpsCoordinates">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5670 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5671 android.<wbr/>jpeg.<wbr/>gps<wbr/>Coordinates
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5672 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5673 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5674 <span class="entry_type_name">double</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5675 <span class="entry_type_container">x</span>
5676
5677 <span class="entry_type_array">
5678 3
5679 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5680 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5681 <div class="entry_type_notes">latitude,<wbr/> longitude,<wbr/> altitude.<wbr/> First two in degrees,<wbr/> the third in meters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5682
5683
5684 </td> <!-- entry_type -->
5685
5686 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5687 <p>GPS coordinates to include in output JPEG
5688EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5689 </td>
5690
5691 <td class="entry_units">
5692 </td>
5693
5694 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5695 <p>(-180 - 180],<wbr/> [-90,<wbr/>90],<wbr/> [-inf,<wbr/> inf]</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5696 </td>
5697
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5698 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5699 <ul class="entry_tags">
5700 <li><a href="#tag_BC">BC</a></li>
5701 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5702 </td>
5703
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5704 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5705
5706
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5707 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5708 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5709
5710
5711 <tr class="entry" id="dynamic_android.jpeg.gpsProcessingMethod">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5712 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5713 android.<wbr/>jpeg.<wbr/>gps<wbr/>Processing<wbr/>Method
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5714 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5715 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5716 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5717
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5718 <span class="entry_type_visibility"> [public as string]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5719
5720
5721 </td> <!-- entry_type -->
5722
5723 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5724 <p>32 characters describing GPS algorithm to
5725include in EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5726 </td>
5727
5728 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5729 UTF-8 null-terminated string
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5730 </td>
5731
5732 <td class="entry_range">
5733 </td>
5734
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5735 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5736 <ul class="entry_tags">
5737 <li><a href="#tag_BC">BC</a></li>
5738 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5739 </td>
5740
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5741 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5742
5743
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5744 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5745 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5746
5747
5748 <tr class="entry" id="dynamic_android.jpeg.gpsTimestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5749 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5750 android.<wbr/>jpeg.<wbr/>gps<wbr/>Timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5751 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5752 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5753 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5754
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5755 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5756
5757
5758 </td> <!-- entry_type -->
5759
5760 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5761 <p>Time GPS fix was made to include in
5762EXIF</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5763 </td>
5764
5765 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5766 UTC in seconds since January 1,<wbr/> 1970
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5767 </td>
5768
5769 <td class="entry_range">
5770 </td>
5771
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5772 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5773 <ul class="entry_tags">
5774 <li><a href="#tag_BC">BC</a></li>
5775 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5776 </td>
5777
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5778 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5779
5780
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5781 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5782 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5783
5784
5785 <tr class="entry" id="dynamic_android.jpeg.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5786 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5787 android.<wbr/>jpeg.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5788 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5789 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5790 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5791
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5792 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5793
5794
5795 </td> <!-- entry_type -->
5796
5797 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5798 <p>Orientation of JPEG image to
5799write</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5800 </td>
5801
5802 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5803 Degrees in multiples of 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5804 </td>
5805
5806 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5807 <p>0,<wbr/> 90,<wbr/> 180,<wbr/> 270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5808 </td>
5809
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5810 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5811 <ul class="entry_tags">
5812 <li><a href="#tag_BC">BC</a></li>
5813 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5814 </td>
5815
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5816 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5817
5818
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5819 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5820 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5821
5822
5823 <tr class="entry" id="dynamic_android.jpeg.quality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5824 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5825 android.<wbr/>jpeg.<wbr/>quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5826 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5827 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5828 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5829
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5830 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5831
5832
5833 </td> <!-- entry_type -->
5834
5835 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5836 <p>Compression quality of the final JPEG
5837image</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5838 </td>
5839
5840 <td class="entry_units">
5841 </td>
5842
5843 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5844 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5845 </td>
5846
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5847 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5848 <ul class="entry_tags">
5849 <li><a href="#tag_BC">BC</a></li>
5850 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5851 </td>
5852
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5853 </tr>
5854 <tr class="entries_header">
5855 <th class="th_details" colspan="5">Details</th>
5856 </tr>
5857 <tr class="entry_cont">
5858 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5859 <p>85-95 is typical usage range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5860 </td>
5861 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5862
5863
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5864 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5865 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5866
5867
5868 <tr class="entry" id="dynamic_android.jpeg.size">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5869 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5870 android.<wbr/>jpeg.<wbr/>size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5871 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5872 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5873 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5874
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5875 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5876
5877
5878 </td> <!-- entry_type -->
5879
5880 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5881 <p>The size of the compressed JPEG image,<wbr/> in
5882bytes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5883 </td>
5884
5885 <td class="entry_units">
5886 </td>
5887
5888 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]5889 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5890 </td>
5891
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5892 <td class="entry_tags">
5893 </td>
5894
5895 </tr>
5896 <tr class="entries_header">
5897 <th class="th_details" colspan="5">Details</th>
5898 </tr>
5899 <tr class="entry_cont">
5900 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5901 <p>If no JPEG output is produced for the request,<wbr/>
5902this must be 0.<wbr/></p>
5903<p>Otherwise,<wbr/> this describes the real size of the compressed
5904JPEG image placed in the output stream.<wbr/> More specifically,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5905if <a href="#static_android.jpeg.maxSize">android.<wbr/>jpeg.<wbr/>max<wbr/>Size</a> = 1000000,<wbr/> and a specific capture
5906has <a href="#dynamic_android.jpeg.size">android.<wbr/>jpeg.<wbr/>size</a> = 500000,<wbr/> then the output buffer from
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5907the JPEG stream will be 1000000 bytes,<wbr/> of which the first
5908500000 make up the real data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5909 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5910 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5911
5912
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5913 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5914 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5915
5916
5917 <tr class="entry" id="dynamic_android.jpeg.thumbnailQuality">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5918 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5919 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Quality
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5920 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5921 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5922 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5923
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]5924 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5925
5926
5927 </td> <!-- entry_type -->
5928
5929 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5930 <p>Compression quality of JPEG
5931thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5932 </td>
5933
5934 <td class="entry_units">
5935 </td>
5936
5937 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5938 <p>1-100; larger is higher quality</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5939 </td>
5940
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5941 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5942 <ul class="entry_tags">
5943 <li><a href="#tag_BC">BC</a></li>
5944 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5945 </td>
5946
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5947 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5948
5949
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5950 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
5951 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5952
5953
5954 <tr class="entry" id="dynamic_android.jpeg.thumbnailSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5955 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5956 android.<wbr/>jpeg.<wbr/>thumbnail<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5957 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5958 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]5959 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5960 <span class="entry_type_container">x</span>
5961
5962 <span class="entry_type_array">
5963 2
5964 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]5965 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5966
5967
5968 </td> <!-- entry_type -->
5969
5970 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5971 <p>Resolution of embedded JPEG thumbnail</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5972 </td>
5973
5974 <td class="entry_units">
5975 </td>
5976
5977 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]5978 <p>Size must be one of the size from <a href="#static_android.jpeg.availableThumbnailSizes">android.<wbr/>jpeg.<wbr/>available<wbr/>Thumbnail<wbr/>Sizes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5979 </td>
5980
5981 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]5982 <ul class="entry_tags">
5983 <li><a href="#tag_BC">BC</a></li>
5984 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]5985 </td>
5986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]5987 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5988 <tr class="entries_header">
5989 <th class="th_details" colspan="5">Details</th>
5990 </tr>
5991 <tr class="entry_cont">
5992 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]5993 <p>When set to (0,<wbr/> 0) value,<wbr/> the JPEG EXIF must not contain thumbnail,<wbr/>
5994but the captured JPEG must still be a valid image.<wbr/></p>
5995<p>When a jpeg image capture is issued,<wbr/> the thumbnail size selected should have
5996the same aspect ratio as the jpeg image.<wbr/></p>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]5997 </td>
5998 </tr>
5999
6000
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6001 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6002 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6003
6004
6005
6006 <!-- end of kind -->
6007 </tbody>
6008
6009 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6010 <tr><td colspan="6" id="section_lens" class="section">lens</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6011
6012
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6013 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6014
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6015 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6016 <tr>
6017 <th class="th_name">Property Name</th>
6018 <th class="th_type">Type</th>
6019 <th class="th_description">Description</th>
6020 <th class="th_units">Units</th>
6021 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6022 <th class="th_tags">Tags</th>
6023 </tr>
6024 </thead>
6025
6026 <tbody>
6027
6028
6029
6030
6031
6032
6033
6034
6035
6036
6037 <tr class="entry" id="controls_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6038 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6039 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6040 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6041 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6042 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6043
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6044 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6045
6046
6047 </td> <!-- entry_type -->
6048
6049 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6050 <p>Size of the lens aperture</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6051 </td>
6052
6053 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6054 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6055 </td>
6056
6057 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6058 <p><a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6059 </td>
6060
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6061 <td class="entry_tags">
6062 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6063 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6064 </ul>
6065 </td>
6066
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6067 </tr>
6068 <tr class="entries_header">
6069 <th class="th_details" colspan="5">Details</th>
6070 </tr>
6071 <tr class="entry_cont">
6072 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6073 <p>Will not be supported on most devices.<wbr/> Can only
6074pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6075 </td>
6076 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6077
6078
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6079 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6080 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6081
6082
6083 <tr class="entry" id="controls_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6084 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6085 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6086 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6087 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6088 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6089
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6090 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6091
6092
6093 </td> <!-- entry_type -->
6094
6095 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6096 <p>State of lens neutral density
6097filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6098 </td>
6099
6100 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6101 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6102 </td>
6103
6104 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6105 <p><a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6106 </td>
6107
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6108 <td class="entry_tags">
6109 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6110 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6111 </ul>
6112 </td>
6113
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6114 </tr>
6115 <tr class="entries_header">
6116 <th class="th_details" colspan="5">Details</th>
6117 </tr>
6118 <tr class="entry_cont">
6119 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6120 <p>Will not be supported on most devices.<wbr/> Can only
6121pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6122 </td>
6123 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6124
6125
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6126 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6127 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6128
6129
6130 <tr class="entry" id="controls_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6131 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6132 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6133 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6134 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6135 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6136
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6137 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6138
6139
6140 </td> <!-- entry_type -->
6141
6142 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6143 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6144 </td>
6145
6146 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6147 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6148 </td>
6149
6150 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6151 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6152 </td>
6153
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6154 <td class="entry_tags">
6155 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6156 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6157 </ul>
6158 </td>
6159
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6160 </tr>
6161 <tr class="entries_header">
6162 <th class="th_details" colspan="5">Details</th>
6163 </tr>
6164 <tr class="entry_cont">
6165 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6166 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6167 </td>
6168 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6169
6170
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6171 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6172 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6173
6174
6175 <tr class="entry" id="controls_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6176 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6177 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6178 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6179 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6180 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6181
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6182 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6183
6184
6185 </td> <!-- entry_type -->
6186
6187 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6188 <p>Distance to plane of sharpest focus,<wbr/>
6189measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6190 </td>
6191
6192 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6193 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6194 </td>
6195
6196 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6197 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6198 </td>
6199
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6200 <td class="entry_tags">
6201 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6202 <li><a href="#tag_BC">BC</a></li>
6203 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6204 </ul>
6205 </td>
6206
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6207 </tr>
6208 <tr class="entries_header">
6209 <th class="th_details" colspan="5">Details</th>
6210 </tr>
6211 <tr class="entry_cont">
6212 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6213 <p>0 = infinity focus.<wbr/> Used value should be clamped
6214to (0,<wbr/>minimum focus distance)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6215 </td>
6216 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6217
6218
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6219 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6220 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6221
6222
6223 <tr class="entry" id="controls_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6224 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6225 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6226 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6227 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6228 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6229
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6230 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6231
6232 <ul class="entry_type_enum">
6233 <li>
6234 <span class="entry_type_enum_name">OFF</span>
6235 </li>
6236 <li>
6237 <span class="entry_type_enum_name">ON</span>
6238 <span class="entry_type_enum_optional">optional</span>
6239 </li>
6240 </ul>
6241
6242 </td> <!-- entry_type -->
6243
6244 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6245 <p>Whether optical image stabilization is
6246enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6247 </td>
6248
6249 <td class="entry_units">
6250 </td>
6251
6252 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6253 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6254 </td>
6255
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6256 <td class="entry_tags">
6257 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6258 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6259 </ul>
6260 </td>
6261
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6262 </tr>
6263 <tr class="entries_header">
6264 <th class="th_details" colspan="5">Details</th>
6265 </tr>
6266 <tr class="entry_cont">
6267 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6268 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6269 </td>
6270 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6271
6272
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6273 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6274 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6275
6276
6277
6278 <!-- end of kind -->
6279 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6280 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6281
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6282 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6283 <tr>
6284 <th class="th_name">Property Name</th>
6285 <th class="th_type">Type</th>
6286 <th class="th_description">Description</th>
6287 <th class="th_units">Units</th>
6288 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6289 <th class="th_tags">Tags</th>
6290 </tr>
6291 </thead>
6292
6293 <tbody>
6294
6295
6296
6297
6298
6299
6300
6301
6302
6303
6304
6305
6306 <tr class="entry" id="static_android.lens.info.availableApertures">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6307 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6308 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6309 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6310 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6311 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6312 <span class="entry_type_container">x</span>
6313
6314 <span class="entry_type_array">
6315 n
6316 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6317 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6318
6319
6320 </td> <!-- entry_type -->
6321
6322 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6323 <p>List of supported aperture
6324values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6325 </td>
6326
6327 <td class="entry_units">
6328 </td>
6329
6330 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6331 <p>one entry required,<wbr/> &gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6332 </td>
6333
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6334 <td class="entry_tags">
6335 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6336 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6337 </ul>
6338 </td>
6339
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6340 </tr>
6341 <tr class="entries_header">
6342 <th class="th_details" colspan="5">Details</th>
6343 </tr>
6344 <tr class="entry_cont">
6345 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6346 <p>If variable aperture not available,<wbr/> only setting
6347should be for the fixed aperture</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6348 </td>
6349 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6350
6351
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6352 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6353 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6354
6355
6356 <tr class="entry" id="static_android.lens.info.availableFilterDensities">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6357 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6358 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6359 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6360 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6361 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6362 <span class="entry_type_container">x</span>
6363
6364 <span class="entry_type_array">
6365 n
6366 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6367 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6368
6369
6370 </td> <!-- entry_type -->
6371
6372 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6373 <p>List of supported ND filter
6374values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6375 </td>
6376
6377 <td class="entry_units">
6378 </td>
6379
6380 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6381 <p>one entry required,<wbr/> &gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6382 </td>
6383
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6384 <td class="entry_tags">
6385 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6386 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6387 </ul>
6388 </td>
6389
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6390 </tr>
6391 <tr class="entries_header">
6392 <th class="th_details" colspan="5">Details</th>
6393 </tr>
6394 <tr class="entry_cont">
6395 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6396 <p>If not available,<wbr/> only setting is 0.<wbr/> Otherwise,<wbr/>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6397lists the available exposure index values for dimming
6398(2 would mean the filter is set to reduce incoming
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6399light by two stops)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6400 </td>
6401 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6402
6403
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6404 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6405 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6406
6407
6408 <tr class="entry" id="static_android.lens.info.availableFocalLengths">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6409 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6410 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Focal<wbr/>Lengths
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6411 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6412 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6413 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6414 <span class="entry_type_container">x</span>
6415
6416 <span class="entry_type_array">
6417 n
6418 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6419 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6420 <div class="entry_type_notes">the list of available focal lengths</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6421
6422
6423 </td> <!-- entry_type -->
6424
6425 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6426 <p>If fitted with optical zoom,<wbr/> what focal
6427lengths are available.<wbr/> If not,<wbr/> the static focal
6428length</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6429 </td>
6430
6431 <td class="entry_units">
6432 </td>
6433
6434 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6435 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6436 </td>
6437
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6438 <td class="entry_tags">
6439 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6440 <li><a href="#tag_BC">BC</a></li>
6441 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6442 </ul>
6443 </td>
6444
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6445 </tr>
6446 <tr class="entries_header">
6447 <th class="th_details" colspan="5">Details</th>
6448 </tr>
6449 <tr class="entry_cont">
6450 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6451 <p>If optical zoom not supported,<wbr/> only one value
6452should be reported</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6453 </td>
6454 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6455
6456
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6457 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6458 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6459
6460
6461 <tr class="entry" id="static_android.lens.info.availableOpticalStabilization">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6462 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6463 android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Optical<wbr/>Stabilization
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6464 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6465 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6466 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6467 <span class="entry_type_container">x</span>
6468
6469 <span class="entry_type_array">
6470 n
6471 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6472 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6473 <div class="entry_type_notes">list of enums</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6474
6475
6476 </td> <!-- entry_type -->
6477
6478 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6479 <p>List of supported optical image
6480stabilization modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6481 </td>
6482
6483 <td class="entry_units">
6484 </td>
6485
6486 <td class="entry_range">
6487 </td>
6488
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6489 <td class="entry_tags">
6490 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6491 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6492 </ul>
6493 </td>
6494
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6495 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6496
6497
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6498 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6499 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6500
6501
6502 <tr class="entry" id="static_android.lens.info.geometricCorrectionMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6503 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6504 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6505 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6506 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6507 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6508 <span class="entry_type_container">x</span>
6509
6510 <span class="entry_type_array">
6511 2 x 3 x n x m
6512 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6513 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6514 <div class="entry_type_notes">2D array of destination coordinate pairs for uniform grid points in source image,<wbr/> per color channel.<wbr/> Size in the range of 2x3x40x30</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6515
6516
6517 </td> <!-- entry_type -->
6518
6519 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6520 <p>A low-resolution map for correction of
6521geometric distortions and chromatic aberrations,<wbr/> per
6522color channel</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6523 </td>
6524
6525 <td class="entry_units">
6526 </td>
6527
6528 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6529 <p>N,<wbr/> M &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6530 </td>
6531
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6532 <td class="entry_tags">
6533 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6534 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6535 </ul>
6536 </td>
6537
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6538 </tr>
6539 <tr class="entries_header">
6540 <th class="th_details" colspan="5">Details</th>
6541 </tr>
6542 <tr class="entry_cont">
6543 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6544 <p>[DNG wants a function instead].<wbr/> What's easiest
6545for implementers? With an array size (M,<wbr/> N),<wbr/> entry (i,<wbr/>
6546j) provides the destination for pixel (i/<wbr/>(M-1) * width,<wbr/>
6547j/<wbr/>(N-1) * height).<wbr/> Data is row-major,<wbr/> with each array
6548entry being ( (X,<wbr/> Y)_<wbr/>r,<wbr/> (X,<wbr/> Y)_<wbr/>g,<wbr/> (X,<wbr/> Y)_<wbr/>b ) )</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6549 </td>
6550 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6551
6552
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6553 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6554 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6555
6556
6557 <tr class="entry" id="static_android.lens.info.geometricCorrectionMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6558 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6559 android.<wbr/>lens.<wbr/>info.<wbr/>geometric<wbr/>Correction<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6560 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6561 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6562 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6563 <span class="entry_type_container">x</span>
6564
6565 <span class="entry_type_array">
6566 2
6567 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6568 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6569 <div class="entry_type_notes">width and height of geometric correction map</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6570
6571
6572 </td> <!-- entry_type -->
6573
6574 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6575 <p>Dimensions of geometric correction
6576map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6577 </td>
6578
6579 <td class="entry_units">
6580 </td>
6581
6582 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6583 <p>Both values &gt;= 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6584 </td>
6585
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6586 <td class="entry_tags">
6587 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6588 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6589 </ul>
6590 </td>
6591
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6592 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6593
6594
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6595 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6596 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6597
6598
6599 <tr class="entry" id="static_android.lens.info.hyperfocalDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6600 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6601 android.<wbr/>lens.<wbr/>info.<wbr/>hyperfocal<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6602 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6603 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6604 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6605
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6606 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6607
6608
6609 </td> <!-- entry_type -->
6610
6611 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6612 <p>Hyperfocal distance for this lens; set to
66130 if fixed focus</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6614 </td>
6615
6616 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6617 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6618 </td>
6619
6620 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6621 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6622 </td>
6623
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6624 <td class="entry_tags">
6625 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6626 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6627 </ul>
6628 </td>
6629
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6630 </tr>
6631 <tr class="entries_header">
6632 <th class="th_details" colspan="5">Details</th>
6633 </tr>
6634 <tr class="entry_cont">
6635 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6636 <p>The hyperfocal distance is used for the old
6637API's 'fixed' setting</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6638 </td>
6639 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6640
6641
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6642 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6643 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6644
6645
6646 <tr class="entry" id="static_android.lens.info.minimumFocusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6647 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6648 android.<wbr/>lens.<wbr/>info.<wbr/>minimum<wbr/>Focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6649 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6650 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6651 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6652
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6653 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6654
6655
6656 </td> <!-- entry_type -->
6657
6658 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6659 <p>Shortest distance from frontmost surface
6660of the lens that can be focused correctly</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6661 </td>
6662
6663 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6664 diopters
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6665 </td>
6666
6667 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]6668 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6669 </td>
6670
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6671 <td class="entry_tags">
6672 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6673 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6674 </ul>
6675 </td>
6676
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6677 </tr>
6678 <tr class="entries_header">
6679 <th class="th_details" colspan="5">Details</th>
6680 </tr>
6681 <tr class="entry_cont">
6682 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6683 <p>If the lens is fixed-focus,<wbr/> this should be
66840</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6685 </td>
6686 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6687
6688
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6689 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6690 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6691
6692
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6693 <tr class="entry" id="static_android.lens.info.shadingMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6694 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6695 android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6696 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6697 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6698 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6699 <span class="entry_type_container">x</span>
6700
6701 <span class="entry_type_array">
6702 2
6703 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]6704 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6705 <div class="entry_type_notes">width and height of lens shading map provided by the HAL.<wbr/> (N x M)</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6706
6707
6708 </td> <!-- entry_type -->
6709
6710 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6711 <p>Dimensions of lens shading map.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6712 </td>
6713
6714 <td class="entry_units">
6715 </td>
6716
6717 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6718 <p>Both values &gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6719 </td>
6720
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6721 <td class="entry_tags">
6722 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6723 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6724 </ul>
6725 </td>
6726
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6727 </tr>
6728 <tr class="entries_header">
6729 <th class="th_details" colspan="5">Details</th>
6730 </tr>
6731 <tr class="entry_cont">
6732 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6733 <p>The map should be on the order of 30-40 rows and columns,<wbr/> and
6734must be smaller than 64x64.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6735 </td>
6736 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6737
6738
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6739 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6740 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6741
6742
6743
6744
6745
6746 <tr class="entry" id="static_android.lens.facing">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6747 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6748 android.<wbr/>lens.<wbr/>facing
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6749 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6750 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6751 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6752
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6753 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6754
6755 <ul class="entry_type_enum">
6756 <li>
6757 <span class="entry_type_enum_name">FRONT</span>
6758 </li>
6759 <li>
6760 <span class="entry_type_enum_name">BACK</span>
6761 </li>
6762 </ul>
6763
6764 </td> <!-- entry_type -->
6765
6766 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6767 <p>Direction the camera faces relative to
6768device screen</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6769 </td>
6770
6771 <td class="entry_units">
6772 </td>
6773
6774 <td class="entry_range">
6775 </td>
6776
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6777 <td class="entry_tags">
6778 </td>
6779
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6780 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6781
6782
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6783 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6784 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6785
6786
6787 <tr class="entry" id="static_android.lens.opticalAxisAngle">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6788 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6789 android.<wbr/>lens.<wbr/>optical<wbr/>Axis<wbr/>Angle
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6790 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6791 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6792 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6793 <span class="entry_type_container">x</span>
6794
6795 <span class="entry_type_array">
6796 2
6797 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6798 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6799 <div class="entry_type_notes">degrees.<wbr/> First defines the angle of separation between the perpendicular to the screen and the camera optical axis.<wbr/> The second then defines the clockwise rotation of the optical axis from native device up.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6800
6801
6802 </td> <!-- entry_type -->
6803
6804 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6805 <p>Relative angle of camera optical axis to the
6806perpendicular axis from the display</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6807 </td>
6808
6809 <td class="entry_units">
6810 </td>
6811
6812 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6813 <p>[0-90) for first angle,<wbr/> [0-360) for second</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6814 </td>
6815
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6816 <td class="entry_tags">
6817 <ul class="entry_tags">
6818 <li><a href="#tag_ADV">ADV</a></li>
6819 </ul>
6820 </td>
6821
6822 </tr>
6823 <tr class="entries_header">
6824 <th class="th_details" colspan="5">Details</th>
6825 </tr>
6826 <tr class="entry_cont">
6827 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6828 <p>Examples:</p>
6829<p>(0,<wbr/>0) means that the camera optical axis
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6830is perpendicular to the display surface;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6831<p>(45,<wbr/>0) means that the camera points 45 degrees up when
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6832device is held upright;</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6833<p>(45,<wbr/>90) means the camera points 45 degrees to the right when
6834the device is held upright.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]6835<p>Use FACING field to determine perpendicular outgoing
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6836direction</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6837 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6838 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6839
6840
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6841 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6842 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6843
6844
6845 <tr class="entry" id="static_android.lens.position">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6846 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6847 android.<wbr/>lens.<wbr/>position
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6848 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6849 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6850 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6851 <span class="entry_type_container">x</span>
6852
6853 <span class="entry_type_array">
6854 3, location in mm, in the sensor coordinate
6855 system
6856 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6857 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6858
6859
6860 </td> <!-- entry_type -->
6861
6862 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6863 <p>Coordinates of camera optical axis on
6864device</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6865 </td>
6866
6867 <td class="entry_units">
6868 </td>
6869
6870 <td class="entry_range">
6871 </td>
6872
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6873 <td class="entry_tags">
6874 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6875 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6876 </ul>
6877 </td>
6878
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6879 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6880
6881
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6882 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6883 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6884
6885
6886
6887 <!-- end of kind -->
6888 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6889 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6890
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6891 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6892 <tr>
6893 <th class="th_name">Property Name</th>
6894 <th class="th_type">Type</th>
6895 <th class="th_description">Description</th>
6896 <th class="th_units">Units</th>
6897 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6898 <th class="th_tags">Tags</th>
6899 </tr>
6900 </thead>
6901
6902 <tbody>
6903
6904
6905
6906
6907
6908
6909
6910
6911
6912
6913 <tr class="entry" id="dynamic_android.lens.aperture">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6914 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6915 android.<wbr/>lens.<wbr/>aperture
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6916 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6917 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6918 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6919
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6920 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6921
6922
6923 </td> <!-- entry_type -->
6924
6925 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6926 <p>Size of the lens aperture</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6927 </td>
6928
6929 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6930 f-number (f/<wbr/>NNN)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6931 </td>
6932
6933 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6934 <p><a href="#static_android.lens.info.availableApertures">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Apertures</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6935 </td>
6936
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6937 <td class="entry_tags">
6938 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6939 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6940 </ul>
6941 </td>
6942
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6943 </tr>
6944 <tr class="entries_header">
6945 <th class="th_details" colspan="5">Details</th>
6946 </tr>
6947 <tr class="entry_cont">
6948 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6949 <p>Will not be supported on most devices.<wbr/> Can only
6950pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6951 </td>
6952 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6953
6954
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6955 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
6956 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6957
6958
6959 <tr class="entry" id="dynamic_android.lens.filterDensity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6960 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6961 android.<wbr/>lens.<wbr/>filter<wbr/>Density
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]6962 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6963 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]6964 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6965
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]6966 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6967
6968
6969 </td> <!-- entry_type -->
6970
6971 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6972 <p>State of lens neutral density
6973filter(s)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6974 </td>
6975
6976 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6977 number of stops of filtering
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6978 </td>
6979
6980 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]6981 <p><a href="#static_android.lens.info.availableFilterDensities">android.<wbr/>lens.<wbr/>info.<wbr/>available<wbr/>Filter<wbr/>Densities</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6982 </td>
6983
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6984 <td class="entry_tags">
6985 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]6986 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]6987 </ul>
6988 </td>
6989
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6990 </tr>
6991 <tr class="entries_header">
6992 <th class="th_details" colspan="5">Details</th>
6993 </tr>
6994 <tr class="entry_cont">
6995 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]6996 <p>Will not be supported on most devices.<wbr/> Can only
6997pick from supported list</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]6998 </td>
6999 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7000
7001
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7002 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7003 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7004
7005
7006 <tr class="entry" id="dynamic_android.lens.focalLength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7007 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7008 android.<wbr/>lens.<wbr/>focal<wbr/>Length
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7009 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7010 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7011 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7012
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7013 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7014
7015
7016 </td> <!-- entry_type -->
7017
7018 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7019 <p>Lens optical zoom setting</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7020 </td>
7021
7022 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7023 focal length in mm
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7024 </td>
7025
7026 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7027 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7028 </td>
7029
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7030 <td class="entry_tags">
7031 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7032 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7033 </ul>
7034 </td>
7035
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7036 </tr>
7037 <tr class="entries_header">
7038 <th class="th_details" colspan="5">Details</th>
7039 </tr>
7040 <tr class="entry_cont">
7041 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7042 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7043 </td>
7044 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7045
7046
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7047 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7048 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7049
7050
7051 <tr class="entry" id="dynamic_android.lens.focusDistance">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7052 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7053 android.<wbr/>lens.<wbr/>focus<wbr/>Distance
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7054 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7055 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7056 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7057
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7058 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7059
7060
7061 </td> <!-- entry_type -->
7062
7063 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7064 <p>Distance to plane of sharpest focus,<wbr/>
7065measured from frontmost surface of the lens</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7066 </td>
7067
7068 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7069 diopters (1/<wbr/>m)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7070 </td>
7071
7072 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7073 <p>&gt;= 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7074 </td>
7075
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7076 <td class="entry_tags">
7077 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7078 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7079 </ul>
7080 </td>
7081
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7082 </tr>
7083 <tr class="entries_header">
7084 <th class="th_details" colspan="5">Details</th>
7085 </tr>
7086 <tr class="entry_cont">
7087 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7088 <p>Should be zero for fixed-focus cameras</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7089 </td>
7090 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7091
7092
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7093 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7094 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7095
7096
7097 <tr class="entry" id="dynamic_android.lens.focusRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7098 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7099 android.<wbr/>lens.<wbr/>focus<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7100 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7101 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7102 <span class="entry_type_name">float</span>
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7103 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7104
Zhijun He50451ad2013-09-26 10:27:47 -0700[diff] [blame]7105 <span class="entry_type_array">
7106 2
7107 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7108 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7109 <div class="entry_type_notes">Range of scene distances that are in focus</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7110
7111
7112 </td> <!-- entry_type -->
7113
7114 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7115 <p>The range of scene distances that are in
7116sharp focus (depth of field)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7117 </td>
7118
7119 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7120 pair of focus distances in diopters: (near,<wbr/>
7121 far)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7122 </td>
7123
7124 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]7125 <p>&gt;=0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7126 </td>
7127
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7128 <td class="entry_tags">
7129 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7130 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7131 </ul>
7132 </td>
7133
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7134 </tr>
7135 <tr class="entries_header">
7136 <th class="th_details" colspan="5">Details</th>
7137 </tr>
7138 <tr class="entry_cont">
7139 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7140 <p>If variable focus not supported,<wbr/> can still report
7141fixed depth of field range</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7142 </td>
7143 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7144
7145
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7146 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7147 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7148
7149
7150 <tr class="entry" id="dynamic_android.lens.opticalStabilizationMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7151 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7152 android.<wbr/>lens.<wbr/>optical<wbr/>Stabilization<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7153 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7154 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7155 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7156
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7157 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7158
7159 <ul class="entry_type_enum">
7160 <li>
7161 <span class="entry_type_enum_name">OFF</span>
7162 </li>
7163 <li>
7164 <span class="entry_type_enum_name">ON</span>
7165 <span class="entry_type_enum_optional">optional</span>
7166 </li>
7167 </ul>
7168
7169 </td> <!-- entry_type -->
7170
7171 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7172 <p>Whether optical image stabilization is
7173enabled.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7174 </td>
7175
7176 <td class="entry_units">
7177 </td>
7178
7179 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7180 <p>android.<wbr/>lens.<wbr/>available<wbr/>Optical<wbr/>Stabilization</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7181 </td>
7182
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7183 <td class="entry_tags">
7184 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7185 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7186 </ul>
7187 </td>
7188
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7189 </tr>
7190 <tr class="entries_header">
7191 <th class="th_details" colspan="5">Details</th>
7192 </tr>
7193 <tr class="entry_cont">
7194 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7195 <p>Will not be supported on most devices.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7196 </td>
7197 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7198
7199
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7200 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7201 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7202
7203
7204 <tr class="entry" id="dynamic_android.lens.state">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7205 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7206 android.<wbr/>lens.<wbr/>state
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7207 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7208 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7209 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7210
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7211 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7212
7213 <ul class="entry_type_enum">
7214 <li>
7215 <span class="entry_type_enum_name">STATIONARY</span>
7216 </li>
Igor Murashkin0e323a12013-09-06 11:50:48 -0700[diff] [blame]7217 <li>
7218 <span class="entry_type_enum_name">MOVING</span>
7219 </li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7220 </ul>
7221
7222 </td> <!-- entry_type -->
7223
7224 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7225 <p>Current lens status</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7226 </td>
7227
7228 <td class="entry_units">
7229 </td>
7230
7231 <td class="entry_range">
7232 </td>
7233
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7234 <td class="entry_tags">
7235 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7236 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7237 </ul>
7238 </td>
7239
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7240 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7241
7242
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7243 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7244 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7245
7246
7247
7248 <!-- end of kind -->
7249 </tbody>
7250
7251 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7252 <tr><td colspan="6" id="section_noiseReduction" class="section">noiseReduction</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7253
7254
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7255 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7256
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7257 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7258 <tr>
7259 <th class="th_name">Property Name</th>
7260 <th class="th_type">Type</th>
7261 <th class="th_description">Description</th>
7262 <th class="th_units">Units</th>
7263 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7264 <th class="th_tags">Tags</th>
7265 </tr>
7266 </thead>
7267
7268 <tbody>
7269
7270
7271
7272
7273
7274
7275
7276
7277
7278
7279 <tr class="entry" id="controls_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7280 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7281 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7282 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7283 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7284 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7285
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7286 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7287
7288 <ul class="entry_type_enum">
7289 <li>
7290 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7291 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7292 </li>
7293 <li>
7294 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7295 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7296 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7297 </li>
7298 <li>
7299 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7300 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7301 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7302 </li>
7303 </ul>
7304
7305 </td> <!-- entry_type -->
7306
7307 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7308 <p>Mode of operation for the noise reduction
7309algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7310 </td>
7311
7312 <td class="entry_units">
7313 </td>
7314
7315 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7316 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7317 </td>
7318
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7319 <td class="entry_tags">
7320 <ul class="entry_tags">
7321 <li><a href="#tag_V1">V1</a></li>
7322 </ul>
7323 </td>
7324
7325 </tr>
7326 <tr class="entries_header">
7327 <th class="th_details" colspan="5">Details</th>
7328 </tr>
7329 <tr class="entry_cont">
7330 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7331 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7332will be applied by the HAL.<wbr/></p>
7333<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7334will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7335should use the highest-quality noise filtering algorithms,<wbr/>
7336even if it slows down capture rate.<wbr/> FAST means the HAL should not
7337slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7338 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7339 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7340
7341
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7342 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7343 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7344
7345
7346 <tr class="entry" id="controls_android.noiseReduction.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7347 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7348 android.<wbr/>noise<wbr/>Reduction.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7349 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7350 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7351 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7352
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7353 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7354
7355
7356 </td> <!-- entry_type -->
7357
7358 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7359 <p>Control the amount of noise reduction
7360applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7361 </td>
7362
7363 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7364 1-10; 10 is max noise reduction
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7365 </td>
7366
7367 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7368 <p>1 - 10</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7369 </td>
7370
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7371 <td class="entry_tags">
7372 </td>
7373
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7374 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7375
7376
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7377 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7378 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7379
7380
7381
7382 <!-- end of kind -->
7383 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7384 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7385
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7386 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7387 <tr>
7388 <th class="th_name">Property Name</th>
7389 <th class="th_type">Type</th>
7390 <th class="th_description">Description</th>
7391 <th class="th_units">Units</th>
7392 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7393 <th class="th_tags">Tags</th>
7394 </tr>
7395 </thead>
7396
7397 <tbody>
7398
7399
7400
7401
7402
7403
7404
7405
7406
7407
7408 <tr class="entry" id="dynamic_android.noiseReduction.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7409 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7410 android.<wbr/>noise<wbr/>Reduction.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7411 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7412 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7413 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7414
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7415 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7416
7417 <ul class="entry_type_enum">
7418 <li>
7419 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7420 <span class="entry_type_enum_notes">No noise reduction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7421 </li>
7422 <li>
7423 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7424 <span class="entry_type_enum_notes">Must not slow down frame rate relative to sensor
7425 output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7426 </li>
7427 <li>
7428 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7429 <span class="entry_type_enum_notes">May slow down frame rate to provide highest
7430 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7431 </li>
7432 </ul>
7433
7434 </td> <!-- entry_type -->
7435
7436 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7437 <p>Mode of operation for the noise reduction
7438algorithm</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7439 </td>
7440
7441 <td class="entry_units">
7442 </td>
7443
7444 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7445 <p>android.<wbr/>noise<wbr/>Reduction.<wbr/>available<wbr/>Modes</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7446 </td>
7447
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7448 <td class="entry_tags">
7449 <ul class="entry_tags">
7450 <li><a href="#tag_V1">V1</a></li>
7451 </ul>
7452 </td>
7453
7454 </tr>
7455 <tr class="entries_header">
7456 <th class="th_details" colspan="5">Details</th>
7457 </tr>
7458 <tr class="entry_cont">
7459 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7460 <p>Noise filtering control.<wbr/> OFF means no noise reduction
7461will be applied by the HAL.<wbr/></p>
7462<p>FAST/<wbr/>HIGH_<wbr/>QUALITY both mean HAL-determined noise filtering
7463will be applied.<wbr/> HIGH_<wbr/>QUALITY mode indicates that the HAL
7464should use the highest-quality noise filtering algorithms,<wbr/>
7465even if it slows down capture rate.<wbr/> FAST means the HAL should not
7466slow down capture rate when applying noise filtering.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7467 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7468 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7469
7470
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7471 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7472 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7473
7474
7475
7476 <!-- end of kind -->
7477 </tbody>
7478
7479 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7480 <tr><td colspan="6" id="section_quirks" class="section">quirks</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7481
7482
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7483 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7484
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7485 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7486 <tr>
7487 <th class="th_name">Property Name</th>
7488 <th class="th_type">Type</th>
7489 <th class="th_description">Description</th>
7490 <th class="th_units">Units</th>
7491 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7492 <th class="th_tags">Tags</th>
7493 </tr>
7494 </thead>
7495
7496 <tbody>
7497
7498
7499
7500
7501
7502
7503
7504
7505
7506
7507 <tr class="entry" id="static_android.quirks.meteringCropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7508 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7509 android.<wbr/>quirks.<wbr/>metering<wbr/>Crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7510 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7511 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7512 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7513
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7514 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7515
7516
7517 </td> <!-- entry_type -->
7518
7519 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7520 <p>If set to 1,<wbr/> the camera service does not
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7521scale 'normalized' coordinates with respect to the crop
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7522region.<wbr/> This applies to metering input (a{e,<wbr/>f,<wbr/>wb}Region
7523and output (face rectangles).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7524 </td>
7525
7526 <td class="entry_units">
7527 </td>
7528
7529 <td class="entry_range">
7530 </td>
7531
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7532 <td class="entry_tags">
7533 </td>
7534
7535 </tr>
7536 <tr class="entries_header">
7537 <th class="th_details" colspan="5">Details</th>
7538 </tr>
7539 <tr class="entry_cont">
7540 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7541 <p>Normalized coordinates refer to those in the
7542(-1000,<wbr/>1000) range mentioned in the
7543android.<wbr/>hardware.<wbr/>Camera API.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7544<p>HAL implementations should instead always use and emit
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7545sensor array-relative coordinates for all region data.<wbr/> Does
7546not need to be listed in static metadata.<wbr/> Support will be
7547removed in future versions of camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7548 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7549 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7550
7551
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7552 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7553 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7554
7555
7556 <tr class="entry" id="static_android.quirks.triggerAfWithAuto">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7557 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7558 android.<wbr/>quirks.<wbr/>trigger<wbr/>Af<wbr/>With<wbr/>Auto
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7559 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7560 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7561 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7562
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7563 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7564
7565
7566 </td> <!-- entry_type -->
7567
7568 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7569 <p>If set to 1,<wbr/> then the camera service always
7570switches to FOCUS_<wbr/>MODE_<wbr/>AUTO before issuing a AF
7571trigger.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7572 </td>
7573
7574 <td class="entry_units">
7575 </td>
7576
7577 <td class="entry_range">
7578 </td>
7579
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7580 <td class="entry_tags">
7581 </td>
7582
7583 </tr>
7584 <tr class="entries_header">
7585 <th class="th_details" colspan="5">Details</th>
7586 </tr>
7587 <tr class="entry_cont">
7588 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7589 <p>HAL implementations should implement AF trigger
7590modes for AUTO,<wbr/> MACRO,<wbr/> CONTINUOUS_<wbr/>FOCUS,<wbr/> and
7591CONTINUOUS_<wbr/>PICTURE modes instead of using this flag.<wbr/> Does
7592not need to be listed in static metadata.<wbr/> Support will be
7593removed in future versions of camera service</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7594 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7595 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7596
7597
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7598 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7599 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7600
7601
7602 <tr class="entry" id="static_android.quirks.useZslFormat">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7603 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7604 android.<wbr/>quirks.<wbr/>use<wbr/>Zsl<wbr/>Format
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7605 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7606 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7607 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7608
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7609 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7610
7611
7612 </td> <!-- entry_type -->
7613
7614 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7615 <p>If set to 1,<wbr/> the camera service uses
7616CAMERA2_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>ZSL instead of
7617HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>IMPLEMENTATION_<wbr/>DEFINED for the zero
7618shutter lag stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7619 </td>
7620
7621 <td class="entry_units">
7622 </td>
7623
7624 <td class="entry_range">
7625 </td>
7626
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7627 <td class="entry_tags">
7628 </td>
7629
7630 </tr>
7631 <tr class="entries_header">
7632 <th class="th_details" colspan="5">Details</th>
7633 </tr>
7634 <tr class="entry_cont">
7635 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7636 <p>HAL implementations should use gralloc usage flags
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7637to determine that a stream will be used for
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7638zero-shutter-lag,<wbr/> instead of relying on an explicit
7639format setting.<wbr/> Does not need to be listed in static
7640metadata.<wbr/> Support will be removed in future versions of
7641camera service.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7642 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7643 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7644
7645
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7646 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7647 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7648
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7649
7650 <tr class="entry" id="static_android.quirks.usePartialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7651 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7652 android.<wbr/>quirks.<wbr/>use<wbr/>Partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7653 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7654 <td class="entry_type">
7655 <span class="entry_type_name">byte</span>
7656
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7657 <span class="entry_type_visibility"> [hidden]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7658
7659
7660 </td> <!-- entry_type -->
7661
7662 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7663 <p>If set to 1,<wbr/> the HAL will always split result
7664metadata for a single capture into multiple buffers,<wbr/>
7665returned using multiple process_<wbr/>capture_<wbr/>result calls.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7666 </td>
7667
7668 <td class="entry_units">
7669 </td>
7670
7671 <td class="entry_range">
7672 </td>
7673
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7674 <td class="entry_tags">
7675 </td>
7676
7677 </tr>
7678 <tr class="entries_header">
7679 <th class="th_details" colspan="5">Details</th>
7680 </tr>
7681 <tr class="entry_cont">
7682 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7683 <p>Does not need to be listed in static
7684metadata.<wbr/> Support for partial results will be reworked in
7685future versions of camera service.<wbr/> This quirk will stop
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7686working at that point; DO NOT USE without careful
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7687consideration of future support.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7688 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7689 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7690
7691
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7692 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7693 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7694
7695
7696
7697 <!-- end of kind -->
7698 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7699 <tr><td colspan="6" class="kind">dynamic</td></tr>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7700
7701 <thead class="entries_header">
7702 <tr>
7703 <th class="th_name">Property Name</th>
7704 <th class="th_type">Type</th>
7705 <th class="th_description">Description</th>
7706 <th class="th_units">Units</th>
7707 <th class="th_range">Range</th>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7708 <th class="th_tags">Tags</th>
7709 </tr>
7710 </thead>
7711
7712 <tbody>
7713
7714
7715
7716
7717
7718
7719
7720
7721
7722
7723 <tr class="entry" id="dynamic_android.quirks.partialResult">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7724 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7725 android.<wbr/>quirks.<wbr/>partial<wbr/>Result
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7726 </td>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7727 <td class="entry_type">
7728 <span class="entry_type_name entry_type_name_enum">byte</span>
7729
Eino-Ville Talvala52a64a52013-11-07 14:43:43 -0800[diff] [blame]7730 <span class="entry_type_visibility"> [hidden as boolean]</span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7731
7732 <ul class="entry_type_enum">
7733 <li>
7734 <span class="entry_type_enum_name">FINAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7735 <span class="entry_type_enum_notes">The last or only metadata result buffer
7736 for this capture.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7737 </li>
7738 <li>
7739 <span class="entry_type_enum_name">PARTIAL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7740 <span class="entry_type_enum_notes">A partial buffer of result metadata for this
7741 capture.<wbr/> More result buffers for this capture will be sent
7742 by the HAL,<wbr/> the last of which will be marked
7743 FINAL.<wbr/></span>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7744 </li>
7745 </ul>
7746
7747 </td> <!-- entry_type -->
7748
7749 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7750 <p>Whether a result given to the framework is the
7751final one for the capture,<wbr/> or only a partial that contains a
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7752subset of the full set of dynamic metadata
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7753values.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7754 </td>
7755
7756 <td class="entry_units">
7757 </td>
7758
7759 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7760 <p>Optional.<wbr/> Default value is FINAL.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7761 </td>
7762
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7763 <td class="entry_tags">
7764 </td>
7765
7766 </tr>
7767 <tr class="entries_header">
7768 <th class="th_details" colspan="5">Details</th>
7769 </tr>
7770 <tr class="entry_cont">
7771 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7772 <p>The entries in the result metadata buffers for a
7773single capture may not overlap,<wbr/> except for this entry.<wbr/> The
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]7774FINAL buffers must retain FIFO ordering relative to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7775requests that generate them,<wbr/> so the FINAL buffer for frame 3 must
7776always be sent to the framework after the FINAL buffer for frame 2,<wbr/> and
7777before the FINAL buffer for frame 4.<wbr/> PARTIAL buffers may be returned
7778in any order relative to other frames,<wbr/> but all PARTIAL buffers for a given
7779capture must arrive before the FINAL buffer for that capture.<wbr/> This entry may
7780only be used by the HAL if quirks.<wbr/>usePartialResult is set to 1.<wbr/></p>
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7781 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7782 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7783
7784
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7785 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7786 <!-- end of entry -->
Eino-Ville Talvala82ce3312013-10-09 18:21:30 -0700[diff] [blame]7787
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7788
7789
7790 <!-- end of kind -->
7791 </tbody>
7792
7793 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7794 <tr><td colspan="6" id="section_request" class="section">request</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7795
7796
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7797 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7798
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7799 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7800 <tr>
7801 <th class="th_name">Property Name</th>
7802 <th class="th_type">Type</th>
7803 <th class="th_description">Description</th>
7804 <th class="th_units">Units</th>
7805 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7806 <th class="th_tags">Tags</th>
7807 </tr>
7808 </thead>
7809
7810 <tbody>
7811
7812
7813
7814
7815
7816
7817
7818
7819
7820
7821 <tr class="entry" id="controls_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7822 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7823 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7824 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7825 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7826 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7827
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7828 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7829
7830
7831 </td> <!-- entry_type -->
7832
7833 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7834 <p>A frame counter set by the framework.<wbr/> Must
7835be maintained unchanged in output frame.<wbr/> This value monotonically
7836increases with every new result (that is,<wbr/> each new result has a unique
7837frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7838 </td>
7839
7840 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7841 incrementing integer
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7842 </td>
7843
7844 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7845 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7846 </td>
7847
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7848 <td class="entry_tags">
7849 </td>
7850
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7851 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7852
7853
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7854 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7855 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7856
7857
7858 <tr class="entry" id="controls_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7859 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7860 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7861 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7862 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7863 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7864
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7865 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7866
7867
7868 </td> <!-- entry_type -->
7869
7870 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7871 <p>An application-specified ID for the current
7872request.<wbr/> Must be maintained unchanged in output
7873frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7874 </td>
7875
7876 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7877 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7878 </td>
7879
7880 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7881 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7882 </td>
7883
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7884 <td class="entry_tags">
7885 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]7886 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7887 </ul>
7888 </td>
7889
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7890 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7891
7892
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7893 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7894 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7895
7896
7897 <tr class="entry" id="controls_android.request.inputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7898 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7899 android.<wbr/>request.<wbr/>input<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7900 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7901 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]7902 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7903 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7904
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7905 <span class="entry_type_array">
7906 n
7907 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7908 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7909
7910
7911 </td> <!-- entry_type -->
7912
7913 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7914 <p>List which camera reprocess stream is used
7915for the source of reprocessing data.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7916 </td>
7917
7918 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7919 List of camera reprocess stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7920 </td>
7921
7922 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7923 <p>Typically,<wbr/> only one entry allowed,<wbr/> must be a valid
7924reprocess stream ID.<wbr/></p>
7925<p>If android.<wbr/>jpeg.<wbr/>needs<wbr/>Thumbnail is set,<wbr/> then multiple
7926reprocess streams may be included in a single request; they
7927must be different scaled versions of the same image.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7928 </td>
7929
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7930 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]7931 <ul class="entry_tags">
7932 <li><a href="#tag_HAL2">HAL2</a></li>
7933 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7934 </td>
7935
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7936 </tr>
7937 <tr class="entries_header">
7938 <th class="th_details" colspan="5">Details</th>
7939 </tr>
7940 <tr class="entry_cont">
7941 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]7942 <p>Only meaningful when <a href="#controls_android.request.type">android.<wbr/>request.<wbr/>type</a> ==
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7943REPROCESS.<wbr/> Ignored otherwise</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7944 </td>
7945 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7946
7947
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7948 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
7949 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7950
7951
7952 <tr class="entry" id="controls_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7953 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7954 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7955 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7956 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]7957 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7958
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]7959 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7960
7961 <ul class="entry_type_enum">
7962 <li>
7963 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7964 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
7965 for application-bound buffer data.<wbr/> If no
7966 application-bound streams exist,<wbr/> no frame should be
7967 placed in the output frame queue.<wbr/> If such streams
7968 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7969 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7970 information.<wbr/> Timestamp information should still be
7971 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7972 </li>
7973 <li>
7974 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7975 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7976 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7977 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7978 </li>
7979 </ul>
7980
7981 </td> <!-- entry_type -->
7982
7983 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]7984 <p>How much metadata to produce on
7985output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7986 </td>
7987
7988 <td class="entry_units">
7989 </td>
7990
7991 <td class="entry_range">
7992 </td>
7993
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]7994 <td class="entry_tags">
7995 </td>
7996
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]7997 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]7998
7999
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8000 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8001 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8002
8003
8004 <tr class="entry" id="controls_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8005 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8006 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8007 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8008 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8009 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8010 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8011
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8012 <span class="entry_type_array">
8013 n
8014 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8015 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8016
8017
8018 </td> <!-- entry_type -->
8019
8020 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8021 <p>Lists which camera output streams image data
8022from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8023 </td>
8024
8025 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8026 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8027 </td>
8028
8029 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8030 <p>List must only include streams that have been
8031created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8032 </td>
8033
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8034 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8035 <ul class="entry_tags">
8036 <li><a href="#tag_HAL2">HAL2</a></li>
8037 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8038 </td>
8039
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8040 </tr>
8041 <tr class="entries_header">
8042 <th class="th_details" colspan="5">Details</th>
8043 </tr>
8044 <tr class="entry_cont">
8045 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8046 <p>If no output streams are listed,<wbr/> then the image
8047data should simply be discarded.<wbr/> The image data must
8048still be captured for metadata and statistics production,<wbr/>
8049and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8050 </td>
8051 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8052
8053
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8054 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8055 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8056
8057
8058 <tr class="entry" id="controls_android.request.type">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8059 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8060 android.<wbr/>request.<wbr/>type
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8061 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8062 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8063 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8064
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8065 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8066
8067 <ul class="entry_type_enum">
8068 <li>
8069 <span class="entry_type_enum_name">CAPTURE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8070 <span class="entry_type_enum_notes">Capture a new image from the imaging hardware,<wbr/>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8071 and process it according to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8072 settings</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8073 </li>
8074 <li>
8075 <span class="entry_type_enum_name">REPROCESS</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8076 <span class="entry_type_enum_notes">Process previously captured data; the
8077 android.<wbr/>request.<wbr/>input<wbr/>Stream parameter determines the
8078 source reprocessing stream.<wbr/> TODO: Mark dynamic metadata
8079 needed for reprocessing with [RP]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8080 </li>
8081 </ul>
8082
8083 </td> <!-- entry_type -->
8084
8085 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8086 <p>The type of the request; either CAPTURE or
8087REPROCESS.<wbr/> For HAL3,<wbr/> this tag is redundant.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8088 </td>
8089
8090 <td class="entry_units">
8091 </td>
8092
8093 <td class="entry_range">
8094 </td>
8095
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8096 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8097 <ul class="entry_tags">
8098 <li><a href="#tag_HAL2">HAL2</a></li>
8099 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8100 </td>
8101
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8102 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8103
8104
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8105 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8106 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8107
8108
8109
8110 <!-- end of kind -->
8111 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8112 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8113
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8114 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8115 <tr>
8116 <th class="th_name">Property Name</th>
8117 <th class="th_type">Type</th>
8118 <th class="th_description">Description</th>
8119 <th class="th_units">Units</th>
8120 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8121 <th class="th_tags">Tags</th>
8122 </tr>
8123 </thead>
8124
8125 <tbody>
8126
8127
8128
8129
8130
8131
8132
8133
8134
8135
8136 <tr class="entry" id="static_android.request.maxNumOutputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8137 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8138 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8139 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8140 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8141 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8142 <span class="entry_type_container">x</span>
8143
8144 <span class="entry_type_array">
8145 3
8146 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8147 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8148
8149
8150 </td> <!-- entry_type -->
8151
8152 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8153 <p>How many output streams can be allocated at
8154the same time for each type of stream</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8155 </td>
8156
8157 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8158 The number of raw sensor streams; the number of
8159 processed,<wbr/> uncompressed streams; and the number of
8160 JPEG-compressed streams
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8161 </td>
8162
8163 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8164 <p>&gt;=1 for Raw and JPEG-compressed stream.<wbr/> &gt;= 3
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8165for processed,<wbr/> uncompressed streams</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8166 </td>
8167
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8168 <td class="entry_tags">
8169 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8170 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8171 </ul>
8172 </td>
8173
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8174 </tr>
8175 <tr class="entries_header">
8176 <th class="th_details" colspan="5">Details</th>
8177 </tr>
8178 <tr class="entry_cont">
8179 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8180 <p>Video snapshot with preview callbacks requires 3
8181processed streams (preview,<wbr/> record,<wbr/> app callbacks) and
8182one JPEG stream (snapshot)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8183 </td>
8184 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8185
8186
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8187 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8188 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8189
8190
8191 <tr class="entry" id="static_android.request.maxNumReprocessStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8192 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8193 android.<wbr/>request.<wbr/>max<wbr/>Num<wbr/>Reprocess<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8194 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8195 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8196 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8197 <span class="entry_type_container">x</span>
8198
8199 <span class="entry_type_array">
8200 1
8201 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8202 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8203
8204
8205 </td> <!-- entry_type -->
8206
8207 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8208 <p>How many reprocessing streams of any type
8209can be allocated at the same time</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8210 </td>
8211
8212 <td class="entry_units">
8213 </td>
8214
8215 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8216 <p>&gt;= 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8217 </td>
8218
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8219 <td class="entry_tags">
8220 </td>
8221
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8222 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8223
8224
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8225 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8226 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8227
8228
8229
8230 <!-- end of kind -->
8231 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8232 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8233
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8234 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8235 <tr>
8236 <th class="th_name">Property Name</th>
8237 <th class="th_type">Type</th>
8238 <th class="th_description">Description</th>
8239 <th class="th_units">Units</th>
8240 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8241 <th class="th_tags">Tags</th>
8242 </tr>
8243 </thead>
8244
8245 <tbody>
8246
8247
8248
8249
8250
8251
8252
8253
8254
8255
8256 <tr class="entry" id="dynamic_android.request.frameCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8257 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8258 android.<wbr/>request.<wbr/>frame<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8259 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8260 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8261 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8262
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8263 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8264
8265
8266 </td> <!-- entry_type -->
8267
8268 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8269 <p>A frame counter set by the framework.<wbr/> This value monotonically
8270increases with every new result (that is,<wbr/> each new result has a unique
8271frameCount value).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8272 </td>
8273
8274 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8275 count of frames
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8276 </td>
8277
8278 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8279 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8280 </td>
8281
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8282 <td class="entry_tags">
8283 </td>
8284
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8285 </tr>
8286 <tr class="entries_header">
8287 <th class="th_details" colspan="5">Details</th>
8288 </tr>
8289 <tr class="entry_cont">
8290 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8291 <p>Reset on release()</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8292 </td>
8293 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8294
8295
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8296 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8297 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8298
8299
8300 <tr class="entry" id="dynamic_android.request.id">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8301 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8302 android.<wbr/>request.<wbr/>id
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8303 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8304 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8305 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8306
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8307 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8308
8309
8310 </td> <!-- entry_type -->
8311
8312 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8313 <p>An application-specified ID for the current
8314request.<wbr/> Must be maintained unchanged in output
8315frame</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8316 </td>
8317
8318 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8319 arbitrary integer assigned by application
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8320 </td>
8321
8322 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8323 <p>Any int</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8324 </td>
8325
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8326 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8327 <ul class="entry_tags">
8328 <li><a href="#tag_V1">V1</a></li>
8329 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8330 </td>
8331
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8332 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8333
8334
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8335 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8336 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8337
8338
8339 <tr class="entry" id="dynamic_android.request.metadataMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8340 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8341 android.<wbr/>request.<wbr/>metadata<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8342 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8343 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8344 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8345
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8346 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8347
8348 <ul class="entry_type_enum">
8349 <li>
8350 <span class="entry_type_enum_name">NONE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8351 <span class="entry_type_enum_notes">No metadata should be produced on output,<wbr/> except
8352 for application-bound buffer data.<wbr/> If no
8353 application-bound streams exist,<wbr/> no frame should be
8354 placed in the output frame queue.<wbr/> If such streams
8355 exist,<wbr/> a frame should be placed on the output queue
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8356 with null metadata but with the necessary output buffer
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8357 information.<wbr/> Timestamp information should still be
8358 included with any output stream buffers</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8359 </li>
8360 <li>
8361 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8362 <span class="entry_type_enum_notes">All metadata should be produced.<wbr/> Statistics will
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8363 only be produced if they are separately
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8364 enabled</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8365 </li>
8366 </ul>
8367
8368 </td> <!-- entry_type -->
8369
8370 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8371 <p>How much metadata to produce on
8372output</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8373 </td>
8374
8375 <td class="entry_units">
8376 </td>
8377
8378 <td class="entry_range">
8379 </td>
8380
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8381 <td class="entry_tags">
8382 </td>
8383
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8384 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8385
8386
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8387 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8388 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8389
8390
8391 <tr class="entry" id="dynamic_android.request.outputStreams">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8392 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8393 android.<wbr/>request.<wbr/>output<wbr/>Streams
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8394 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8395 <td class="entry_type">
Zhijun Hee36cdbe2013-09-06 14:28:37 -0700[diff] [blame]8396 <span class="entry_type_name">int32</span>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8397 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8398
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8399 <span class="entry_type_array">
8400 n
8401 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8402 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8403
8404
8405 </td> <!-- entry_type -->
8406
8407 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8408 <p>Lists which camera output streams image data
8409from this capture must be sent to</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8410 </td>
8411
8412 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8413 List of camera stream IDs
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8414 </td>
8415
8416 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8417 <p>List must only include streams that have been
8418created</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8419 </td>
8420
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8421 <td class="entry_tags">
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]8422 <ul class="entry_tags">
8423 <li><a href="#tag_HAL2">HAL2</a></li>
8424 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8425 </td>
8426
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8427 </tr>
8428 <tr class="entries_header">
8429 <th class="th_details" colspan="5">Details</th>
8430 </tr>
8431 <tr class="entry_cont">
8432 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8433 <p>If no output streams are listed,<wbr/> then the image
8434data should simply be discarded.<wbr/> The image data must
8435still be captured for metadata and statistics production,<wbr/>
8436and the lens and flash must operate as requested.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8437 </td>
8438 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8439
8440
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8441 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8442 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8443
8444
8445
8446 <!-- end of kind -->
8447 </tbody>
8448
8449 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8450 <tr><td colspan="6" id="section_scaler" class="section">scaler</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8451
8452
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8453 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8454
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8455 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8456 <tr>
8457 <th class="th_name">Property Name</th>
8458 <th class="th_type">Type</th>
8459 <th class="th_description">Description</th>
8460 <th class="th_units">Units</th>
8461 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8462 <th class="th_tags">Tags</th>
8463 </tr>
8464 </thead>
8465
8466 <tbody>
8467
8468
8469
8470
8471
8472
8473
8474
8475
8476
8477 <tr class="entry" id="controls_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8478 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8479 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8480 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8481 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8482 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8483 <span class="entry_type_container">x</span>
8484
8485 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]8486 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8487 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8488 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8489
8490
8491 </td> <!-- entry_type -->
8492
8493 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8494 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
8495<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
8496(width,<wbr/> height).<wbr/> The region of the sensor that is used for
8497output.<wbr/> Each stream must use this rectangle to produce its
8498output,<wbr/> cropping to a smaller region if necessary to
8499maintain the stream's aspect ratio.<wbr/></p>
8500<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8501 </td>
8502
8503 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8504 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
8505 in pixels; (0,<wbr/>0) is top-left corner of
8506 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8507 </td>
8508
8509 <td class="entry_range">
8510 </td>
8511
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8512 <td class="entry_tags">
8513 <ul class="entry_tags">
8514 <li><a href="#tag_BC">BC</a></li>
8515 </ul>
8516 </td>
8517
8518 </tr>
8519 <tr class="entries_header">
8520 <th class="th_details" colspan="5">Details</th>
8521 </tr>
8522 <tr class="entry_cont">
8523 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8524 <p>Any additional per-stream cropping must be done to
8525maximize the final pixel area of the stream.<wbr/></p>
8526<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
8527ratio,<wbr/> then 4:3 streams should use the exact crop
8528region.<wbr/> 16:9 streams should further crop vertically
8529(letterbox).<wbr/></p>
8530<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
8531outputs should crop horizontally (pillarbox),<wbr/> and 16:9
8532streams should match exactly.<wbr/> These additional crops must
8533be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8534<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8535times,<wbr/> no matter what the relative aspect ratios of the
8536crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8537corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8538larger than active pixel array.<wbr/> Width and height may be
8539rounded to nearest larger supportable width,<wbr/> especially
8540for raw output,<wbr/> where only a few fixed scales may be
8541possible.<wbr/> The width and height of the crop region cannot
8542be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
8543android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
8544activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
8545respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8546 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8547 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8548
8549
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8550 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8551 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8552
8553
8554
8555 <!-- end of kind -->
8556 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8557 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8558
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8559 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8560 <tr>
8561 <th class="th_name">Property Name</th>
8562 <th class="th_type">Type</th>
8563 <th class="th_description">Description</th>
8564 <th class="th_units">Units</th>
8565 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8566 <th class="th_tags">Tags</th>
8567 </tr>
8568 </thead>
8569
8570 <tbody>
8571
8572
8573
8574
8575
8576
8577
8578
8579
8580
8581 <tr class="entry" id="static_android.scaler.availableFormats">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8582 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8583 android.<wbr/>scaler.<wbr/>available<wbr/>Formats
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8584 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8585 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8586 <span class="entry_type_name entry_type_name_enum">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8587 <span class="entry_type_container">x</span>
8588
8589 <span class="entry_type_array">
8590 n
8591 </span>
Eino-Ville Talvalad4e240a2013-08-08 12:56:37 -0700[diff] [blame]8592 <span class="entry_type_visibility"> [public as imageFormat]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8593 <div class="entry_type_notes">values from HAL_<wbr/>PIXEL_<wbr/>FORMAT_<wbr/>* in /<wbr/>system/<wbr/>core/<wbr/>include/<wbr/>system/<wbr/>graphics.<wbr/>h</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8594
8595 <ul class="entry_type_enum">
8596 <li>
8597 <span class="entry_type_enum_name">RAW_SENSOR</span>
8598 <span class="entry_type_enum_value">0x20</span>
8599 </li>
8600 <li>
8601 <span class="entry_type_enum_name">YV12</span>
8602 <span class="entry_type_enum_value">0x32315659</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8603 <span class="entry_type_enum_notes">YCrCb 4:2:0 Planar</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8604 </li>
8605 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8606 <span class="entry_type_enum_name">YCrCb_420_SP</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8607 <span class="entry_type_enum_value">0x11</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8608 <span class="entry_type_enum_notes">NV21</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8609 </li>
8610 <li>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8611 <span class="entry_type_enum_name">IMPLEMENTATION_DEFINED</span>
8612 <span class="entry_type_enum_value">0x22</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8613 <span class="entry_type_enum_notes">Hal Implementation Defined</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8614 </li>
8615 <li>
8616 <span class="entry_type_enum_name">YCbCr_420_888</span>
8617 <span class="entry_type_enum_value">0x23</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8618 <span class="entry_type_enum_notes">Flexible YUV420 Format</span>
Zhijun Hec2eebff2013-05-16 17:49:35 -0700[diff] [blame]8619 </li>
8620 <li>
8621 <span class="entry_type_enum_name">BLOB</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8622 <span class="entry_type_enum_value">0x21</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8623 <span class="entry_type_enum_notes">JPEG</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8624 </li>
8625 </ul>
8626
8627 </td> <!-- entry_type -->
8628
8629 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8630 <p>List of app-visible formats</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8631 </td>
8632
8633 <td class="entry_units">
8634 </td>
8635
8636 <td class="entry_range">
8637 </td>
8638
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8639 <td class="entry_tags">
8640 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8641 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8642 </ul>
8643 </td>
8644
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8645 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8646
8647
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8648 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8649 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8650
8651
8652 <tr class="entry" id="static_android.scaler.availableJpegMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8653 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8654 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8655 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8656 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8657 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8658 <span class="entry_type_container">x</span>
8659
8660 <span class="entry_type_array">
8661 n
8662 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8663 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8664
8665
8666 </td> <!-- entry_type -->
8667
8668 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8669 <p>The minimum frame duration that is supported
8670for each resolution in availableJpegSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8671correspond to the frame duration when only that JPEG
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8672stream is active and captured in a burst,<wbr/> with all
8673processing set to FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8674 </td>
8675
8676 <td class="entry_units">
8677 </td>
8678
8679 <td class="entry_range">
8680 </td>
8681
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8682 <td class="entry_tags">
8683 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8684 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8685 </ul>
8686 </td>
8687
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8688 </tr>
8689 <tr class="entries_header">
8690 <th class="th_details" colspan="5">Details</th>
8691 </tr>
8692 <tr class="entry_cont">
8693 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8694 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8695frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8696durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8697 </td>
8698 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8699
8700
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8701 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8702 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8703
8704
8705 <tr class="entry" id="static_android.scaler.availableJpegSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8706 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8707 android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8708 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8709 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8710 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8711 <span class="entry_type_container">x</span>
8712
8713 <span class="entry_type_array">
8714 n x 2
8715 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8716 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8717
8718
8719 </td> <!-- entry_type -->
8720
8721 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8722 <p>The resolutions available for output from
8723the JPEG block.<wbr/> Listed as width x height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8724 </td>
8725
8726 <td class="entry_units">
8727 </td>
8728
8729 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8730 <p>Must include: - sensor maximum resolution Should
8731include: - half/<wbr/>quarter max resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8732 </td>
8733
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8734 <td class="entry_tags">
8735 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8736 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8737 </ul>
8738 </td>
8739
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8740 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8741
8742
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8743 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8744 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8745
8746
8747 <tr class="entry" id="static_android.scaler.availableMaxDigitalZoom">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8748 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8749 android.<wbr/>scaler.<wbr/>available<wbr/>Max<wbr/>Digital<wbr/>Zoom
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8750 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8751 <td class="entry_type">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8752 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8753
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8754 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8755
8756
8757 </td> <!-- entry_type -->
8758
8759 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8760 <p>The maximum ratio between active area width
8761and crop region width,<wbr/> or between active area height and
8762crop region height,<wbr/> if the crop region height is larger
8763than width</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8764 </td>
8765
8766 <td class="entry_units">
8767 </td>
8768
8769 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]8770 <p>&gt;=1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8771 </td>
8772
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8773 <td class="entry_tags">
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]8774 <ul class="entry_tags">
8775 <li><a href="#tag_BC">BC</a></li>
8776 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8777 </td>
8778
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8779 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8780
8781
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8782 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8783 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8784
8785
8786 <tr class="entry" id="static_android.scaler.availableProcessedMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8787 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8788 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8789 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8790 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8791 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8792 <span class="entry_type_container">x</span>
8793
8794 <span class="entry_type_array">
8795 n
8796 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8797 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8798
8799
8800 </td> <!-- entry_type -->
8801
8802 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8803 <p>The minimum frame duration that is supported
8804for each resolution in availableProcessedSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8805correspond to the frame duration when only that processed
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8806stream is active,<wbr/> with all processing set to
8807FAST</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8808 </td>
8809
8810 <td class="entry_units">
8811 </td>
8812
8813 <td class="entry_range">
8814 </td>
8815
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8816 <td class="entry_tags">
8817 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8818 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8819 </ul>
8820 </td>
8821
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8822 </tr>
8823 <tr class="entries_header">
8824 <th class="th_details" colspan="5">Details</th>
8825 </tr>
8826 <tr class="entry_cont">
8827 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8828 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8829frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8830durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8831 </td>
8832 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8833
8834
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8835 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8836 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8837
8838
8839 <tr class="entry" id="static_android.scaler.availableProcessedSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8840 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8841 android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8842 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8843 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8844 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8845 <span class="entry_type_container">x</span>
8846
8847 <span class="entry_type_array">
8848 n x 2
8849 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8850 <span class="entry_type_visibility"> [public as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8851
8852
8853 </td> <!-- entry_type -->
8854
8855 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8856 <p>The resolutions available for use with
8857processed output streams,<wbr/> such as YV12,<wbr/> NV12,<wbr/> and
8858platform opaque YUV/<wbr/>RGB streams to the GPU or video
8859encoders.<wbr/> Listed as width,<wbr/> height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8860 </td>
8861
8862 <td class="entry_units">
8863 </td>
8864
8865 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8866 <p>Must include: - sensor maximum resolution -
8867standard QCIF,<wbr/> 240p,<wbr/> 480p,<wbr/> 720p,<wbr/> and 1080p
8868resolutions</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8869 </td>
8870
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8871 <td class="entry_tags">
8872 <ul class="entry_tags">
8873 <li><a href="#tag_BC">BC</a></li>
8874 </ul>
8875 </td>
8876
8877 </tr>
8878 <tr class="entries_header">
8879 <th class="th_details" colspan="5">Details</th>
8880 </tr>
8881 <tr class="entry_cont">
8882 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8883 <p>The actual supported resolution list may be limited by
8884consumer end points for different use cases.<wbr/> For example,<wbr/> for
8885recording use case,<wbr/> the largest supported resolution may be
8886limited by max supported size from encoder,<wbr/> for preview use
8887case,<wbr/> the largest supported resolution may be limited by max
8888resolution SurfaceTexture/<wbr/>SurfaceView can support.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8889 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8890 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8891
8892
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8893 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8894 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8895
8896
8897 <tr class="entry" id="static_android.scaler.availableRawMinDurations">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8898 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8899 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8900 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8901 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8902 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8903 <span class="entry_type_container">x</span>
8904
8905 <span class="entry_type_array">
8906 n
8907 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8908 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8909
8910
8911 </td> <!-- entry_type -->
8912
8913 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8914 <p>The minimum frame duration that is supported
8915for each raw resolution in availableRawSizes.<wbr/> Should
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]8916correspond to the frame duration when only the raw stream
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8917is active.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8918 </td>
8919
8920 <td class="entry_units">
8921 </td>
8922
8923 <td class="entry_range">
8924 </td>
8925
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8926 <td class="entry_tags">
8927 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]8928 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8929 </ul>
8930 </td>
8931
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8932 </tr>
8933 <tr class="entries_header">
8934 <th class="th_details" colspan="5">Details</th>
8935 </tr>
8936 <tr class="entry_cont">
8937 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8938 <p>When multiple streams are configured,<wbr/> the minimum
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8939frame duration will be &gt;= max(individual stream min
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8940durations)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8941 </td>
8942 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8943
8944
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8945 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8946 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8947
8948
8949 <tr class="entry" id="static_android.scaler.availableRawSizes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8950 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8951 android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Sizes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8952 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8953 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]8954 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8955 <span class="entry_type_container">x</span>
8956
8957 <span class="entry_type_array">
8958 n x 2
8959 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]8960 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8961
8962
8963 </td> <!-- entry_type -->
8964
8965 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]8966 <p>The resolutions available for use with raw
8967sensor output streams,<wbr/> listed as width,<wbr/>
8968height</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8969 </td>
8970
8971 <td class="entry_units">
8972 </td>
8973
8974 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]8975 <p>Must include: - sensor maximum resolution</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8976 </td>
8977
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8978 <td class="entry_tags">
8979 </td>
8980
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8981 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]8982
8983
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8984 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
8985 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8986
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8987
8988
8989 <!-- end of kind -->
8990 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]8991 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8992
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]8993 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]8994 <tr>
8995 <th class="th_name">Property Name</th>
8996 <th class="th_type">Type</th>
8997 <th class="th_description">Description</th>
8998 <th class="th_units">Units</th>
8999 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9000 <th class="th_tags">Tags</th>
9001 </tr>
9002 </thead>
9003
9004 <tbody>
9005
9006
9007
9008
9009
9010
9011
9012
9013
9014
9015 <tr class="entry" id="dynamic_android.scaler.cropRegion">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9016 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9017 android.<wbr/>scaler.<wbr/>crop<wbr/>Region
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9018 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9019 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9020 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9021 <span class="entry_type_container">x</span>
9022
9023 <span class="entry_type_array">
Eino-Ville Talvalae04ec6e2013-04-16 15:35:18 -0700[diff] [blame]9024 4
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9025 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9026 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9027
9028
9029 </td> <!-- entry_type -->
9030
9031 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9032 <p>(x,<wbr/> y,<wbr/> width,<wbr/> height).<wbr/></p>
9033<p>A rectangle with the top-level corner of (x,<wbr/>y) and size
9034(width,<wbr/> height).<wbr/> The region of the sensor that is used for
9035output.<wbr/> Each stream must use this rectangle to produce its
9036output,<wbr/> cropping to a smaller region if necessary to
9037maintain the stream's aspect ratio.<wbr/></p>
9038<p>HAL2.<wbr/>x uses only (x,<wbr/> y,<wbr/> width)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9039 </td>
9040
9041 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9042 (x,<wbr/>y) of top-left corner,<wbr/> width and height of region
9043 in pixels; (0,<wbr/>0) is top-left corner of
9044 android.<wbr/>sensor.<wbr/>active<wbr/>Array<wbr/>Size
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9045 </td>
9046
9047 <td class="entry_range">
9048 </td>
9049
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9050 <td class="entry_tags">
9051 <ul class="entry_tags">
9052 <li><a href="#tag_BC">BC</a></li>
9053 </ul>
9054 </td>
9055
9056 </tr>
9057 <tr class="entries_header">
9058 <th class="th_details" colspan="5">Details</th>
9059 </tr>
9060 <tr class="entry_cont">
9061 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9062 <p>Any additional per-stream cropping must be done to
9063maximize the final pixel area of the stream.<wbr/></p>
9064<p>For example,<wbr/> if the crop region is set to a 4:3 aspect
9065ratio,<wbr/> then 4:3 streams should use the exact crop
9066region.<wbr/> 16:9 streams should further crop vertically
9067(letterbox).<wbr/></p>
9068<p>Conversely,<wbr/> if the crop region is set to a 16:9,<wbr/> then 4:3
9069outputs should crop horizontally (pillarbox),<wbr/> and 16:9
9070streams should match exactly.<wbr/> These additional crops must
9071be centered within the crop region.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9072<p>The output streams must maintain square pixels at all
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9073times,<wbr/> no matter what the relative aspect ratios of the
9074crop region and the stream are.<wbr/> Negative values for
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9075corner are allowed for raw output if full pixel array is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9076larger than active pixel array.<wbr/> Width and height may be
9077rounded to nearest larger supportable width,<wbr/> especially
9078for raw output,<wbr/> where only a few fixed scales may be
9079possible.<wbr/> The width and height of the crop region cannot
9080be set to be smaller than floor( activeArraySize.<wbr/>width /<wbr/>
9081android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom ) and floor(
9082activeArraySize.<wbr/>height /<wbr/> android.<wbr/>scaler.<wbr/>max<wbr/>Digital<wbr/>Zoom),<wbr/>
9083respectively.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9084 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9085 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9086
9087
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9088 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9089 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9090
9091
9092
9093 <!-- end of kind -->
9094 </tbody>
9095
9096 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9097 <tr><td colspan="6" id="section_sensor" class="section">sensor</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9098
9099
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9100 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9101
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9102 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9103 <tr>
9104 <th class="th_name">Property Name</th>
9105 <th class="th_type">Type</th>
9106 <th class="th_description">Description</th>
9107 <th class="th_units">Units</th>
9108 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9109 <th class="th_tags">Tags</th>
9110 </tr>
9111 </thead>
9112
9113 <tbody>
9114
9115
9116
9117
9118
9119
9120
9121
9122
9123
9124 <tr class="entry" id="controls_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9125 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9126 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9127 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9128 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9129 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9130
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9131 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9132
9133
9134 </td> <!-- entry_type -->
9135
9136 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9137 <p>Duration each pixel is exposed to
9138light.<wbr/></p>
9139<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
9140duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9141 </td>
9142
9143 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9144 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9145 </td>
9146
9147 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9148 <p><a href="#static_android.sensor.info.exposureTimeRange">android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9149 </td>
9150
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9151 <td class="entry_tags">
9152 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9153 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9154 </ul>
9155 </td>
9156
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9157 </tr>
9158 <tr class="entries_header">
9159 <th class="th_details" colspan="5">Details</th>
9160 </tr>
9161 <tr class="entry_cont">
9162 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9163 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9164 </td>
9165 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9166
9167
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9168 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9169 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9170
9171
9172 <tr class="entry" id="controls_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9173 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9174 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9175 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9176 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9177 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9178
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9179 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9180
9181
9182 </td> <!-- entry_type -->
9183
9184 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9185 <p>Duration from start of frame exposure to
9186start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9187 </td>
9188
9189 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9190 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9191 </td>
9192
9193 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9194 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
9195android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9196 </td>
9197
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9198 <td class="entry_tags">
9199 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9200 <li><a href="#tag_V1">V1</a></li>
9201 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9202 </ul>
9203 </td>
9204
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9205 </tr>
9206 <tr class="entries_header">
9207 <th class="th_details" colspan="5">Details</th>
9208 </tr>
9209 <tr class="entry_cont">
9210 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9211 <p>Exposure time has priority,<wbr/> so duration is set to
9212max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9213 </td>
9214 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9215
9216
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9217 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9218 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9219
9220
9221 <tr class="entry" id="controls_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9222 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9223 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9224 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9225 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9226 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9227
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9228 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9229
9230
9231 </td> <!-- entry_type -->
9232
9233 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9234 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9235implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9236below 'maximum analog sensitivity'.<wbr/></p>
9237<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
9238gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9239 </td>
9240
9241 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9242 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9243 </td>
9244
9245 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9246 <p><a href="#static_android.sensor.info.sensitivityRange">android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9247 </td>
9248
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9249 <td class="entry_tags">
9250 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9251 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9252 </ul>
9253 </td>
9254
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9255 </tr>
9256 <tr class="entries_header">
9257 <th class="th_details" colspan="5">Details</th>
9258 </tr>
9259 <tr class="entry_cont">
9260 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9261 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9262 </td>
9263 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9264
9265
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9266 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9267 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9268
9269
9270
9271 <!-- end of kind -->
9272 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9273 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9274
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9275 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9276 <tr>
9277 <th class="th_name">Property Name</th>
9278 <th class="th_type">Type</th>
9279 <th class="th_description">Description</th>
9280 <th class="th_units">Units</th>
9281 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9282 <th class="th_tags">Tags</th>
9283 </tr>
9284 </thead>
9285
9286 <tbody>
9287
9288
9289
9290
9291
9292
9293
9294
9295
9296
9297
9298
9299 <tr class="entry" id="static_android.sensor.info.activeArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9300 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9301 android.<wbr/>sensor.<wbr/>info.<wbr/>active<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9302 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9303 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9304 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9305 <span class="entry_type_container">x</span>
9306
9307 <span class="entry_type_array">
9308 4
9309 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9310 <span class="entry_type_visibility"> [public as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9311 <div class="entry_type_notes">Four ints defining the active pixel rectangle</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9312
9313
9314 </td> <!-- entry_type -->
9315
9316 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9317 <p>Area of raw data which corresponds to only
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9318active pixels; smaller or equal to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9319pixelArraySize.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9320 </td>
9321
9322 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9323 xmin,<wbr/> ymin,<wbr/> width,<wbr/> height.<wbr/> Top left of full
9324 pixel array is (0,<wbr/>0)
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9325 </td>
9326
9327 <td class="entry_range">
9328 </td>
9329
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9330 <td class="entry_tags">
9331 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9332 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9333 </ul>
9334 </td>
9335
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9336 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9337
9338
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9339 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9340 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9341
9342
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9343 <tr class="entry" id="static_android.sensor.info.sensitivityRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9344 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9345 android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9346 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9347 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9348 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9349 <span class="entry_type_container">x</span>
9350
9351 <span class="entry_type_array">
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]9352 2
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9353 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9354 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9355 <div class="entry_type_notes">Range of supported sensitivities</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9356
9357
9358 </td> <!-- entry_type -->
9359
9360 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9361 <p>Range of valid sensitivities</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9362 </td>
9363
9364 <td class="entry_units">
9365 </td>
9366
9367 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9368 <p>Min &lt;= 100,<wbr/> Max &gt;= 1600</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9369 </td>
9370
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9371 <td class="entry_tags">
9372 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9373 <li><a href="#tag_BC">BC</a></li>
9374 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9375 </ul>
9376 </td>
9377
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9378 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9379
9380
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9381 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9382 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9383
9384
9385 <tr class="entry" id="static_android.sensor.info.colorFilterArrangement">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9386 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9387 android.<wbr/>sensor.<wbr/>info.<wbr/>color<wbr/>Filter<wbr/>Arrangement
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9388 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9389 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9390 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9391
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9392 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9393
9394 <ul class="entry_type_enum">
9395 <li>
9396 <span class="entry_type_enum_name">RGGB</span>
9397 </li>
9398 <li>
9399 <span class="entry_type_enum_name">GRBG</span>
9400 </li>
9401 <li>
9402 <span class="entry_type_enum_name">GBRG</span>
9403 </li>
9404 <li>
9405 <span class="entry_type_enum_name">BGGR</span>
9406 </li>
9407 <li>
9408 <span class="entry_type_enum_name">RGB</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9409 <span class="entry_type_enum_notes">Sensor is not Bayer; output has 3 16-bit
9410 values for each pixel,<wbr/> instead of just 1 16-bit value
9411 per pixel.<wbr/></span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9412 </li>
9413 </ul>
9414
9415 </td> <!-- entry_type -->
9416
9417 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9418 <p>Arrangement of color filters on sensor;
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]9419represents the colors in the top-left 2x2 section of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9420the sensor,<wbr/> in reading order</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9421 </td>
9422
9423 <td class="entry_units">
9424 </td>
9425
9426 <td class="entry_range">
9427 </td>
9428
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9429 <td class="entry_tags">
9430 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9431 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9432 </ul>
9433 </td>
9434
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9435 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9436
9437
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9438 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9439 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9440
9441
9442 <tr class="entry" id="static_android.sensor.info.exposureTimeRange">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9443 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9444 android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9445 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9446 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9447 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9448 <span class="entry_type_container">x</span>
9449
9450 <span class="entry_type_array">
9451 2
9452 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9453 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9454 <div class="entry_type_notes">nanoseconds</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9455
9456
9457 </td> <!-- entry_type -->
9458
9459 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9460 <p>Range of valid exposure
9461times</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9462 </td>
9463
9464 <td class="entry_units">
9465 </td>
9466
9467 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9468 <p>Min &lt;= 100e3 (100 us),<wbr/> Max &gt;= 30e9 (30
9469sec)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9470 </td>
9471
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9472 <td class="entry_tags">
9473 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9474 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9475 </ul>
9476 </td>
9477
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9478 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9479
9480
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9481 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9482 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9483
9484
9485 <tr class="entry" id="static_android.sensor.info.maxFrameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9486 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9487 android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9488 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9489 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9490 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9491
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9492 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9493
9494
9495 </td> <!-- entry_type -->
9496
9497 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9498 <p>Maximum possible frame duration (minimum frame
9499rate)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9500 </td>
9501
9502 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9503 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9504 </td>
9505
9506 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9507 <p>&gt;= 30e9</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9508 </td>
9509
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9510 <td class="entry_tags">
9511 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9512 <li><a href="#tag_BC">BC</a></li>
9513 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9514 </ul>
9515 </td>
9516
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9517 </tr>
9518 <tr class="entries_header">
9519 <th class="th_details" colspan="5">Details</th>
9520 </tr>
9521 <tr class="entry_cont">
9522 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9523 <p>Minimum duration is a function of resolution,<wbr/>
9524processing settings.<wbr/> See
9525android.<wbr/>scaler.<wbr/>available<wbr/>Processed<wbr/>Min<wbr/>Durations
9526android.<wbr/>scaler.<wbr/>available<wbr/>Jpeg<wbr/>Min<wbr/>Durations
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]9527<a href="#static_android.scaler.availableRawMinDurations">android.<wbr/>scaler.<wbr/>available<wbr/>Raw<wbr/>Min<wbr/>Durations</a></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9528 </td>
9529 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9530
9531
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9532 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9533 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9534
9535
9536 <tr class="entry" id="static_android.sensor.info.physicalSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9537 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9538 android.<wbr/>sensor.<wbr/>info.<wbr/>physical<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9539 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9540 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9541 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9542 <span class="entry_type_container">x</span>
9543
9544 <span class="entry_type_array">
9545 2
9546 </span>
Timothy Knightec817d52013-08-16 16:15:29 -0700[diff] [blame]9547 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9548 <div class="entry_type_notes">width x height in millimeters</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9549
9550
9551 </td> <!-- entry_type -->
9552
9553 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9554 <p>The physical dimensions of the full pixel
9555array</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9556 </td>
9557
9558 <td class="entry_units">
9559 </td>
9560
9561 <td class="entry_range">
9562 </td>
9563
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9564 <td class="entry_tags">
9565 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9566 <li><a href="#tag_V1">V1</a></li>
9567 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9568 </ul>
9569 </td>
9570
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9571 </tr>
9572 <tr class="entries_header">
9573 <th class="th_details" colspan="5">Details</th>
9574 </tr>
9575 <tr class="entry_cont">
9576 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9577 <p>Needed for FOV calculation for old API</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9578 </td>
9579 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9580
9581
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9582 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9583 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9584
9585
9586 <tr class="entry" id="static_android.sensor.info.pixelArraySize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9587 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9588 android.<wbr/>sensor.<wbr/>info.<wbr/>pixel<wbr/>Array<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9589 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9590 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9591 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9592 <span class="entry_type_container">x</span>
9593
9594 <span class="entry_type_array">
9595 2
9596 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]9597 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9598
9599
9600 </td> <!-- entry_type -->
9601
9602 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9603 <p>Dimensions of full pixel array,<wbr/> possibly
9604including black calibration pixels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9605 </td>
9606
9607 <td class="entry_units">
9608 </td>
9609
9610 <td class="entry_range">
9611 </td>
9612
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9613 <td class="entry_tags">
9614 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9615 <li><a href="#tag_DNG">DNG</a></li>
9616 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9617 </ul>
9618 </td>
9619
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9620 </tr>
9621 <tr class="entries_header">
9622 <th class="th_details" colspan="5">Details</th>
9623 </tr>
9624 <tr class="entry_cont">
9625 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9626 <p>Maximum output resolution for raw format must
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9627match this in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9628android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Sizes<wbr/>Per<wbr/>Format</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9629 </td>
9630 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9631
9632
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9633 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9634 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9635
9636
9637 <tr class="entry" id="static_android.sensor.info.whiteLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9638 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9639 android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9640 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9641 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9642 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9643
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9644 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9645
9646
9647 </td> <!-- entry_type -->
9648
9649 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9650 <p>Maximum raw value output by
9651sensor</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9652 </td>
9653
9654 <td class="entry_units">
9655 </td>
9656
9657 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9658 <p>&gt; 1024 (10-bit output)</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9659 </td>
9660
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9661 <td class="entry_tags">
9662 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9663 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9664 </ul>
9665 </td>
9666
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9667 </tr>
9668 <tr class="entries_header">
9669 <th class="th_details" colspan="5">Details</th>
9670 </tr>
9671 <tr class="entry_cont">
9672 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9673 <p>Defines sensor bit depth (10-14 bits is
9674expected)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9675 </td>
9676 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9677
9678
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9679 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9680 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9681
9682
9683
9684
9685
9686 <tr class="entry" id="static_android.sensor.baseGainFactor">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9687 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9688 android.<wbr/>sensor.<wbr/>base<wbr/>Gain<wbr/>Factor
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9689 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9690 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9691 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9692
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9693 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9694
9695
9696 </td> <!-- entry_type -->
9697
9698 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9699 <p>Gain factor from electrons to raw units when
9700ISO=100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9701 </td>
9702
9703 <td class="entry_units">
9704 </td>
9705
9706 <td class="entry_range">
9707 </td>
9708
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9709 <td class="entry_tags">
9710 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9711 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]9712 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9713 </ul>
9714 </td>
9715
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9716 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9717
9718
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9719 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9720 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9721
9722
9723 <tr class="entry" id="static_android.sensor.blackLevelPattern">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9724 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9725 android.<wbr/>sensor.<wbr/>black<wbr/>Level<wbr/>Pattern
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9726 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9727 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9728 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9729 <span class="entry_type_container">x</span>
9730
9731 <span class="entry_type_array">
9732 4
9733 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9734 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9735 <div class="entry_type_notes">2x2 raw count block</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9736
9737
9738 </td> <!-- entry_type -->
9739
9740 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9741 <p>A fixed black level offset for each of the
9742Bayer mosaic channels</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9743 </td>
9744
9745 <td class="entry_units">
9746 </td>
9747
9748 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]9749 <p>&gt;= 0 each</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9750 </td>
9751
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9752 <td class="entry_tags">
9753 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9754 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9755 </ul>
9756 </td>
9757
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9758 </tr>
9759 <tr class="entries_header">
9760 <th class="th_details" colspan="5">Details</th>
9761 </tr>
9762 <tr class="entry_cont">
9763 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9764 <p>As per DNG BlackLevelRepeatDim /<wbr/> BlackLevel
9765tags</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9766 </td>
9767 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9768
9769
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9770 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9771 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9772
9773
9774 <tr class="entry" id="static_android.sensor.calibrationTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9775 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9776 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9777 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9778 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9779 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9780 <span class="entry_type_container">x</span>
9781
9782 <span class="entry_type_array">
9783 9
9784 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9785 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9786 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9787
9788
9789 </td> <!-- entry_type -->
9790
9791 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9792 <p>Per-device calibration on top of color space
9793transform 1</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9794 </td>
9795
9796 <td class="entry_units">
9797 </td>
9798
9799 <td class="entry_range">
9800 </td>
9801
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9802 <td class="entry_tags">
9803 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9804 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9805 </ul>
9806 </td>
9807
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9808 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9809
9810
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9811 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9812 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9813
9814
9815 <tr class="entry" id="static_android.sensor.calibrationTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9816 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9817 android.<wbr/>sensor.<wbr/>calibration<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9818 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9819 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9820 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9821 <span class="entry_type_container">x</span>
9822
9823 <span class="entry_type_array">
9824 9
9825 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9826 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9827 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9828
9829
9830 </td> <!-- entry_type -->
9831
9832 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9833 <p>Per-device calibration on top of color space
9834transform 2</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9835 </td>
9836
9837 <td class="entry_units">
9838 </td>
9839
9840 <td class="entry_range">
9841 </td>
9842
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9843 <td class="entry_tags">
9844 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9845 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9846 </ul>
9847 </td>
9848
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9849 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9850
9851
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9852 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9853 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9854
9855
9856 <tr class="entry" id="static_android.sensor.colorTransform1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9857 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9858 android.<wbr/>sensor.<wbr/>color<wbr/>Transform1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9859 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9860 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9861 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9862 <span class="entry_type_container">x</span>
9863
9864 <span class="entry_type_array">
9865 9
9866 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9867 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9868 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9869
9870
9871 </td> <!-- entry_type -->
9872
9873 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9874 <p>Linear mapping from XYZ (D50) color space to
9875reference linear sensor color,<wbr/> for first reference
9876illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9877 </td>
9878
9879 <td class="entry_units">
9880 </td>
9881
9882 <td class="entry_range">
9883 </td>
9884
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9885 <td class="entry_tags">
9886 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9887 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9888 </ul>
9889 </td>
9890
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9891 </tr>
9892 <tr class="entries_header">
9893 <th class="th_details" colspan="5">Details</th>
9894 </tr>
9895 <tr class="entry_cont">
9896 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9897 <p>Use as follows XYZ = inv(transform) * clip( (raw -
9898black level(raw) ) /<wbr/> ( white level - max black level) ).<wbr/>
9899At least in the simple case</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9900 </td>
9901 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9902
9903
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9904 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9905 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9906
9907
9908 <tr class="entry" id="static_android.sensor.colorTransform2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9909 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9910 android.<wbr/>sensor.<wbr/>color<wbr/>Transform2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9911 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9912 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9913 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9914 <span class="entry_type_container">x</span>
9915
9916 <span class="entry_type_array">
9917 9
9918 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9919 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9920 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9921
9922
9923 </td> <!-- entry_type -->
9924
9925 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9926 <p>Linear mapping from XYZ (D50) color space to
9927reference linear sensor color,<wbr/> for second reference
9928illuminant</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9929 </td>
9930
9931 <td class="entry_units">
9932 </td>
9933
9934 <td class="entry_range">
9935 </td>
9936
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9937 <td class="entry_tags">
9938 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9939 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9940 </ul>
9941 </td>
9942
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9943 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9944
9945
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9946 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9947 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9948
9949
9950 <tr class="entry" id="static_android.sensor.forwardMatrix1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9951 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9952 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9953 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9954 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9955 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9956 <span class="entry_type_container">x</span>
9957
9958 <span class="entry_type_array">
9959 9
9960 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]9961 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9962 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9963
9964
9965 </td> <!-- entry_type -->
9966
9967 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9968 <p>Used by DNG for better WB
9969adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9970 </td>
9971
9972 <td class="entry_units">
9973 </td>
9974
9975 <td class="entry_range">
9976 </td>
9977
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9978 <td class="entry_tags">
9979 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]9980 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9981 </ul>
9982 </td>
9983
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9984 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9985
9986
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]9987 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
9988 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9989
9990
9991 <tr class="entry" id="static_android.sensor.forwardMatrix2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9992 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]9993 android.<wbr/>sensor.<wbr/>forward<wbr/>Matrix2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]9994 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9995 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]9996 <span class="entry_type_name">rational</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]9997 <span class="entry_type_container">x</span>
9998
9999 <span class="entry_type_array">
10000 9
10001 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10002 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10003 <div class="entry_type_notes">3x3 matrix in row-major-order</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10004
10005
10006 </td> <!-- entry_type -->
10007
10008 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10009 <p>Used by DNG for better WB
10010adaptation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10011 </td>
10012
10013 <td class="entry_units">
10014 </td>
10015
10016 <td class="entry_range">
10017 </td>
10018
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10019 <td class="entry_tags">
10020 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10021 <li><a href="#tag_DNG">DNG</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10022 </ul>
10023 </td>
10024
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10025 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10026
10027
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10028 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10029 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10030
10031
10032 <tr class="entry" id="static_android.sensor.maxAnalogSensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10033 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10034 android.<wbr/>sensor.<wbr/>max<wbr/>Analog<wbr/>Sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10035 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10036 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10037 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10038
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10039 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10040
10041
10042 </td> <!-- entry_type -->
10043
10044 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10045 <p>Maximum sensitivity that is implemented
10046purely through analog gain</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10047 </td>
10048
10049 <td class="entry_units">
10050 </td>
10051
10052 <td class="entry_range">
10053 </td>
10054
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10055 <td class="entry_tags">
10056 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10057 <li><a href="#tag_V1">V1</a></li>
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10058 <li><a href="#tag_FULL">FULL</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10059 </ul>
10060 </td>
10061
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10062 </tr>
10063 <tr class="entries_header">
10064 <th class="th_details" colspan="5">Details</th>
10065 </tr>
10066 <tr class="entry_cont">
10067 <td class="entry_details" colspan="5">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10068 <p>For <a href="#controls_android.sensor.sensitivity">android.<wbr/>sensor.<wbr/>sensitivity</a> values less than or
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10069equal to this,<wbr/> all applied gain must be analog.<wbr/> For
10070values above this,<wbr/> it can be a mix of analog and
10071digital</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10072 </td>
10073 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10074
10075
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10076 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10077 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10078
10079
10080 <tr class="entry" id="static_android.sensor.noiseModelCoefficients">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10081 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10082 android.<wbr/>sensor.<wbr/>noise<wbr/>Model<wbr/>Coefficients
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10083 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10084 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10085 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10086 <span class="entry_type_container">x</span>
10087
10088 <span class="entry_type_array">
10089 2
10090 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10091 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10092 <div class="entry_type_notes">float constants A,<wbr/> B for the noise variance model</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10093
10094
10095 </td> <!-- entry_type -->
10096
10097 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10098 <p>Estimation of sensor noise
10099characteristics</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10100 </td>
10101
10102 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10103 var(raw pixel value) = electrons * (baseGainFactor
10104 * iso/<wbr/>100)^2 + A * (baseGainFactor * iso/<wbr/>100)^2 +
10105 B
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10106 </td>
10107
10108 <td class="entry_range">
10109 </td>
10110
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10111 <td class="entry_tags">
10112 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10113 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10114 </ul>
10115 </td>
10116
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10117 </tr>
10118 <tr class="entries_header">
10119 <th class="th_details" colspan="5">Details</th>
10120 </tr>
10121 <tr class="entry_cont">
10122 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10123 <p>A represents sensor read noise before analog
10124amplification; B represents noise from A/<wbr/>D conversion and
10125other circuits after amplification.<wbr/> Both noise sources
10126are assumed to be gaussian,<wbr/> independent,<wbr/> and not to vary
10127across the sensor</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10128 </td>
10129 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10130
10131
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10132 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10133 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10134
10135
10136 <tr class="entry" id="static_android.sensor.orientation">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10137 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10138 android.<wbr/>sensor.<wbr/>orientation
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10139 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10140 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10141 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10142
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10143 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10144
10145
10146 </td> <!-- entry_type -->
10147
10148 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10149 <p>Clockwise angle through which the output
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10150image needs to be rotated to be upright on the device
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10151screen in its native orientation.<wbr/> Also defines the
10152direction of rolling shutter readout,<wbr/> which is from top
10153to bottom in the sensor's coordinate system</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10154 </td>
10155
10156 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10157 degrees clockwise rotation,<wbr/> only multiples of
10158 90
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10159 </td>
10160
10161 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10162 <p>0,<wbr/>90,<wbr/>180,<wbr/>270</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10163 </td>
10164
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10165 <td class="entry_tags">
10166 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10167 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10168 </ul>
10169 </td>
10170
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10171 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10172
10173
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10174 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10175 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10176
10177
10178 <tr class="entry" id="static_android.sensor.referenceIlluminant1">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10179 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10180 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant1
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10181 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10182 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10183 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10184
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10185 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10186
10187 <ul class="entry_type_enum">
10188 <li>
10189 <span class="entry_type_enum_name">DAYLIGHT</span>
10190 <span class="entry_type_enum_value">1</span>
10191 </li>
10192 <li>
10193 <span class="entry_type_enum_name">FLUORESCENT</span>
10194 <span class="entry_type_enum_value">2</span>
10195 </li>
10196 <li>
10197 <span class="entry_type_enum_name">TUNGSTEN</span>
10198 <span class="entry_type_enum_value">3</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10199 <span class="entry_type_enum_notes">Incandescent light</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10200 </li>
10201 <li>
10202 <span class="entry_type_enum_name">FLASH</span>
10203 <span class="entry_type_enum_value">4</span>
10204 </li>
10205 <li>
10206 <span class="entry_type_enum_name">FINE_WEATHER</span>
10207 <span class="entry_type_enum_value">9</span>
10208 </li>
10209 <li>
10210 <span class="entry_type_enum_name">CLOUDY_WEATHER</span>
10211 <span class="entry_type_enum_value">10</span>
10212 </li>
10213 <li>
10214 <span class="entry_type_enum_name">SHADE</span>
10215 <span class="entry_type_enum_value">11</span>
10216 </li>
10217 <li>
10218 <span class="entry_type_enum_name">DAYLIGHT_FLUORESCENT</span>
10219 <span class="entry_type_enum_value">12</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10220 <span class="entry_type_enum_notes">D 5700 - 7100K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10221 </li>
10222 <li>
10223 <span class="entry_type_enum_name">DAY_WHITE_FLUORESCENT</span>
10224 <span class="entry_type_enum_value">13</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10225 <span class="entry_type_enum_notes">N 4600 - 5400K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10226 </li>
10227 <li>
10228 <span class="entry_type_enum_name">COOL_WHITE_FLUORESCENT</span>
10229 <span class="entry_type_enum_value">14</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10230 <span class="entry_type_enum_notes">W 3900 - 4500K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10231 </li>
10232 <li>
10233 <span class="entry_type_enum_name">WHITE_FLUORESCENT</span>
10234 <span class="entry_type_enum_value">15</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10235 <span class="entry_type_enum_notes">WW 3200 - 3700K</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10236 </li>
10237 <li>
10238 <span class="entry_type_enum_name">STANDARD_A</span>
10239 <span class="entry_type_enum_value">17</span>
10240 </li>
10241 <li>
10242 <span class="entry_type_enum_name">STANDARD_B</span>
10243 <span class="entry_type_enum_value">18</span>
10244 </li>
10245 <li>
10246 <span class="entry_type_enum_name">STANDARD_C</span>
10247 <span class="entry_type_enum_value">19</span>
10248 </li>
10249 <li>
10250 <span class="entry_type_enum_name">D55</span>
10251 <span class="entry_type_enum_value">20</span>
10252 </li>
10253 <li>
10254 <span class="entry_type_enum_name">D65</span>
10255 <span class="entry_type_enum_value">21</span>
10256 </li>
10257 <li>
10258 <span class="entry_type_enum_name">D75</span>
10259 <span class="entry_type_enum_value">22</span>
10260 </li>
10261 <li>
10262 <span class="entry_type_enum_name">D50</span>
10263 <span class="entry_type_enum_value">23</span>
10264 </li>
10265 <li>
10266 <span class="entry_type_enum_name">ISO_STUDIO_TUNGSTEN</span>
10267 <span class="entry_type_enum_value">24</span>
10268 </li>
10269 </ul>
10270
10271 </td> <!-- entry_type -->
10272
10273 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10274 <p>Light source used to define transform
102751</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10276 </td>
10277
10278 <td class="entry_units">
10279 </td>
10280
10281 <td class="entry_range">
10282 </td>
10283
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10284 <td class="entry_tags">
10285 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10286 <li><a href="#tag_DNG">DNG</a></li>
10287 <li><a href="#tag_EXIF">EXIF</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10288 </ul>
10289 </td>
10290
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10291 </tr>
10292 <tr class="entries_header">
10293 <th class="th_details" colspan="5">Details</th>
10294 </tr>
10295 <tr class="entry_cont">
10296 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10297 <p>[EXIF LightSource tag] Must all these be
10298supported? Need CCT for each!</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10299 </td>
10300 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10301
10302
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10303 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10304 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10305
10306
10307 <tr class="entry" id="static_android.sensor.referenceIlluminant2">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10308 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10309 android.<wbr/>sensor.<wbr/>reference<wbr/>Illuminant2
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10310 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10311 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10312 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10313
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10314 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10315
10316
10317 </td> <!-- entry_type -->
10318
10319 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10320 <p>Light source used to define transform
103212</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10322 </td>
10323
10324 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10325 Same as illuminant 1
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10326 </td>
10327
10328 <td class="entry_range">
10329 </td>
10330
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10331 <td class="entry_tags">
10332 </td>
10333
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10334 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10335
10336
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10337 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10338 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10339
10340
10341
10342 <!-- end of kind -->
10343 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10344 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10345
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10346 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10347 <tr>
10348 <th class="th_name">Property Name</th>
10349 <th class="th_type">Type</th>
10350 <th class="th_description">Description</th>
10351 <th class="th_units">Units</th>
10352 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10353 <th class="th_tags">Tags</th>
10354 </tr>
10355 </thead>
10356
10357 <tbody>
10358
10359
10360
10361
10362
10363
10364
10365
10366
10367
10368 <tr class="entry" id="dynamic_android.sensor.exposureTime">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10369 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10370 android.<wbr/>sensor.<wbr/>exposure<wbr/>Time
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10371 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10372 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10373 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10374
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10375 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10376
10377
10378 </td> <!-- entry_type -->
10379
10380 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10381 <p>Duration each pixel is exposed to
10382light.<wbr/></p>
10383<p>If the sensor can't expose this exact duration,<wbr/> it should shorten the
10384duration exposed to the nearest possible value (rather than expose longer).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10385 </td>
10386
10387 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10388 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10389 </td>
10390
10391 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10392 <p><a href="#static_android.sensor.info.exposureTimeRange">android.<wbr/>sensor.<wbr/>info.<wbr/>exposure<wbr/>Time<wbr/>Range</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10393 </td>
10394
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10395 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10396 <ul class="entry_tags">
10397 <li><a href="#tag_V1">V1</a></li>
10398 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10399 </td>
10400
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10401 </tr>
10402 <tr class="entries_header">
10403 <th class="th_details" colspan="5">Details</th>
10404 </tr>
10405 <tr class="entry_cont">
10406 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10407 <p>1/<wbr/>10000 - 30 sec range.<wbr/> No bulb mode</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10408 </td>
10409 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10410
10411
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10412 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10413 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10414
10415
10416 <tr class="entry" id="dynamic_android.sensor.frameDuration">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10417 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10418 android.<wbr/>sensor.<wbr/>frame<wbr/>Duration
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10419 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10420 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10421 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10422
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10423 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10424
10425
10426 </td> <!-- entry_type -->
10427
10428 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10429 <p>Duration from start of frame exposure to
10430start of next frame exposure</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10431 </td>
10432
10433 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10434 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10435 </td>
10436
10437 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10438 <p>see <a href="#static_android.sensor.info.maxFrameDuration">android.<wbr/>sensor.<wbr/>info.<wbr/>max<wbr/>Frame<wbr/>Duration</a>,<wbr/>
10439android.<wbr/>scaler.<wbr/>info.<wbr/>available<wbr/>Min<wbr/>Frame<wbr/>Durations</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10440 </td>
10441
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10442 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10443 <ul class="entry_tags">
10444 <li><a href="#tag_V1">V1</a></li>
10445 <li><a href="#tag_BC">BC</a></li>
10446 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10447 </td>
10448
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10449 </tr>
10450 <tr class="entries_header">
10451 <th class="th_details" colspan="5">Details</th>
10452 </tr>
10453 <tr class="entry_cont">
10454 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10455 <p>Exposure time has priority,<wbr/> so duration is set to
10456max(duration,<wbr/> exposure time + overhead)</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10457 </td>
10458 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10459
10460
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10461 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10462 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10463
10464
10465 <tr class="entry" id="dynamic_android.sensor.sensitivity">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10466 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10467 android.<wbr/>sensor.<wbr/>sensitivity
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10468 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10469 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10470 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10471
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10472 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10473
10474
10475 </td> <!-- entry_type -->
10476
10477 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10478 <p>Gain applied to image data.<wbr/> Must be
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]10479implemented through analog gain only if set to values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10480below 'maximum analog sensitivity'.<wbr/></p>
10481<p>If the sensor can't apply this exact gain,<wbr/> it should lessen the
10482gain to the nearest possible value (rather than gain more).<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10483 </td>
10484
10485 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10486 ISO arithmetic units
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10487 </td>
10488
10489 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10490 <p><a href="#static_android.sensor.info.sensitivityRange">android.<wbr/>sensor.<wbr/>info.<wbr/>sensitivity<wbr/>Range</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10491 </td>
10492
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10493 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10494 <ul class="entry_tags">
10495 <li><a href="#tag_V1">V1</a></li>
10496 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10497 </td>
10498
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10499 </tr>
10500 <tr class="entries_header">
10501 <th class="th_details" colspan="5">Details</th>
10502 </tr>
10503 <tr class="entry_cont">
10504 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10505 <p>ISO 12232:2006 REI method</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10506 </td>
10507 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10508
10509
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10510 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10511 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10512
10513
10514 <tr class="entry" id="dynamic_android.sensor.timestamp">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10515 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10516 android.<wbr/>sensor.<wbr/>timestamp
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10517 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10518 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10519 <span class="entry_type_name">int64</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10520
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10521 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10522
10523
10524 </td> <!-- entry_type -->
10525
10526 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10527 <p>Time at start of exposure of first
10528row</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10529 </td>
10530
10531 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10532 nanoseconds
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10533 </td>
10534
10535 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]10536 <p>&gt; 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10537 </td>
10538
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10539 <td class="entry_tags">
10540 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10541 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10542 </ul>
10543 </td>
10544
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10545 </tr>
10546 <tr class="entries_header">
10547 <th class="th_details" colspan="5">Details</th>
10548 </tr>
10549 <tr class="entry_cont">
10550 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10551 <p>Monotonic,<wbr/> should be synced to other timestamps in
10552system</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10553 </td>
10554 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10555
10556
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10557 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10558 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10559
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10560
10561 <tr class="entry" id="dynamic_android.sensor.temperature">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10562 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10563 android.<wbr/>sensor.<wbr/>temperature
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10564 </td>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10565 <td class="entry_type">
10566 <span class="entry_type_name">float</span>
10567
10568 <span class="entry_type_visibility"> [public]</span>
10569
10570
10571 </td> <!-- entry_type -->
10572
10573 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10574 <p>The temperature of the sensor,<wbr/> sampled at the time
10575exposure began for this frame.<wbr/></p>
10576<p>The thermal diode being queried should be inside the sensor PCB,<wbr/> or
10577somewhere close to it.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10578 </td>
10579
10580 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10581 celsius
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10582 </td>
10583
10584 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10585 <p>Optional.<wbr/> This value is missing if no temperature is available.<wbr/></p>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10586 </td>
10587
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10588 <td class="entry_tags">
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]10589 <ul class="entry_tags">
10590 <li><a href="#tag_FULL">FULL</a></li>
10591 </ul>
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10592 </td>
10593
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10594 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10595
10596
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10597 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10598 <!-- end of entry -->
Igor Murashkin656aa5a2013-08-13 14:23:39 -0700[diff] [blame]10599
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10600
10601
10602 <!-- end of kind -->
10603 </tbody>
10604
10605 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10606 <tr><td colspan="6" id="section_shading" class="section">shading</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10607
10608
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10609 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10610
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10611 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10612 <tr>
10613 <th class="th_name">Property Name</th>
10614 <th class="th_type">Type</th>
10615 <th class="th_description">Description</th>
10616 <th class="th_units">Units</th>
10617 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10618 <th class="th_tags">Tags</th>
10619 </tr>
10620 </thead>
10621
10622 <tbody>
10623
10624
10625
10626
10627
10628
10629
10630
10631
10632
10633 <tr class="entry" id="controls_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10634 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10635 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10636 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10637 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10638 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10639
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10640 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10641
10642 <ul class="entry_type_enum">
10643 <li>
10644 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10645 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10646 </li>
10647 <li>
10648 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10649 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10650 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10651 </li>
10652 <li>
10653 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10654 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10655 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10656 </li>
10657 </ul>
10658
10659 </td> <!-- entry_type -->
10660
10661 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10662 <p>Quality of lens shading correction applied
10663to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10664 </td>
10665
10666 <td class="entry_units">
10667 </td>
10668
10669 <td class="entry_range">
10670 </td>
10671
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10672 <td class="entry_tags">
10673 </td>
10674
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10675 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10676
10677
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10678 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10679 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10680
10681
10682 <tr class="entry" id="controls_android.shading.strength">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10683 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10684 android.<wbr/>shading.<wbr/>strength
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10685 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10686 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10687 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10688
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10689 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10690
10691
10692 </td> <!-- entry_type -->
10693
10694 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10695 <p>Control the amount of shading correction
10696applied to the images</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10697 </td>
10698
10699 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10700 unitless: 1-10; 10 is full shading
10701 compensation
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10702 </td>
10703
10704 <td class="entry_range">
10705 </td>
10706
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10707 <td class="entry_tags">
10708 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10709 <li><a href="#tag_ADV">ADV</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10710 </ul>
10711 </td>
10712
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10713 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10714
10715
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10716 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10717 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10718
10719
10720
10721 <!-- end of kind -->
10722 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10723 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10724
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10725 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10726 <tr>
10727 <th class="th_name">Property Name</th>
10728 <th class="th_type">Type</th>
10729 <th class="th_description">Description</th>
10730 <th class="th_units">Units</th>
10731 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10732 <th class="th_tags">Tags</th>
10733 </tr>
10734 </thead>
10735
10736 <tbody>
10737
10738
10739
10740
10741
10742
10743
10744
10745
10746
10747 <tr class="entry" id="dynamic_android.shading.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10748 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10749 android.<wbr/>shading.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10750 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10751 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10752 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10753
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10754 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10755
10756 <ul class="entry_type_enum">
10757 <li>
10758 <span class="entry_type_enum_name">OFF</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10759 <span class="entry_type_enum_notes">No shading correction is applied</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10760 </li>
10761 <li>
10762 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10763 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
10764 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10765 </li>
10766 <li>
10767 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10768 <span class="entry_type_enum_notes">Frame rate may be reduced by high
10769 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10770 </li>
10771 </ul>
10772
10773 </td> <!-- entry_type -->
10774
10775 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10776 <p>Quality of lens shading correction applied
10777to the image data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10778 </td>
10779
10780 <td class="entry_units">
10781 </td>
10782
10783 <td class="entry_range">
10784 </td>
10785
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10786 <td class="entry_tags">
10787 </td>
10788
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10789 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10790
10791
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10792 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10793 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10794
10795
10796
10797 <!-- end of kind -->
10798 </tbody>
10799
10800 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10801 <tr><td colspan="6" id="section_statistics" class="section">statistics</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10802
10803
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10804 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10805
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10806 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10807 <tr>
10808 <th class="th_name">Property Name</th>
10809 <th class="th_type">Type</th>
10810 <th class="th_description">Description</th>
10811 <th class="th_units">Units</th>
10812 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]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="controls_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10829 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10830 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10831 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10832 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10833 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10834
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]10835 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10836
10837 <ul class="entry_type_enum">
10838 <li>
10839 <span class="entry_type_enum_name">OFF</span>
10840 </li>
10841 <li>
10842 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10843 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
10844 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10845 </li>
10846 <li>
10847 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10848 <span class="entry_type_enum_notes">Optional Return all face
10849 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10850 </li>
10851 </ul>
10852
10853 </td> <!-- entry_type -->
10854
10855 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10856 <p>State of the face detector
10857unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10858 </td>
10859
10860 <td class="entry_units">
10861 </td>
10862
10863 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10864 <p><a href="#static_android.statistics.info.availableFaceDetectModes">android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10865 </td>
10866
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10867 <td class="entry_tags">
10868 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10869 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10870 </ul>
10871 </td>
10872
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10873 </tr>
10874 <tr class="entries_header">
10875 <th class="th_details" colspan="5">Details</th>
10876 </tr>
10877 <tr class="entry_cont">
10878 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10879 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10880should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10881fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]10882<a href="#static_android.statistics.info.availableFaceDetectModes">android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes</a>.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10883 </td>
10884 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10885
10886
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10887 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10888 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10889
10890
10891 <tr class="entry" id="controls_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10892 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10893 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10894 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10895 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10896 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10897
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10898 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10899
10900 <ul class="entry_type_enum">
10901 <li>
10902 <span class="entry_type_enum_name">OFF</span>
10903 </li>
10904 <li>
10905 <span class="entry_type_enum_name">ON</span>
10906 </li>
10907 </ul>
10908
10909 </td> <!-- entry_type -->
10910
10911 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10912 <p>Operating mode for histogram
10913generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10914 </td>
10915
10916 <td class="entry_units">
10917 </td>
10918
10919 <td class="entry_range">
10920 </td>
10921
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10922 <td class="entry_tags">
10923 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10924 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10925 </ul>
10926 </td>
10927
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10928 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10929
10930
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10931 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10932 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10933
10934
10935 <tr class="entry" id="controls_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10936 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10937 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10938 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10939 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]10940 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10941
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]10942 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10943
10944 <ul class="entry_type_enum">
10945 <li>
10946 <span class="entry_type_enum_name">OFF</span>
10947 </li>
10948 <li>
10949 <span class="entry_type_enum_name">ON</span>
10950 </li>
10951 </ul>
10952
10953 </td> <!-- entry_type -->
10954
10955 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10956 <p>Operating mode for sharpness map
10957generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10958 </td>
10959
10960 <td class="entry_units">
10961 </td>
10962
10963 <td class="entry_range">
10964 </td>
10965
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10966 <td class="entry_tags">
10967 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]10968 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10969 </ul>
10970 </td>
10971
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10972 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10973
10974
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]10975 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
10976 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]10977
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10978
10979 <tr class="entry" id="controls_android.statistics.lensShadingMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10980 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]10981 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]10982 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]10983 <td class="entry_type">
10984 <span class="entry_type_name entry_type_name_enum">byte</span>
10985
10986 <span class="entry_type_visibility"> [public]</span>
10987
10988 <ul class="entry_type_enum">
10989 <li>
10990 <span class="entry_type_enum_name">OFF</span>
10991 </li>
10992 <li>
10993 <span class="entry_type_enum_name">ON</span>
10994 </li>
10995 </ul>
10996
10997 </td> <!-- entry_type -->
10998
10999 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11000 <p>Whether the HAL needs to output the lens
11001shading map in output result metadata</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11002 </td>
11003
11004 <td class="entry_units">
11005 </td>
11006
11007 <td class="entry_range">
11008 </td>
11009
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11010 <td class="entry_tags">
11011 </td>
11012
11013 </tr>
11014 <tr class="entries_header">
11015 <th class="th_details" colspan="5">Details</th>
11016 </tr>
11017 <tr class="entry_cont">
11018 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11019 <p>When set to ON,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11020<a href="#dynamic_android.statistics.lensShadingMap">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map</a> must be provided in
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11021the output result metadata.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11022 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11023 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11024
11025
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11026 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11027 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11028
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11029
11030
11031 <!-- end of kind -->
11032 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11033 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11034
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11035 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11036 <tr>
11037 <th class="th_name">Property Name</th>
11038 <th class="th_type">Type</th>
11039 <th class="th_description">Description</th>
11040 <th class="th_units">Units</th>
11041 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11042 <th class="th_tags">Tags</th>
11043 </tr>
11044 </thead>
11045
11046 <tbody>
11047
11048
11049
11050
11051
11052
11053
11054
11055
11056
11057
11058
11059 <tr class="entry" id="static_android.statistics.info.availableFaceDetectModes">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11060 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11061 android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11062 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11063 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11064 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11065 <span class="entry_type_container">x</span>
11066
11067 <span class="entry_type_array">
11068 n
11069 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11070 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11071 <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]11072
11073
11074 </td> <!-- entry_type -->
11075
11076 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11077 <p>Which face detection modes are available,<wbr/>
11078if any</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11079 </td>
11080
11081 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11082 List of enum:
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11083 OFF
11084 SIMPLE
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11085 FULL
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11086 </td>
11087
11088 <td class="entry_range">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11089 </td>
11090
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11091 <td class="entry_tags">
11092 </td>
11093
11094 </tr>
11095 <tr class="entries_header">
11096 <th class="th_details" colspan="5">Details</th>
11097 </tr>
11098 <tr class="entry_cont">
11099 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11100 <p>OFF means face detection is disabled,<wbr/> it must
11101be included in the list.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11102<p>SIMPLE means the device supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11103<a href="#dynamic_android.statistics.faceRectangles">android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles</a> and
11104<a href="#dynamic_android.statistics.faceScores">android.<wbr/>statistics.<wbr/>face<wbr/>Scores</a> outputs.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11105<p>FULL means the device additionally supports the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11106<a href="#dynamic_android.statistics.faceIds">android.<wbr/>statistics.<wbr/>face<wbr/>Ids</a> and
11107<a href="#dynamic_android.statistics.faceLandmarks">android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks</a> outputs.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11108 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11109 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11110
11111
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11112 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11113 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11114
11115
11116 <tr class="entry" id="static_android.statistics.info.histogramBucketCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11117 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11118 android.<wbr/>statistics.<wbr/>info.<wbr/>histogram<wbr/>Bucket<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11119 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11120 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11121 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11122
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11123 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11124
11125
11126 </td> <!-- entry_type -->
11127
11128 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11129 <p>Number of histogram buckets
11130supported</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11131 </td>
11132
11133 <td class="entry_units">
11134 </td>
11135
11136 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11137 <p>&gt;= 64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11138 </td>
11139
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11140 <td class="entry_tags">
11141 </td>
11142
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11143 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11144
11145
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11146 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11147 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11148
11149
11150 <tr class="entry" id="static_android.statistics.info.maxFaceCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11151 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11152 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Face<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11153 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11154 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11155 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11156
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11157 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11158
11159
11160 </td> <!-- entry_type -->
11161
11162 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11163 <p>Maximum number of simultaneously detectable
11164faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11165 </td>
11166
11167 <td class="entry_units">
11168 </td>
11169
11170 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]11171 <p>&gt;= 4 if availableFaceDetectionModes lists
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11172modes besides OFF,<wbr/> otherwise 0</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11173 </td>
11174
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11175 <td class="entry_tags">
11176 </td>
11177
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11178 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11179
11180
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11181 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11182 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11183
11184
11185 <tr class="entry" id="static_android.statistics.info.maxHistogramCount">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11186 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11187 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Histogram<wbr/>Count
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11188 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11189 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11190 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11191
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11192 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11193
11194
11195 </td> <!-- entry_type -->
11196
11197 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11198 <p>Maximum value possible for a histogram
11199bucket</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11200 </td>
11201
11202 <td class="entry_units">
11203 </td>
11204
11205 <td class="entry_range">
11206 </td>
11207
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11208 <td class="entry_tags">
11209 </td>
11210
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11211 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11212
11213
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11214 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11215 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11216
11217
11218 <tr class="entry" id="static_android.statistics.info.maxSharpnessMapValue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11219 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11220 android.<wbr/>statistics.<wbr/>info.<wbr/>max<wbr/>Sharpness<wbr/>Map<wbr/>Value
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11221 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11222 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11223 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11224
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11225 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11226
11227
11228 </td> <!-- entry_type -->
11229
11230 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11231 <p>Maximum value possible for a sharpness map
11232region.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11233 </td>
11234
11235 <td class="entry_units">
11236 </td>
11237
11238 <td class="entry_range">
11239 </td>
11240
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11241 <td class="entry_tags">
11242 </td>
11243
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11244 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11245
11246
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11247 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11248 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11249
11250
11251 <tr class="entry" id="static_android.statistics.info.sharpnessMapSize">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11252 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11253 android.<wbr/>statistics.<wbr/>info.<wbr/>sharpness<wbr/>Map<wbr/>Size
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11254 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11255 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11256 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11257 <span class="entry_type_container">x</span>
11258
11259 <span class="entry_type_array">
11260 2
11261 </span>
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11262 <span class="entry_type_visibility"> [system as size]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11263 <div class="entry_type_notes">width x height</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11264
11265
11266 </td> <!-- entry_type -->
11267
11268 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11269 <p>Dimensions of the sharpness
11270map</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11271 </td>
11272
11273 <td class="entry_units">
11274 </td>
11275
11276 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11277 <p>Must be at least 32 x 32</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11278 </td>
11279
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11280 <td class="entry_tags">
11281 </td>
11282
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11283 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11284
11285
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11286 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11287 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11288
11289
11290
11291
11292
11293
11294 <!-- end of kind -->
11295 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11296 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11297
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11298 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11299 <tr>
11300 <th class="th_name">Property Name</th>
11301 <th class="th_type">Type</th>
11302 <th class="th_description">Description</th>
11303 <th class="th_units">Units</th>
11304 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11305 <th class="th_tags">Tags</th>
11306 </tr>
11307 </thead>
11308
11309 <tbody>
11310
11311
11312
11313
11314
11315
11316
11317
11318
11319
11320 <tr class="entry" id="dynamic_android.statistics.faceDetectMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11321 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11322 android.<wbr/>statistics.<wbr/>face<wbr/>Detect<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11323 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11324 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11325 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11326
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11327 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11328
11329 <ul class="entry_type_enum">
11330 <li>
11331 <span class="entry_type_enum_name">OFF</span>
11332 </li>
11333 <li>
11334 <span class="entry_type_enum_name">SIMPLE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11335 <span class="entry_type_enum_notes">Optional Return rectangle and confidence
11336 only</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11337 </li>
11338 <li>
11339 <span class="entry_type_enum_name">FULL</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11340 <span class="entry_type_enum_notes">Optional Return all face
11341 metadata</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11342 </li>
11343 </ul>
11344
11345 </td> <!-- entry_type -->
11346
11347 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11348 <p>State of the face detector
11349unit</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11350 </td>
11351
11352 <td class="entry_units">
11353 </td>
11354
11355 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11356 <p><a href="#static_android.statistics.info.availableFaceDetectModes">android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11357 </td>
11358
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11359 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11360 <ul class="entry_tags">
11361 <li><a href="#tag_BC">BC</a></li>
11362 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11363 </td>
11364
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11365 </tr>
11366 <tr class="entries_header">
11367 <th class="th_details" colspan="5">Details</th>
11368 </tr>
11369 <tr class="entry_cont">
11370 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11371 <p>Whether face detection is enabled,<wbr/> and whether it
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11372should output just the basic fields or the full set of
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11373fields.<wbr/> Value must be one of the
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11374<a href="#static_android.statistics.info.availableFaceDetectModes">android.<wbr/>statistics.<wbr/>info.<wbr/>available<wbr/>Face<wbr/>Detect<wbr/>Modes</a>.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11375 </td>
11376 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11377
11378
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11379 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11380 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11381
11382
11383 <tr class="entry" id="dynamic_android.statistics.faceIds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11384 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11385 android.<wbr/>statistics.<wbr/>face<wbr/>Ids
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11386 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11387 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11388 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11389 <span class="entry_type_container">x</span>
11390
11391 <span class="entry_type_array">
11392 n
11393 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11394 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11395
11396
11397 </td> <!-- entry_type -->
11398
11399 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11400 <p>List of unique IDs for detected
11401faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11402 </td>
11403
11404 <td class="entry_units">
11405 </td>
11406
11407 <td class="entry_range">
11408 </td>
11409
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11410 <td class="entry_tags">
11411 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11412 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11413 </ul>
11414 </td>
11415
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11416 </tr>
11417 <tr class="entries_header">
11418 <th class="th_details" colspan="5">Details</th>
11419 </tr>
11420 <tr class="entry_cont">
11421 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11422 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11423 </td>
11424 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11425
11426
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11427 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11428 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11429
11430
11431 <tr class="entry" id="dynamic_android.statistics.faceLandmarks">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11432 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11433 android.<wbr/>statistics.<wbr/>face<wbr/>Landmarks
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11434 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11435 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11436 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11437 <span class="entry_type_container">x</span>
11438
11439 <span class="entry_type_array">
11440 n x 6
11441 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11442 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11443 <div class="entry_type_notes">(leftEyeX,<wbr/> leftEyeY,<wbr/> rightEyeX,<wbr/> rightEyeY,<wbr/> mouthX,<wbr/> mouthY)</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11444
11445
11446 </td> <!-- entry_type -->
11447
11448 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11449 <p>List of landmarks for detected
11450faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11451 </td>
11452
11453 <td class="entry_units">
11454 </td>
11455
11456 <td class="entry_range">
11457 </td>
11458
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11459 <td class="entry_tags">
11460 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11461 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11462 </ul>
11463 </td>
11464
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11465 </tr>
11466 <tr class="entries_header">
11467 <th class="th_details" colspan="5">Details</th>
11468 </tr>
11469 <tr class="entry_cont">
11470 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11471 <p>Only available if faceDetectMode == FULL</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11472 </td>
11473 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11474
11475
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11476 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11477 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11478
11479
11480 <tr class="entry" id="dynamic_android.statistics.faceRectangles">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11481 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11482 android.<wbr/>statistics.<wbr/>face<wbr/>Rectangles
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11483 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11484 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11485 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11486 <span class="entry_type_container">x</span>
11487
11488 <span class="entry_type_array">
11489 n x 4
11490 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11491 <span class="entry_type_visibility"> [hidden as rectangle]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11492 <div class="entry_type_notes">(xmin,<wbr/> ymin,<wbr/> xmax,<wbr/> ymax).<wbr/> (0,<wbr/>0) is top-left of active pixel area</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11493
11494
11495 </td> <!-- entry_type -->
11496
11497 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11498 <p>List of the bounding rectangles for detected
11499faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11500 </td>
11501
11502 <td class="entry_units">
11503 </td>
11504
11505 <td class="entry_range">
11506 </td>
11507
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11508 <td class="entry_tags">
11509 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11510 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11511 </ul>
11512 </td>
11513
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11514 </tr>
11515 <tr class="entries_header">
11516 <th class="th_details" colspan="5">Details</th>
11517 </tr>
11518 <tr class="entry_cont">
11519 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11520 <p>Only available if faceDetectMode != OFF</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11521 </td>
11522 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11523
11524
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11525 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11526 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11527
11528
11529 <tr class="entry" id="dynamic_android.statistics.faceScores">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11530 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11531 android.<wbr/>statistics.<wbr/>face<wbr/>Scores
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11532 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11533 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11534 <span class="entry_type_name">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11535 <span class="entry_type_container">x</span>
11536
11537 <span class="entry_type_array">
11538 n
11539 </span>
Zhijun He3b4c2062013-10-07 11:23:30 -0700[diff] [blame]11540 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11541
11542
11543 </td> <!-- entry_type -->
11544
11545 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11546 <p>List of the face confidence scores for
11547detected faces</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11548 </td>
11549
11550 <td class="entry_units">
11551 </td>
11552
11553 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11554 <p>1-100</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11555 </td>
11556
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11557 <td class="entry_tags">
11558 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11559 <li><a href="#tag_BC">BC</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11560 </ul>
11561 </td>
11562
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11563 </tr>
11564 <tr class="entries_header">
11565 <th class="th_details" colspan="5">Details</th>
11566 </tr>
11567 <tr class="entry_cont">
11568 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11569 <p>Only available if faceDetectMode != OFF.<wbr/> The value should be
11570meaningful (for example,<wbr/> setting 100 at all times is illegal).<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11571 </td>
11572 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11573
11574
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11575 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11576 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11577
11578
11579 <tr class="entry" id="dynamic_android.statistics.histogram">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11580 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11581 android.<wbr/>statistics.<wbr/>histogram
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11582 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11583 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11584 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11585 <span class="entry_type_container">x</span>
11586
11587 <span class="entry_type_array">
11588 n x 3
11589 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11590 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11591 <div class="entry_type_notes">count of pixels for each color channel that fall into each histogram bucket,<wbr/> scaled to be between 0 and maxHistogramCount</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11592
11593
11594 </td> <!-- entry_type -->
11595
11596 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11597 <p>A 3-channel histogram based on the raw
11598sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11599 </td>
11600
11601 <td class="entry_units">
11602 </td>
11603
11604 <td class="entry_range">
11605 </td>
11606
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11607 <td class="entry_tags">
11608 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11609 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11610 </ul>
11611 </td>
11612
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11613 </tr>
11614 <tr class="entries_header">
11615 <th class="th_details" colspan="5">Details</th>
11616 </tr>
11617 <tr class="entry_cont">
11618 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11619 <p>The k'th bucket (0-based) covers the input range
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11620(with w = <a href="#static_android.sensor.info.whiteLevel">android.<wbr/>sensor.<wbr/>info.<wbr/>white<wbr/>Level</a>) of [ k * w/<wbr/>N,<wbr/>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11621(k + 1) * w /<wbr/> N ).<wbr/> If only a monochrome sharpness map is
11622supported,<wbr/> all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11623 </td>
11624 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11625
11626
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11627 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11628 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11629
11630
11631 <tr class="entry" id="dynamic_android.statistics.histogramMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11632 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11633 android.<wbr/>statistics.<wbr/>histogram<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11634 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11635 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11636 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11637
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11638 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11639
11640 <ul class="entry_type_enum">
11641 <li>
11642 <span class="entry_type_enum_name">OFF</span>
11643 </li>
11644 <li>
11645 <span class="entry_type_enum_name">ON</span>
11646 </li>
11647 </ul>
11648
11649 </td> <!-- entry_type -->
11650
11651 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11652 <p>Operating mode for histogram
11653generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11654 </td>
11655
11656 <td class="entry_units">
11657 </td>
11658
11659 <td class="entry_range">
11660 </td>
11661
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11662 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11663 <ul class="entry_tags">
11664 <li><a href="#tag_V1">V1</a></li>
11665 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11666 </td>
11667
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11668 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11669
11670
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11671 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11672 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11673
11674
11675 <tr class="entry" id="dynamic_android.statistics.sharpnessMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11676 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11677 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11678 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11679 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11680 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11681 <span class="entry_type_container">x</span>
11682
11683 <span class="entry_type_array">
11684 n x m x 3
11685 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]11686 <span class="entry_type_visibility"> [system]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11687 <div class="entry_type_notes">estimated sharpness for each region of the input image.<wbr/> Normalized to be between 0 and maxSharpnessMapValue.<wbr/> Higher values mean sharper (better focused)</div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11688
11689
11690 </td> <!-- entry_type -->
11691
11692 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11693 <p>A 3-channel sharpness map,<wbr/> based on the raw
11694sensor data</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11695 </td>
11696
11697 <td class="entry_units">
11698 </td>
11699
11700 <td class="entry_range">
11701 </td>
11702
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11703 <td class="entry_tags">
11704 <ul class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11705 <li><a href="#tag_V1">V1</a></li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11706 </ul>
11707 </td>
11708
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11709 </tr>
11710 <tr class="entries_header">
11711 <th class="th_details" colspan="5">Details</th>
11712 </tr>
11713 <tr class="entry_cont">
11714 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11715 <p>If only a monochrome sharpness map is supported,<wbr/>
11716all channels should have the same data</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11717 </td>
11718 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11719
11720
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11721 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11722 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11723
11724
11725 <tr class="entry" id="dynamic_android.statistics.sharpnessMapMode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11726 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11727 android.<wbr/>statistics.<wbr/>sharpness<wbr/>Map<wbr/>Mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11728 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11729 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]11730 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11731
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]11732 <span class="entry_type_visibility"> [system as boolean]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11733
11734 <ul class="entry_type_enum">
11735 <li>
11736 <span class="entry_type_enum_name">OFF</span>
11737 </li>
11738 <li>
11739 <span class="entry_type_enum_name">ON</span>
11740 </li>
11741 </ul>
11742
11743 </td> <!-- entry_type -->
11744
11745 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11746 <p>Operating mode for sharpness map
11747generation</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11748 </td>
11749
11750 <td class="entry_units">
11751 </td>
11752
11753 <td class="entry_range">
11754 </td>
11755
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11756 <td class="entry_tags">
Igor Murashkinbaacf9a2012-12-05 14:49:11 -0800[diff] [blame]11757 <ul class="entry_tags">
11758 <li><a href="#tag_V1">V1</a></li>
11759 </ul>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11760 </td>
11761
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11762 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11763
11764
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11765 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11766 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]11767
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11768
11769 <tr class="entry" id="dynamic_android.statistics.lensShadingMap">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11770 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11771 android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11772 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11773 <td class="entry_type">
11774 <span class="entry_type_name">float</span>
11775 <span class="entry_type_container">x</span>
11776
11777 <span class="entry_type_array">
11778 4 x n x m
11779 </span>
11780 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11781 <div class="entry_type_notes">2D array of float gain factors per channel to correct lens shading</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11782
11783
11784 </td> <!-- entry_type -->
11785
11786 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11787 <p>The shading map is a low-resolution floating-point map
11788that lists the coefficients used to correct for vignetting,<wbr/> for each
11789Bayer color channel.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11790 </td>
11791
11792 <td class="entry_units">
11793 </td>
11794
11795 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11796 <p>Each gain factor is &gt;= 1</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11797 </td>
11798
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11799 <td class="entry_tags">
11800 </td>
11801
11802 </tr>
11803 <tr class="entries_header">
11804 <th class="th_details" colspan="5">Details</th>
11805 </tr>
11806 <tr class="entry_cont">
11807 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11808 <p>The least shaded section of the image should have a gain factor
11809of 1; all other sections should have gains above 1.<wbr/></p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11810<p>When <a href="#controls_android.colorCorrection.mode">android.<wbr/>color<wbr/>Correction.<wbr/>mode</a> = TRANSFORM_<wbr/>MATRIX,<wbr/> the map
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11811must take into account the colorCorrection settings.<wbr/></p>
11812<p>The shading map is for the entire active pixel array,<wbr/> and is not
11813affected by the crop region specified in the request.<wbr/> Each shading map
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11814entry is the value of the shading compensation map over a specific
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11815pixel on the sensor.<wbr/> Specifically,<wbr/> with a (N x M) resolution shading
11816map,<wbr/> and an active pixel array size (W x H),<wbr/> shading map entry
11817(x,<wbr/>y) ϵ (0 ...<wbr/> N-1,<wbr/> 0 ...<wbr/> M-1) is the value of the shading map at
11818pixel ( ((W-1)/<wbr/>(N-1)) * x,<wbr/> ((H-1)/<wbr/>(M-1)) * y) for the four color channels.<wbr/>
11819The map is assumed to be bilinearly interpolated between the sample points.<wbr/></p>
11820<p>The channel order is [R,<wbr/> Geven,<wbr/> Godd,<wbr/> B],<wbr/> where Geven is the green
11821channel for the even rows of a Bayer pattern,<wbr/> and Godd is the odd rows.<wbr/>
11822The shading map is stored in a fully interleaved format,<wbr/> and its size
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11823is provided in the camera static metadata by <a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a>.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11824<p>The shading map should have on the order of 30-40 rows and columns,<wbr/>
11825and must be smaller than 64x64.<wbr/></p>
11826<p>As an example,<wbr/> given a very small map defined as:</p>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11827<pre><code><a href="#static_android.lens.info.shadingMapSize">android.<wbr/>lens.<wbr/>info.<wbr/>shading<wbr/>Map<wbr/>Size</a> = [ 4,<wbr/> 3 ]
11828<a href="#dynamic_android.statistics.lensShadingMap">android.<wbr/>statistics.<wbr/>lens<wbr/>Shading<wbr/>Map</a> =
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11829[ 1.<wbr/>3,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>15,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>15,<wbr/> 1.<wbr/>2,<wbr/>
11830 1.<wbr/>1,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>3,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>3,<wbr/> 1.<wbr/>3,<wbr/>
11831 1.<wbr/>2,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>25,<wbr/> 1.<wbr/>1,<wbr/> 1.<wbr/>1,<wbr/> 1.<wbr/>1,<wbr/> 1.<wbr/>1,<wbr/> 1.<wbr/>0,<wbr/>
11832 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>3,<wbr/> 1.<wbr/>25,<wbr/> 1.<wbr/>2,<wbr/>
11833 1.<wbr/>3,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>3,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>15,<wbr/> 1.<wbr/>1,<wbr/> 1.<wbr/>2,<wbr/>
11834 1.<wbr/>2,<wbr/> 1.<wbr/>1,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>3,<wbr/> 1.<wbr/>15,<wbr/> 1.<wbr/>2,<wbr/> 1.<wbr/>3 ]
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11835</code></pre>
11836<p>The low-resolution scaling map images for each channel are
11837(displayed using nearest-neighbor interpolation):</p>
11838<p><img alt="Red lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/red_shading.png"/>
11839<img alt="Green (even rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_e_shading.png"/>
11840<img alt="Green (odd rows) lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/green_o_shading.png"/>
11841<img alt="Blue lens shading map" src="images/camera2/metadata/android.statistics.lensShadingMap/blue_shading.png"/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11842<p>As a visualization only,<wbr/> inverting the full-color map to recover an
Igor Murashkin1dd4ecb2013-12-11 13:31:00 -0800[diff] [blame]11843image of a gray wall (using bicubic interpolation for visual quality) as captured by the sensor gives:</p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11844<p><img alt="Image of a uniform white wall (inverse shading map)" src="images/camera2/metadata/android.statistics.lensShadingMap/inv_shading.png"/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11845 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11846 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11847
11848
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11849 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11850 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11851
11852
11853 <tr class="entry" id="dynamic_android.statistics.predictedColorGains">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11854 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11855 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Gains
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11856 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11857 <td class="entry_type">
11858 <span class="entry_type_name">float</span>
11859 <span class="entry_type_container">x</span>
11860
11861 <span class="entry_type_array">
11862 4
11863 </span>
11864 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11865 <div class="entry_type_notes">A 1D array of floats for 4 color channel gains</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11866
11867
11868 </td> <!-- entry_type -->
11869
11870 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11871 <p>The best-fit color channel gains calculated
11872by the HAL's statistics units for the current output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11873 </td>
11874
11875 <td class="entry_units">
11876 </td>
11877
11878 <td class="entry_range">
11879 </td>
11880
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11881 <td class="entry_tags">
11882 </td>
11883
11884 </tr>
11885 <tr class="entries_header">
11886 <th class="th_details" colspan="5">Details</th>
11887 </tr>
11888 <tr class="entry_cont">
11889 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11890 <p>This may be different than the gains used for this frame,<wbr/>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11891since statistics processing on data from a new frame
11892typically completes after the transform has already been
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11893applied to that frame.<wbr/></p>
11894<p>The 4 channel gains are defined in Bayer domain,<wbr/>
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]11895see <a href="#controls_android.colorCorrection.gains">android.<wbr/>color<wbr/>Correction.<wbr/>gains</a> for details.<wbr/></p>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11896<p>This value should always be calculated by the AWB block,<wbr/>
11897regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11898 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11899 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11900
11901
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11902 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11903 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11904
11905
11906 <tr class="entry" id="dynamic_android.statistics.predictedColorTransform">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11907 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11908 android.<wbr/>statistics.<wbr/>predicted<wbr/>Color<wbr/>Transform
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11909 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11910 <td class="entry_type">
11911 <span class="entry_type_name">rational</span>
11912 <span class="entry_type_container">x</span>
11913
11914 <span class="entry_type_array">
11915 3 x 3
11916 </span>
11917 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11918 <div class="entry_type_notes">3x3 rational matrix in row-major order</div>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11919
11920
11921 </td> <!-- entry_type -->
11922
11923 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11924 <p>The best-fit color transform matrix estimate
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11925calculated by the HAL's statistics units for the current
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11926output frame</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11927 </td>
11928
11929 <td class="entry_units">
11930 </td>
11931
11932 <td class="entry_range">
11933 </td>
11934
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11935 <td class="entry_tags">
11936 </td>
11937
11938 </tr>
11939 <tr class="entries_header">
11940 <th class="th_details" colspan="5">Details</th>
11941 </tr>
11942 <tr class="entry_cont">
11943 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11944 <p>The HAL must provide the estimate from its
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11945statistics unit on the white balance transforms to use
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11946for the next frame.<wbr/> These are the values the HAL believes
11947are the best fit for the current output frame.<wbr/> This may
11948be different than the transform used for this frame,<wbr/> since
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]11949statistics processing on data from a new frame typically
11950completes after the transform has already been applied to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11951that frame.<wbr/></p>
11952<p>These estimates must be provided for all frames,<wbr/> even if
11953capture settings and color transforms are set by the application.<wbr/></p>
11954<p>This value should always be calculated by the AWB block,<wbr/>
11955regardless of the android.<wbr/>control.<wbr/>* current values.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11956 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11957 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11958
11959
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]11960 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
11961 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11962
11963
11964 <tr class="entry" id="dynamic_android.statistics.sceneFlicker">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11965 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11966 android.<wbr/>statistics.<wbr/>scene<wbr/>Flicker
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]11967 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11968 <td class="entry_type">
11969 <span class="entry_type_name entry_type_name_enum">byte</span>
11970
11971 <span class="entry_type_visibility"> [public]</span>
11972
11973 <ul class="entry_type_enum">
11974 <li>
11975 <span class="entry_type_enum_name">NONE</span>
11976 </li>
11977 <li>
11978 <span class="entry_type_enum_name">50HZ</span>
11979 </li>
11980 <li>
11981 <span class="entry_type_enum_name">60HZ</span>
11982 </li>
11983 </ul>
11984
11985 </td> <!-- entry_type -->
11986
11987 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]11988 <p>The HAL estimated scene illumination lighting
11989frequency</p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11990 </td>
11991
11992 <td class="entry_units">
11993 </td>
11994
11995 <td class="entry_range">
11996 </td>
11997
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]11998 <td class="entry_tags">
11999 </td>
12000
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12001 </tr>
12002 <tr class="entries_header">
12003 <th class="th_details" colspan="5">Details</th>
12004 </tr>
12005 <tr class="entry_cont">
12006 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12007 <p>Report NONE if there doesn't appear to be flickering
12008illumination</p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12009 </td>
12010 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12011
12012
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12013 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12014 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12015
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12016
12017
12018 <!-- end of kind -->
12019 </tbody>
12020
12021 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12022 <tr><td colspan="6" id="section_tonemap" class="section">tonemap</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12023
12024
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12025 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12026
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12027 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12028 <tr>
12029 <th class="th_name">Property Name</th>
12030 <th class="th_type">Type</th>
12031 <th class="th_description">Description</th>
12032 <th class="th_units">Units</th>
12033 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12034 <th class="th_tags">Tags</th>
12035 </tr>
12036 </thead>
12037
12038 <tbody>
12039
12040
12041
12042
12043
12044
12045
12046
12047
12048
12049 <tr class="entry" id="controls_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12050 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12051 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12052 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12053 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12054 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12055 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12056
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12057 <span class="entry_type_array">
12058 n x 2
12059 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12060 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12061 <div class="entry_type_notes">1D array of float pairs (P_<wbr/>IN,<wbr/> P_<wbr/>OUT).<wbr/> The maximum number of pairs is specified by android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12062
12063
12064 </td> <!-- entry_type -->
12065
12066 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12067 <p>Table mapping blue input values to output
12068values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12069 </td>
12070
12071 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12072 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12073 </td>
12074
12075 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12076 <p>same as <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12077 </td>
12078
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12079 <td class="entry_tags">
12080 </td>
12081
12082 </tr>
12083 <tr class="entries_header">
12084 <th class="th_details" colspan="5">Details</th>
12085 </tr>
12086 <tr class="entry_cont">
12087 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12088 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12089channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12090<p>See <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12091 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12092 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12093
12094
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12095 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12096 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12097
12098
12099 <tr class="entry" id="controls_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12100 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12101 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12102 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12103 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12104 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12105 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12106
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12107 <span class="entry_type_array">
12108 n x 2
12109 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12110 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12111 <div class="entry_type_notes">1D array of float pairs (P_<wbr/>IN,<wbr/> P_<wbr/>OUT).<wbr/> The maximum number of pairs is specified by android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12112
12113
12114 </td> <!-- entry_type -->
12115
12116 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12117 <p>Table mapping green input values to output
12118values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12119 </td>
12120
12121 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12122 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12123 </td>
12124
12125 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12126 <p>same as <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12127 </td>
12128
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12129 <td class="entry_tags">
12130 </td>
12131
12132 </tr>
12133 <tr class="entries_header">
12134 <th class="th_details" colspan="5">Details</th>
12135 </tr>
12136 <tr class="entry_cont">
12137 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12138 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12139channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12140<p>See <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12141 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12142 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12143
12144
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12145 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12146 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12147
12148
12149 <tr class="entry" id="controls_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12150 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12151 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12152 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12153 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12154 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12155 <span class="entry_type_container">x</span>
12156
12157 <span class="entry_type_array">
12158 n x 2
12159 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12160 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12161 <div class="entry_type_notes">1D array of float pairs (P_<wbr/>IN,<wbr/> P_<wbr/>OUT).<wbr/> The maximum number of pairs is specified by android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12162
12163
12164 </td> <!-- entry_type -->
12165
12166 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12167 <p>Table mapping red input values to output
12168values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12169 </td>
12170
12171 <td class="entry_units">
12172 </td>
12173
12174 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12175 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12176 </td>
12177
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12178 <td class="entry_tags">
12179 <ul class="entry_tags">
12180 <li><a href="#tag_DNG">DNG</a></li>
12181 </ul>
12182 </td>
12183
12184 </tr>
12185 <tr class="entries_header">
12186 <th class="th_details" colspan="5">Details</th>
12187 </tr>
12188 <tr class="entry_cont">
12189 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12190 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12191channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12192<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12193the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12194are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12195between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12196<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12197defined points.<wbr/> The points will be listed in increasing
12198order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
121990.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12200for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
122010.<wbr/>25,<wbr/> 0.<wbr/>3 -&gt; 0.<wbr/>5,<wbr/> 0.<wbr/>5 -&gt; 0.<wbr/>64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12202 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12203 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12204
12205
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12206 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12207 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12208
12209
12210 <tr class="entry" id="controls_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12211 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12212 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12213 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12214 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12215 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12216
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12217 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12218
12219 <ul class="entry_type_enum">
12220 <li>
12221 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12222 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12223 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12224 </li>
12225 <li>
12226 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12227 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12228 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12229 </li>
12230 <li>
12231 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12232 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12233 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12234 </li>
12235 </ul>
12236
12237 </td> <!-- entry_type -->
12238
12239 <td class="entry_description">
12240 </td>
12241
12242 <td class="entry_units">
12243 </td>
12244
12245 <td class="entry_range">
12246 </td>
12247
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12248 <td class="entry_tags">
12249 </td>
12250
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12251 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12252
12253
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12254 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12255 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12256
12257
12258
12259 <!-- end of kind -->
12260 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12261 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12262
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12263 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12264 <tr>
12265 <th class="th_name">Property Name</th>
12266 <th class="th_type">Type</th>
12267 <th class="th_description">Description</th>
12268 <th class="th_units">Units</th>
12269 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12270 <th class="th_tags">Tags</th>
12271 </tr>
12272 </thead>
12273
12274 <tbody>
12275
12276
12277
12278
12279
12280
12281
12282
12283
12284
12285 <tr class="entry" id="static_android.tonemap.maxCurvePoints">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12286 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12287 android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12288 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12289 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12290 <span class="entry_type_name">int32</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12291
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12292 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12293
12294
12295 </td> <!-- entry_type -->
12296
12297 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12298 <p>Maximum number of supported points in the
12299tonemap curve</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12300 </td>
12301
12302 <td class="entry_units">
12303 </td>
12304
12305 <td class="entry_range">
Igor Murashkin6cb7c2c2014-01-10 15:12:40 -0800[diff] [blame]12306 <p>&gt;= 128</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12307 </td>
12308
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12309 <td class="entry_tags">
12310 </td>
12311
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12312 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12313
12314
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12315 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12316 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12317
12318
12319
12320 <!-- end of kind -->
12321 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12322 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12323
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12324 <thead class="entries_header">
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12325 <tr>
12326 <th class="th_name">Property Name</th>
12327 <th class="th_type">Type</th>
12328 <th class="th_description">Description</th>
12329 <th class="th_units">Units</th>
12330 <th class="th_range">Range</th>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12331 <th class="th_tags">Tags</th>
12332 </tr>
12333 </thead>
12334
12335 <tbody>
12336
12337
12338
12339
12340
12341
12342
12343
12344
12345
12346 <tr class="entry" id="dynamic_android.tonemap.curveBlue">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12347 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12348 android.<wbr/>tonemap.<wbr/>curve<wbr/>Blue
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12349 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12350 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12351 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12352 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12353
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12354 <span class="entry_type_array">
12355 n x 2
12356 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12357 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12358 <div class="entry_type_notes">1D array of float pairs (P_<wbr/>IN,<wbr/> P_<wbr/>OUT).<wbr/> The maximum number of pairs is specified by android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12359
12360
12361 </td> <!-- entry_type -->
12362
12363 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12364 <p>Table mapping blue input values to output
12365values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12366 </td>
12367
12368 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12369 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12370 </td>
12371
12372 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12373 <p>same as <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12374 </td>
12375
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12376 <td class="entry_tags">
12377 </td>
12378
12379 </tr>
12380 <tr class="entries_header">
12381 <th class="th_details" colspan="5">Details</th>
12382 </tr>
12383 <tr class="entry_cont">
12384 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12385 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the blue
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12386channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12387<p>See <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12388 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12389 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12390
12391
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12392 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12393 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12394
12395
12396 <tr class="entry" id="dynamic_android.tonemap.curveGreen">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12397 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12398 android.<wbr/>tonemap.<wbr/>curve<wbr/>Green
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12399 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12400 <td class="entry_type">
Eino-Ville Talvala76548fe2013-01-11 13:57:19 -0800[diff] [blame]12401 <span class="entry_type_name">float</span>
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12402 <span class="entry_type_container">x</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12403
Zhijun He704d1282013-08-19 15:26:33 -0700[diff] [blame]12404 <span class="entry_type_array">
12405 n x 2
12406 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12407 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12408 <div class="entry_type_notes">1D array of float pairs (P_<wbr/>IN,<wbr/> P_<wbr/>OUT).<wbr/> The maximum number of pairs is specified by android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12409
12410
12411 </td> <!-- entry_type -->
12412
12413 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12414 <p>Table mapping green input values to output
12415values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12416 </td>
12417
12418 <td class="entry_units">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12419 same as android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12420 </td>
12421
12422 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12423 <p>same as <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12424 </td>
12425
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12426 <td class="entry_tags">
12427 </td>
12428
12429 </tr>
12430 <tr class="entries_header">
12431 <th class="th_details" colspan="5">Details</th>
12432 </tr>
12433 <tr class="entry_cont">
12434 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12435 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the green
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12436channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
12437<p>See <a href="#controls_android.tonemap.curveRed">android.<wbr/>tonemap.<wbr/>curve<wbr/>Red</a> for more details.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12438 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12439 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12440
12441
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12442 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12443 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12444
12445
12446 <tr class="entry" id="dynamic_android.tonemap.curveRed">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12447 <td class="entry_name" rowspan="3">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12448 android.<wbr/>tonemap.<wbr/>curve<wbr/>Red
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12449 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12450 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12451 <span class="entry_type_name">float</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12452 <span class="entry_type_container">x</span>
12453
12454 <span class="entry_type_array">
12455 n x 2
12456 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12457 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12458 <div class="entry_type_notes">1D array of float pairs (P_<wbr/>IN,<wbr/> P_<wbr/>OUT).<wbr/> The maximum number of pairs is specified by android.<wbr/>tonemap.<wbr/>max<wbr/>Curve<wbr/>Points.<wbr/></div>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12459
12460
12461 </td> <!-- entry_type -->
12462
12463 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12464 <p>Table mapping red input values to output
12465values</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12466 </td>
12467
12468 <td class="entry_units">
12469 </td>
12470
12471 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12472 <p>0-1 on input and output coordinates.<wbr/></p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12473 </td>
12474
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12475 <td class="entry_tags">
12476 <ul class="entry_tags">
12477 <li><a href="#tag_DNG">DNG</a></li>
12478 </ul>
12479 </td>
12480
12481 </tr>
12482 <tr class="entries_header">
12483 <th class="th_details" colspan="5">Details</th>
12484 </tr>
12485 <tr class="entry_cont">
12486 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12487 <p>Tonemapping /<wbr/> contrast /<wbr/> gamma curve for the red
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12488channel,<wbr/> to use when <a href="#controls_android.tonemap.mode">android.<wbr/>tonemap.<wbr/>mode</a> is CONTRAST_<wbr/>CURVE.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12489<p>Since the input and output ranges may vary depending on
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12490the camera pipeline,<wbr/> the input and output pixel values
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12491are represented by normalized floating-point values
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12492between 0 and 1,<wbr/> with 0 == black and 1 == white.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12493<p>The curve should be linearly interpolated between the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12494defined points.<wbr/> The points will be listed in increasing
12495order of P_<wbr/>IN.<wbr/> For example,<wbr/> if the array is: [0.<wbr/>0,<wbr/> 0.<wbr/>0,<wbr/>
124960.<wbr/>3,<wbr/> 0.<wbr/>5,<wbr/> 1.<wbr/>0,<wbr/> 1.<wbr/>0],<wbr/> then the input-&gt;output mapping
12497for a few sample points would be: 0 -&gt; 0,<wbr/> 0.<wbr/>15 -&gt;
124980.<wbr/>25,<wbr/> 0.<wbr/>3 -&gt; 0.<wbr/>5,<wbr/> 0.<wbr/>5 -&gt; 0.<wbr/>64</p>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12499 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12500 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12501
12502
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12503 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12504 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12505
12506
12507 <tr class="entry" id="dynamic_android.tonemap.mode">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12508 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12509 android.<wbr/>tonemap.<wbr/>mode
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12510 </td>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12511 <td class="entry_type">
Igor Murashkinb556bc42012-12-04 16:07:21 -0800[diff] [blame]12512 <span class="entry_type_name entry_type_name_enum">byte</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12513
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12514 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12515
12516 <ul class="entry_type_enum">
12517 <li>
12518 <span class="entry_type_enum_name">CONTRAST_CURVE</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12519 <span class="entry_type_enum_notes">Use the tone mapping curve specified in
12520 android.<wbr/>tonemap.<wbr/>curve</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12521 </li>
12522 <li>
12523 <span class="entry_type_enum_name">FAST</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12524 <span class="entry_type_enum_notes">Must not slow down frame rate relative to raw
12525 bayer output</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12526 </li>
12527 <li>
12528 <span class="entry_type_enum_name">HIGH_QUALITY</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12529 <span class="entry_type_enum_notes">Frame rate may be reduced by high
12530 quality</span>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12531 </li>
12532 </ul>
12533
12534 </td> <!-- entry_type -->
12535
12536 <td class="entry_description">
12537 </td>
12538
12539 <td class="entry_units">
12540 </td>
12541
12542 <td class="entry_range">
12543 </td>
12544
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12545 <td class="entry_tags">
12546 </td>
12547
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12548 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12549
12550
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12551 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12552 <!-- end of entry -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]12553
12554
12555
12556 <!-- end of kind -->
12557 </tbody>
12558
12559 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12560 <tr><td colspan="6" id="section_led" class="section">led</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12561
12562
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12563 <tr><td colspan="6" class="kind">controls</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12564
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12565 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12566 <tr>
12567 <th class="th_name">Property Name</th>
12568 <th class="th_type">Type</th>
12569 <th class="th_description">Description</th>
12570 <th class="th_units">Units</th>
12571 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12572 <th class="th_tags">Tags</th>
12573 </tr>
12574 </thead>
12575
12576 <tbody>
12577
12578
12579
12580
12581
12582
12583
12584
12585
12586
12587 <tr class="entry" id="controls_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12588 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12589 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12590 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12591 <td class="entry_type">
12592 <span class="entry_type_name entry_type_name_enum">byte</span>
12593
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12594 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12595
12596 <ul class="entry_type_enum">
12597 <li>
12598 <span class="entry_type_enum_name">OFF</span>
12599 </li>
12600 <li>
12601 <span class="entry_type_enum_name">ON</span>
12602 </li>
12603 </ul>
12604
12605 </td> <!-- entry_type -->
12606
12607 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12608 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12609that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12610Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12611disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12612any untrusted applications.<wbr/></p>
12613<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12614transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12615data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12616<p>The LED <em>may</em> be off if a trusted application is using the data that
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12617doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12618 </td>
12619
12620 <td class="entry_units">
12621 </td>
12622
12623 <td class="entry_range">
12624 </td>
12625
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12626 <td class="entry_tags">
12627 </td>
12628
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12629 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12630
12631
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12632 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12633 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12634
12635
12636
12637 <!-- end of kind -->
12638 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12639 <tr><td colspan="6" class="kind">dynamic</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12640
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12641 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12642 <tr>
12643 <th class="th_name">Property Name</th>
12644 <th class="th_type">Type</th>
12645 <th class="th_description">Description</th>
12646 <th class="th_units">Units</th>
12647 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12648 <th class="th_tags">Tags</th>
12649 </tr>
12650 </thead>
12651
12652 <tbody>
12653
12654
12655
12656
12657
12658
12659
12660
12661
12662
12663 <tr class="entry" id="dynamic_android.led.transmit">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12664 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12665 android.<wbr/>led.<wbr/>transmit
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12666 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12667 <td class="entry_type">
12668 <span class="entry_type_name entry_type_name_enum">byte</span>
12669
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12670 <span class="entry_type_visibility"> [hidden as boolean]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12671
12672 <ul class="entry_type_enum">
12673 <li>
12674 <span class="entry_type_enum_name">OFF</span>
12675 </li>
12676 <li>
12677 <span class="entry_type_enum_name">ON</span>
12678 </li>
12679 </ul>
12680
12681 </td> <!-- entry_type -->
12682
12683 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12684 <p>This LED is nominally used to indicate to the user
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12685that the camera is powered on and may be streaming images back to the
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12686Application Processor.<wbr/> In certain rare circumstances,<wbr/> the OS may
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12687disable this when video is processed locally and not transmitted to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12688any untrusted applications.<wbr/></p>
12689<p>In particular,<wbr/> the LED <em>must</em> always be on when the data could be
12690transmitted off the device.<wbr/> The LED <em>should</em> always be on whenever
12691data is stored locally on the device.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12692<p>The LED <em>may</em> be off if a trusted application is using the data that
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12693doesn't violate the above rules.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12694 </td>
12695
12696 <td class="entry_units">
12697 </td>
12698
12699 <td class="entry_range">
12700 </td>
12701
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12702 <td class="entry_tags">
12703 </td>
12704
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12705 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12706
12707
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12708 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12709 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12710
12711
12712
12713 <!-- end of kind -->
12714 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12715 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12716
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12717 <thead class="entries_header">
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12718 <tr>
12719 <th class="th_name">Property Name</th>
12720 <th class="th_type">Type</th>
12721 <th class="th_description">Description</th>
12722 <th class="th_units">Units</th>
12723 <th class="th_range">Range</th>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12724 <th class="th_tags">Tags</th>
12725 </tr>
12726 </thead>
12727
12728 <tbody>
12729
12730
12731
12732
12733
12734
12735
12736
12737
12738
12739 <tr class="entry" id="static_android.led.availableLeds">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12740 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12741 android.<wbr/>led.<wbr/>available<wbr/>Leds
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12742 </td>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12743 <td class="entry_type">
12744 <span class="entry_type_name entry_type_name_enum">byte</span>
12745 <span class="entry_type_container">x</span>
12746
12747 <span class="entry_type_array">
12748 n
12749 </span>
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12750 <span class="entry_type_visibility"> [hidden]</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12751
12752 <ul class="entry_type_enum">
12753 <li>
12754 <span class="entry_type_enum_name">TRANSMIT</span>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12755 <span class="entry_type_enum_notes">android.<wbr/>led.<wbr/>transmit control is used</span>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12756 </li>
12757 </ul>
12758
12759 </td> <!-- entry_type -->
12760
12761 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12762 <p>A list of camera LEDs that are available on this system.<wbr/></p>
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12763 </td>
12764
12765 <td class="entry_units">
12766 </td>
12767
12768 <td class="entry_range">
12769 </td>
12770
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12771 <td class="entry_tags">
12772 </td>
12773
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12774 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12775
12776
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12777 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12778 <!-- end of entry -->
Igor Murashkinc469f7d2013-04-23 14:31:02 -0700[diff] [blame]12779
12780
12781
12782 <!-- end of kind -->
12783 </tbody>
12784
12785 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12786 <tr><td colspan="6" id="section_info" class="section">info</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12787
12788
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12789 <tr><td colspan="6" class="kind">static</td></tr>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12790
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12791 <thead class="entries_header">
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12792 <tr>
12793 <th class="th_name">Property Name</th>
12794 <th class="th_type">Type</th>
12795 <th class="th_description">Description</th>
12796 <th class="th_units">Units</th>
12797 <th class="th_range">Range</th>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12798 <th class="th_tags">Tags</th>
12799 </tr>
12800 </thead>
12801
12802 <tbody>
12803
12804
12805
12806
12807
12808
12809
12810
12811
12812
12813 <tr class="entry" id="static_android.info.supportedHardwareLevel">
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12814 <td class="entry_name" rowspan="1">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12815 android.<wbr/>info.<wbr/>supported<wbr/>Hardware<wbr/>Level
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12816 </td>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12817 <td class="entry_type">
12818 <span class="entry_type_name entry_type_name_enum">byte</span>
12819
Eino-Ville Talvalafcef4c22013-07-16 16:18:44 -0700[diff] [blame]12820 <span class="entry_type_visibility"> [public]</span>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12821
12822 <ul class="entry_type_enum">
12823 <li>
12824 <span class="entry_type_enum_name">LIMITED</span>
12825 </li>
12826 <li>
12827 <span class="entry_type_enum_name">FULL</span>
12828 </li>
12829 </ul>
12830
12831 </td> <!-- entry_type -->
12832
12833 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12834 <p>The camera 3 HAL device can implement one of two possible
12835operational modes; limited and full.<wbr/> Full support is
12836expected from new higher-end devices.<wbr/> Limited mode has
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12837hardware requirements roughly in line with those for a
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12838camera HAL device v1 implementation,<wbr/> and is expected from
12839older or inexpensive devices.<wbr/> Full is a strict superset of
12840limited,<wbr/> and they share the same essential operational flow.<wbr/></p>
12841<p>For full details refer to "S3.<wbr/> Operational Modes" in camera3.<wbr/>h</p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12842 </td>
12843
12844 <td class="entry_units">
12845 </td>
12846
12847 <td class="entry_range">
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]12848 <p>Optional.<wbr/> Default value is LIMITED.<wbr/></p>
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12849 </td>
12850
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12851 <td class="entry_tags">
12852 </td>
12853
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12854 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12855
12856
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12857 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12858 <!-- end of entry -->
Igor Murashkin38b8cae2013-05-23 16:38:59 -0700[diff] [blame]12859
12860
12861
12862 <!-- end of kind -->
12863 </tbody>
12864
12865 <!-- end of section -->
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12866 <tr><td colspan="6" id="section_blackLevel" class="section">blackLevel</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12867
12868
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12869 <tr><td colspan="6" class="kind">controls</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12870
12871 <thead class="entries_header">
12872 <tr>
12873 <th class="th_name">Property Name</th>
12874 <th class="th_type">Type</th>
12875 <th class="th_description">Description</th>
12876 <th class="th_units">Units</th>
12877 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12878 <th class="th_tags">Tags</th>
12879 </tr>
12880 </thead>
12881
12882 <tbody>
12883
12884
12885
12886
12887
12888
12889
12890
12891
12892
12893 <tr class="entry" id="controls_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12894 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12895 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12896 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12897 <td class="entry_type">
12898 <span class="entry_type_name entry_type_name_enum">byte</span>
12899
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]12900 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12901
12902 <ul class="entry_type_enum">
12903 <li>
12904 <span class="entry_type_enum_name">OFF</span>
12905 </li>
12906 <li>
12907 <span class="entry_type_enum_name">ON</span>
12908 </li>
12909 </ul>
12910
12911 </td> <!-- entry_type -->
12912
12913 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12914 <p>Whether black-level compensation is locked
12915to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12916 </td>
12917
12918 <td class="entry_units">
12919 </td>
12920
12921 <td class="entry_range">
12922 </td>
12923
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12924 <td class="entry_tags">
12925 <ul class="entry_tags">
12926 <li><a href="#tag_HAL2">HAL2</a></li>
12927 </ul>
12928 </td>
12929
12930 </tr>
12931 <tr class="entries_header">
12932 <th class="th_details" colspan="5">Details</th>
12933 </tr>
12934 <tr class="entry_cont">
12935 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12936 <p>When set to ON,<wbr/> the values used for black-level
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12937compensation will not change until the lock is set to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12938OFF.<wbr/></p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12939<p>Since changes to certain capture parameters (such as
12940exposure time) may require resetting of black level
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12941compensation,<wbr/> the camera device must report whether setting
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12942the black level lock was successful in the output result
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12943metadata.<wbr/></p>
12944<p>For example,<wbr/> if a sequence of requests is as follows:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12945<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12946<li>Request 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12947<li>Request 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12948<li>Request 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12949<li>Request 4: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12950<li>Request 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12951<li>Request 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12952</ul>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12953<p>And the exposure change in Request 4 requires the camera
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12954device to reset the black level offsets,<wbr/> then the output
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12955result metadata is expected to be:</p>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12956<ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12957<li>Result 1: Exposure = 10ms,<wbr/> Black level lock = OFF</li>
12958<li>Result 2: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12959<li>Result 3: Exposure = 10ms,<wbr/> Black level lock = ON</li>
12960<li>Result 4: Exposure = 20ms,<wbr/> Black level lock = OFF</li>
12961<li>Result 5: Exposure = 20ms,<wbr/> Black level lock = ON</li>
12962<li>Result 6: Exposure = 20ms,<wbr/> Black level lock = ON</li>
Igor Murashkin8aa2a112013-12-09 12:06:17 -0800[diff] [blame]12963</ul>
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12964<p>This indicates to the application that on frame 4,<wbr/> black
12965levels were reset due to exposure value changes,<wbr/> and pixel
12966values may not be consistent across captures.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12967<p>The camera device will maintain the lock to the extent
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12968possible,<wbr/> only overriding the lock to OFF when changes to
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12969other request parameters require a black level recalculation
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12970or reset.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12971 </td>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12972 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12973
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12974 <tr class="entries_header">
12975 <th class="th_details" colspan="5">HAL Implementation Details</th>
12976 </tr>
12977 <tr class="entry_cont">
12978 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12979 <p>If for some reason black level locking is no longer possible
12980(for example,<wbr/> the analog gain has changed,<wbr/> which forces
12981black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12982override this request (and it must report 'OFF' when this
12983does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]12984possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]12985 </td>
12986 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]12987
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12988 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
12989 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12990
12991
12992
12993 <!-- end of kind -->
12994 </tbody>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]12995 <tr><td colspan="6" class="kind">dynamic</td></tr>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]12996
12997 <thead class="entries_header">
12998 <tr>
12999 <th class="th_name">Property Name</th>
13000 <th class="th_type">Type</th>
13001 <th class="th_description">Description</th>
13002 <th class="th_units">Units</th>
13003 <th class="th_range">Range</th>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13004 <th class="th_tags">Tags</th>
13005 </tr>
13006 </thead>
13007
13008 <tbody>
13009
13010
13011
13012
13013
13014
13015
13016
13017
13018
13019 <tr class="entry" id="dynamic_android.blackLevel.lock">
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13020 <td class="entry_name" rowspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13021 android.<wbr/>black<wbr/>Level.<wbr/>lock
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13022 </td>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13023 <td class="entry_type">
13024 <span class="entry_type_name entry_type_name_enum">byte</span>
13025
Igor Murashkinb8dc8812013-07-17 16:29:34 -0700[diff] [blame]13026 <span class="entry_type_visibility"> [public as boolean]</span>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13027
13028 <ul class="entry_type_enum">
13029 <li>
13030 <span class="entry_type_enum_name">OFF</span>
13031 </li>
13032 <li>
13033 <span class="entry_type_enum_name">ON</span>
13034 </li>
13035 </ul>
13036
13037 </td> <!-- entry_type -->
13038
13039 <td class="entry_description">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13040 <p>Whether black-level compensation is locked
13041to its current values,<wbr/> or is free to vary.<wbr/></p>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13042 </td>
13043
13044 <td class="entry_units">
13045 </td>
13046
13047 <td class="entry_range">
13048 </td>
13049
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13050 <td class="entry_tags">
13051 <ul class="entry_tags">
13052 <li><a href="#tag_HAL2">HAL2</a></li>
13053 </ul>
13054 </td>
13055
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13056 </tr>
13057 <tr class="entries_header">
13058 <th class="th_details" colspan="5">Details</th>
13059 </tr>
13060 <tr class="entry_cont">
13061 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13062 <p>Whether the black level offset was locked for this frame.<wbr/> Should be
Eino-Ville Talvala63c0fb22014-01-02 16:11:44 -0800[diff] [blame]13063ON if <a href="#controls_android.blackLevel.lock">android.<wbr/>black<wbr/>Level.<wbr/>lock</a> was ON in the capture request,<wbr/> unless
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13064a change in other capture settings forced the camera device to
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13065perform a black level reset.<wbr/></p>
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13066 </td>
13067 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13068
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13069 <tr class="entries_header">
13070 <th class="th_details" colspan="5">HAL Implementation Details</th>
13071 </tr>
13072 <tr class="entry_cont">
13073 <td class="entry_details" colspan="5">
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13074 <p>If for some reason black level locking is no longer possible
13075(for example,<wbr/> the analog gain has changed,<wbr/> which forces
13076black level offsets to be recalculated),<wbr/> then the HAL must
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13077override this request (and it must report 'OFF' when this
13078does happen) until the next capture for which locking is
Igor Murashkin0b080452013-12-27 15:30:25 -0800[diff] [blame]13079possible again.<wbr/></p>
Eino-Ville Talvala7796cfe2013-12-26 13:16:54 -0800[diff] [blame]13080 </td>
13081 </tr>
Eino-Ville Talvalaa5b73c22013-12-27 13:50:19 -0800[diff] [blame]13082
Eino-Ville Talvala8eb70052013-12-26 12:06:13 -0800[diff] [blame]13083 <tr class="entry_spacer"><td class="entry_spacer" colspan="6"></td></tr>
13084 <!-- end of entry -->
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13085
13086
13087
13088 <!-- end of kind -->
13089 </tbody>
13090
13091 <!-- end of section -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13092<!-- </namespace> -->
13093 </table>
13094
13095 <div class="tags" id="tag_index">
13096 <h2>Tags</h2>
13097 <ul>
13098 <li id="tag_AWB">AWB -
13099 Needed for auto white balance
13100
13101 <ul class="tags_entries">
13102 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13103 </ul>
13104 </li> <!-- tag_AWB -->
13105 <li id="tag_BC">BC -
13106 Needed for backwards compatibility with old Java API
13107
13108 <ul class="tags_entries">
Eino-Ville Talvala19ce2c12013-12-30 12:03:45 -0800[diff] [blame]13109 <li><a href="#controls_android.control.aeAntibandingMode">android.control.aeAntibandingMode</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13110 <li><a href="#controls_android.control.aeExposureCompensation">android.control.aeExposureCompensation</a> (controls)</li>
13111 <li><a href="#controls_android.control.aeLock">android.control.aeLock</a> (controls)</li>
13112 <li><a href="#controls_android.control.aeMode">android.control.aeMode</a> (controls)</li>
13113 <li><a href="#controls_android.control.aeRegions">android.control.aeRegions</a> (controls)</li>
13114 <li><a href="#controls_android.control.aeTargetFpsRange">android.control.aeTargetFpsRange</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13115 <li><a href="#controls_android.control.aePrecaptureTrigger">android.control.aePrecaptureTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13116 <li><a href="#controls_android.control.afMode">android.control.afMode</a> (controls)</li>
13117 <li><a href="#controls_android.control.afRegions">android.control.afRegions</a> (controls)</li>
Eino-Ville Talvala3b4383a2013-03-18 09:42:48 -0700[diff] [blame]13118 <li><a href="#controls_android.control.afTrigger">android.control.afTrigger</a> (controls)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13119 <li><a href="#controls_android.control.awbLock">android.control.awbLock</a> (controls)</li>
13120 <li><a href="#controls_android.control.awbMode">android.control.awbMode</a> (controls)</li>
13121 <li><a href="#controls_android.control.awbRegions">android.control.awbRegions</a> (controls)</li>
13122 <li><a href="#controls_android.control.captureIntent">android.control.captureIntent</a> (controls)</li>
13123 <li><a href="#controls_android.control.effectMode">android.control.effectMode</a> (controls)</li>
13124 <li><a href="#controls_android.control.mode">android.control.mode</a> (controls)</li>
13125 <li><a href="#controls_android.control.sceneMode">android.control.sceneMode</a> (controls)</li>
13126 <li><a href="#controls_android.control.videoStabilizationMode">android.control.videoStabilizationMode</a> (controls)</li>
Eino-Ville Talvala9fa0d902014-01-08 16:16:53 -0800[diff] [blame]13127 <li><a href="#static_android.control.aeAvailableModes">android.control.aeAvailableModes</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13128 <li><a href="#static_android.control.aeCompensationRange">android.control.aeCompensationRange</a> (static)</li>
13129 <li><a href="#static_android.control.aeCompensationStep">android.control.aeCompensationStep</a> (static)</li>
13130 <li><a href="#static_android.control.afAvailableModes">android.control.afAvailableModes</a> (static)</li>
13131 <li><a href="#static_android.control.availableEffects">android.control.availableEffects</a> (static)</li>
13132 <li><a href="#static_android.control.availableSceneModes">android.control.availableSceneModes</a> (static)</li>
13133 <li><a href="#static_android.control.availableVideoStabilizationModes">android.control.availableVideoStabilizationModes</a> (static)</li>
13134 <li><a href="#static_android.control.awbAvailableModes">android.control.awbAvailableModes</a> (static)</li>
13135 <li><a href="#static_android.control.maxRegions">android.control.maxRegions</a> (static)</li>
13136 <li><a href="#static_android.control.sceneModeOverrides">android.control.sceneModeOverrides</a> (static)</li>
13137 <li><a href="#controls_android.flash.mode">android.flash.mode</a> (controls)</li>
13138 <li><a href="#static_android.flash.info.available">android.flash.info.available</a> (static)</li>
13139 <li><a href="#controls_android.jpeg.gpsCoordinates">android.jpeg.gpsCoordinates</a> (controls)</li>
13140 <li><a href="#controls_android.jpeg.gpsProcessingMethod">android.jpeg.gpsProcessingMethod</a> (controls)</li>
13141 <li><a href="#controls_android.jpeg.gpsTimestamp">android.jpeg.gpsTimestamp</a> (controls)</li>
13142 <li><a href="#controls_android.jpeg.orientation">android.jpeg.orientation</a> (controls)</li>
13143 <li><a href="#controls_android.jpeg.quality">android.jpeg.quality</a> (controls)</li>
13144 <li><a href="#controls_android.jpeg.thumbnailQuality">android.jpeg.thumbnailQuality</a> (controls)</li>
13145 <li><a href="#controls_android.jpeg.thumbnailSize">android.jpeg.thumbnailSize</a> (controls)</li>
13146 <li><a href="#static_android.jpeg.availableThumbnailSizes">android.jpeg.availableThumbnailSizes</a> (static)</li>
13147 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13148 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13149 <li><a href="#static_android.lens.info.hyperfocalDistance">android.lens.info.hyperfocalDistance</a> (static)</li>
13150 <li><a href="#dynamic_android.lens.focusRange">android.lens.focusRange</a> (dynamic)</li>
13151 <li><a href="#static_android.request.maxNumOutputStreams">android.request.maxNumOutputStreams</a> (static)</li>
13152 <li><a href="#controls_android.scaler.cropRegion">android.scaler.cropRegion</a> (controls)</li>
13153 <li><a href="#static_android.scaler.availableFormats">android.scaler.availableFormats</a> (static)</li>
13154 <li><a href="#static_android.scaler.availableJpegMinDurations">android.scaler.availableJpegMinDurations</a> (static)</li>
13155 <li><a href="#static_android.scaler.availableJpegSizes">android.scaler.availableJpegSizes</a> (static)</li>
Igor Murashkinf11a4df2013-05-07 10:00:46 -0700[diff] [blame]13156 <li><a href="#static_android.scaler.availableMaxDigitalZoom">android.scaler.availableMaxDigitalZoom</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13157 <li><a href="#static_android.scaler.availableProcessedMinDurations">android.scaler.availableProcessedMinDurations</a> (static)</li>
13158 <li><a href="#static_android.scaler.availableProcessedSizes">android.scaler.availableProcessedSizes</a> (static)</li>
13159 <li><a href="#static_android.scaler.availableRawMinDurations">android.scaler.availableRawMinDurations</a> (static)</li>
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13160 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13161 <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]13162 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13163 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13164 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13165 <li><a href="#static_android.sensor.orientation">android.sensor.orientation</a> (static)</li>
13166 <li><a href="#dynamic_android.sensor.timestamp">android.sensor.timestamp</a> (dynamic)</li>
13167 <li><a href="#controls_android.statistics.faceDetectMode">android.statistics.faceDetectMode</a> (controls)</li>
13168 <li><a href="#dynamic_android.statistics.faceIds">android.statistics.faceIds</a> (dynamic)</li>
13169 <li><a href="#dynamic_android.statistics.faceLandmarks">android.statistics.faceLandmarks</a> (dynamic)</li>
13170 <li><a href="#dynamic_android.statistics.faceRectangles">android.statistics.faceRectangles</a> (dynamic)</li>
13171 <li><a href="#dynamic_android.statistics.faceScores">android.statistics.faceScores</a> (dynamic)</li>
13172 <li><a href="#dynamic_android.lens.focalLength">android.lens.focalLength</a> (dynamic)</li>
13173 <li><a href="#dynamic_android.lens.focusDistance">android.lens.focusDistance</a> (dynamic)</li>
13174 </ul>
13175 </li> <!-- tag_BC -->
13176 <li id="tag_V1">V1 -
13177 New features for first camera 2 release (API1)
13178
13179 <ul class="tags_entries">
13180 <li><a href="#controls_android.demosaic.mode">android.demosaic.mode</a> (controls)</li>
13181 <li><a href="#controls_android.flash.firingPower">android.flash.firingPower</a> (controls)</li>
13182 <li><a href="#controls_android.flash.firingTime">android.flash.firingTime</a> (controls)</li>
13183 <li><a href="#static_android.flash.info.chargeDuration">android.flash.info.chargeDuration</a> (static)</li>
13184 <li><a href="#controls_android.hotPixel.mode">android.hotPixel.mode</a> (controls)</li>
13185 <li><a href="#controls_android.lens.aperture">android.lens.aperture</a> (controls)</li>
13186 <li><a href="#controls_android.lens.filterDensity">android.lens.filterDensity</a> (controls)</li>
13187 <li><a href="#controls_android.lens.focalLength">android.lens.focalLength</a> (controls)</li>
13188 <li><a href="#controls_android.lens.focusDistance">android.lens.focusDistance</a> (controls)</li>
13189 <li><a href="#controls_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (controls)</li>
13190 <li><a href="#static_android.lens.info.availableApertures">android.lens.info.availableApertures</a> (static)</li>
13191 <li><a href="#static_android.lens.info.availableFilterDensities">android.lens.info.availableFilterDensities</a> (static)</li>
13192 <li><a href="#static_android.lens.info.availableFocalLengths">android.lens.info.availableFocalLengths</a> (static)</li>
13193 <li><a href="#static_android.lens.info.availableOpticalStabilization">android.lens.info.availableOpticalStabilization</a> (static)</li>
13194 <li><a href="#static_android.lens.info.geometricCorrectionMapSize">android.lens.info.geometricCorrectionMapSize</a> (static)</li>
13195 <li><a href="#static_android.lens.info.minimumFocusDistance">android.lens.info.minimumFocusDistance</a> (static)</li>
13196 <li><a href="#static_android.lens.info.shadingMapSize">android.lens.info.shadingMapSize</a> (static)</li>
13197 <li><a href="#static_android.lens.position">android.lens.position</a> (static)</li>
13198 <li><a href="#dynamic_android.lens.state">android.lens.state</a> (dynamic)</li>
13199 <li><a href="#controls_android.noiseReduction.mode">android.noiseReduction.mode</a> (controls)</li>
13200 <li><a href="#controls_android.request.id">android.request.id</a> (controls)</li>
13201 <li><a href="#controls_android.sensor.exposureTime">android.sensor.exposureTime</a> (controls)</li>
13202 <li><a href="#controls_android.sensor.frameDuration">android.sensor.frameDuration</a> (controls)</li>
13203 <li><a href="#controls_android.sensor.sensitivity">android.sensor.sensitivity</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13204 <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]13205 <li><a href="#static_android.sensor.info.exposureTimeRange">android.sensor.info.exposureTimeRange</a> (static)</li>
13206 <li><a href="#static_android.sensor.info.maxFrameDuration">android.sensor.info.maxFrameDuration</a> (static)</li>
13207 <li><a href="#static_android.sensor.info.physicalSize">android.sensor.info.physicalSize</a> (static)</li>
13208 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13209 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13210 <li><a href="#static_android.sensor.noiseModelCoefficients">android.sensor.noiseModelCoefficients</a> (static)</li>
13211 <li><a href="#controls_android.statistics.histogramMode">android.statistics.histogramMode</a> (controls)</li>
13212 <li><a href="#controls_android.statistics.sharpnessMapMode">android.statistics.sharpnessMapMode</a> (controls)</li>
13213 <li><a href="#dynamic_android.statistics.histogram">android.statistics.histogram</a> (dynamic)</li>
13214 <li><a href="#dynamic_android.statistics.sharpnessMap">android.statistics.sharpnessMap</a> (dynamic)</li>
13215 <li><a href="#dynamic_android.hotPixel.mode">android.hotPixel.mode</a> (dynamic)</li>
13216 <li><a href="#dynamic_android.lens.aperture">android.lens.aperture</a> (dynamic)</li>
13217 <li><a href="#dynamic_android.lens.filterDensity">android.lens.filterDensity</a> (dynamic)</li>
13218 <li><a href="#dynamic_android.lens.opticalStabilizationMode">android.lens.opticalStabilizationMode</a> (dynamic)</li>
13219 </ul>
13220 </li> <!-- tag_V1 -->
13221 <li id="tag_ADV">ADV - None
13222 <ul class="tags_entries">
13223 <li><a href="#static_android.flash.colorTemperature">android.flash.colorTemperature</a> (static)</li>
13224 <li><a href="#static_android.flash.maxEnergy">android.flash.maxEnergy</a> (static)</li>
13225 <li><a href="#controls_android.geometric.strength">android.geometric.strength</a> (controls)</li>
13226 <li><a href="#static_android.hotPixel.info.map">android.hotPixel.info.map</a> (static)</li>
13227 <li><a href="#static_android.lens.opticalAxisAngle">android.lens.opticalAxisAngle</a> (static)</li>
13228 <li><a href="#controls_android.shading.strength">android.shading.strength</a> (controls)</li>
13229 </ul>
13230 </li> <!-- tag_ADV -->
13231 <li id="tag_DNG">DNG -
13232 Needed for DNG file support
13233
13234 <ul class="tags_entries">
13235 <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]13236 <li><a href="#static_android.sensor.info.activeArraySize">android.sensor.info.activeArraySize</a> (static)</li>
13237 <li><a href="#static_android.sensor.info.colorFilterArrangement">android.sensor.info.colorFilterArrangement</a> (static)</li>
13238 <li><a href="#static_android.sensor.info.pixelArraySize">android.sensor.info.pixelArraySize</a> (static)</li>
13239 <li><a href="#static_android.sensor.info.whiteLevel">android.sensor.info.whiteLevel</a> (static)</li>
13240 <li><a href="#static_android.sensor.blackLevelPattern">android.sensor.blackLevelPattern</a> (static)</li>
13241 <li><a href="#static_android.sensor.calibrationTransform1">android.sensor.calibrationTransform1</a> (static)</li>
13242 <li><a href="#static_android.sensor.calibrationTransform2">android.sensor.calibrationTransform2</a> (static)</li>
13243 <li><a href="#static_android.sensor.colorTransform1">android.sensor.colorTransform1</a> (static)</li>
13244 <li><a href="#static_android.sensor.colorTransform2">android.sensor.colorTransform2</a> (static)</li>
13245 <li><a href="#static_android.sensor.forwardMatrix1">android.sensor.forwardMatrix1</a> (static)</li>
13246 <li><a href="#static_android.sensor.forwardMatrix2">android.sensor.forwardMatrix2</a> (static)</li>
13247 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13248 <li><a href="#controls_android.tonemap.curveRed">android.tonemap.curveRed</a> (controls)</li>
13249 </ul>
13250 </li> <!-- tag_DNG -->
13251 <li id="tag_EXIF">EXIF - None
13252 <ul class="tags_entries">
13253 <li><a href="#static_android.sensor.referenceIlluminant1">android.sensor.referenceIlluminant1</a> (static)</li>
13254 </ul>
13255 </li> <!-- tag_EXIF -->
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13256 <li id="tag_HAL2">HAL2 -
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13257 Entry is only used by camera device HAL 2.x
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13258
13259 <ul class="tags_entries">
13260 <li><a href="#controls_android.request.inputStreams">android.request.inputStreams</a> (controls)</li>
13261 <li><a href="#controls_android.request.outputStreams">android.request.outputStreams</a> (controls)</li>
13262 <li><a href="#controls_android.request.type">android.request.type</a> (controls)</li>
Zhijun He69fc0ea2013-07-17 09:42:58 -0700[diff] [blame]13263 <li><a href="#controls_android.blackLevel.lock">android.blackLevel.lock</a> (controls)</li>
Eino-Ville Talvalaf384f0a2013-07-12 17:02:27 -0700[diff] [blame]13264 </ul>
13265 </li> <!-- tag_HAL2 -->
Alex Rayef40ad62013-10-01 17:52:33 -0700[diff] [blame]13266 <li id="tag_FULL">FULL -
13267 Entry is required for full hardware level devices, and optional for other hardware levels
13268
13269 <ul class="tags_entries">
13270 <li><a href="#static_android.sensor.baseGainFactor">android.sensor.baseGainFactor</a> (static)</li>
13271 <li><a href="#static_android.sensor.maxAnalogSensitivity">android.sensor.maxAnalogSensitivity</a> (static)</li>
13272 <li><a href="#dynamic_android.sensor.temperature">android.sensor.temperature</a> (dynamic)</li>
13273 </ul>
13274 </li> <!-- tag_FULL -->
Igor Murashkin08b8aad2012-11-29 15:23:03 -0800[diff] [blame]13275 </ul>
13276 </div>
13277
13278 [ <a href="#">top</a> ]
13279
13280</body>
13281</html>