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/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             int deviceVersion);
     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     status_t removeFrameListener(int32_t minId, int32_t maxId,
    123             wp<camera2::FrameProcessor::FilteredListener> listener);
    124 
    125     status_t stopStream();
    126 
    127     static size_t calculateBufferSize(int width, int height,
    128             int format, int stride);
    129 
    130     static const int32_t kPreviewRequestIdStart = 10000000;
    131     static const int32_t kPreviewRequestIdEnd   = 20000000;
    132 
    133     static const int32_t kRecordingRequestIdStart  = 20000000;
    134     static const int32_t kRecordingRequestIdEnd    = 30000000;
    135 
    136     static const int32_t kCaptureRequestIdStart = 30000000;
    137     static const int32_t kCaptureRequestIdEnd   = 40000000;
    138 
    139     // Constant strings for ATRACE logging
    140     static const char* kAutofocusLabel;
    141     static const char* kTakepictureLabel;
    142 
    143 private:
    144     /** ICamera interface-related private members */
    145     typedef camera2::Parameters Parameters;
    146 
    147     status_t setPreviewWindowL(const sp<IBinder>& binder,
    148             sp<ANativeWindow> window);
    149     status_t startPreviewL(Parameters &params, bool restart);
    150     void     stopPreviewL();
    151     status_t startRecordingL(Parameters &params, bool restart);
    152     bool     recordingEnabledL();
    153 
    154     // Individual commands for sendCommand()
    155     status_t commandStartSmoothZoomL();
    156     status_t commandStopSmoothZoomL();
    157     status_t commandSetDisplayOrientationL(int degrees);
    158     status_t commandEnableShutterSoundL(bool enable);
    159     status_t commandPlayRecordingSoundL();
    160     status_t commandStartFaceDetectionL(int type);
    161     status_t commandStopFaceDetectionL(Parameters &params);
    162     status_t commandEnableFocusMoveMsgL(bool enable);
    163     status_t commandPingL();
    164     status_t commandSetVideoBufferCountL(size_t count);
    165 
    166     // Current camera device configuration
    167     camera2::SharedParameters mParameters;
    168 
    169     /** Camera device-related private members */
    170 
    171     void     setPreviewCallbackFlagL(Parameters &params, int flag);
    172     status_t updateRequests(Parameters &params);
    173     int mDeviceVersion;
    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 
    208     // Wait until the camera device has received the latest control settings
    209     status_t syncWithDevice();
    210 };
    211 
    212 }; // namespace android
    213 
    214 #endif
    215