[go: nahoru, domu]
Google Git
Sign in
android / platform / hardware / interfaces / refs/heads/main / . / camera / metadata / 3.3 / types.hal
blob: 0d896818bc283e27dccdda7c39b3c2a77a992313 [file] [log] [blame]
Eino-Ville Talvala6d3fecc2017-12-05 15:52:26 -0800[diff] [blame]1/*
2 * Copyright (C) 2017 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17/*
18 * Autogenerated from camera metadata definitions in
19 * /system/media/camera/docs/metadata_definitions.xml
20 * *** DO NOT EDIT BY HAND ***
21 */
22
23package android.hardware.camera.metadata@3.3;
24
Eino-Ville Talvala6d3fecc2017-12-05 15:52:26 -0800[diff] [blame]25import android.hardware.camera.metadata@3.2;
26
Shuzhen Wang82e36b32017-11-28 17:00:43 -0800[diff] [blame]27/**
28 * Top level hierarchy definitions for camera metadata. *_INFO sections are for
29 * the static metadata that can be retrived without opening the camera device.
30 */
31enum CameraMetadataSection : @3.2::CameraMetadataSection {
32 ANDROID_LOGICAL_MULTI_CAMERA =
33 android.hardware.camera.metadata@3.2::CameraMetadataSection:ANDROID_SECTION_COUNT,
34
Eino-Ville Talvala7b5fd702018-03-13 19:46:29 -0700[diff] [blame]35 ANDROID_DISTORTION_CORRECTION,
36
Shuzhen Wang82e36b32017-11-28 17:00:43 -0800[diff] [blame]37 ANDROID_SECTION_COUNT_3_3,
38
39 VENDOR_SECTION_3_3 = 0x8000,
40
41};
42
43/**
44 * Hierarchy positions in enum space. All vendor extension sections must be
45 * defined with tag >= VENDOR_SECTION_START
46 */
47enum CameraMetadataSectionStart : android.hardware.camera.metadata@3.2::CameraMetadataSectionStart {
48 ANDROID_LOGICAL_MULTI_CAMERA_START = CameraMetadataSection:ANDROID_LOGICAL_MULTI_CAMERA << 16,
49
Eino-Ville Talvala7b5fd702018-03-13 19:46:29 -0700[diff] [blame]50 ANDROID_DISTORTION_CORRECTION_START = CameraMetadataSection:ANDROID_DISTORTION_CORRECTION << 16,
51
Shuzhen Wang82e36b32017-11-28 17:00:43 -0800[diff] [blame]52 VENDOR_SECTION_START_3_3 = CameraMetadataSection:VENDOR_SECTION_3_3 << 16,
53
54};
Eino-Ville Talvala6d3fecc2017-12-05 15:52:26 -0800[diff] [blame]55
56/**
57 * Main enumeration for defining camera metadata tags added in this revision
58 *
59 * <p>Partial documentation is included for each tag; for complete documentation, reference
60 * '/system/media/camera/docs/docs.html' in the corresponding Android source tree.</p>
61 */
62enum CameraMetadataTag : @3.2::CameraMetadataTag {
63 /** android.control.afSceneChange [dynamic, enum, public]
64 *
65 * <p>Whether a significant scene change is detected within the currently-set AF
66 * region(s).</p>
67 */
68 ANDROID_CONTROL_AF_SCENE_CHANGE = android.hardware.camera.metadata@3.2::CameraMetadataTag:ANDROID_CONTROL_END,
69
70 ANDROID_CONTROL_END_3_3,
71
Eino-Ville Talvalae41911b2017-12-11 10:42:05 -0800[diff] [blame]72 /** android.lens.poseReference [static, enum, public]
73 *
Shuzhen Wangc5ae0692020-01-08 13:06:26 -0800[diff] [blame]74 * <p>The origin for ANDROID_LENS_POSE_TRANSLATION, and the accuracy of
75 * ANDROID_LENS_POSE_TRANSLATION and ANDROID_LENS_POSE_ROTATION.</p>
Eino-Ville Talvalae41911b2017-12-11 10:42:05 -0800[diff] [blame]76 *
Shuzhen Wangc5ae0692020-01-08 13:06:26 -0800[diff] [blame]77 * @see ANDROID_LENS_POSE_ROTATION
Eino-Ville Talvalae41911b2017-12-11 10:42:05 -0800[diff] [blame]78 * @see ANDROID_LENS_POSE_TRANSLATION
79 */
80 ANDROID_LENS_POSE_REFERENCE = android.hardware.camera.metadata@3.2::CameraMetadataTag:ANDROID_LENS_END,
81
Eino-Ville Talvala9171b612018-03-13 19:11:11 -0700[diff] [blame]82 /** android.lens.distortion [dynamic, float[], public]
83 *
84 * <p>The correction coefficients to correct for this camera device's
85 * radial and tangential lens distortion.</p>
86 * <p>Replaces the deprecated ANDROID_LENS_RADIAL_DISTORTION field, which was
87 * inconsistently defined.</p>
88 *
89 * @see ANDROID_LENS_RADIAL_DISTORTION
90 */
91 ANDROID_LENS_DISTORTION,
92
Eino-Ville Talvalae41911b2017-12-11 10:42:05 -0800[diff] [blame]93 ANDROID_LENS_END_3_3,
94
Emilian Peev9fc7f3b2018-01-10 13:49:29 +0000[diff] [blame]95 /** android.request.availableSessionKeys [static, int32[], ndk_public]
96 *
97 * <p>A subset of the available request keys that the camera device
98 * can pass as part of the capture session initialization.</p>
99 */
100 ANDROID_REQUEST_AVAILABLE_SESSION_KEYS = android.hardware.camera.metadata@3.2::CameraMetadataTag:ANDROID_REQUEST_END,
101
Shuzhen Wangf09054c2019-02-28 15:27:07 -0800[diff] [blame]102 /** android.request.availablePhysicalCameraRequestKeys [static, int32[], ndk_public]
Emilian Peevb75aa352018-01-17 11:00:54 +0000[diff] [blame]103 *
Shuzhen Wang068b1c62018-10-11 09:45:40 -0700[diff] [blame]104 * <p>A subset of the available request keys that can be overridden for
Emilian Peevb75aa352018-01-17 11:00:54 +0000[diff] [blame]105 * physical devices backing a logical multi-camera.</p>
106 */
107 ANDROID_REQUEST_AVAILABLE_PHYSICAL_CAMERA_REQUEST_KEYS,
108
Emilian Peev9fc7f3b2018-01-10 13:49:29 +0000[diff] [blame]109 ANDROID_REQUEST_END_3_3,
110
Chien-Yu Chen5e8a1be2018-01-19 11:19:46 -0800[diff] [blame]111 /** android.statistics.oisDataMode [dynamic, enum, public]
112 *
Eino-Ville Talvala5845a3f2018-08-01 17:31:44 -0700[diff] [blame]113 * <p>A control for selecting whether optical stabilization (OIS) position
114 * information is included in output result metadata.</p>
Chien-Yu Chen5e8a1be2018-01-19 11:19:46 -0800[diff] [blame]115 */
116 ANDROID_STATISTICS_OIS_DATA_MODE = android.hardware.camera.metadata@3.2::CameraMetadataTag:ANDROID_STATISTICS_END,
117
Chien-Yu Chend8c31602018-02-15 12:40:36 -0800[diff] [blame]118 /** android.statistics.oisTimestamps [dynamic, int64[], ndk_public]
Chien-Yu Chen5e8a1be2018-01-19 11:19:46 -0800[diff] [blame]119 *
120 * <p>An array of timestamps of OIS samples, in nanoseconds.</p>
121 */
122 ANDROID_STATISTICS_OIS_TIMESTAMPS,
123
Chien-Yu Chend8c31602018-02-15 12:40:36 -0800[diff] [blame]124 /** android.statistics.oisXShifts [dynamic, float[], ndk_public]
Chien-Yu Chen5e8a1be2018-01-19 11:19:46 -0800[diff] [blame]125 *
126 * <p>An array of shifts of OIS samples, in x direction.</p>
127 */
128 ANDROID_STATISTICS_OIS_X_SHIFTS,
129
Chien-Yu Chend8c31602018-02-15 12:40:36 -0800[diff] [blame]130 /** android.statistics.oisYShifts [dynamic, float[], ndk_public]
Chien-Yu Chen5e8a1be2018-01-19 11:19:46 -0800[diff] [blame]131 *
132 * <p>An array of shifts of OIS samples, in y direction.</p>
133 */
134 ANDROID_STATISTICS_OIS_Y_SHIFTS,
135
136 ANDROID_STATISTICS_END_3_3,
137
138 /** android.statistics.info.availableOisDataModes [static, byte[], public]
139 *
140 * <p>List of OIS data output modes for ANDROID_STATISTICS_OIS_DATA_MODE that
141 * are supported by this camera device.</p>
142 *
143 * @see ANDROID_STATISTICS_OIS_DATA_MODE
144 */
145 ANDROID_STATISTICS_INFO_AVAILABLE_OIS_DATA_MODES = android.hardware.camera.metadata@3.2::CameraMetadataTag:ANDROID_STATISTICS_INFO_END,
146
147 ANDROID_STATISTICS_INFO_END_3_3,
148
Chien-Yu Chen13cfbf02018-01-03 14:39:59 -0800[diff] [blame]149 /** android.info.version [static, byte, public]
150 *
151 * <p>A short string for manufacturer version information about the camera device, such as
152 * ISP hardware, sensors, etc.</p>
153 */
154 ANDROID_INFO_VERSION = android.hardware.camera.metadata@3.2::CameraMetadataTag:ANDROID_INFO_END,
155
156 ANDROID_INFO_END_3_3,
157
Shuzhen Wangf43ecc92018-12-07 17:52:32 -0800[diff] [blame]158 /** android.logicalMultiCamera.physicalIds [static, byte[], ndk_public]
Shuzhen Wang82e36b32017-11-28 17:00:43 -0800[diff] [blame]159 *
160 * <p>String containing the ids of the underlying physical cameras.</p>
161 */
162 ANDROID_LOGICAL_MULTI_CAMERA_PHYSICAL_IDS = CameraMetadataSectionStart:ANDROID_LOGICAL_MULTI_CAMERA_START,
163
164 /** android.logicalMultiCamera.sensorSyncType [static, enum, public]
165 *
166 * <p>The accuracy of frame timestamp synchronization between physical cameras</p>
167 */
168 ANDROID_LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE,
169
170 ANDROID_LOGICAL_MULTI_CAMERA_END_3_3,
171
Eino-Ville Talvala7b5fd702018-03-13 19:46:29 -0700[diff] [blame]172 /** android.distortionCorrection.mode [dynamic, enum, public]
173 *
174 * <p>Mode of operation for the lens distortion correction block.</p>
175 */
176 ANDROID_DISTORTION_CORRECTION_MODE = CameraMetadataSectionStart:ANDROID_DISTORTION_CORRECTION_START,
177
178 /** android.distortionCorrection.availableModes [static, byte[], public]
179 *
180 * <p>List of distortion correction modes for ANDROID_DISTORTION_CORRECTION_MODE that are
181 * supported by this camera device.</p>
182 *
183 * @see ANDROID_DISTORTION_CORRECTION_MODE
184 */
185 ANDROID_DISTORTION_CORRECTION_AVAILABLE_MODES,
186
187 ANDROID_DISTORTION_CORRECTION_END_3_3,
188
Eino-Ville Talvala6d3fecc2017-12-05 15:52:26 -0800[diff] [blame]189};
190
191/*
192 * Enumeration definitions for the various entries that need them
193 */
194
Chien-Yu Chen79f734b2018-01-11 10:54:38 -0800[diff] [blame]195/** android.control.aeMode enumeration values added since v3.2
196 * @see ANDROID_CONTROL_AE_MODE
197 */
198enum CameraMetadataEnumAndroidControlAeMode :
199 @3.2::CameraMetadataEnumAndroidControlAeMode {
200 ANDROID_CONTROL_AE_MODE_ON_EXTERNAL_FLASH,
201};
202
Eino-Ville Talvalae41911b2017-12-11 10:42:05 -0800[diff] [blame]203/** android.control.captureIntent enumeration values added since v3.2
204 * @see ANDROID_CONTROL_CAPTURE_INTENT
205 */
206enum CameraMetadataEnumAndroidControlCaptureIntent :
207 @3.2::CameraMetadataEnumAndroidControlCaptureIntent {
208 ANDROID_CONTROL_CAPTURE_INTENT_MOTION_TRACKING,
209};
210
Eino-Ville Talvala6d3fecc2017-12-05 15:52:26 -0800[diff] [blame]211/** android.control.afSceneChange enumeration values
212 * @see ANDROID_CONTROL_AF_SCENE_CHANGE
213 */
214enum CameraMetadataEnumAndroidControlAfSceneChange : uint32_t {
215 ANDROID_CONTROL_AF_SCENE_CHANGE_NOT_DETECTED,
216 ANDROID_CONTROL_AF_SCENE_CHANGE_DETECTED,
217};
Eino-Ville Talvalae41911b2017-12-11 10:42:05 -0800[diff] [blame]218
219/** android.lens.poseReference enumeration values
220 * @see ANDROID_LENS_POSE_REFERENCE
221 */
222enum CameraMetadataEnumAndroidLensPoseReference : uint32_t {
223 ANDROID_LENS_POSE_REFERENCE_PRIMARY_CAMERA,
224 ANDROID_LENS_POSE_REFERENCE_GYROSCOPE,
225};
226
227/** android.request.availableCapabilities enumeration values added since v3.2
228 * @see ANDROID_REQUEST_AVAILABLE_CAPABILITIES
229 */
230enum CameraMetadataEnumAndroidRequestAvailableCapabilities :
231 @3.2::CameraMetadataEnumAndroidRequestAvailableCapabilities {
232 ANDROID_REQUEST_AVAILABLE_CAPABILITIES_MOTION_TRACKING,
Shuzhen Wang82e36b32017-11-28 17:00:43 -0800[diff] [blame]233 ANDROID_REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA,
Shuzhen Wangcf41ad42018-03-26 16:16:38 -0700[diff] [blame]234 ANDROID_REQUEST_AVAILABLE_CAPABILITIES_MONOCHROME,
Shuzhen Wang82e36b32017-11-28 17:00:43 -0800[diff] [blame]235};
236
Eino-Ville Talvala0a2a9fc2018-02-05 16:27:15 -0800[diff] [blame]237/** android.statistics.oisDataMode enumeration values
238 * @see ANDROID_STATISTICS_OIS_DATA_MODE
Shuzhen Wang82e36b32017-11-28 17:00:43 -0800[diff] [blame]239 */
Eino-Ville Talvala0a2a9fc2018-02-05 16:27:15 -0800[diff] [blame]240enum CameraMetadataEnumAndroidStatisticsOisDataMode : uint32_t {
241 ANDROID_STATISTICS_OIS_DATA_MODE_OFF,
242 ANDROID_STATISTICS_OIS_DATA_MODE_ON,
Eino-Ville Talvalae41911b2017-12-11 10:42:05 -0800[diff] [blame]243};
Yin-Chia Yeh729eef72018-01-19 11:40:40 -0800[diff] [blame]244
245/** android.info.supportedHardwareLevel enumeration values added since v3.2
246 * @see ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL
247 */
248enum CameraMetadataEnumAndroidInfoSupportedHardwareLevel :
249 @3.2::CameraMetadataEnumAndroidInfoSupportedHardwareLevel {
250 ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_EXTERNAL,
251};
Chien-Yu Chen5e8a1be2018-01-19 11:19:46 -0800[diff] [blame]252
Eino-Ville Talvala0a2a9fc2018-02-05 16:27:15 -0800[diff] [blame]253/** android.logicalMultiCamera.sensorSyncType enumeration values
254 * @see ANDROID_LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE
Chien-Yu Chen5e8a1be2018-01-19 11:19:46 -0800[diff] [blame]255 */
Eino-Ville Talvala0a2a9fc2018-02-05 16:27:15 -0800[diff] [blame]256enum CameraMetadataEnumAndroidLogicalMultiCameraSensorSyncType : uint32_t {
257 ANDROID_LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE_APPROXIMATE,
258 ANDROID_LOGICAL_MULTI_CAMERA_SENSOR_SYNC_TYPE_CALIBRATED,
Chien-Yu Chen5e8a1be2018-01-19 11:19:46 -0800[diff] [blame]259};
Eino-Ville Talvala7b5fd702018-03-13 19:46:29 -0700[diff] [blame]260
261/** android.distortionCorrection.mode enumeration values
262 * @see ANDROID_DISTORTION_CORRECTION_MODE
263 */
264enum CameraMetadataEnumAndroidDistortionCorrectionMode : uint32_t {
265 ANDROID_DISTORTION_CORRECTION_MODE_OFF,
266 ANDROID_DISTORTION_CORRECTION_MODE_FAST,
267 ANDROID_DISTORTION_CORRECTION_MODE_HIGH_QUALITY,
268};