1/*
2 * Copyright (C) 2013 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_HARDWARE_CAMERA_BASE_H
18#define ANDROID_HARDWARE_CAMERA_BASE_H
19
20#include <utils/Mutex.h>
21
22struct camera_frame_metadata;
23
24namespace android {
25
26namespace hardware {
27
28
29class ICameraService;
30class ICameraServiceListener;
31
32struct CameraInfo : public android::Parcelable {
33    /**
34     * The direction that the camera faces to. It should be CAMERA_FACING_BACK
35     * or CAMERA_FACING_FRONT.
36     */
37    int facing;
38
39    /**
40     * The orientation of the camera image. The value is the angle that the
41     * camera image needs to be rotated clockwise so it shows correctly on the
42     * display in its natural orientation. It should be 0, 90, 180, or 270.
43     *
44     * For example, suppose a device has a naturally tall screen. The
45     * back-facing camera sensor is mounted in landscape. You are looking at
46     * the screen. If the top side of the camera sensor is aligned with the
47     * right edge of the screen in natural orientation, the value should be
48     * 90. If the top side of a front-facing camera sensor is aligned with the
49     * right of the screen, the value should be 270.
50     */
51    int orientation;
52
53    virtual status_t writeToParcel(Parcel* parcel) const;
54    virtual status_t readFromParcel(const Parcel* parcel);
55
56};
57
58} // namespace hardware
59
60using hardware::CameraInfo;
61
62
63template <typename TCam>
64struct CameraTraits {
65};
66
67template <typename TCam, typename TCamTraits = CameraTraits<TCam> >
68class CameraBase : public IBinder::DeathRecipient
69{
70public:
71    typedef typename TCamTraits::TCamListener       TCamListener;
72    typedef typename TCamTraits::TCamUser           TCamUser;
73    typedef typename TCamTraits::TCamCallbacks      TCamCallbacks;
74    typedef typename TCamTraits::TCamConnectService TCamConnectService;
75
76    static sp<TCam>      connect(int cameraId,
77                                 const String16& clientPackageName,
78                                 int clientUid, int clientPid);
79    virtual void         disconnect();
80
81    void                 setListener(const sp<TCamListener>& listener);
82
83    static int           getNumberOfCameras();
84
85    static status_t      getCameraInfo(int cameraId,
86                                       /*out*/
87                                       struct hardware::CameraInfo* cameraInfo);
88
89    static status_t      addServiceListener(
90        const sp<::android::hardware::ICameraServiceListener>& listener);
91
92    static status_t      removeServiceListener(
93        const sp<::android::hardware::ICameraServiceListener>& listener);
94
95    sp<TCamUser>         remote();
96
97    // Status is set to 'UNKNOWN_ERROR' after successful (re)connection
98    status_t             getStatus();
99
100protected:
101    CameraBase(int cameraId);
102    virtual              ~CameraBase();
103
104    ////////////////////////////////////////////////////////
105    // TCamCallbacks implementation
106    ////////////////////////////////////////////////////////
107    virtual void         notifyCallback(int32_t msgType, int32_t ext,
108                                        int32_t ext2);
109
110    ////////////////////////////////////////////////////////
111    // Common instance variables
112    ////////////////////////////////////////////////////////
113    Mutex                            mLock;
114
115    virtual void                     binderDied(const wp<IBinder>& who);
116
117    // helper function to obtain camera service handle
118    static const sp<::android::hardware::ICameraService>& getCameraService();
119
120    sp<TCamUser>                     mCamera;
121    status_t                         mStatus;
122
123    sp<TCamListener>                 mListener;
124
125    const int                        mCameraId;
126
127    typedef CameraBase<TCam>         CameraBaseT;
128};
129
130}; // namespace android
131
132#endif
133