• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2020 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 #ifndef ANDROID_SERVERS_CAMERA_SESSION_CONFIGURATION_UTILS_H
17 #define ANDROID_SERVERS_CAMERA_SESSION_CONFIGURATION_UTILS_H
18 
19 #include <android/hardware/camera2/BnCameraDeviceUser.h>
20 #include <android/hardware/camera2/ICameraDeviceCallbacks.h>
21 #include <camera/camera2/OutputConfiguration.h>
22 #include <camera/camera2/SessionConfiguration.h>
23 #include <camera/camera2/SubmitInfo.h>
24 #include <android/hardware/camera/device/3.7/types.h>
25 #include <android/hardware/camera/device/3.4/ICameraDeviceSession.h>
26 #include <android/hardware/camera/device/3.7/ICameraDeviceSession.h>
27 
28 #include <device3/Camera3StreamInterface.h>
29 
30 #include <set>
31 #include <stdint.h>
32 
33 // Convenience methods for constructing binder::Status objects for error returns
34 
35 #define STATUS_ERROR(errorCode, errorString) \
36     binder::Status::fromServiceSpecificError(errorCode, \
37             String8::format("%s:%d: %s", __FUNCTION__, __LINE__, errorString))
38 
39 #define STATUS_ERROR_FMT(errorCode, errorString, ...) \
40     binder::Status::fromServiceSpecificError(errorCode, \
41             String8::format("%s:%d: " errorString, __FUNCTION__, __LINE__, \
42                     __VA_ARGS__))
43 
44 namespace android {
45 namespace camera3 {
46 
47 typedef std::function<CameraMetadata (const String8 &, int targetSdkVersion)> metadataGetter;
48 
49 class StreamConfiguration {
50 public:
51     int32_t format;
52     int32_t width;
53     int32_t height;
54     int32_t isInput;
55     static void getStreamConfigurations(
56             const CameraMetadata &static_info, bool maxRes,
57             std::unordered_map<int, std::vector<StreamConfiguration>> *scm);
58     static void getStreamConfigurations(
59             const CameraMetadata &static_info, int configuration,
60             std::unordered_map<int, std::vector<StreamConfiguration>> *scm);
61 };
62 
63 // Holds the default StreamConfigurationMap and Maximum resolution
64 // StreamConfigurationMap for a camera device.
65 struct StreamConfigurationPair {
66     std::unordered_map<int, std::vector<camera3::StreamConfiguration>>
67             mDefaultStreamConfigurationMap;
68     std::unordered_map<int, std::vector<camera3::StreamConfiguration>>
69             mMaximumResolutionStreamConfigurationMap;
70 };
71 
72 class SessionConfigurationUtils {
73 public:
74     static camera3::Size getMaxJpegResolution(const CameraMetadata &metadata,
75             bool ultraHighResolution);
76 
77     static size_t getUHRMaxJpegBufferSize(camera3::Size uhrMaxJpegSize,
78             camera3::Size defaultMaxJpegSize, size_t defaultMaxJpegBufferSize);
79 
80     static int64_t euclidDistSquare(int32_t x0, int32_t y0, int32_t x1, int32_t y1);
81 
82     // Find the closest dimensions for a given format in available stream configurations with
83     // a width <= ROUNDING_WIDTH_CAP
84     static bool roundBufferDimensionNearest(int32_t width, int32_t height, int32_t format,
85             android_dataspace dataSpace, const CameraMetadata& info, bool maxResolution,
86             /*out*/int32_t* outWidth, /*out*/int32_t* outHeight);
87 
88     static bool getArrayWidthAndHeight(const CameraMetadata *deviceInfo, int32_t arrayTag,
89             int32_t *width, int32_t *height);
90 
91     //check if format is not custom format
92     static bool isPublicFormat(int32_t format);
93 
94     // Create a Surface from an IGraphicBufferProducer. Returns error if
95     // IGraphicBufferProducer's property doesn't match with streamInfo
96     static binder::Status createSurfaceFromGbp(
97         camera3::OutputStreamInfo& streamInfo, bool isStreamInfoValid,
98         sp<Surface>& surface, const sp<IGraphicBufferProducer>& gbp,
99         const String8 &logicalCameraId, const CameraMetadata &physicalCameraMetadata,
100         const std::vector<int32_t> &sensorPixelModesUsed);
101 
102     static void mapStreamInfo(const camera3::OutputStreamInfo &streamInfo,
103             camera3::camera_stream_rotation_t rotation, String8 physicalId, int32_t groupId,
104             hardware::camera::device::V3_7::Stream *stream /*out*/);
105 
106     // Check that the physicalCameraId passed in is spported by the camera
107     // device.
108     static binder::Status checkPhysicalCameraId(
109         const std::vector<std::string> &physicalCameraIds, const String8 &physicalCameraId,
110         const String8 &logicalCameraId);
111 
112     static binder::Status checkSurfaceType(size_t numBufferProducers,
113         bool deferredConsumer, int surfaceType);
114 
115     static binder::Status checkOperatingMode(int operatingMode,
116         const CameraMetadata &staticInfo, const String8 &cameraId);
117 
118     // utility function to convert AIDL SessionConfiguration to HIDL
119     // streamConfiguration. Also checks for validity of SessionConfiguration and
120     // returns a non-ok binder::Status if the passed in session configuration
121     // isn't valid.
122     static binder::Status
123     convertToHALStreamCombination(const SessionConfiguration& sessionConfiguration,
124             const String8 &cameraId, const CameraMetadata &deviceInfo,
125             metadataGetter getMetadata, const std::vector<std::string> &physicalCameraIds,
126             hardware::camera::device::V3_7::StreamConfiguration &streamConfiguration,
127             bool overrideForPerfClass, bool *earlyExit);
128 
129     // Utility function to convert a V3_7::StreamConfiguration to
130     // V3_4::StreamConfiguration. Return false if the original V3_7 configuration cannot
131     // be used by older version HAL.
132     static bool convertHALStreamCombinationFromV37ToV34(
133             hardware::camera::device::V3_4::StreamConfiguration &streamConfigV34,
134             const hardware::camera::device::V3_7::StreamConfiguration &streamConfigV37);
135 
136     static StreamConfigurationPair getStreamConfigurationPair(const CameraMetadata &metadata);
137 
138     static status_t checkAndOverrideSensorPixelModesUsed(
139             const std::vector<int32_t> &sensorPixelModesUsed, int format, int width, int height,
140             const CameraMetadata &staticInfo, bool flexibleConsumer,
141             std::unordered_set<int32_t> *overriddenSensorPixelModesUsed);
142 
143     static bool isUltraHighResolutionSensor(const CameraMetadata &deviceInfo);
144 
145     static int32_t getAppropriateModeTag(int32_t defaultTag, bool maxResolution = false);
146 
147     static bool targetPerfClassPrimaryCamera(
148             const std::set<std::string>& perfClassPrimaryCameraIds, const std::string& cameraId,
149             int32_t targetSdkVersion);
150 
151     static const int32_t MAX_SURFACES_PER_STREAM = 4;
152 
153     static const int32_t ROUNDING_WIDTH_CAP = 1920;
154 
155     static const int32_t SDK_VERSION_S = 31;
156     static int32_t PERF_CLASS_LEVEL;
157     static bool IS_PERF_CLASS;
158     static const int32_t PERF_CLASS_JPEG_THRESH_W = 1920;
159     static const int32_t PERF_CLASS_JPEG_THRESH_H = 1080;
160 };
161 
162 } // camera3
163 } // android
164 #endif
165