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/ZslProcessor.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 ZslProcessor;
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_3_0 and above.
47  */
48 class Camera2Client :
49         public Camera2ClientBase<CameraService::Client>
50 {
51 public:
52     /**
53      * ICamera interface (see ICamera for details)
54      */
55 
56     virtual binder::Status  disconnect();
57     virtual status_t        connect(const sp<hardware::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        setVideoBufferMode(int32_t videoBufferMode);
70     virtual status_t        startRecording();
71     virtual void            stopRecording();
72     virtual bool            recordingEnabled();
73     virtual void            releaseRecordingFrame(const sp<IMemory>& mem);
74     virtual void            releaseRecordingFrameHandle(native_handle_t *handle);
75     virtual void            releaseRecordingFrameHandleBatch(
76                                     const std::vector<native_handle_t*>& handles);
77     virtual status_t        autoFocus();
78     virtual status_t        cancelAutoFocus();
79     virtual status_t        takePicture(int msgType);
80     virtual status_t        setParameters(const String8& params);
81     virtual String8         getParameters() const;
82     virtual status_t        sendCommand(int32_t cmd, int32_t arg1, int32_t arg2);
83     virtual void            notifyError(int32_t errorCode,
84                                         const CaptureResultExtras& resultExtras);
85     virtual status_t        setVideoTarget(const sp<IGraphicBufferProducer>& bufferProducer);
86 
87     /**
88      * Interface used by CameraService
89      */
90 
91     Camera2Client(const sp<CameraService>& cameraService,
92             const sp<hardware::ICameraClient>& cameraClient,
93             const String16& clientPackageName,
94             const String8& cameraDeviceId,
95             int api1CameraId,
96             int cameraFacing,
97             int clientPid,
98             uid_t clientUid,
99             int servicePid);
100 
101     virtual ~Camera2Client();
102 
103     virtual status_t initialize(sp<CameraProviderManager> manager,
104             const String8& monitorTags) override;
105 
106     virtual status_t dump(int fd, const Vector<String16>& args);
107 
108     virtual status_t dumpClient(int fd, const Vector<String16>& args);
109 
110     /**
111      * Interface used by CameraDeviceBase
112      */
113 
114     virtual void notifyAutoFocus(uint8_t newState, int triggerId);
115     virtual void notifyAutoExposure(uint8_t newState, int triggerId);
116     virtual void notifyShutter(const CaptureResultExtras& resultExtras,
117                                nsecs_t timestamp);
118 
119     /**
120      * Interface used by independent components of Camera2Client.
121      */
122 
123     camera2::SharedParameters& getParameters();
124 
125     int getPreviewStreamId() const;
126     int getCaptureStreamId() const;
127     int getCallbackStreamId() const;
128     int getRecordingStreamId() const;
129     int getZslStreamId() const;
130 
131     status_t registerFrameListener(int32_t minId, int32_t maxId,
132             const wp<camera2::FrameProcessor::FilteredListener>& listener,
133             bool sendPartials = true);
134     status_t removeFrameListener(int32_t minId, int32_t maxId,
135             const wp<camera2::FrameProcessor::FilteredListener>& listener);
136 
137     status_t stopStream();
138 
139     // For the slowJpegMode to create jpeg stream when precapture sequence is done
140     status_t createJpegStreamL(camera2::Parameters &params);
141 
142     static size_t calculateBufferSize(int width, int height,
143             int format, int stride);
144 
145     static const int32_t kPreviewRequestIdStart = 10000000;
146     static const int32_t kPreviewRequestIdEnd   = 20000000;
147 
148     static const int32_t kRecordingRequestIdStart  = 20000000;
149     static const int32_t kRecordingRequestIdEnd    = 30000000;
150 
151     static const int32_t kCaptureRequestIdStart = 30000000;
152     static const int32_t kCaptureRequestIdEnd   = 40000000;
153 
154     // Constant strings for ATRACE logging
155     static const char* kAutofocusLabel;
156     static const char* kTakepictureLabel;
157 
158     // Used with stream IDs
159     static const int NO_STREAM = -1;
160 
161 private:
162     /** ICamera interface-related private members */
163     typedef camera2::Parameters Parameters;
164 
165     status_t setPreviewWindowL(const sp<IBinder>& binder,
166             const sp<Surface>& window);
167     status_t startPreviewL(Parameters &params, bool restart);
168     void     stopPreviewL();
169     status_t startRecordingL(Parameters &params, bool restart);
170     bool     recordingEnabledL();
171 
172     // Individual commands for sendCommand()
173     status_t commandStartSmoothZoomL();
174     status_t commandStopSmoothZoomL();
175     status_t commandSetDisplayOrientationL(int degrees);
176     status_t commandEnableShutterSoundL(bool enable);
177     status_t commandPlayRecordingSoundL();
178     status_t commandStartFaceDetectionL(int type);
179     status_t commandStopFaceDetectionL(Parameters &params);
180     status_t commandEnableFocusMoveMsgL(bool enable);
181     status_t commandPingL();
182     status_t commandSetVideoBufferCountL(size_t count);
183     status_t commandSetVideoFormatL(int format, android_dataspace dataSpace);
184 
185     // Current camera device configuration
186     camera2::SharedParameters mParameters;
187 
188     /** Camera device-related private members */
189 
190     void     setPreviewCallbackFlagL(Parameters &params, int flag);
191     status_t updateRequests(Parameters &params);
192 
193     template <typename ProcessorT>
194     status_t updateProcessorStream(sp<ProcessorT> processor, Parameters params);
195     template <typename ProcessorT,
196               status_t (ProcessorT::*updateStreamF)(const Parameters &)>
197     status_t updateProcessorStream(sp<ProcessorT> processor, Parameters params);
198 
199     sp<camera2::FrameProcessor> mFrameProcessor;
200 
201     /* Preview/Recording related members */
202 
203     sp<IBinder> mPreviewSurface;
204     sp<IBinder> mVideoSurface;
205     sp<camera2::StreamingProcessor> mStreamingProcessor;
206 
207     /** Preview callback related members */
208 
209     sp<camera2::CallbackProcessor> mCallbackProcessor;
210 
211     /* Still image capture related members */
212 
213     sp<camera2::CaptureSequencer> mCaptureSequencer;
214     sp<camera2::JpegProcessor> mJpegProcessor;
215     sp<camera2::ZslProcessor> mZslProcessor;
216 
217     /** Utility members */
218     bool mLegacyMode;
219 
220     // Wait until the camera device has received the latest control settings
221     status_t syncWithDevice();
222 
223     // Video snapshot jpeg size overriding helper function
224     status_t overrideVideoSnapshotSize(Parameters &params);
225 
226     template<typename TProviderPtr>
227     status_t initializeImpl(TProviderPtr providerPtr, const String8& monitorTags);
228 
229     bool isZslEnabledInStillTemplate();
230 };
231 
232 }; // namespace android
233 
234 #endif
235