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