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_CAPTUREREQUEST_H 18 #define ANDROID_HARDWARE_PHOTOGRAPHY_CAPTUREREQUEST_H 19 20 #include <utils/RefBase.h> 21 #include <utils/Vector.h> 22 #include <binder/Parcelable.h> 23 #include <camera/CameraMetadata.h> 24 25 namespace android { 26 27 class Surface; 28 29 namespace hardware { 30 namespace camera2 { 31 32 struct CaptureRequest : public Parcelable { 33 34 // those are needed so we can use a forward declaration of Surface, otherwise 35 // the type is incomplete when the ctor/dtors are generated. This has the added 36 // benefit that ctor/dtors are not inlined, which is good because they're not trivial 37 // (because of the vtable and Vector<>) 38 CaptureRequest(); 39 CaptureRequest(const CaptureRequest& rhs); 40 CaptureRequest(CaptureRequest&& rhs) noexcept; 41 virtual ~CaptureRequest(); 42 43 struct PhysicalCameraSettings { 44 std::string id; 45 CameraMetadata settings; 46 }; 47 std::vector<PhysicalCameraSettings> mPhysicalCameraSettings; 48 49 // Used by NDK client to pass surfaces by stream/surface index. 50 bool mSurfaceConverted = false; 51 52 // Starting in Android O, create a Surface from Parcel will take one extra 53 // IPC call. 54 Vector<sp<Surface> > mSurfaceList; 55 // Optional way of passing surface list since passing Surface over binder 56 // is expensive. Use the stream/surface index from current output configuration 57 // to represent an configured output Surface. When stream/surface index is used, 58 // set mSurfaceList to zero length to save unparcel time. 59 Vector<int> mStreamIdxList; 60 Vector<int> mSurfaceIdxList; // per stream surface list index 61 62 bool mIsReprocess; 63 64 void* mContext; // arbitrary user context from NDK apps, null for java apps 65 66 /** 67 * Keep impl up-to-date with CaptureRequest.java in frameworks/base 68 */ 69 // used by cameraserver to receive CaptureRequest from java/NDK client 70 status_t readFromParcel(const android::Parcel* parcel) override; 71 // used by NDK client to send CaptureRequest to cameraserver 72 status_t writeToParcel(android::Parcel* parcel) const override; 73 }; 74 75 } // namespace camera2 76 } // namespace hardware 77 78 struct CaptureRequest : 79 public RefBase, public hardware::camera2::CaptureRequest { 80 public: 81 // Same as android::hardware::camera2::CaptureRequest, except that you can 82 // put this in an sp<> 83 }; 84 85 } // namespace android 86 87 #endif 88