1 /*
2  * Copyright (C) 2014 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_CAMERA3_DUMMY_STREAM_H
18 #define ANDROID_SERVERS_CAMERA3_DUMMY_STREAM_H
19 
20 #include <utils/RefBase.h>
21 #include <gui/Surface.h>
22 
23 #include "Camera3Stream.h"
24 #include "Camera3IOStreamBase.h"
25 #include "Camera3OutputStreamInterface.h"
26 
27 namespace android {
28 namespace camera3 {
29 
30 /**
31  * A dummy output stream class, to be used as a placeholder when no valid
32  * streams are configured by the client.
33  * This is necessary because camera HAL v3.2 or older disallow configuring
34  * 0 output streams, while the public camera2 API allows for it.
35  */
36 class Camera3DummyStream :
37         public Camera3IOStreamBase,
38         public Camera3OutputStreamInterface {
39 
40   public:
41     /**
42      * Set up a dummy stream; doesn't actually connect to anything, and uses
43      * a default dummy format and size.
44      */
45     Camera3DummyStream(int id);
46 
47     virtual ~Camera3DummyStream();
48 
49     /**
50      * Camera3Stream interface
51      */
52 
53     virtual void     dump(int fd, const Vector<String16> &args) const;
54 
55     status_t         setTransform(int transform);
56 
57   protected:
58 
59     /**
60      * Note that we release the lock briefly in this function
61      */
62     virtual status_t returnBufferCheckedLocked(
63             const camera3_stream_buffer &buffer,
64             nsecs_t timestamp,
65             bool output,
66             /*out*/
67             sp<Fence> *releaseFenceOut);
68 
69     virtual status_t disconnectLocked();
70 
71   private:
72 
73     // Default dummy parameters; 320x240 is a required size for all devices,
74     // otherwise act like a SurfaceView would.
75     static const int DUMMY_WIDTH = 320;
76     static const int DUMMY_HEIGHT = 240;
77     static const int DUMMY_FORMAT = HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED;
78     static const android_dataspace DUMMY_DATASPACE = HAL_DATASPACE_UNKNOWN;
79     static const camera3_stream_rotation_t DUMMY_ROTATION = CAMERA3_STREAM_ROTATION_0;
80     static const uint32_t DUMMY_USAGE = GRALLOC_USAGE_HW_COMPOSER;
81 
82     /**
83      * Internal Camera3Stream interface
84      */
85     virtual status_t getBufferLocked(camera3_stream_buffer *buffer);
86     virtual status_t returnBufferLocked(
87             const camera3_stream_buffer &buffer,
88             nsecs_t timestamp);
89 
90     virtual status_t configureQueueLocked();
91 
92     virtual status_t getEndpointUsage(uint32_t *usage) const;
93 
94 }; // class Camera3DummyStream
95 
96 } // namespace camera3
97 
98 } // namespace android
99 
100 #endif
101