Commit | Line | Data |
---|---|---|
1e494cf4 JB |
1 | /* |
2 | * Copyright (C) 2011 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 | #ifndef SYSTEM_CORE_INCLUDE_ANDROID_CAMERA_H | |
18 | #define SYSTEM_CORE_INCLUDE_ANDROID_CAMERA_H | |
19 | ||
20 | #include <stdint.h> | |
21 | #include <sys/cdefs.h> | |
22 | #include <sys/types.h> | |
23 | #include <cutils/native_handle.h> | |
24 | #include <hardware/hardware.h> | |
25 | #include <hardware/gralloc.h> | |
26 | ||
27 | __BEGIN_DECLS | |
28 | ||
29 | /** | |
30 | * A set of bit masks for specifying how the received preview frames are | |
31 | * handled before the previewCallback() call. | |
32 | * | |
33 | * The least significant 3 bits of an "int" value are used for this purpose: | |
34 | * | |
35 | * ..... 0 0 0 | |
36 | * ^ ^ ^ | |
37 | * | | |---------> determine whether the callback is enabled or not | |
38 | * | |-----------> determine whether the callback is one-shot or not | |
39 | * |-------------> determine whether the frame is copied out or not | |
40 | * | |
41 | * WARNING: When a frame is sent directly without copying, it is the frame | |
42 | * receiver's responsiblity to make sure that the frame data won't get | |
43 | * corrupted by subsequent preview frames filled by the camera. This flag is | |
44 | * recommended only when copying out data brings significant performance price | |
45 | * and the handling/processing of the received frame data is always faster than | |
46 | * the preview frame rate so that data corruption won't occur. | |
47 | * | |
48 | * For instance, | |
49 | * 1. 0x00 disables the callback. In this case, copy out and one shot bits | |
50 | * are ignored. | |
51 | * 2. 0x01 enables a callback without copying out the received frames. A | |
52 | * typical use case is the Camcorder application to avoid making costly | |
53 | * frame copies. | |
54 | * 3. 0x05 is enabling a callback with frame copied out repeatedly. A typical | |
55 | * use case is the Camera application. | |
56 | * 4. 0x07 is enabling a callback with frame copied out only once. A typical | |
57 | * use case is the Barcode scanner application. | |
58 | */ | |
59 | ||
60 | enum { | |
61 | CAMERA_FRAME_CALLBACK_FLAG_ENABLE_MASK = 0x01, | |
62 | CAMERA_FRAME_CALLBACK_FLAG_ONE_SHOT_MASK = 0x02, | |
63 | CAMERA_FRAME_CALLBACK_FLAG_COPY_OUT_MASK = 0x04, | |
64 | /** Typical use cases */ | |
65 | CAMERA_FRAME_CALLBACK_FLAG_NOOP = 0x00, | |
66 | CAMERA_FRAME_CALLBACK_FLAG_CAMCORDER = 0x01, | |
67 | CAMERA_FRAME_CALLBACK_FLAG_CAMERA = 0x05, | |
68 | CAMERA_FRAME_CALLBACK_FLAG_BARCODE_SCANNER = 0x07 | |
69 | }; | |
70 | ||
71 | /** msgType in notifyCallback and dataCallback functions */ | |
72 | enum { | |
73 | CAMERA_MSG_ERROR = 0x0001, // notifyCallback | |
74 | CAMERA_MSG_SHUTTER = 0x0002, // notifyCallback | |
75 | CAMERA_MSG_FOCUS = 0x0004, // notifyCallback | |
76 | CAMERA_MSG_ZOOM = 0x0008, // notifyCallback | |
77 | CAMERA_MSG_PREVIEW_FRAME = 0x0010, // dataCallback | |
78 | CAMERA_MSG_VIDEO_FRAME = 0x0020, // data_timestamp_callback | |
79 | CAMERA_MSG_POSTVIEW_FRAME = 0x0040, // dataCallback | |
80 | CAMERA_MSG_RAW_IMAGE = 0x0080, // dataCallback | |
81 | CAMERA_MSG_COMPRESSED_IMAGE = 0x0100, // dataCallback | |
82 | CAMERA_MSG_RAW_IMAGE_NOTIFY = 0x0200, // dataCallback | |
83 | // Preview frame metadata. This can be combined with | |
84 | // CAMERA_MSG_PREVIEW_FRAME in dataCallback. For example, the apps can | |
85 | // request FRAME and METADATA. Or the apps can request only FRAME or only | |
86 | // METADATA. | |
87 | CAMERA_MSG_PREVIEW_METADATA = 0x0400, // dataCallback | |
88 | // Notify on autofocus start and stop. This is useful in continuous | |
89 | // autofocus - FOCUS_MODE_CONTINUOUS_VIDEO and FOCUS_MODE_CONTINUOUS_PICTURE. | |
90 | #if defined(QCOM_ICS_COMPAT) && defined(QCOM_HARDWARE) | |
91 | CAMERA_MSG_STATS_DATA = 0x800, | |
92 | CAMERA_MSG_FOCUS_MOVE = 0x1000, // notifyCallback | |
93 | #elif defined(OMAP_ICS_CAMERA) && defined(OMAP_ENHANCEMENT) | |
94 | CAMERA_MSG_COMPRESSED_BURST_IMAGE = 0x0800, //dataCallback | |
95 | CAMERA_MSG_RAW_BURST = 0x1000, // dataCallback | |
96 | #else | |
97 | CAMERA_MSG_FOCUS_MOVE = 0x0800, // notifyCallback | |
98 | #ifdef QCOM_HARDWARE | |
99 | CAMERA_MSG_STATS_DATA = 0x1000, | |
100 | #elif defined(OMAP_ENHANCEMENT) && defined(OMAP_ENHANCEMENT_BURST_CAPTURE) | |
101 | CAMERA_MSG_COMPRESSED_BURST_IMAGE = 0x1000, // dataCallback | |
102 | CAMERA_MSG_RAW_BURST = 0x2000, // dataCallback | |
103 | #endif | |
104 | #endif | |
105 | CAMERA_MSG_ALL_MSGS = 0xFFFF | |
106 | }; | |
107 | ||
108 | /** cmdType in sendCommand functions */ | |
109 | enum { | |
110 | CAMERA_CMD_START_SMOOTH_ZOOM = 1, | |
111 | CAMERA_CMD_STOP_SMOOTH_ZOOM = 2, | |
112 | ||
113 | /** | |
114 | * Set the clockwise rotation of preview display (setPreviewDisplay) in | |
115 | * degrees. This affects the preview frames and the picture displayed after | |
116 | * snapshot. This method is useful for portrait mode applications. Note | |
117 | * that preview display of front-facing cameras is flipped horizontally | |
118 | * before the rotation, that is, the image is reflected along the central | |
119 | * vertical axis of the camera sensor. So the users can see themselves as | |
120 | * looking into a mirror. | |
121 | * | |
122 | * This does not affect the order of byte array of | |
123 | * CAMERA_MSG_PREVIEW_FRAME, CAMERA_MSG_VIDEO_FRAME, | |
124 | * CAMERA_MSG_POSTVIEW_FRAME, CAMERA_MSG_RAW_IMAGE, or | |
125 | * CAMERA_MSG_COMPRESSED_IMAGE. This is allowed to be set during preview | |
126 | * since API level 14. | |
127 | */ | |
128 | CAMERA_CMD_SET_DISPLAY_ORIENTATION = 3, | |
129 | ||
130 | /** | |
131 | * cmdType to disable/enable shutter sound. In sendCommand passing arg1 = | |
132 | * 0 will disable, while passing arg1 = 1 will enable the shutter sound. | |
133 | */ | |
134 | CAMERA_CMD_ENABLE_SHUTTER_SOUND = 4, | |
135 | ||
136 | /* cmdType to play recording sound */ | |
137 | CAMERA_CMD_PLAY_RECORDING_SOUND = 5, | |
138 | ||
139 | /** | |
140 | * Start the face detection. This should be called after preview is started. | |
141 | * The camera will notify the listener of CAMERA_MSG_FACE and the detected | |
142 | * faces in the preview frame. The detected faces may be the same as the | |
143 | * previous ones. Apps should call CAMERA_CMD_STOP_FACE_DETECTION to stop | |
144 | * the face detection. This method is supported if CameraParameters | |
145 | * KEY_MAX_NUM_HW_DETECTED_FACES or KEY_MAX_NUM_SW_DETECTED_FACES is | |
146 | * bigger than 0. Hardware and software face detection should not be running | |
147 | * at the same time. If the face detection has started, apps should not send | |
148 | * this again. | |
149 | * | |
150 | * In hardware face detection mode, CameraParameters KEY_WHITE_BALANCE, | |
151 | * KEY_FOCUS_AREAS and KEY_METERING_AREAS have no effect. | |
152 | * | |
153 | * arg1 is the face detection type. It can be CAMERA_FACE_DETECTION_HW or | |
154 | * CAMERA_FACE_DETECTION_SW. If the type of face detection requested is not | |
155 | * supported, the HAL must return BAD_VALUE. | |
156 | */ | |
157 | CAMERA_CMD_START_FACE_DETECTION = 6, | |
158 | ||
159 | /** | |
160 | * Stop the face detection. | |
161 | */ | |
162 | CAMERA_CMD_STOP_FACE_DETECTION = 7, | |
163 | ||
164 | #if defined(QCOM_ICS_COMPAT) && defined(QCOM_HARDWARE) | |
165 | CAMERA_CMD_HISTOGRAM_ON = 8, | |
166 | CAMERA_CMD_HISTOGRAM_OFF = 9, | |
167 | CAMERA_CMD_HISTOGRAM_SEND_DATA = 10, | |
168 | /* Unused by the older blobs, but referenced */ | |
169 | CAMERA_CMD_ENABLE_FOCUS_MOVE_MSG = 11, | |
170 | CAMERA_CMD_PING = 12, | |
171 | CAMERA_CMD_SET_VIDEO_BUFFER_COUNT = 13, | |
172 | #else | |
173 | /** | |
174 | * Enable/disable focus move callback (CAMERA_MSG_FOCUS_MOVE). Passing | |
175 | * arg1 = 0 will disable, while passing arg1 = 1 will enable the callback. | |
176 | */ | |
177 | CAMERA_CMD_ENABLE_FOCUS_MOVE_MSG = 8, | |
178 | ||
179 | /** | |
180 | * Ping camera service to see if camera hardware is released. | |
181 | * | |
182 | * When any camera method returns error, the client can use ping command | |
183 | * to see if the camera has been taken away by other clients. If the result | |
184 | * is NO_ERROR, it means the camera hardware is not released. If the result | |
185 | * is not NO_ERROR, the camera has been released and the existing client | |
186 | * can silently finish itself or show a dialog. | |
187 | */ | |
188 | CAMERA_CMD_PING = 9, | |
189 | ||
190 | /** | |
191 | * Configure the number of video buffers used for recording. The intended | |
192 | * video buffer count for recording is passed as arg1, which must be | |
193 | * greater than 0. This command must be sent before recording is started. | |
194 | * This command returns INVALID_OPERATION error if it is sent after video | |
195 | * recording is started, or the command is not supported at all. This | |
196 | * command also returns a BAD_VALUE error if the intended video buffer | |
197 | * count is non-positive or too big to be realized. | |
198 | */ | |
199 | CAMERA_CMD_SET_VIDEO_BUFFER_COUNT = 10, | |
200 | #endif | |
201 | ||
202 | }; | |
203 | ||
204 | /** camera fatal errors */ | |
205 | enum { | |
206 | CAMERA_ERROR_UNKNOWN = 1, | |
207 | /** | |
208 | * Camera was released because another client has connected to the camera. | |
209 | * The original client should call Camera::disconnect immediately after | |
210 | * getting this notification. Otherwise, the camera will be released by | |
211 | * camera service in a short time. The client should not call any method | |
212 | * (except disconnect and sending CAMERA_CMD_PING) after getting this. | |
213 | */ | |
214 | CAMERA_ERROR_RELEASED = 2, | |
215 | CAMERA_ERROR_SERVER_DIED = 100 | |
216 | }; | |
217 | ||
218 | enum { | |
219 | /** The facing of the camera is opposite to that of the screen. */ | |
220 | CAMERA_FACING_BACK = 0, | |
221 | /** The facing of the camera is the same as that of the screen. */ | |
222 | CAMERA_FACING_FRONT = 1 | |
223 | }; | |
224 | ||
225 | #ifdef QCOM_HARDWARE | |
226 | enum { | |
227 | CAMERA_SUPPORT_MODE_2D = 0x01, /* Camera Sensor supports 2D mode. */ | |
228 | CAMERA_SUPPORT_MODE_3D = 0x02, /* Camera Sensor supports 3D mode. */ | |
229 | CAMERA_SUPPORT_MODE_NONZSL = 0x04, /* Camera Sensor in NON-ZSL mode. */ | |
230 | CAMERA_SUPPORT_MODE_ZSL = 0x08 /* Camera Sensor supports ZSL mode. */ | |
231 | }; | |
232 | #endif | |
233 | ||
234 | enum { | |
235 | /** Hardware face detection. It does not use much CPU. */ | |
236 | CAMERA_FACE_DETECTION_HW = 0, | |
237 | /** | |
238 | * Software face detection. It uses some CPU. Applications must use | |
239 | * Camera.setPreviewTexture for preview in this mode. | |
240 | */ | |
241 | CAMERA_FACE_DETECTION_SW = 1 | |
242 | }; | |
243 | ||
244 | /** | |
245 | * The information of a face from camera face detection. | |
246 | */ | |
247 | typedef struct camera_face { | |
248 | /** | |
249 | * Bounds of the face [left, top, right, bottom]. (-1000, -1000) represents | |
250 | * the top-left of the camera field of view, and (1000, 1000) represents the | |
251 | * bottom-right of the field of view. The width and height cannot be 0 or | |
252 | * negative. This is supported by both hardware and software face detection. | |
253 | * | |
254 | * The direction is relative to the sensor orientation, that is, what the | |
255 | * sensor sees. The direction is not affected by the rotation or mirroring | |
256 | * of CAMERA_CMD_SET_DISPLAY_ORIENTATION. | |
257 | */ | |
258 | int32_t rect[4]; | |
259 | ||
260 | /** | |
261 | * The confidence level of the face. The range is 1 to 100. 100 is the | |
262 | * highest confidence. This is supported by both hardware and software | |
263 | * face detection. | |
264 | */ | |
265 | int32_t score; | |
266 | ||
267 | /** | |
268 | * An unique id per face while the face is visible to the tracker. If | |
269 | * the face leaves the field-of-view and comes back, it will get a new | |
270 | * id. If the value is 0, id is not supported. | |
271 | */ | |
272 | int32_t id; | |
273 | ||
274 | /** | |
275 | * The coordinates of the center of the left eye. The range is -1000 to | |
276 | * 1000. -2000, -2000 if this is not supported. | |
277 | */ | |
278 | int32_t left_eye[2]; | |
279 | ||
280 | /** | |
281 | * The coordinates of the center of the right eye. The range is -1000 to | |
282 | * 1000. -2000, -2000 if this is not supported. | |
283 | */ | |
284 | int32_t right_eye[2]; | |
285 | ||
286 | /** | |
287 | * The coordinates of the center of the mouth. The range is -1000 to 1000. | |
288 | * -2000, -2000 if this is not supported. | |
289 | */ | |
290 | int32_t mouth[2]; | |
291 | ||
292 | } camera_face_t; | |
293 | ||
294 | /** | |
295 | * The metadata of the frame data. | |
296 | */ | |
297 | typedef struct camera_frame_metadata { | |
298 | /** | |
299 | * The number of detected faces in the frame. | |
300 | */ | |
301 | int32_t number_of_faces; | |
302 | ||
303 | /** | |
304 | * An array of the detected faces. The length is number_of_faces. | |
305 | */ | |
306 | camera_face_t *faces; | |
307 | } camera_frame_metadata_t; | |
308 | ||
309 | __END_DECLS | |
310 | ||
311 | #endif /* SYSTEM_CORE_INCLUDE_ANDROID_CAMERA_H */ |