1 /* 2 * Copyright (C) 2012 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 ANDROID_SERVERS_CAMERA_CAMERA2CLIENT_H 18 #define ANDROID_SERVERS_CAMERA_CAMERA2CLIENT_H 19 20 #include "CameraService.h" 21 #include "common/CameraDeviceBase.h" 22 #include "common/Camera2ClientBase.h" 23 #include "api1/client2/Parameters.h" 24 #include "api1/client2/FrameProcessor.h" 25 //#include "api1/client2/StreamingProcessor.h" 26 //#include "api1/client2/JpegProcessor.h" 27 //#include "api1/client2/ZslProcessorInterface.h" 28 //#include "api1/client2/CaptureSequencer.h" 29 //#include "api1/client2/CallbackProcessor.h" 30 31 namespace android { 32 33 namespace camera2 { 34 35 class StreamingProcessor; 36 class JpegProcessor; 37 class ZslProcessorInterface; 38 class CaptureSequencer; 39 class CallbackProcessor; 40 41 } 42 43 class IMemory; 44 /** 45 * Interface between android.hardware.Camera API and Camera HAL device for versions 46 * CAMERA_DEVICE_API_VERSION_2_0 and 3_0. 47 */ 48 class Camera2Client : 49 public Camera2ClientBase<CameraService::Client> 50 { 51 public: 52 /** 53 * ICamera interface (see ICamera for details) 54 */ 55 56 virtual void disconnect(); 57 virtual status_t connect(const sp<ICameraClient>& client); 58 virtual status_t lock(); 59 virtual status_t unlock(); 60 virtual status_t setPreviewTarget( 61 const sp<IGraphicBufferProducer>& bufferProducer); 62 virtual void setPreviewCallbackFlag(int flag); 63 virtual status_t setPreviewCallbackTarget( 64 const sp<IGraphicBufferProducer>& callbackProducer); 65 66 virtual status_t startPreview(); 67 virtual void stopPreview(); 68 virtual bool previewEnabled(); 69 virtual status_t storeMetaDataInBuffers(bool enabled); 70 virtual status_t startRecording(); 71 virtual void stopRecording(); 72 virtual bool recordingEnabled(); 73 virtual void releaseRecordingFrame(const sp<IMemory>& mem); 74 virtual status_t autoFocus(); 75 virtual status_t cancelAutoFocus(); 76 virtual status_t takePicture(int msgType); 77 virtual status_t setParameters(const String8& params); 78 virtual String8 getParameters() const; 79 virtual status_t sendCommand(int32_t cmd, int32_t arg1, int32_t arg2); 80 81 /** 82 * Interface used by CameraService 83 */ 84 85 Camera2Client(const sp<CameraService>& cameraService, 86 const sp<ICameraClient>& cameraClient, 87 const String16& clientPackageName, 88 int cameraId, 89 int cameraFacing, 90 int clientPid, 91 uid_t clientUid, 92 int servicePid, 93 bool legacyMode); 94 95 virtual ~Camera2Client(); 96 97 status_t initialize(camera_module_t *module); 98 99 virtual status_t dump(int fd, const Vector<String16>& args); 100 101 /** 102 * Interface used by CameraDeviceBase 103 */ 104 105 virtual void notifyAutoFocus(uint8_t newState, int triggerId); 106 virtual void notifyAutoExposure(uint8_t newState, int triggerId); 107 108 /** 109 * Interface used by independent components of Camera2Client. 110 */ 111 112 camera2::SharedParameters& getParameters(); 113 114 int getPreviewStreamId() const; 115 int getCaptureStreamId() const; 116 int getCallbackStreamId() const; 117 int getRecordingStreamId() const; 118 int getZslStreamId() const; 119 120 status_t registerFrameListener(int32_t minId, int32_t maxId, 121 wp<camera2::FrameProcessor::FilteredListener> listener, 122 bool sendPartials = true); 123 status_t removeFrameListener(int32_t minId, int32_t maxId, 124 wp<camera2::FrameProcessor::FilteredListener> listener); 125 126 status_t stopStream(); 127 128 static size_t calculateBufferSize(int width, int height, 129 int format, int stride); 130 131 static const int32_t kPreviewRequestIdStart = 10000000; 132 static const int32_t kPreviewRequestIdEnd = 20000000; 133 134 static const int32_t kRecordingRequestIdStart = 20000000; 135 static const int32_t kRecordingRequestIdEnd = 30000000; 136 137 static const int32_t kCaptureRequestIdStart = 30000000; 138 static const int32_t kCaptureRequestIdEnd = 40000000; 139 140 // Constant strings for ATRACE logging 141 static const char* kAutofocusLabel; 142 static const char* kTakepictureLabel; 143 144 private: 145 /** ICamera interface-related private members */ 146 typedef camera2::Parameters Parameters; 147 148 status_t setPreviewWindowL(const sp<IBinder>& binder, 149 sp<ANativeWindow> window); 150 status_t startPreviewL(Parameters ¶ms, bool restart); 151 void stopPreviewL(); 152 status_t startRecordingL(Parameters ¶ms, bool restart); 153 bool recordingEnabledL(); 154 155 // Individual commands for sendCommand() 156 status_t commandStartSmoothZoomL(); 157 status_t commandStopSmoothZoomL(); 158 status_t commandSetDisplayOrientationL(int degrees); 159 status_t commandEnableShutterSoundL(bool enable); 160 status_t commandPlayRecordingSoundL(); 161 status_t commandStartFaceDetectionL(int type); 162 status_t commandStopFaceDetectionL(Parameters ¶ms); 163 status_t commandEnableFocusMoveMsgL(bool enable); 164 status_t commandPingL(); 165 status_t commandSetVideoBufferCountL(size_t count); 166 167 // Current camera device configuration 168 camera2::SharedParameters mParameters; 169 170 /** Camera device-related private members */ 171 172 void setPreviewCallbackFlagL(Parameters ¶ms, int flag); 173 status_t updateRequests(Parameters ¶ms); 174 175 // Used with stream IDs 176 static const int NO_STREAM = -1; 177 178 template <typename ProcessorT> 179 status_t updateProcessorStream(sp<ProcessorT> processor, Parameters params); 180 template <typename ProcessorT, 181 status_t (ProcessorT::*updateStreamF)(const Parameters &)> 182 status_t updateProcessorStream(sp<ProcessorT> processor, Parameters params); 183 184 sp<camera2::FrameProcessor> mFrameProcessor; 185 186 /* Preview/Recording related members */ 187 188 sp<IBinder> mPreviewSurface; 189 sp<camera2::StreamingProcessor> mStreamingProcessor; 190 191 /** Preview callback related members */ 192 193 sp<camera2::CallbackProcessor> mCallbackProcessor; 194 195 /* Still image capture related members */ 196 197 sp<camera2::CaptureSequencer> mCaptureSequencer; 198 sp<camera2::JpegProcessor> mJpegProcessor; 199 sp<camera2::ZslProcessorInterface> mZslProcessor; 200 sp<Thread> mZslProcessorThread; 201 202 /** Notification-related members */ 203 204 bool mAfInMotion; 205 206 /** Utility members */ 207 bool mLegacyMode; 208 209 // Wait until the camera device has received the latest control settings 210 status_t syncWithDevice(); 211 212 // Video snapshot jpeg size overriding helper function 213 status_t overrideVideoSnapshotSize(Parameters ¶ms); 214 }; 215 216 }; // namespace android 217 218 #endif 219