blob: 29e3eca9afac4b02bd2e998c04f2beae6dea0d61 [file] [log] [blame]
Jayant Chowdhary2bbdce42020-01-12 14:55:41 -08001/*
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>
Austin Borger1c1bee02023-06-01 16:51:35 -070024#include <camera/StringUtils.h>
Jayant Chowdharya04055f2022-01-03 02:07:49 +000025#include <aidl/android/hardware/camera/device/ICameraDevice.h>
Jayant Chowdhary13f9b2f2020-12-02 22:46:15 -080026#include <android/hardware/camera/device/3.4/ICameraDeviceSession.h>
27#include <android/hardware/camera/device/3.7/ICameraDeviceSession.h>
Jayant Chowdhary2bbdce42020-01-12 14:55:41 -080028
Colin Crossb8a9dbb2020-08-27 04:12:26 +000029#include <device3/Camera3StreamInterface.h>
Jayant Chowdharyc67af1b2022-04-07 18:05:04 +000030#include <utils/IPCTransport.h>
Colin Crossb8a9dbb2020-08-27 04:12:26 +000031
Shuzhen Wangd4abdf72021-05-28 11:22:50 -070032#include <set>
Jayant Chowdhary2bbdce42020-01-12 14:55:41 -080033#include <stdint.h>
34
Austin Borgerea931242021-12-13 23:10:41 +000035#include "SessionConfigurationUtilsHost.h"
36
Jayant Chowdhary13f9b2f2020-12-02 22:46:15 -080037// Convenience methods for constructing binder::Status objects for error returns
38
39#define STATUS_ERROR(errorCode, errorString) \
40 binder::Status::fromServiceSpecificError(errorCode, \
Austin Borger1c1bee02023-06-01 16:51:35 -070041 fmt::sprintf("%s:%d: %s", __FUNCTION__, __LINE__, errorString).c_str())
Jayant Chowdhary13f9b2f2020-12-02 22:46:15 -080042
43#define STATUS_ERROR_FMT(errorCode, errorString, ...) \
44 binder::Status::fromServiceSpecificError(errorCode, \
Austin Borger1c1bee02023-06-01 16:51:35 -070045 fmt::sprintf("%s:%d: " errorString, __FUNCTION__, __LINE__, \
46 __VA_ARGS__).c_str())
Jayant Chowdhary13f9b2f2020-12-02 22:46:15 -080047
Jayant Chowdhary2bbdce42020-01-12 14:55:41 -080048namespace android {
Jayant Chowdhary13f9b2f2020-12-02 22:46:15 -080049namespace camera3 {
Jayant Chowdhary2bbdce42020-01-12 14:55:41 -080050
Shuzhen Wang045be6c2023-10-12 10:01:10 -070051typedef enum camera_request_template {
52 CAMERA_TEMPLATE_PREVIEW = 1,
53 CAMERA_TEMPLATE_STILL_CAPTURE = 2,
54 CAMERA_TEMPLATE_VIDEO_RECORD = 3,
55 CAMERA_TEMPLATE_VIDEO_SNAPSHOT = 4,
56 CAMERA_TEMPLATE_ZERO_SHUTTER_LAG = 5,
57 CAMERA_TEMPLATE_MANUAL = 6,
58 CAMERA_TEMPLATE_COUNT,
59 CAMERA_VENDOR_TEMPLATE_START = 0x40000000
60} camera_request_template_t;
61
Austin Borger1c1bee02023-06-01 16:51:35 -070062typedef std::function<CameraMetadata (const std::string &, bool overrideForPerfClass)>
63 metadataGetter;
Jayant Chowdhary2bbdce42020-01-12 14:55:41 -080064
Jayant Chowdhary13f9b2f2020-12-02 22:46:15 -080065class StreamConfiguration {
66public:
67 int32_t format;
68 int32_t width;
69 int32_t height;
70 int32_t isInput;
71 static void getStreamConfigurations(
72 const CameraMetadata &static_info, bool maxRes,
73 std::unordered_map<int, std::vector<StreamConfiguration>> *scm);
74 static void getStreamConfigurations(
75 const CameraMetadata &static_info, int configuration,
76 std::unordered_map<int, std::vector<StreamConfiguration>> *scm);
77};
78
79// Holds the default StreamConfigurationMap and Maximum resolution
80// StreamConfigurationMap for a camera device.
81struct StreamConfigurationPair {
82 std::unordered_map<int, std::vector<camera3::StreamConfiguration>>
83 mDefaultStreamConfigurationMap;
84 std::unordered_map<int, std::vector<camera3::StreamConfiguration>>
85 mMaximumResolutionStreamConfigurationMap;
86};
87
Austin Borgerea931242021-12-13 23:10:41 +000088namespace SessionConfigurationUtils {
Jayant Chowdharycd3d36b2021-07-10 10:53:53 -070089
Austin Borgerea931242021-12-13 23:10:41 +000090camera3::Size getMaxJpegResolution(const CameraMetadata &metadata,
91 bool ultraHighResolution);
Jayant Chowdharycd3d36b2021-07-10 10:53:53 -070092
Austin Borgerea931242021-12-13 23:10:41 +000093size_t getUHRMaxJpegBufferSize(camera3::Size uhrMaxJpegSize,
94 camera3::Size defaultMaxJpegSize, size_t defaultMaxJpegBufferSize);
Colin Crossb8a9dbb2020-08-27 04:12:26 +000095
Austin Borgerea931242021-12-13 23:10:41 +000096int64_t euclidDistSquare(int32_t x0, int32_t y0, int32_t x1, int32_t y1);
Colin Crossb8a9dbb2020-08-27 04:12:26 +000097
Austin Borgerea931242021-12-13 23:10:41 +000098// Find the closest dimensions for a given format in available stream configurations with
99// a width <= ROUNDING_WIDTH_CAP
100bool roundBufferDimensionNearest(int32_t width, int32_t height, int32_t format,
101 android_dataspace dataSpace, const CameraMetadata& info, bool maxResolution,
102 /*out*/int32_t* outWidth, /*out*/int32_t* outHeight);
Jayant Chowdhary9255ce02021-07-15 11:18:17 -0700103
Austin Borgerea931242021-12-13 23:10:41 +0000104// check if format is not custom format
105bool isPublicFormat(int32_t format);
Colin Crossb8a9dbb2020-08-27 04:12:26 +0000106
Austin Borgerea931242021-12-13 23:10:41 +0000107// Create a Surface from an IGraphicBufferProducer. Returns error if
108// IGraphicBufferProducer's property doesn't match with streamInfo
109binder::Status createSurfaceFromGbp(
Shuzhen Wangc8ab4522021-12-14 20:12:42 -0800110 camera3::OutputStreamInfo& streamInfo, bool isStreamInfoValid,
111 sp<Surface>& surface, const sp<IGraphicBufferProducer>& gbp,
Austin Borger1c1bee02023-06-01 16:51:35 -0700112 const std::string &logicalCameraId, const CameraMetadata &physicalCameraMetadata,
Emilian Peevc81a7592022-02-14 17:38:18 -0800113 const std::vector<int32_t> &sensorPixelModesUsed, int64_t dynamicRangeProfile,
Austin Borger9e2b27c2022-07-15 11:27:24 -0700114 int64_t streamUseCase, int timestampBase, int mirrorMode,
115 int32_t colorSpace);
Shuzhen Wangc8ab4522021-12-14 20:12:42 -0800116
Emilian Peev2295df72021-11-12 18:14:10 -0800117//check if format is 10-bit output compatible
Emilian Peev434248e2022-10-06 14:58:54 -0700118bool is10bitCompatibleFormat(int32_t format, android_dataspace_t dataSpace);
Emilian Peev2295df72021-11-12 18:14:10 -0800119
120// check if the dynamic range requires 10-bit output
Emilian Peevc81a7592022-02-14 17:38:18 -0800121bool is10bitDynamicRangeProfile(int64_t dynamicRangeProfile);
Emilian Peev2295df72021-11-12 18:14:10 -0800122
123// Check if the device supports a given dynamicRangeProfile
Emilian Peevc81a7592022-02-14 17:38:18 -0800124bool isDynamicRangeProfileSupported(int64_t dynamicRangeProfile, const CameraMetadata& staticMeta);
Emilian Peev2295df72021-11-12 18:14:10 -0800125
Austin Borger9e2b27c2022-07-15 11:27:24 -0700126bool deviceReportsColorSpaces(const CameraMetadata& staticMeta);
127
128bool isColorSpaceSupported(int32_t colorSpace, int32_t format, android_dataspace dataSpace,
129 int64_t dynamicRangeProfile, const CameraMetadata& staticMeta);
130
Austin Borger9b263b12023-03-27 17:01:33 -0700131bool dataSpaceFromColorSpace(android_dataspace *dataSpace, int32_t colorSpace);
132
Shuzhen Wang8ed1e872022-03-08 16:34:33 -0800133bool isStreamUseCaseSupported(int64_t streamUseCase, const CameraMetadata &deviceInfo);
Shuzhen Wangc8ab4522021-12-14 20:12:42 -0800134
Jayant Chowdharya04055f2022-01-03 02:07:49 +0000135void mapStreamInfo(const OutputStreamInfo &streamInfo,
Austin Borger1c1bee02023-06-01 16:51:35 -0700136 camera3::camera_stream_rotation_t rotation, const std::string &physicalId,
Jayant Chowdharya04055f2022-01-03 02:07:49 +0000137 int32_t groupId, aidl::android::hardware::camera::device::Stream *stream /*out*/);
138
Austin Borgerea931242021-12-13 23:10:41 +0000139// Check that the physicalCameraId passed in is spported by the camera
140// device.
141binder::Status checkPhysicalCameraId(
Austin Borger1c1bee02023-06-01 16:51:35 -0700142const std::vector<std::string> &physicalCameraIds, const std::string &physicalCameraId,
143const std::string &logicalCameraId);
Colin Crossb8a9dbb2020-08-27 04:12:26 +0000144
Austin Borgerea931242021-12-13 23:10:41 +0000145binder::Status checkSurfaceType(size_t numBufferProducers,
146bool deferredConsumer, int surfaceType);
Colin Crossb8a9dbb2020-08-27 04:12:26 +0000147
Austin Borgerea931242021-12-13 23:10:41 +0000148binder::Status checkOperatingMode(int operatingMode,
Austin Borger1c1bee02023-06-01 16:51:35 -0700149const CameraMetadata &staticInfo, const std::string &cameraId);
Colin Crossb8a9dbb2020-08-27 04:12:26 +0000150
Jayant Chowdharya04055f2022-01-03 02:07:49 +0000151binder::Status
152convertToHALStreamCombination(
153 const SessionConfiguration& sessionConfiguration,
Austin Borger1c1bee02023-06-01 16:51:35 -0700154 const std::string &logicalCameraId, const CameraMetadata &deviceInfo,
155 bool isCompositeJpegRDisabled, metadataGetter getMetadata,
156 const std::vector<std::string> &physicalCameraIds,
Jayant Chowdharya04055f2022-01-03 02:07:49 +0000157 aidl::android::hardware::camera::device::StreamConfiguration &streamConfiguration,
Shuzhen Wang045be6c2023-10-12 10:01:10 -0700158 bool overrideForPerfClass, metadata_vendor_id_t vendorTagId,
159 bool checkSessionParams, bool *earlyExit);
Jayant Chowdharya04055f2022-01-03 02:07:49 +0000160
Austin Borgerea931242021-12-13 23:10:41 +0000161StreamConfigurationPair getStreamConfigurationPair(const CameraMetadata &metadata);
Jayant Chowdhary13f9b2f2020-12-02 22:46:15 -0800162
Austin Borgerea931242021-12-13 23:10:41 +0000163status_t checkAndOverrideSensorPixelModesUsed(
164 const std::vector<int32_t> &sensorPixelModesUsed, int format, int width, int height,
Jayant Chowdharya80ad242023-03-17 00:49:47 +0000165 const CameraMetadata &staticInfo,
Austin Borgerea931242021-12-13 23:10:41 +0000166 std::unordered_set<int32_t> *overriddenSensorPixelModesUsed);
Jayant Chowdhary13f9b2f2020-12-02 22:46:15 -0800167
Austin Borgerea931242021-12-13 23:10:41 +0000168bool targetPerfClassPrimaryCamera(
169 const std::set<std::string>& perfClassPrimaryCameraIds, const std::string& cameraId,
170 int32_t targetSdkVersion);
Jayant Chowdhary13f9b2f2020-12-02 22:46:15 -0800171
Shuzhen Wang045be6c2023-10-12 10:01:10 -0700172// Utility method that maps AIDL request templates.
173binder::Status mapRequestTemplateFromClient(const std::string& cameraId, int templateId,
174 camera_request_template_t* tempId /*out*/);
175
176status_t mapRequestTemplateToAidl(camera_request_template_t templateId,
177 aidl::android::hardware::camera::device::RequestTemplate* tempId /*out*/);
178
179void filterParameters(const CameraMetadata& src, const CameraMetadata& deviceInfo,
180 int vendorTagId, CameraMetadata& dst);
181
Austin Borgerea931242021-12-13 23:10:41 +0000182constexpr int32_t MAX_SURFACES_PER_STREAM = 4;
Shuzhen Wangd4abdf72021-05-28 11:22:50 -0700183
Austin Borgerea931242021-12-13 23:10:41 +0000184constexpr int32_t ROUNDING_WIDTH_CAP = 1920;
Colin Crossb8a9dbb2020-08-27 04:12:26 +0000185
Austin Borgerea931242021-12-13 23:10:41 +0000186constexpr int32_t SDK_VERSION_S = 31;
187extern int32_t PERF_CLASS_LEVEL;
188extern bool IS_PERF_CLASS;
189constexpr int32_t PERF_CLASS_JPEG_THRESH_W = 1920;
190constexpr int32_t PERF_CLASS_JPEG_THRESH_H = 1080;
Jayant Chowdhary13f9b2f2020-12-02 22:46:15 -0800191
Austin Borgerea931242021-12-13 23:10:41 +0000192} // SessionConfigurationUtils
Jayant Chowdhary13f9b2f2020-12-02 22:46:15 -0800193} // camera3
Jayant Chowdhary2bbdce42020-01-12 14:55:41 -0800194} // android
Austin Borgerea931242021-12-13 23:10:41 +0000195
Jayant Chowdhary2bbdce42020-01-12 14:55:41 -0800196#endif