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_PHOTOGRAPHY_ICAMERADEVICEUSER_H 18 #define ANDROID_HARDWARE_PHOTOGRAPHY_ICAMERADEVICEUSER_H 19 20 #include <binder/IInterface.h> 21 #include <binder/Parcel.h> 22 #include <utils/List.h> 23 24 struct camera_metadata; 25 26 namespace android { 27 28 class ICameraDeviceUserClient; 29 class IGraphicBufferProducer; 30 class Surface; 31 class CaptureRequest; 32 class CameraMetadata; 33 34 enum { 35 NO_IN_FLIGHT_REPEATING_FRAMES = -1, 36 }; 37 38 class ICameraDeviceUser : public IInterface 39 { 40 /** 41 * Keep up-to-date with ICameraDeviceUser.aidl in frameworks/base 42 */ 43 public: 44 DECLARE_META_INTERFACE(CameraDeviceUser); 45 46 virtual void disconnect() = 0; 47 48 /** 49 * Request Handling 50 **/ 51 52 /** 53 * For streaming requests, output lastFrameNumber is the last frame number 54 * of the previous repeating request. 55 * For non-streaming requests, output lastFrameNumber is the expected last 56 * frame number of the current request. 57 */ 58 virtual int submitRequest(sp<CaptureRequest> request, 59 bool streaming = false, 60 /*out*/ 61 int64_t* lastFrameNumber = NULL) = 0; 62 63 /** 64 * For streaming requests, output lastFrameNumber is the last frame number 65 * of the previous repeating request. 66 * For non-streaming requests, output lastFrameNumber is the expected last 67 * frame number of the current request. 68 */ 69 virtual int submitRequestList(List<sp<CaptureRequest> > requestList, 70 bool streaming = false, 71 /*out*/ 72 int64_t* lastFrameNumber = NULL) = 0; 73 74 /** 75 * Output lastFrameNumber is the last frame number of the previous repeating request. 76 */ 77 virtual status_t cancelRequest(int requestId, 78 /*out*/ 79 int64_t* lastFrameNumber = NULL) = 0; 80 81 /** 82 * Begin the device configuration. 83 * 84 * <p> 85 * beginConfigure must be called before any call to deleteStream, createStream, 86 * or endConfigure. It is not valid to call this when the device is not idle. 87 * <p> 88 */ 89 virtual status_t beginConfigure() = 0; 90 91 /** 92 * End the device configuration. 93 * 94 * <p> 95 * endConfigure must be called after stream configuration is complete (i.e. after 96 * a call to beginConfigure and subsequent createStream/deleteStream calls). This 97 * must be called before any requests can be submitted. 98 * <p> 99 */ 100 virtual status_t endConfigure() = 0; 101 102 virtual status_t deleteStream(int streamId) = 0; 103 virtual status_t createStream( 104 int width, int height, int format, 105 const sp<IGraphicBufferProducer>& bufferProducer) = 0; 106 107 // Create a request object from a template. 108 virtual status_t createDefaultRequest(int templateId, 109 /*out*/ 110 CameraMetadata* request) = 0; 111 // Get static camera metadata 112 virtual status_t getCameraInfo(/*out*/ 113 CameraMetadata* info) = 0; 114 115 // Wait until all the submitted requests have finished processing 116 virtual status_t waitUntilIdle() = 0; 117 118 /** 119 * Flush all pending and in-progress work as quickly as possible. 120 * Output lastFrameNumber is the last frame number of the previous repeating request. 121 */ 122 virtual status_t flush(/*out*/ 123 int64_t* lastFrameNumber = NULL) = 0; 124 }; 125 126 // ---------------------------------------------------------------------------- 127 128 class BnCameraDeviceUser: public BnInterface<ICameraDeviceUser> 129 { 130 public: 131 virtual status_t onTransact( uint32_t code, 132 const Parcel& data, 133 Parcel* reply, 134 uint32_t flags = 0); 135 }; 136 137 }; // namespace android 138 139 #endif 140