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 | |
| 17 | #ifndef ANDROID_SF_HWC2_H |
| 18 | #define ANDROID_SF_HWC2_H |
| 19 | |
Courtney Goeltzenleuchter | f9c98e5 | 2018-02-12 07:23:17 -0700 | [diff] [blame] | 20 | #include <gui/HdrMetadata.h> |
Mathias Agopian | 1d77b71 | 2017-02-17 15:46:13 -0800 | [diff] [blame] | 21 | #include <math/mat4.h> |
Dominik Laskowski | 55c8540 | 2020-01-21 16:25:47 -0800 | [diff] [blame] | 22 | #include <ui/DisplayInfo.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> |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 25 | #include <utils/Log.h> |
| 26 | #include <utils/StrongPointer.h> |
| 27 | #include <utils/Timers.h> |
| 28 | |
| 29 | #include <functional> |
| 30 | #include <string> |
| 31 | #include <unordered_map> |
Dan Stoza | 9f26a9c | 2016-06-22 14:51:09 -0700 | [diff] [blame] | 32 | #include <unordered_set> |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 33 | #include <vector> |
| 34 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 35 | #include "Hal.h" |
| 36 | |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 37 | namespace android { |
Kevin DuBois | 1d4249a | 2018-08-29 10:45:14 -0700 | [diff] [blame] | 38 | struct DisplayedFrameStats; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 39 | class Fence; |
Dan Stoza | 5a423ea | 2017-02-16 14:10:39 -0800 | [diff] [blame] | 40 | class FloatRect; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 41 | class GraphicBuffer; |
Chia-I Wu | aab99f5 | 2016-10-05 12:59:58 +0800 | [diff] [blame] | 42 | namespace Hwc2 { |
| 43 | class Composer; |
Dan Stoza | 71bded5 | 2016-10-19 11:10:33 -0700 | [diff] [blame] | 44 | } |
Lloyd Pique | bc79209 | 2018-01-17 11:52:30 -0800 | [diff] [blame] | 45 | |
| 46 | class TestableSurfaceFlinger; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 47 | |
| 48 | namespace HWC2 { |
| 49 | |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 50 | class Layer; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 51 | |
| 52 | namespace hal = android::hardware::graphics::composer::hal; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 53 | |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 54 | // Implement this interface to receive hardware composer events. |
| 55 | // |
| 56 | // These callback functions will generally be called on a hwbinder thread, but |
| 57 | // when first registering the callback the onHotplugReceived() function will |
| 58 | // immediately be called on the thread calling registerCallback(). |
| 59 | // |
| 60 | // All calls receive a sequenceId, which will be the value that was supplied to |
| 61 | // HWC2::Device::registerCallback(). It's used to help differentiate callbacks |
| 62 | // from different hardware composer instances. |
| 63 | class ComposerCallback { |
| 64 | public: |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 65 | virtual void onHotplugReceived(int32_t sequenceId, hal::HWDisplayId display, |
| 66 | hal::Connection connection) = 0; |
| 67 | virtual void onRefreshReceived(int32_t sequenceId, hal::HWDisplayId display) = 0; |
| 68 | virtual void onVsyncReceived(int32_t sequenceId, hal::HWDisplayId display, int64_t timestamp, |
| 69 | std::optional<hal::VsyncPeriodNanos> vsyncPeriod) = 0; |
| 70 | virtual void onVsyncPeriodTimingChangedReceived( |
| 71 | int32_t sequenceId, hal::HWDisplayId display, |
| 72 | const hal::VsyncPeriodChangeTimeline& updatedTimeline) = 0; |
| 73 | virtual void onSeamlessPossible(int32_t sequenceId, hal::HWDisplayId display) = 0; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 74 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 75 | virtual ~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 | |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 83 | class Config { |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 84 | public: |
| 85 | class Builder |
| 86 | { |
| 87 | public: |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 88 | Builder(Display& display, hal::HWConfigId id); |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 89 | |
| 90 | std::shared_ptr<const Config> build() { |
| 91 | return std::const_pointer_cast<const Config>( |
| 92 | std::move(mConfig)); |
| 93 | } |
| 94 | |
| 95 | Builder& setWidth(int32_t width) { |
| 96 | mConfig->mWidth = width; |
| 97 | return *this; |
| 98 | } |
| 99 | Builder& setHeight(int32_t height) { |
| 100 | mConfig->mHeight = height; |
| 101 | return *this; |
| 102 | } |
| 103 | Builder& setVsyncPeriod(int32_t vsyncPeriod) { |
| 104 | mConfig->mVsyncPeriod = vsyncPeriod; |
| 105 | return *this; |
| 106 | } |
| 107 | Builder& setDpiX(int32_t dpiX) { |
| 108 | if (dpiX == -1) { |
| 109 | mConfig->mDpiX = getDefaultDensity(); |
| 110 | } else { |
| 111 | mConfig->mDpiX = dpiX / 1000.0f; |
| 112 | } |
| 113 | return *this; |
| 114 | } |
| 115 | Builder& setDpiY(int32_t dpiY) { |
| 116 | if (dpiY == -1) { |
| 117 | mConfig->mDpiY = getDefaultDensity(); |
| 118 | } else { |
| 119 | mConfig->mDpiY = dpiY / 1000.0f; |
| 120 | } |
| 121 | return *this; |
| 122 | } |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 123 | Builder& setConfigGroup(int32_t configGroup) { |
| 124 | mConfig->mConfigGroup = configGroup; |
| 125 | return *this; |
| 126 | } |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 127 | |
| 128 | private: |
| 129 | float getDefaultDensity(); |
| 130 | std::shared_ptr<Config> mConfig; |
| 131 | }; |
| 132 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 133 | hal::HWDisplayId getDisplayId() const { return mDisplay.getId(); } |
| 134 | hal::HWConfigId getId() const { return mId; } |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 135 | |
| 136 | int32_t getWidth() const { return mWidth; } |
| 137 | int32_t getHeight() const { return mHeight; } |
David Sodman | 1afa8b0 | 2018-10-15 11:20:48 -0700 | [diff] [blame] | 138 | nsecs_t getVsyncPeriod() const { return mVsyncPeriod; } |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 139 | float getDpiX() const { return mDpiX; } |
| 140 | float getDpiY() const { return mDpiY; } |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 141 | int32_t getConfigGroup() const { return mConfigGroup; } |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 142 | |
| 143 | private: |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 144 | Config(Display& display, hal::HWConfigId id); |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 145 | |
| 146 | Display& mDisplay; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 147 | hal::HWConfigId mId; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 148 | |
| 149 | int32_t mWidth; |
| 150 | int32_t mHeight; |
| 151 | nsecs_t mVsyncPeriod; |
| 152 | float mDpiX; |
| 153 | float mDpiY; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 154 | int32_t mConfigGroup; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 155 | }; |
| 156 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 157 | virtual hal::HWDisplayId getId() const = 0; |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 158 | virtual bool isConnected() const = 0; |
| 159 | virtual void setConnected(bool connected) = 0; // For use by Device only |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 160 | virtual const std::unordered_set<hal::DisplayCapability>& getCapabilities() const = 0; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 161 | virtual bool isVsyncPeriodSwitchSupported() const = 0; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 162 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 163 | [[clang::warn_unused_result]] virtual hal::Error acceptChanges() = 0; |
| 164 | [[clang::warn_unused_result]] virtual hal::Error createLayer(Layer** outLayer) = 0; |
| 165 | [[clang::warn_unused_result]] virtual hal::Error destroyLayer(Layer* layer) = 0; |
| 166 | [[clang::warn_unused_result]] virtual hal::Error getActiveConfig( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 167 | std::shared_ptr<const Config>* outConfig) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 168 | [[clang::warn_unused_result]] virtual hal::Error getActiveConfigIndex(int* outIndex) const = 0; |
| 169 | [[clang::warn_unused_result]] virtual hal::Error getChangedCompositionTypes( |
| 170 | std::unordered_map<Layer*, hal::Composition>* outTypes) = 0; |
| 171 | [[clang::warn_unused_result]] virtual hal::Error getColorModes( |
| 172 | std::vector<hal::ColorMode>* outModes) const = 0; |
Chia-I Wu | d7e01d7 | 2018-06-21 13:39:09 +0800 | [diff] [blame] | 173 | // Returns a bitmask which contains HdrMetadata::Type::*. |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 174 | [[clang::warn_unused_result]] virtual int32_t getSupportedPerFrameMetadata() const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 175 | [[clang::warn_unused_result]] virtual hal::Error getRenderIntents( |
| 176 | hal::ColorMode colorMode, std::vector<hal::RenderIntent>* outRenderIntents) const = 0; |
| 177 | [[clang::warn_unused_result]] virtual hal::Error getDataspaceSaturationMatrix( |
| 178 | hal::Dataspace dataspace, android::mat4* outMatrix) = 0; |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 179 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 180 | // Doesn't call into the HWC2 device, so no errors are possible |
| 181 | [[clang::warn_unused_result]] virtual std::vector<std::shared_ptr<const Config>> getConfigs() |
| 182 | const = 0; |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 183 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 184 | [[clang::warn_unused_result]] virtual hal::Error getName(std::string* outName) const = 0; |
| 185 | [[clang::warn_unused_result]] virtual hal::Error getRequests( |
| 186 | hal::DisplayRequest* outDisplayRequests, |
| 187 | std::unordered_map<Layer*, hal::LayerRequest>* outLayerRequests) = 0; |
| 188 | [[clang::warn_unused_result]] virtual hal::Error getConnectionType( |
Dominik Laskowski | 55c8540 | 2020-01-21 16:25:47 -0800 | [diff] [blame] | 189 | android::DisplayConnectionType*) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 190 | [[clang::warn_unused_result]] virtual hal::Error supportsDoze(bool* outSupport) const = 0; |
| 191 | [[clang::warn_unused_result]] virtual hal::Error getHdrCapabilities( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 192 | android::HdrCapabilities* outCapabilities) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 193 | [[clang::warn_unused_result]] virtual hal::Error getDisplayedContentSamplingAttributes( |
| 194 | hal::PixelFormat* outFormat, hal::Dataspace* outDataspace, |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 195 | uint8_t* outComponentMask) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 196 | [[clang::warn_unused_result]] virtual hal::Error setDisplayContentSamplingEnabled( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 197 | bool enabled, uint8_t componentMask, uint64_t maxFrames) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 198 | [[clang::warn_unused_result]] virtual hal::Error getDisplayedContentSample( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 199 | uint64_t maxFrames, uint64_t timestamp, |
| 200 | android::DisplayedFrameStats* outStats) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 201 | [[clang::warn_unused_result]] virtual hal::Error getReleaseFences( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 202 | std::unordered_map<Layer*, android::sp<android::Fence>>* outFences) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 203 | [[clang::warn_unused_result]] virtual hal::Error present( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 204 | android::sp<android::Fence>* outPresentFence) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 205 | [[clang::warn_unused_result]] virtual hal::Error setActiveConfig( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 206 | const std::shared_ptr<const Config>& config) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 207 | [[clang::warn_unused_result]] virtual hal::Error setClientTarget( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 208 | uint32_t slot, const android::sp<android::GraphicBuffer>& target, |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 209 | const android::sp<android::Fence>& acquireFence, hal::Dataspace dataspace) = 0; |
| 210 | [[clang::warn_unused_result]] virtual hal::Error setColorMode( |
| 211 | hal::ColorMode mode, hal::RenderIntent renderIntent) = 0; |
| 212 | [[clang::warn_unused_result]] virtual hal::Error setColorTransform( |
| 213 | const android::mat4& matrix, hal::ColorTransform hint) = 0; |
| 214 | [[clang::warn_unused_result]] virtual hal::Error setOutputBuffer( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 215 | const android::sp<android::GraphicBuffer>& buffer, |
| 216 | const android::sp<android::Fence>& releaseFence) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 217 | [[clang::warn_unused_result]] virtual hal::Error setPowerMode(hal::PowerMode mode) = 0; |
| 218 | [[clang::warn_unused_result]] virtual hal::Error setVsyncEnabled(hal::Vsync enabled) = 0; |
| 219 | [[clang::warn_unused_result]] virtual hal::Error validate(uint32_t* outNumTypes, |
| 220 | uint32_t* outNumRequests) = 0; |
| 221 | [[clang::warn_unused_result]] virtual hal::Error presentOrValidate( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 222 | uint32_t* outNumTypes, uint32_t* outNumRequests, |
| 223 | android::sp<android::Fence>* outPresentFence, uint32_t* state) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 224 | [[clang::warn_unused_result]] virtual hal::Error setDisplayBrightness( |
| 225 | float brightness) const = 0; |
| 226 | [[clang::warn_unused_result]] virtual hal::Error getDisplayVsyncPeriod( |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 227 | nsecs_t* outVsyncPeriod) const = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 228 | [[clang::warn_unused_result]] virtual hal::Error setActiveConfigWithConstraints( |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 229 | const std::shared_ptr<const HWC2::Display::Config>& config, |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 230 | const hal::VsyncPeriodChangeConstraints& constraints, |
| 231 | hal::VsyncPeriodChangeTimeline* outTimeline) = 0; |
| 232 | [[clang::warn_unused_result]] virtual hal::Error setAutoLowLatencyMode(bool on) const = 0; |
| 233 | [[clang::warn_unused_result]] virtual hal::Error getSupportedContentTypes( |
| 234 | std::vector<hal::ContentType>*) const = 0; |
| 235 | [[clang::warn_unused_result]] virtual hal::Error setContentType(hal::ContentType) const = 0; |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 236 | }; |
| 237 | |
| 238 | namespace impl { |
| 239 | |
| 240 | class Display : public HWC2::Display { |
| 241 | public: |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 242 | Display(android::Hwc2::Composer& composer, |
| 243 | const std::unordered_set<hal::Capability>& capabilities, hal::HWDisplayId id, |
| 244 | hal::DisplayType type); |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 245 | ~Display() override; |
| 246 | |
| 247 | // Required by HWC2 |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 248 | hal::Error acceptChanges() override; |
| 249 | hal::Error createLayer(Layer** outLayer) override; |
| 250 | hal::Error destroyLayer(Layer* layer) override; |
| 251 | hal::Error getActiveConfig(std::shared_ptr<const Config>* outConfig) const override; |
| 252 | hal::Error getActiveConfigIndex(int* outIndex) const override; |
| 253 | hal::Error getChangedCompositionTypes( |
| 254 | std::unordered_map<Layer*, hal::Composition>* outTypes) override; |
| 255 | hal::Error getColorModes(std::vector<hal::ColorMode>* outModes) const override; |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 256 | // Returns a bitmask which contains HdrMetadata::Type::*. |
| 257 | int32_t getSupportedPerFrameMetadata() const override; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 258 | hal::Error getRenderIntents(hal::ColorMode colorMode, |
| 259 | std::vector<hal::RenderIntent>* outRenderIntents) const override; |
| 260 | hal::Error getDataspaceSaturationMatrix(hal::Dataspace dataspace, |
| 261 | android::mat4* outMatrix) override; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 262 | |
| 263 | // Doesn't call into the HWC2 device, so no errors are possible |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 264 | std::vector<std::shared_ptr<const Config>> getConfigs() const override; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 265 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 266 | hal::Error getName(std::string* outName) const override; |
| 267 | hal::Error getRequests( |
| 268 | hal::DisplayRequest* outDisplayRequests, |
| 269 | std::unordered_map<Layer*, hal::LayerRequest>* outLayerRequests) override; |
| 270 | hal::Error getConnectionType(android::DisplayConnectionType*) const override; |
| 271 | hal::Error supportsDoze(bool* outSupport) const override; |
| 272 | hal::Error getHdrCapabilities(android::HdrCapabilities* outCapabilities) const override; |
| 273 | hal::Error getDisplayedContentSamplingAttributes(hal::PixelFormat* outFormat, |
| 274 | hal::Dataspace* outDataspace, |
| 275 | uint8_t* outComponentMask) const override; |
| 276 | hal::Error setDisplayContentSamplingEnabled(bool enabled, uint8_t componentMask, |
| 277 | uint64_t maxFrames) const override; |
| 278 | hal::Error getDisplayedContentSample(uint64_t maxFrames, uint64_t timestamp, |
| 279 | android::DisplayedFrameStats* outStats) const override; |
| 280 | hal::Error getReleaseFences( |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 281 | std::unordered_map<Layer*, android::sp<android::Fence>>* outFences) const override; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 282 | hal::Error present(android::sp<android::Fence>* outPresentFence) override; |
| 283 | hal::Error setActiveConfig(const std::shared_ptr<const HWC2::Display::Config>& config) override; |
| 284 | hal::Error setClientTarget(uint32_t slot, const android::sp<android::GraphicBuffer>& target, |
| 285 | const android::sp<android::Fence>& acquireFence, |
| 286 | hal::Dataspace dataspace) override; |
| 287 | hal::Error setColorMode(hal::ColorMode mode, hal::RenderIntent renderIntent) override; |
| 288 | hal::Error setColorTransform(const android::mat4& matrix, hal::ColorTransform hint) override; |
| 289 | hal::Error setOutputBuffer(const android::sp<android::GraphicBuffer>& buffer, |
| 290 | const android::sp<android::Fence>& releaseFence) override; |
| 291 | hal::Error setPowerMode(hal::PowerMode mode) override; |
| 292 | hal::Error setVsyncEnabled(hal::Vsync enabled) override; |
| 293 | hal::Error validate(uint32_t* outNumTypes, uint32_t* outNumRequests) override; |
| 294 | hal::Error presentOrValidate(uint32_t* outNumTypes, uint32_t* outNumRequests, |
| 295 | android::sp<android::Fence>* outPresentFence, |
| 296 | uint32_t* state) override; |
| 297 | hal::Error setDisplayBrightness(float brightness) const override; |
| 298 | hal::Error getDisplayVsyncPeriod(nsecs_t* outVsyncPeriod) const override; |
| 299 | hal::Error setActiveConfigWithConstraints( |
| 300 | const std::shared_ptr<const HWC2::Display::Config>& config, |
| 301 | const hal::VsyncPeriodChangeConstraints& constraints, |
| 302 | hal::VsyncPeriodChangeTimeline* outTimeline) override; |
| 303 | hal::Error setAutoLowLatencyMode(bool on) const override; |
| 304 | hal::Error getSupportedContentTypes( |
| 305 | std::vector<hal::ContentType>* outSupportedContentTypes) const override; |
| 306 | hal::Error setContentType(hal::ContentType contentType) const override; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 307 | // Other Display methods |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 308 | hal::HWDisplayId getId() const override { return mId; } |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 309 | bool isConnected() const override { return mIsConnected; } |
| 310 | void setConnected(bool connected) override; // For use by Device only |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 311 | const std::unordered_set<hal::DisplayCapability>& getCapabilities() const override { |
Peiyong Lin | ed531a3 | 2018-10-26 18:27:56 -0700 | [diff] [blame] | 312 | return mDisplayCapabilities; |
| 313 | }; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 314 | virtual bool isVsyncPeriodSwitchSupported() const override; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 315 | |
| 316 | private: |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 317 | int32_t getAttribute(hal::HWConfigId configId, hal::Attribute attribute); |
| 318 | void loadConfig(hal::HWConfigId configId); |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 319 | void loadConfigs(); |
| 320 | |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 321 | // This may fail (and return a null pointer) if no layer with this ID exists |
| 322 | // on this display |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 323 | Layer* getLayerById(hal::HWLayerId id) const; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 324 | |
Lloyd Pique | bc79209 | 2018-01-17 11:52:30 -0800 | [diff] [blame] | 325 | friend android::TestableSurfaceFlinger; |
| 326 | |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 327 | // Member variables |
| 328 | |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 329 | // These are references to data owned by HWC2::Device, which will outlive |
| 330 | // this HWC2::Display, so these references are guaranteed to be valid for |
| 331 | // the lifetime of this object. |
| 332 | android::Hwc2::Composer& mComposer; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 333 | const std::unordered_set<hal::Capability>& mCapabilities; |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 334 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 335 | const hal::HWDisplayId mId; |
| 336 | hal::DisplayType mType; |
Dominik Laskowski | 55c8540 | 2020-01-21 16:25:47 -0800 | [diff] [blame] | 337 | bool mIsConnected = false; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 338 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 339 | std::unordered_map<hal::HWLayerId, std::unique_ptr<Layer>> mLayers; |
| 340 | std::unordered_map<hal::HWConfigId, std::shared_ptr<const Config>> mConfigs; |
Ady Abraham | 7159f57 | 2019-10-11 11:10:18 -0700 | [diff] [blame] | 341 | |
Peiyong Lin | 1336e6e | 2019-05-28 09:23:50 -0700 | [diff] [blame] | 342 | std::once_flag mDisplayCapabilityQueryFlag; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 343 | std::unordered_set<hal::DisplayCapability> mDisplayCapabilities; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 344 | }; |
Dominik Laskowski | 55c8540 | 2020-01-21 16:25:47 -0800 | [diff] [blame] | 345 | |
Ana Krulec | 4593b69 | 2019-01-11 22:07:25 -0800 | [diff] [blame] | 346 | } // namespace impl |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 347 | |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 348 | class Layer { |
| 349 | public: |
| 350 | virtual ~Layer(); |
| 351 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 352 | virtual hal::HWLayerId getId() const = 0; |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 353 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 354 | [[clang::warn_unused_result]] virtual hal::Error setCursorPosition(int32_t x, int32_t y) = 0; |
| 355 | [[clang::warn_unused_result]] virtual hal::Error setBuffer( |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 356 | uint32_t slot, const android::sp<android::GraphicBuffer>& buffer, |
| 357 | const android::sp<android::Fence>& acquireFence) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 358 | [[clang::warn_unused_result]] virtual hal::Error setSurfaceDamage( |
| 359 | const android::Region& damage) = 0; |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 360 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 361 | [[clang::warn_unused_result]] virtual hal::Error setBlendMode(hal::BlendMode mode) = 0; |
| 362 | [[clang::warn_unused_result]] virtual hal::Error setColor(hal::Color color) = 0; |
| 363 | [[clang::warn_unused_result]] virtual hal::Error setCompositionType(hal::Composition type) = 0; |
| 364 | [[clang::warn_unused_result]] virtual hal::Error setDataspace(hal::Dataspace dataspace) = 0; |
| 365 | [[clang::warn_unused_result]] virtual hal::Error setPerFrameMetadata( |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 366 | const int32_t supportedPerFrameMetadata, const android::HdrMetadata& metadata) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 367 | [[clang::warn_unused_result]] virtual hal::Error setDisplayFrame( |
| 368 | const android::Rect& frame) = 0; |
| 369 | [[clang::warn_unused_result]] virtual hal::Error setPlaneAlpha(float alpha) = 0; |
| 370 | [[clang::warn_unused_result]] virtual hal::Error setSidebandStream( |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 371 | const native_handle_t* stream) = 0; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 372 | [[clang::warn_unused_result]] virtual hal::Error setSourceCrop( |
| 373 | const android::FloatRect& crop) = 0; |
| 374 | [[clang::warn_unused_result]] virtual hal::Error setTransform(hal::Transform transform) = 0; |
| 375 | [[clang::warn_unused_result]] virtual hal::Error setVisibleRegion( |
| 376 | const android::Region& region) = 0; |
| 377 | [[clang::warn_unused_result]] virtual hal::Error setZOrder(uint32_t z) = 0; |
| 378 | [[clang::warn_unused_result]] virtual hal::Error setInfo(uint32_t type, uint32_t appId) = 0; |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 379 | |
| 380 | // Composer HAL 2.3 |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 381 | [[clang::warn_unused_result]] virtual hal::Error setColorTransform( |
| 382 | const android::mat4& matrix) = 0; |
Lloyd Pique | 4603f3c | 2020-02-11 12:06:56 -0800 | [diff] [blame] | 383 | |
| 384 | // Composer HAL 2.4 |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 385 | [[clang::warn_unused_result]] virtual hal::Error setLayerGenericMetadata( |
Lloyd Pique | 4603f3c | 2020-02-11 12:06:56 -0800 | [diff] [blame] | 386 | const std::string& name, bool mandatory, const std::vector<uint8_t>& value) = 0; |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 387 | }; |
| 388 | |
| 389 | namespace impl { |
| 390 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 391 | // Convenience C++ class to access per layer functions directly. |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 392 | |
| 393 | class Layer : public HWC2::Layer { |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 394 | public: |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 395 | Layer(android::Hwc2::Composer& composer, |
| 396 | const std::unordered_set<hal::Capability>& capabilities, hal::HWDisplayId displayId, |
| 397 | hal::HWLayerId layerId); |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 398 | ~Layer() override; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 399 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 400 | hal::HWLayerId getId() const override { return mId; } |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 401 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 402 | hal::Error setCursorPosition(int32_t x, int32_t y) override; |
| 403 | hal::Error setBuffer(uint32_t slot, const android::sp<android::GraphicBuffer>& buffer, |
| 404 | const android::sp<android::Fence>& acquireFence) override; |
| 405 | hal::Error setSurfaceDamage(const android::Region& damage) override; |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 406 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 407 | hal::Error setBlendMode(hal::BlendMode mode) override; |
| 408 | hal::Error setColor(hal::Color color) override; |
| 409 | hal::Error setCompositionType(hal::Composition type) override; |
| 410 | hal::Error setDataspace(hal::Dataspace dataspace) override; |
| 411 | hal::Error setPerFrameMetadata(const int32_t supportedPerFrameMetadata, |
| 412 | const android::HdrMetadata& metadata) override; |
| 413 | hal::Error setDisplayFrame(const android::Rect& frame) override; |
| 414 | hal::Error setPlaneAlpha(float alpha) override; |
| 415 | hal::Error setSidebandStream(const native_handle_t* stream) override; |
| 416 | hal::Error setSourceCrop(const android::FloatRect& crop) override; |
| 417 | hal::Error setTransform(hal::Transform transform) override; |
| 418 | hal::Error setVisibleRegion(const android::Region& region) override; |
| 419 | hal::Error setZOrder(uint32_t z) override; |
| 420 | hal::Error setInfo(uint32_t type, uint32_t appId) override; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 421 | |
Peiyong Lin | 698147a | 2018-09-14 13:27:18 -0700 | [diff] [blame] | 422 | // Composer HAL 2.3 |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 423 | hal::Error setColorTransform(const android::mat4& matrix) override; |
Peiyong Lin | 698147a | 2018-09-14 13:27:18 -0700 | [diff] [blame] | 424 | |
Lloyd Pique | 4603f3c | 2020-02-11 12:06:56 -0800 | [diff] [blame] | 425 | // Composer HAL 2.4 |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 426 | hal::Error setLayerGenericMetadata(const std::string& name, bool mandatory, |
| 427 | const std::vector<uint8_t>& value) override; |
Lloyd Pique | 4603f3c | 2020-02-11 12:06:56 -0800 | [diff] [blame] | 428 | |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 429 | private: |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 430 | // These are references to data owned by HWC2::Device, which will outlive |
| 431 | // this HWC2::Layer, so these references are guaranteed to be valid for |
| 432 | // the lifetime of this object. |
| 433 | android::Hwc2::Composer& mComposer; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 434 | const std::unordered_set<hal::Capability>& mCapabilities; |
Steven Thomas | 94e35b9 | 2017-07-26 18:48:28 -0700 | [diff] [blame] | 435 | |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 436 | hal::HWDisplayId mDisplayId; |
| 437 | hal::HWLayerId mId; |
Yichi Chen | 8366f56 | 2019-03-25 19:44:06 +0800 | [diff] [blame] | 438 | |
| 439 | // Cached HWC2 data, to ensure the same commands aren't sent to the HWC |
| 440 | // multiple times. |
| 441 | android::Region mVisibleRegion = android::Region::INVALID_REGION; |
| 442 | android::Region mDamageRegion = android::Region::INVALID_REGION; |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 443 | hal::Dataspace mDataSpace = hal::Dataspace::UNKNOWN; |
Courtney Goeltzenleuchter | f9c98e5 | 2018-02-12 07:23:17 -0700 | [diff] [blame] | 444 | android::HdrMetadata mHdrMetadata; |
Peiyong Lin | 698147a | 2018-09-14 13:27:18 -0700 | [diff] [blame] | 445 | android::mat4 mColorMatrix; |
Yichi Chen | 8366f56 | 2019-03-25 19:44:06 +0800 | [diff] [blame] | 446 | uint32_t mBufferSlot; |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 447 | }; |
| 448 | |
Lloyd Pique | 35d5824 | 2018-12-18 16:33:25 -0800 | [diff] [blame] | 449 | } // namespace impl |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 450 | } // namespace HWC2 |
Peiyong Lin | e9d809e | 2020-04-14 13:10:48 -0700 | [diff] [blame] | 451 | } // namespace android |
Dan Stoza | 651bf31 | 2015-10-23 17:03:17 -0700 | [diff] [blame] | 452 | |
| 453 | #endif // ANDROID_SF_HWC2_H |