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_SERVERS_CAMERA_CAMERA2_PROFRAMEPROCESSOR_H
18 #define ANDROID_SERVERS_CAMERA_CAMERA2_PROFRAMEPROCESSOR_H
19 
20 #include <utils/Thread.h>
21 #include <utils/String16.h>
22 #include <utils/Vector.h>
23 #include <utils/KeyedVector.h>
24 #include <utils/List.h>
25 #include <camera/CameraMetadata.h>
26 #include <camera/CaptureResult.h>
27 
28 namespace android {
29 
30 class CameraDeviceBase;
31 
32 namespace camera2 {
33 
34 /* Output frame metadata processing thread.  This thread waits for new
35  * frames from the device, and analyzes them as necessary.
36  */
37 class FrameProcessorBase: public Thread {
38   public:
39     FrameProcessorBase(wp<CameraDeviceBase> device);
40     virtual ~FrameProcessorBase();
41 
42     struct FilteredListener: virtual public RefBase {
43         virtual void onResultAvailable(const CaptureResult &result) = 0;
44     };
45 
46     // Register a listener for a range of IDs [minId, maxId). Multiple listeners
47     // can be listening to the same range. Registering the same listener with
48     // the same range of IDs has no effect.
49     // sendPartials controls whether partial results will be sent.
50     status_t registerListener(int32_t minId, int32_t maxId,
51                               wp<FilteredListener> listener,
52                               bool sendPartials = true);
53     status_t removeListener(int32_t minId, int32_t maxId,
54                             wp<FilteredListener> listener);
55 
56     void dump(int fd, const Vector<String16>& args);
57   protected:
58     static const nsecs_t kWaitDuration = 10000000; // 10 ms
59     wp<CameraDeviceBase> mDevice;
60 
61     virtual bool threadLoop();
62 
63     Mutex mInputMutex;
64     Mutex mLastFrameMutex;
65 
66     struct RangeListener {
67         int32_t minId;
68         int32_t maxId;
69         wp<FilteredListener> listener;
70         bool sendPartials;
71     };
72     List<RangeListener> mRangeListeners;
73 
74     // Number of partial result the HAL will potentially send.
75     int32_t mNumPartialResults;
76 
77     void processNewFrames(const sp<CameraDeviceBase> &device);
78 
79     virtual bool processSingleFrame(CaptureResult &result,
80                                     const sp<CameraDeviceBase> &device);
81 
82     status_t processListeners(const CaptureResult &result,
83                               const sp<CameraDeviceBase> &device);
84 
85     CameraMetadata mLastFrame;
86 };
87 
88 
89 }; //namespace camera2
90 }; //namespace android
91 
92 #endif
93