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