Home | History | Annotate | Download | only in api1
      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             int cameraId,
     95             int cameraFacing,
     96             int clientPid,
     97             uid_t clientUid,
     98             int servicePid,
     99             bool legacyMode);
    100 
    101     virtual ~Camera2Client();
    102 
    103     virtual status_t initialize(sp<CameraProviderManager> manager) override;
    104 
    105     virtual status_t dump(int fd, const Vector<String16>& args);
    106 
    107     virtual status_t dumpClient(int fd, const Vector<String16>& args);
    108 
    109     /**
    110      * Interface used by CameraDeviceBase
    111      */
    112 
    113     virtual void notifyAutoFocus(uint8_t newState, int triggerId);
    114     virtual void notifyAutoExposure(uint8_t newState, int triggerId);
    115     virtual void notifyShutter(const CaptureResultExtras& resultExtras,
    116                                nsecs_t timestamp);
    117 
    118     /**
    119      * Interface used by independent components of Camera2Client.
    120      */
    121 
    122     camera2::SharedParameters& getParameters();
    123 
    124     int getPreviewStreamId() const;
    125     int getCaptureStreamId() const;
    126     int getCallbackStreamId() const;
    127     int getRecordingStreamId() const;
    128     int getZslStreamId() const;
    129 
    130     status_t registerFrameListener(int32_t minId, int32_t maxId,
    131             const wp<camera2::FrameProcessor::FilteredListener>& listener,
    132             bool sendPartials = true);
    133     status_t removeFrameListener(int32_t minId, int32_t maxId,
    134             const wp<camera2::FrameProcessor::FilteredListener>& listener);
    135 
    136     status_t stopStream();
    137 
    138     // For the slowJpegMode to create jpeg stream when precapture sequence is done
    139     status_t createJpegStreamL(camera2::Parameters &params);
    140 
    141     static size_t calculateBufferSize(int width, int height,
    142             int format, int stride);
    143 
    144     static const int32_t kPreviewRequestIdStart = 10000000;
    145     static const int32_t kPreviewRequestIdEnd   = 20000000;
    146 
    147     static const int32_t kRecordingRequestIdStart  = 20000000;
    148     static const int32_t kRecordingRequestIdEnd    = 30000000;
    149 
    150     static const int32_t kCaptureRequestIdStart = 30000000;
    151     static const int32_t kCaptureRequestIdEnd   = 40000000;
    152 
    153     // Constant strings for ATRACE logging
    154     static const char* kAutofocusLabel;
    155     static const char* kTakepictureLabel;
    156 
    157     // Used with stream IDs
    158     static const int NO_STREAM = -1;
    159 
    160 private:
    161     /** ICamera interface-related private members */
    162     typedef camera2::Parameters Parameters;
    163 
    164     status_t setPreviewWindowL(const sp<IBinder>& binder,
    165             const sp<Surface>& window);
    166     status_t startPreviewL(Parameters &params, bool restart);
    167     void     stopPreviewL();
    168     status_t startRecordingL(Parameters &params, bool restart);
    169     bool     recordingEnabledL();
    170 
    171     // Individual commands for sendCommand()
    172     status_t commandStartSmoothZoomL();
    173     status_t commandStopSmoothZoomL();
    174     status_t commandSetDisplayOrientationL(int degrees);
    175     status_t commandEnableShutterSoundL(bool enable);
    176     status_t commandPlayRecordingSoundL();
    177     status_t commandStartFaceDetectionL(int type);
    178     status_t commandStopFaceDetectionL(Parameters &params);
    179     status_t commandEnableFocusMoveMsgL(bool enable);
    180     status_t commandPingL();
    181     status_t commandSetVideoBufferCountL(size_t count);
    182     status_t commandSetVideoFormatL(int format, android_dataspace dataSpace);
    183 
    184     // Current camera device configuration
    185     camera2::SharedParameters mParameters;
    186 
    187     /** Camera device-related private members */
    188 
    189     void     setPreviewCallbackFlagL(Parameters &params, int flag);
    190     status_t updateRequests(Parameters &params);
    191 
    192     template <typename ProcessorT>
    193     status_t updateProcessorStream(sp<ProcessorT> processor, Parameters params);
    194     template <typename ProcessorT,
    195               status_t (ProcessorT::*updateStreamF)(const Parameters &)>
    196     status_t updateProcessorStream(sp<ProcessorT> processor, Parameters params);
    197 
    198     sp<camera2::FrameProcessor> mFrameProcessor;
    199 
    200     /* Preview/Recording related members */
    201 
    202     sp<IBinder> mPreviewSurface;
    203     sp<IBinder> mVideoSurface;
    204     sp<camera2::StreamingProcessor> mStreamingProcessor;
    205 
    206     /** Preview callback related members */
    207 
    208     sp<camera2::CallbackProcessor> mCallbackProcessor;
    209 
    210     /* Still image capture related members */
    211 
    212     sp<camera2::CaptureSequencer> mCaptureSequencer;
    213     sp<camera2::JpegProcessor> mJpegProcessor;
    214     sp<camera2::ZslProcessor> mZslProcessor;
    215 
    216     /** Utility members */
    217     bool mLegacyMode;
    218 
    219     // Wait until the camera device has received the latest control settings
    220     status_t syncWithDevice();
    221 
    222     // Video snapshot jpeg size overriding helper function
    223     status_t overrideVideoSnapshotSize(Parameters &params);
    224 
    225     template<typename TProviderPtr>
    226     status_t initializeImpl(TProviderPtr providerPtr);
    227 };
    228 
    229 }; // namespace android
    230 
    231 #endif
    232