The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 1 | /* |
| 2 | * Copyright (C) 2008 The Android Open Source Project |
| 3 | * Copyright (C) 2008 HTC Inc. |
| 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 | |
| 18 | #ifndef ANDROID_HARDWARE_CAMERA_H |
| 19 | #define ANDROID_HARDWARE_CAMERA_H |
| 20 | |
| 21 | #include <ui/ICameraClient.h> |
| 22 | |
| 23 | namespace android { |
| 24 | |
| 25 | /* |
| 26 | * A set of bit masks for specifying how the received preview frames are |
| 27 | * handled before the previewCallback() call. |
| 28 | * |
| 29 | * The least significant 3 bits of an "int" value are used for this purpose: |
| 30 | * |
| 31 | * ..... 0 0 0 |
| 32 | * ^ ^ ^ |
| 33 | * | | |---------> determine whether the callback is enabled or not |
| 34 | * | |-----------> determine whether the callback is one-shot or not |
| 35 | * |-------------> determine whether the frame is copied out or not |
| 36 | * |
| 37 | * WARNING: |
| 38 | * When a frame is sent directly without copying, it is the frame receiver's |
| 39 | * responsiblity to make sure that the frame data won't get corrupted by |
| 40 | * subsequent preview frames filled by the camera. This flag is recommended |
| 41 | * only when copying out data brings significant performance price and the |
| 42 | * handling/processing of the received frame data is always faster than |
| 43 | * the preview frame rate so that data corruption won't occur. |
| 44 | * |
| 45 | * For instance, |
| 46 | * 1. 0x00 disables the callback. In this case, copy out and one shot bits |
| 47 | * are ignored. |
| 48 | * 2. 0x01 enables a callback without copying out the received frames. A |
| 49 | * typical use case is the Camcorder application to avoid making costly |
| 50 | * frame copies. |
| 51 | * 3. 0x05 is enabling a callback with frame copied out repeatedly. A typical |
| 52 | * use case is the Camera application. |
| 53 | * 4. 0x07 is enabling a callback with frame copied out only once. A typical use |
| 54 | * case is the Barcode scanner application. |
| 55 | */ |
| 56 | #define FRAME_CALLBACK_FLAG_ENABLE_MASK 0x01 |
| 57 | #define FRAME_CALLBACK_FLAG_ONE_SHOT_MASK 0x02 |
| 58 | #define FRAME_CALLBACK_FLAG_COPY_OUT_MASK 0x04 |
| 59 | |
| 60 | // Typical use cases |
| 61 | #define FRAME_CALLBACK_FLAG_NOOP 0x00 |
| 62 | #define FRAME_CALLBACK_FLAG_CAMCORDER 0x01 |
| 63 | #define FRAME_CALLBACK_FLAG_CAMERA 0x05 |
| 64 | #define FRAME_CALLBACK_FLAG_BARCODE_SCANNER 0x07 |
| 65 | |
Dave Sparks | 93b9458 | 2009-05-07 19:27:32 -0700 | [diff] [blame] | 66 | // msgType in notifyCallback function |
| 67 | enum { |
| 68 | CAMERA_MSG_ERROR, |
| 69 | CAMERA_MSG_SHUTTER, |
| 70 | CAMERA_MSG_FOCUS, |
| 71 | CAMERA_MSG_ZOOM |
| 72 | }; |
| 73 | |
| 74 | // msgType in dataCallback function |
| 75 | enum { |
| 76 | CAMERA_MSG_PREVIEW_FRAME, |
| 77 | CAMERA_MSG_VIDEO_FRAME, |
| 78 | CAMERA_MSG_POSTVIEW_FRAME, |
| 79 | CAMERA_MSG_RAW_IMAGE, |
| 80 | CAMERA_MSG_COMPRESSED_IMAGE |
| 81 | }; |
| 82 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 83 | class ICameraService; |
| 84 | class ICamera; |
| 85 | class Surface; |
| 86 | class Mutex; |
| 87 | class String8; |
| 88 | |
Dave Sparks | bbbc7cb | 2009-06-23 17:30:11 -0700 | [diff] [blame] | 89 | // ref-counted object for callbacks |
| 90 | class CameraListener: virtual public RefBase |
| 91 | { |
| 92 | public: |
| 93 | virtual void notify(int32_t msgType, int32_t ext1, int32_t ext2) = 0; |
| 94 | virtual void postData(int32_t msgType, const sp<IMemory>& dataPtr) = 0; |
| 95 | }; |
| 96 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 97 | typedef void (*shutter_callback)(void *cookie); |
| 98 | typedef void (*frame_callback)(const sp<IMemory>& mem, void *cookie); |
| 99 | typedef void (*autofocus_callback)(bool focused, void *cookie); |
| 100 | typedef void (*error_callback)(status_t err, void *cookie); |
| 101 | |
| 102 | class Camera : public BnCameraClient, public IBinder::DeathRecipient |
| 103 | { |
| 104 | public: |
| 105 | // construct a camera client from an existing remote |
James Dong | f1a5314 | 2009-04-23 14:07:23 -0700 | [diff] [blame] | 106 | static sp<Camera> create(const sp<ICamera>& camera); |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 107 | static sp<Camera> connect(); |
| 108 | ~Camera(); |
| 109 | void init(); |
| 110 | |
| 111 | status_t reconnect(); |
| 112 | void disconnect(); |
| 113 | status_t lock(); |
| 114 | status_t unlock(); |
| 115 | |
| 116 | status_t getStatus() { return mStatus; } |
| 117 | |
| 118 | // pass the buffered ISurface to the camera service |
| 119 | status_t setPreviewDisplay(const sp<Surface>& surface); |
| 120 | status_t setPreviewDisplay(const sp<ISurface>& surface); |
| 121 | |
| 122 | // start preview mode, must call setPreviewDisplay first |
| 123 | status_t startPreview(); |
| 124 | |
| 125 | // stop preview mode |
| 126 | void stopPreview(); |
| 127 | |
| 128 | // get preview state |
| 129 | bool previewEnabled(); |
| 130 | |
| 131 | // start recording mode, must call setPreviewDisplay first |
| 132 | status_t startRecording(); |
| 133 | |
| 134 | // stop recording mode |
| 135 | void stopRecording(); |
| 136 | |
| 137 | // get recording state |
| 138 | bool recordingEnabled(); |
| 139 | |
| 140 | // release a recording frame |
| 141 | void releaseRecordingFrame(const sp<IMemory>& mem); |
| 142 | |
| 143 | // autoFocus - status returned from callback |
| 144 | status_t autoFocus(); |
| 145 | |
| 146 | // take a picture - picture returned from callback |
| 147 | status_t takePicture(); |
| 148 | |
| 149 | // set preview/capture parameters - key/value pairs |
| 150 | status_t setParameters(const String8& params); |
| 151 | |
| 152 | // get preview/capture parameters - key/value pairs |
| 153 | String8 getParameters() const; |
| 154 | |
Dave Sparks | bbbc7cb | 2009-06-23 17:30:11 -0700 | [diff] [blame] | 155 | void setListener(const sp<CameraListener>& listener); |
| 156 | void setPreviewCallbackFlags(int preview_callback_flag); |
| 157 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 158 | // ICameraClient interface |
Dave Sparks | 9b35233 | 2009-05-07 12:25:25 -0700 | [diff] [blame] | 159 | virtual void notifyCallback(int32_t msgType, int32_t ext, int32_t ext2); |
Dave Sparks | 93b9458 | 2009-05-07 19:27:32 -0700 | [diff] [blame] | 160 | virtual void dataCallback(int32_t msgType, const sp<IMemory>& dataPtr); |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 161 | |
| 162 | sp<ICamera> remote(); |
| 163 | |
| 164 | private: |
| 165 | Camera(); |
| 166 | virtual void binderDied(const wp<IBinder>& who); |
| 167 | |
| 168 | class DeathNotifier: public IBinder::DeathRecipient |
| 169 | { |
| 170 | public: |
| 171 | DeathNotifier() { |
| 172 | } |
| 173 | |
| 174 | virtual void binderDied(const wp<IBinder>& who); |
| 175 | }; |
| 176 | |
| 177 | static sp<DeathNotifier> mDeathNotifier; |
| 178 | |
| 179 | // helper function to obtain camera service handle |
| 180 | static const sp<ICameraService>& getCameraService(); |
| 181 | |
| 182 | sp<ICamera> mCamera; |
| 183 | status_t mStatus; |
| 184 | |
Dave Sparks | bbbc7cb | 2009-06-23 17:30:11 -0700 | [diff] [blame] | 185 | sp<CameraListener> mListener; |
| 186 | |
The Android Open Source Project | edbf3b6 | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 187 | friend class DeathNotifier; |
| 188 | |
| 189 | static Mutex mLock; |
| 190 | static sp<ICameraService> mCameraService; |
| 191 | |
| 192 | }; |
| 193 | |
| 194 | }; // namespace android |
| 195 | |
| 196 | #endif |
| 197 | |