Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 1 | /* |
| 2 | * Copyright 2015 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 | |
Dominik Laskowski | 8b01cc0 | 2020-07-14 19:02:41 -0700 | [diff] [blame] | 17 | #pragma once |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 18 | |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 19 | #include <android-base/expected.h> |
Ady Abraham | 27fbcc7 | 2021-09-20 14:54:57 -0700 | [diff] [blame] | 20 | #include <android-base/thread_annotations.h> |
Courtney Goeltzenleuchter | f9c98e5 | 2018-02-12 07:23:17 -0700 | [diff] [blame] | 21 | #include <gui/HdrMetadata.h> |
Mathias Agopian | 1d77b71 | 2017-02-17 15:46:13 -0800 | [diff] [blame] | 22 | #include <math/mat4.h> |
Courtney Goeltzenleuchter | f9c98e5 | 2018-02-12 07:23:17 -0700 | [diff] [blame] | 23 | #include <ui/HdrCapabilities.h> |
Yichi Chen | 8366f56 | 2019-03-25 19:44:06 +0800 | [diff] [blame] | 24 | #include <ui/Region.h> |
Marin Shalamanov | 228f46b | 2021-01-28 21:11:45 +0100 | [diff] [blame] | 25 | #include <ui/StaticDisplayInfo.h> |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 26 | #include <utils/Log.h> |
| 27 | #include <utils/StrongPointer.h> |
| 28 | #include <utils/Timers.h> |
| 29 | |
| 30 | #include <functional> |
Dominik Laskowski | 5690bde | 2020-04-23 19:04:22 -0700 | [diff] [blame] | 31 | #include <future> |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 32 | #include <string> |
| 33 | #include <unordered_map> |
Dan Stoza | 9f26a9c | 2016-06-22 14:51:09 -0700 | [diff] [blame] | 34 | #include <unordered_set> |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 35 | #include <vector> |
| 36 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 37 | #include "Hal.h" |
| 38 | |
Leon Scroggins III | 2e1aa18 | 2021-12-01 17:33:12 -0500 | [diff] [blame] | 39 | #include <aidl/android/hardware/graphics/composer3/Composition.h> |
Leon Scroggins III | 5967aec | 2021-12-29 11:14:22 -0500 | [diff] [blame] | 40 | #include <aidl/android/hardware/graphics/composer3/DisplayCapability.h> |
Leon Scroggins III | 2e1aa18 | 2021-12-01 17:33:12 -0500 | [diff] [blame] | 41 | |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 42 | namespace android { |
Lloyd Pique | bc79209 | 2018-01-17 11:52:30 -0800 | [diff] [blame] | 43 | |
Dominik Laskowski | 8b01cc0 | 2020-07-14 19:02:41 -0700 | [diff] [blame] | 44 | class Fence; |
| 45 | class FloatRect; |
| 46 | class GraphicBuffer; |
| 47 | class TestableSurfaceFlinger; |
| 48 | struct DisplayedFrameStats; |
| 49 | |
| 50 | namespace Hwc2 { |
| 51 | class Composer; |
| 52 | } // namespace Hwc2 |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 53 | |
| 54 | namespace HWC2 { |
| 55 | |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 56 | class Layer; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 57 | |
| 58 | namespace hal = android::hardware::graphics::composer::hal; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 59 | |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 60 | // Implement this interface to receive hardware composer events. |
| 61 | // |
| 62 | // These callback functions will generally be called on a hwbinder thread, but |
Dominik Laskowski | 0deb06e | 2021-04-16 23:18:31 -0700 | [diff] [blame] | 63 | // when first registering the callback the onComposerHalHotplug() function will |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 64 | // immediately be called on the thread calling registerCallback(). |
Dominik Laskowski | 8b01cc0 | 2020-07-14 19:02:41 -0700 | [diff] [blame] | 65 | struct ComposerCallback { |
Dominik Laskowski | 0deb06e | 2021-04-16 23:18:31 -0700 | [diff] [blame] | 66 | virtual void onComposerHalHotplug(hal::HWDisplayId, hal::Connection) = 0; |
| 67 | virtual void onComposerHalRefresh(hal::HWDisplayId) = 0; |
| 68 | virtual void onComposerHalVsync(hal::HWDisplayId, int64_t timestamp, |
| 69 | std::optional<hal::VsyncPeriodNanos>) = 0; |
| 70 | virtual void onComposerHalVsyncPeriodTimingChanged(hal::HWDisplayId, |
| 71 | const hal::VsyncPeriodChangeTimeline&) = 0; |
| 72 | virtual void onComposerHalSeamlessPossible(hal::HWDisplayId) = 0; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 73 | |
Dominik Laskowski | 8b01cc0 | 2020-07-14 19:02:41 -0700 | [diff] [blame] | 74 | protected: |
| 75 | ~ComposerCallback() = default; |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 76 | }; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 77 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 78 | // Convenience C++ class to access per display functions directly. |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 79 | class Display { |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 80 | public: |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 81 | virtual ~Display(); |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 82 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 83 | virtual hal::HWDisplayId getId() const = 0; |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 84 | virtual bool isConnected() const = 0; |
| 85 | virtual void setConnected(bool connected) = 0; // For use by Device only |
Leon Scroggins III | 5967aec | 2021-12-29 11:14:22 -0500 | [diff] [blame] | 86 | virtual bool hasCapability( |
| 87 | aidl::android::hardware::graphics::composer3::DisplayCapability) const = 0; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 88 | virtual bool isVsyncPeriodSwitchSupported() const = 0; |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 89 | virtual void onLayerDestroyed(hal::HWLayerId layerId) = 0; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 90 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 91 | [[clang::warn_unused_result]] virtual hal::Error acceptChanges() = 0; |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 92 | [[clang::warn_unused_result]] virtual base::expected<std::shared_ptr<HWC2::Layer>, hal::Error> |
| 93 | createLayer() = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 94 | [[clang::warn_unused_result]] virtual hal::Error getChangedCompositionTypes( |
Leon Scroggins III | 2e1aa18 | 2021-12-01 17:33:12 -0500 | [diff] [blame] | 95 | std::unordered_map<Layer*, aidl::android::hardware::graphics::composer3::Composition>* |
| 96 | outTypes) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 97 | [[clang::warn_unused_result]] virtual hal::Error getColorModes( |
| 98 | std::vector<hal::ColorMode>* outModes) const = 0; |
Chia-I Wu | d7e01d7 | 2018-06-21 13:39:09 +0800 | [diff] [blame] | 99 | // Returns a bitmask which contains HdrMetadata::Type::*. |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 100 | [[clang::warn_unused_result]] virtual int32_t getSupportedPerFrameMetadata() const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 101 | [[clang::warn_unused_result]] virtual hal::Error getRenderIntents( |
| 102 | hal::ColorMode colorMode, std::vector<hal::RenderIntent>* outRenderIntents) const = 0; |
| 103 | [[clang::warn_unused_result]] virtual hal::Error getDataspaceSaturationMatrix( |
| 104 | hal::Dataspace dataspace, android::mat4* outMatrix) = 0; |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 105 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 106 | [[clang::warn_unused_result]] virtual hal::Error getName(std::string* outName) const = 0; |
| 107 | [[clang::warn_unused_result]] virtual hal::Error getRequests( |
| 108 | hal::DisplayRequest* outDisplayRequests, |
| 109 | std::unordered_map<Layer*, hal::LayerRequest>* outLayerRequests) = 0; |
| 110 | [[clang::warn_unused_result]] virtual hal::Error getConnectionType( |
Marin Shalamanov | 228f46b | 2021-01-28 21:11:45 +0100 | [diff] [blame] | 111 | ui::DisplayConnectionType*) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 112 | [[clang::warn_unused_result]] virtual hal::Error supportsDoze(bool* outSupport) const = 0; |
| 113 | [[clang::warn_unused_result]] virtual hal::Error getHdrCapabilities( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 114 | android::HdrCapabilities* outCapabilities) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 115 | [[clang::warn_unused_result]] virtual hal::Error getDisplayedContentSamplingAttributes( |
| 116 | hal::PixelFormat* outFormat, hal::Dataspace* outDataspace, |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 117 | uint8_t* outComponentMask) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 118 | [[clang::warn_unused_result]] virtual hal::Error setDisplayContentSamplingEnabled( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 119 | bool enabled, uint8_t componentMask, uint64_t maxFrames) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 120 | [[clang::warn_unused_result]] virtual hal::Error getDisplayedContentSample( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 121 | uint64_t maxFrames, uint64_t timestamp, |
| 122 | android::DisplayedFrameStats* outStats) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 123 | [[clang::warn_unused_result]] virtual hal::Error getReleaseFences( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 124 | std::unordered_map<Layer*, android::sp<android::Fence>>* outFences) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 125 | [[clang::warn_unused_result]] virtual hal::Error present( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 126 | android::sp<android::Fence>* outPresentFence) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 127 | [[clang::warn_unused_result]] virtual hal::Error setClientTarget( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 128 | uint32_t slot, const android::sp<android::GraphicBuffer>& target, |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 129 | const android::sp<android::Fence>& acquireFence, hal::Dataspace dataspace) = 0; |
| 130 | [[clang::warn_unused_result]] virtual hal::Error setColorMode( |
| 131 | hal::ColorMode mode, hal::RenderIntent renderIntent) = 0; |
| 132 | [[clang::warn_unused_result]] virtual hal::Error setColorTransform( |
Ady Abraham | dc011a9 | 2021-12-21 14:06:44 -0800 | [diff] [blame] | 133 | const android::mat4& matrix) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 134 | [[clang::warn_unused_result]] virtual hal::Error setOutputBuffer( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 135 | const android::sp<android::GraphicBuffer>& buffer, |
| 136 | const android::sp<android::Fence>& releaseFence) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 137 | [[clang::warn_unused_result]] virtual hal::Error setPowerMode(hal::PowerMode mode) = 0; |
| 138 | [[clang::warn_unused_result]] virtual hal::Error setVsyncEnabled(hal::Vsync enabled) = 0; |
Ady Abraham | 43065bd | 2021-12-10 17:22:15 -0800 | [diff] [blame] | 139 | [[clang::warn_unused_result]] virtual hal::Error validate(nsecs_t expectedPresentTime, |
| 140 | uint32_t* outNumTypes, |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 141 | uint32_t* outNumRequests) = 0; |
| 142 | [[clang::warn_unused_result]] virtual hal::Error presentOrValidate( |
Ady Abraham | 43065bd | 2021-12-10 17:22:15 -0800 | [diff] [blame] | 143 | nsecs_t expectedPresentTime, uint32_t* outNumTypes, uint32_t* outNumRequests, |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 144 | android::sp<android::Fence>* outPresentFence, uint32_t* state) = 0; |
Dominik Laskowski | 5690bde | 2020-04-23 19:04:22 -0700 | [diff] [blame] | 145 | [[clang::warn_unused_result]] virtual std::future<hal::Error> setDisplayBrightness( |
| 146 | float brightness) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 147 | [[clang::warn_unused_result]] virtual hal::Error setActiveConfigWithConstraints( |
Marin Shalamanov | 3ea1d60 | 2020-12-16 19:59:39 +0100 | [diff] [blame] | 148 | hal::HWConfigId configId, const hal::VsyncPeriodChangeConstraints& constraints, |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 149 | hal::VsyncPeriodChangeTimeline* outTimeline) = 0; |
Dominik Laskowski | 5690bde | 2020-04-23 19:04:22 -0700 | [diff] [blame] | 150 | [[clang::warn_unused_result]] virtual hal::Error setAutoLowLatencyMode(bool on) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 151 | [[clang::warn_unused_result]] virtual hal::Error getSupportedContentTypes( |
| 152 | std::vector<hal::ContentType>*) const = 0; |
Dominik Laskowski | 5690bde | 2020-04-23 19:04:22 -0700 | [diff] [blame] | 153 | [[clang::warn_unused_result]] virtual hal::Error setContentType(hal::ContentType) = 0; |
Peiyong Lin | dfc3f7c | 2020-05-07 20:15:50 -0700 | [diff] [blame] | 154 | [[clang::warn_unused_result]] virtual hal::Error getClientTargetProperty( |
Alec Mouri | cdf6cbc | 2021-11-01 17:21:15 -0700 | [diff] [blame] | 155 | hal::ClientTargetProperty* outClientTargetProperty, float* outWhitePointNits) = 0; |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 156 | }; |
| 157 | |
| 158 | namespace impl { |
| 159 | |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 160 | class Layer; |
| 161 | |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 162 | class Display : public HWC2::Display { |
| 163 | public: |
Marin Shalamanov | 0f10d0d | 2020-08-06 20:04:06 +0200 | [diff] [blame] | 164 | Display(android::Hwc2::Composer&, const std::unordered_set<hal::Capability>&, hal::HWDisplayId, |
| 165 | hal::DisplayType); |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 166 | ~Display() override; |
| 167 | |
| 168 | // Required by HWC2 |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 169 | hal::Error acceptChanges() override; |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 170 | base::expected<std::shared_ptr<HWC2::Layer>, hal::Error> createLayer() override; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 171 | hal::Error getChangedCompositionTypes( |
Leon Scroggins III | 2e1aa18 | 2021-12-01 17:33:12 -0500 | [diff] [blame] | 172 | std::unordered_map<HWC2::Layer*, |
| 173 | aidl::android::hardware::graphics::composer3::Composition>* outTypes) |
| 174 | override; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 175 | hal::Error getColorModes(std::vector<hal::ColorMode>* outModes) const override; |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 176 | // Returns a bitmask which contains HdrMetadata::Type::*. |
| 177 | int32_t getSupportedPerFrameMetadata() const override; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 178 | hal::Error getRenderIntents(hal::ColorMode colorMode, |
| 179 | std::vector<hal::RenderIntent>* outRenderIntents) const override; |
Marin Shalamanov | 0f10d0d | 2020-08-06 20:04:06 +0200 | [diff] [blame] | 180 | hal::Error getDataspaceSaturationMatrix(hal::Dataspace, android::mat4* outMatrix) override; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 181 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 182 | hal::Error getName(std::string* outName) const override; |
| 183 | hal::Error getRequests( |
| 184 | hal::DisplayRequest* outDisplayRequests, |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 185 | std::unordered_map<HWC2::Layer*, hal::LayerRequest>* outLayerRequests) override; |
Marin Shalamanov | 228f46b | 2021-01-28 21:11:45 +0100 | [diff] [blame] | 186 | hal::Error getConnectionType(ui::DisplayConnectionType*) const override; |
Ady Abraham | 27fbcc7 | 2021-09-20 14:54:57 -0700 | [diff] [blame] | 187 | hal::Error supportsDoze(bool* outSupport) const override EXCLUDES(mDisplayCapabilitiesMutex); |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 188 | hal::Error getHdrCapabilities(android::HdrCapabilities* outCapabilities) const override; |
| 189 | hal::Error getDisplayedContentSamplingAttributes(hal::PixelFormat* outFormat, |
| 190 | hal::Dataspace* outDataspace, |
| 191 | uint8_t* outComponentMask) const override; |
| 192 | hal::Error setDisplayContentSamplingEnabled(bool enabled, uint8_t componentMask, |
| 193 | uint64_t maxFrames) const override; |
| 194 | hal::Error getDisplayedContentSample(uint64_t maxFrames, uint64_t timestamp, |
| 195 | android::DisplayedFrameStats* outStats) const override; |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 196 | hal::Error getReleaseFences(std::unordered_map<HWC2::Layer*, android::sp<android::Fence>>* |
| 197 | outFences) const override; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 198 | hal::Error present(android::sp<android::Fence>* outPresentFence) override; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 199 | hal::Error setClientTarget(uint32_t slot, const android::sp<android::GraphicBuffer>& target, |
| 200 | const android::sp<android::Fence>& acquireFence, |
| 201 | hal::Dataspace dataspace) override; |
Marin Shalamanov | 0f10d0d | 2020-08-06 20:04:06 +0200 | [diff] [blame] | 202 | hal::Error setColorMode(hal::ColorMode, hal::RenderIntent) override; |
Ady Abraham | dc011a9 | 2021-12-21 14:06:44 -0800 | [diff] [blame] | 203 | hal::Error setColorTransform(const android::mat4& matrix) override; |
Marin Shalamanov | 0f10d0d | 2020-08-06 20:04:06 +0200 | [diff] [blame] | 204 | hal::Error setOutputBuffer(const android::sp<android::GraphicBuffer>&, |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 205 | const android::sp<android::Fence>& releaseFence) override; |
Marin Shalamanov | 0f10d0d | 2020-08-06 20:04:06 +0200 | [diff] [blame] | 206 | hal::Error setPowerMode(hal::PowerMode) override; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 207 | hal::Error setVsyncEnabled(hal::Vsync enabled) override; |
Ady Abraham | 43065bd | 2021-12-10 17:22:15 -0800 | [diff] [blame] | 208 | hal::Error validate(nsecs_t expectedPresentTime, uint32_t* outNumTypes, |
| 209 | uint32_t* outNumRequests) override; |
| 210 | hal::Error presentOrValidate(nsecs_t expectedPresentTime, uint32_t* outNumTypes, |
| 211 | uint32_t* outNumRequests, |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 212 | android::sp<android::Fence>* outPresentFence, |
| 213 | uint32_t* state) override; |
Dominik Laskowski | 5690bde | 2020-04-23 19:04:22 -0700 | [diff] [blame] | 214 | std::future<hal::Error> setDisplayBrightness(float brightness) override; |
Marin Shalamanov | 3ea1d60 | 2020-12-16 19:59:39 +0100 | [diff] [blame] | 215 | hal::Error setActiveConfigWithConstraints(hal::HWConfigId configId, |
| 216 | const hal::VsyncPeriodChangeConstraints& constraints, |
| 217 | hal::VsyncPeriodChangeTimeline* outTimeline) override; |
Dominik Laskowski | 5690bde | 2020-04-23 19:04:22 -0700 | [diff] [blame] | 218 | hal::Error setAutoLowLatencyMode(bool on) override; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 219 | hal::Error getSupportedContentTypes( |
| 220 | std::vector<hal::ContentType>* outSupportedContentTypes) const override; |
Dominik Laskowski | 5690bde | 2020-04-23 19:04:22 -0700 | [diff] [blame] | 221 | hal::Error setContentType(hal::ContentType) override; |
Alec Mouri | cdf6cbc | 2021-11-01 17:21:15 -0700 | [diff] [blame] | 222 | hal::Error getClientTargetProperty(hal::ClientTargetProperty* outClientTargetProperty, |
| 223 | float* outWhitePointNits) override; |
Peiyong Lin | dfc3f7c | 2020-05-07 20:15:50 -0700 | [diff] [blame] | 224 | |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 225 | // Other Display methods |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 226 | hal::HWDisplayId getId() const override { return mId; } |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 227 | bool isConnected() const override { return mIsConnected; } |
| 228 | void setConnected(bool connected) override; // For use by Device only |
Leon Scroggins III | 5967aec | 2021-12-29 11:14:22 -0500 | [diff] [blame] | 229 | bool hasCapability(aidl::android::hardware::graphics::composer3::DisplayCapability) |
| 230 | const override EXCLUDES(mDisplayCapabilitiesMutex); |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 231 | bool isVsyncPeriodSwitchSupported() const override; |
| 232 | void onLayerDestroyed(hal::HWLayerId layerId) override; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 233 | |
| 234 | private: |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 235 | |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 236 | // This may fail (and return a null pointer) if no layer with this ID exists |
| 237 | // on this display |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 238 | std::shared_ptr<HWC2::Layer> getLayerById(hal::HWLayerId id) const; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 239 | |
Lloyd Pique | bc79209 | 2018-01-17 11:52:30 -0800 | [diff] [blame] | 240 | friend android::TestableSurfaceFlinger; |
| 241 | |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 242 | // Member variables |
| 243 | |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 244 | // These are references to data owned by HWC2::Device, which will outlive |
| 245 | // this HWC2::Display, so these references are guaranteed to be valid for |
| 246 | // the lifetime of this object. |
| 247 | android::Hwc2::Composer& mComposer; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 248 | const std::unordered_set<hal::Capability>& mCapabilities; |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 249 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 250 | const hal::HWDisplayId mId; |
| 251 | hal::DisplayType mType; |
Dominik Laskowski | 55c8540 | 2020-01-21 16:25:47 -0800 | [diff] [blame] | 252 | bool mIsConnected = false; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 253 | |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 254 | using Layers = std::unordered_map<hal::HWLayerId, std::weak_ptr<HWC2::impl::Layer>>; |
| 255 | Layers mLayers; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 256 | |
Ady Abraham | 27fbcc7 | 2021-09-20 14:54:57 -0700 | [diff] [blame] | 257 | mutable std::mutex mDisplayCapabilitiesMutex; |
Peiyong Lin | 1336e6e | 2019-05-28 09:23:50 -0700 | [diff] [blame] | 258 | std::once_flag mDisplayCapabilityQueryFlag; |
Leon Scroggins III | 5967aec | 2021-12-29 11:14:22 -0500 | [diff] [blame] | 259 | std::optional< |
| 260 | std::unordered_set<aidl::android::hardware::graphics::composer3::DisplayCapability>> |
| 261 | mDisplayCapabilities GUARDED_BY(mDisplayCapabilitiesMutex); |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 262 | }; |
Dominik Laskowski | 55c8540 | 2020-01-21 16:25:47 -0800 | [diff] [blame] | 263 | |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 264 | } // namespace impl |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 265 | |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 266 | class Layer { |
| 267 | public: |
| 268 | virtual ~Layer(); |
| 269 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 270 | virtual hal::HWLayerId getId() const = 0; |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 271 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 272 | [[clang::warn_unused_result]] virtual hal::Error setCursorPosition(int32_t x, int32_t y) = 0; |
| 273 | [[clang::warn_unused_result]] virtual hal::Error setBuffer( |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 274 | uint32_t slot, const android::sp<android::GraphicBuffer>& buffer, |
| 275 | const android::sp<android::Fence>& acquireFence) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 276 | [[clang::warn_unused_result]] virtual hal::Error setSurfaceDamage( |
| 277 | const android::Region& damage) = 0; |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 278 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 279 | [[clang::warn_unused_result]] virtual hal::Error setBlendMode(hal::BlendMode mode) = 0; |
| 280 | [[clang::warn_unused_result]] virtual hal::Error setColor(hal::Color color) = 0; |
Leon Scroggins III | 2e1aa18 | 2021-12-01 17:33:12 -0500 | [diff] [blame] | 281 | [[clang::warn_unused_result]] virtual hal::Error setCompositionType( |
| 282 | aidl::android::hardware::graphics::composer3::Composition type) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 283 | [[clang::warn_unused_result]] virtual hal::Error setDataspace(hal::Dataspace dataspace) = 0; |
| 284 | [[clang::warn_unused_result]] virtual hal::Error setPerFrameMetadata( |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 285 | const int32_t supportedPerFrameMetadata, const android::HdrMetadata& metadata) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 286 | [[clang::warn_unused_result]] virtual hal::Error setDisplayFrame( |
| 287 | const android::Rect& frame) = 0; |
| 288 | [[clang::warn_unused_result]] virtual hal::Error setPlaneAlpha(float alpha) = 0; |
| 289 | [[clang::warn_unused_result]] virtual hal::Error setSidebandStream( |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 290 | const native_handle_t* stream) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 291 | [[clang::warn_unused_result]] virtual hal::Error setSourceCrop( |
| 292 | const android::FloatRect& crop) = 0; |
| 293 | [[clang::warn_unused_result]] virtual hal::Error setTransform(hal::Transform transform) = 0; |
| 294 | [[clang::warn_unused_result]] virtual hal::Error setVisibleRegion( |
| 295 | const android::Region& region) = 0; |
| 296 | [[clang::warn_unused_result]] virtual hal::Error setZOrder(uint32_t z) = 0; |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 297 | |
| 298 | // Composer HAL 2.3 |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 299 | [[clang::warn_unused_result]] virtual hal::Error setColorTransform( |
| 300 | const android::mat4& matrix) = 0; |
Lloyd Pique | 4603f3c | 2020-02-11 12:06:56 -0800 | [diff] [blame] | 301 | |
| 302 | // Composer HAL 2.4 |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 303 | [[clang::warn_unused_result]] virtual hal::Error setLayerGenericMetadata( |
Lloyd Pique | 4603f3c | 2020-02-11 12:06:56 -0800 | [diff] [blame] | 304 | const std::string& name, bool mandatory, const std::vector<uint8_t>& value) = 0; |
Alec Mouri | cdf6cbc | 2021-11-01 17:21:15 -0700 | [diff] [blame] | 305 | |
| 306 | // AIDL HAL |
| 307 | [[clang::warn_unused_result]] virtual hal::Error setWhitePointNits(float whitePointNits) = 0; |
Leon Scroggins III | d77d316 | 2022-01-05 10:42:28 -0500 | [diff] [blame^] | 308 | [[clang::warn_unused_result]] virtual hal::Error setBlockingRegion( |
| 309 | const android::Region& region) = 0; |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 310 | }; |
| 311 | |
| 312 | namespace impl { |
| 313 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 314 | // Convenience C++ class to access per layer functions directly. |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 315 | |
| 316 | class Layer : public HWC2::Layer { |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 317 | public: |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 318 | Layer(android::Hwc2::Composer& composer, |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 319 | const std::unordered_set<hal::Capability>& capabilities, HWC2::Display& display, |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 320 | hal::HWLayerId layerId); |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 321 | ~Layer() override; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 322 | |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 323 | void onOwningDisplayDestroyed(); |
| 324 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 325 | hal::HWLayerId getId() const override { return mId; } |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 326 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 327 | hal::Error setCursorPosition(int32_t x, int32_t y) override; |
| 328 | hal::Error setBuffer(uint32_t slot, const android::sp<android::GraphicBuffer>& buffer, |
| 329 | const android::sp<android::Fence>& acquireFence) override; |
| 330 | hal::Error setSurfaceDamage(const android::Region& damage) override; |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 331 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 332 | hal::Error setBlendMode(hal::BlendMode mode) override; |
| 333 | hal::Error setColor(hal::Color color) override; |
Leon Scroggins III | 2e1aa18 | 2021-12-01 17:33:12 -0500 | [diff] [blame] | 334 | hal::Error setCompositionType( |
| 335 | aidl::android::hardware::graphics::composer3::Composition type) override; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 336 | hal::Error setDataspace(hal::Dataspace dataspace) override; |
| 337 | hal::Error setPerFrameMetadata(const int32_t supportedPerFrameMetadata, |
| 338 | const android::HdrMetadata& metadata) override; |
| 339 | hal::Error setDisplayFrame(const android::Rect& frame) override; |
| 340 | hal::Error setPlaneAlpha(float alpha) override; |
| 341 | hal::Error setSidebandStream(const native_handle_t* stream) override; |
| 342 | hal::Error setSourceCrop(const android::FloatRect& crop) override; |
| 343 | hal::Error setTransform(hal::Transform transform) override; |
| 344 | hal::Error setVisibleRegion(const android::Region& region) override; |
| 345 | hal::Error setZOrder(uint32_t z) override; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 346 | |
Peiyong Lin | 698147a | 2018-09-14 13:27:18 -0700 | [diff] [blame] | 347 | // Composer HAL 2.3 |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 348 | hal::Error setColorTransform(const android::mat4& matrix) override; |
Peiyong Lin | 698147a | 2018-09-14 13:27:18 -0700 | [diff] [blame] | 349 | |
Lloyd Pique | 4603f3c | 2020-02-11 12:06:56 -0800 | [diff] [blame] | 350 | // Composer HAL 2.4 |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 351 | hal::Error setLayerGenericMetadata(const std::string& name, bool mandatory, |
| 352 | const std::vector<uint8_t>& value) override; |
Lloyd Pique | 4603f3c | 2020-02-11 12:06:56 -0800 | [diff] [blame] | 353 | |
Alec Mouri | cdf6cbc | 2021-11-01 17:21:15 -0700 | [diff] [blame] | 354 | // AIDL HAL |
| 355 | hal::Error setWhitePointNits(float whitePointNits) override; |
Leon Scroggins III | d77d316 | 2022-01-05 10:42:28 -0500 | [diff] [blame^] | 356 | hal::Error setBlockingRegion(const android::Region& region) override; |
Alec Mouri | cdf6cbc | 2021-11-01 17:21:15 -0700 | [diff] [blame] | 357 | |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 358 | private: |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 359 | // These are references to data owned by HWC2::Device, which will outlive |
| 360 | // this HWC2::Layer, so these references are guaranteed to be valid for |
| 361 | // the lifetime of this object. |
| 362 | android::Hwc2::Composer& mComposer; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 363 | const std::unordered_set<hal::Capability>& mCapabilities; |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 364 | |
Lloyd Pique | a516c00 | 2021-05-07 14:36:58 -0700 | [diff] [blame] | 365 | HWC2::Display* mDisplay; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 366 | hal::HWLayerId mId; |
Yichi Chen | 8366f56 | 2019-03-25 19:44:06 +0800 | [diff] [blame] | 367 | |
| 368 | // Cached HWC2 data, to ensure the same commands aren't sent to the HWC |
| 369 | // multiple times. |
| 370 | android::Region mVisibleRegion = android::Region::INVALID_REGION; |
| 371 | android::Region mDamageRegion = android::Region::INVALID_REGION; |
Leon Scroggins III | d77d316 | 2022-01-05 10:42:28 -0500 | [diff] [blame^] | 372 | android::Region mBlockingRegion = android::Region::INVALID_REGION; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 373 | hal::Dataspace mDataSpace = hal::Dataspace::UNKNOWN; |
Courtney Goeltzenleuchter | f9c98e5 | 2018-02-12 07:23:17 -0700 | [diff] [blame] | 374 | android::HdrMetadata mHdrMetadata; |
Peiyong Lin | 698147a | 2018-09-14 13:27:18 -0700 | [diff] [blame] | 375 | android::mat4 mColorMatrix; |
Yichi Chen | 8366f56 | 2019-03-25 19:44:06 +0800 | [diff] [blame] | 376 | uint32_t mBufferSlot; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 377 | }; |
| 378 | |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 379 | } // namespace impl |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 380 | } // namespace HWC2 |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 381 | } // namespace android |