Home | History | Annotate | Download | only in camera2 
      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