| /* |
| * Copyright 2016 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| #pragma once |
| |
| #include <memory> |
| |
| // TODO(b/129481165): remove the #pragma below and fix conversion issues |
| #pragma clang diagnostic push |
| #pragma clang diagnostic ignored "-Wconversion" |
| #pragma clang diagnostic ignored "-Wextra" |
| |
| #include <composer-command-buffer/2.4/ComposerCommandBuffer.h> |
| #include <gui/BufferQueue.h> |
| #include <gui/HdrMetadata.h> |
| #include <math/mat4.h> |
| #include <ui/DisplayedFrameStats.h> |
| #include <ui/GraphicBuffer.h> |
| #include <utils/StrongPointer.h> |
| |
| #include <aidl/android/hardware/graphics/common/DisplayDecorationSupport.h> |
| #include <aidl/android/hardware/graphics/common/HdrConversionCapability.h> |
| #include <aidl/android/hardware/graphics/common/HdrConversionStrategy.h> |
| #include <aidl/android/hardware/graphics/composer3/Capability.h> |
| #include <aidl/android/hardware/graphics/composer3/ClientTargetPropertyWithBrightness.h> |
| #include <aidl/android/hardware/graphics/composer3/Color.h> |
| #include <aidl/android/hardware/graphics/composer3/Composition.h> |
| #include <aidl/android/hardware/graphics/composer3/DisplayCapability.h> |
| #include <aidl/android/hardware/graphics/composer3/DisplayConfiguration.h> |
| #include <aidl/android/hardware/graphics/composer3/IComposerCallback.h> |
| #include <aidl/android/hardware/graphics/composer3/OverlayProperties.h> |
| |
| #include <aidl/android/hardware/graphics/common/Transform.h> |
| #include <optional> |
| |
| // TODO(b/129481165): remove the #pragma below and fix conversion issues |
| #pragma clang diagnostic pop // ignored "-Wconversion -Wextra" |
| |
| namespace android { |
| namespace HWC2 { |
| struct ComposerCallback; |
| } // namespace HWC2 |
| |
| namespace Hwc2 { |
| |
| namespace types = hardware::graphics::common; |
| |
| namespace V2_1 = hardware::graphics::composer::V2_1; |
| namespace V2_2 = hardware::graphics::composer::V2_2; |
| namespace V2_3 = hardware::graphics::composer::V2_3; |
| namespace V2_4 = hardware::graphics::composer::V2_4; |
| namespace V3_0 = ::aidl::android::hardware::graphics::composer3; |
| |
| using types::V1_0::ColorTransform; |
| using types::V1_0::Transform; |
| using types::V1_1::RenderIntent; |
| using types::V1_2::ColorMode; |
| using types::V1_2::Dataspace; |
| using types::V1_2::PixelFormat; |
| |
| using V2_1::Config; |
| using V2_1::Display; |
| using V2_1::Error; |
| using V2_1::Layer; |
| using V2_4::CommandReaderBase; |
| using V2_4::CommandWriterBase; |
| using V2_4::IComposer; |
| using V2_4::IComposerCallback; |
| using V2_4::IComposerClient; |
| using V2_4::VsyncPeriodChangeTimeline; |
| using V2_4::VsyncPeriodNanos; |
| using PerFrameMetadata = IComposerClient::PerFrameMetadata; |
| using PerFrameMetadataKey = IComposerClient::PerFrameMetadataKey; |
| using PerFrameMetadataBlob = IComposerClient::PerFrameMetadataBlob; |
| using AidlTransform = ::aidl::android::hardware::graphics::common::Transform; |
| using DisplayConfiguration = V3_0::DisplayConfiguration; |
| using aidl::android::hardware::graphics::common::Hdr; |
| |
| class Composer { |
| public: |
| static std::unique_ptr<Composer> create(const std::string& serviceName); |
| |
| virtual ~Composer() = 0; |
| |
| enum class OptionalFeature { |
| RefreshRateSwitching, |
| ExpectedPresentTime, |
| // Whether setDisplayBrightness is able to be applied as part of a display command. |
| DisplayBrightnessCommand, |
| KernelIdleTimer, |
| PhysicalDisplayOrientation, |
| }; |
| |
| virtual bool isSupported(OptionalFeature) const = 0; |
| virtual bool isVrrSupported() const = 0; |
| |
| virtual std::vector<aidl::android::hardware::graphics::composer3::Capability> |
| getCapabilities() = 0; |
| virtual std::string dumpDebugInfo() = 0; |
| |
| virtual void registerCallback(HWC2::ComposerCallback& callback) = 0; |
| |
| // Explicitly flush all pending commands in the command buffer. |
| virtual Error executeCommands(Display) = 0; |
| |
| virtual uint32_t getMaxVirtualDisplayCount() = 0; |
| virtual Error createVirtualDisplay(uint32_t width, uint32_t height, PixelFormat*, |
| Display* outDisplay) = 0; |
| virtual Error destroyVirtualDisplay(Display display) = 0; |
| |
| virtual Error acceptDisplayChanges(Display display) = 0; |
| |
| virtual Error createLayer(Display display, Layer* outLayer) = 0; |
| virtual Error destroyLayer(Display display, Layer layer) = 0; |
| |
| virtual Error getActiveConfig(Display display, Config* outConfig) = 0; |
| virtual Error getChangedCompositionTypes(Display display, std::vector<Layer>* outLayers, |
| std::vector<V3_0::Composition>* outTypes) = 0; |
| virtual Error getColorModes(Display display, std::vector<ColorMode>* outModes) = 0; |
| virtual Error getDisplayAttribute(Display display, Config config, |
| IComposerClient::Attribute attribute, int32_t* outValue) = 0; |
| virtual Error getDisplayConfigs(Display display, std::vector<Config>* outConfigs) = 0; |
| |
| virtual Error getDisplayConfigurations(Display, int32_t maxFrameIntervalNs, |
| std::vector<DisplayConfiguration>*) = 0; |
| |
| virtual Error getDisplayName(Display display, std::string* outName) = 0; |
| |
| virtual Error getDisplayRequests(Display display, uint32_t* outDisplayRequestMask, |
| std::vector<Layer>* outLayers, |
| std::vector<uint32_t>* outLayerRequestMasks) = 0; |
| |
| virtual Error getDozeSupport(Display display, bool* outSupport) = 0; |
| virtual Error hasDisplayIdleTimerCapability(Display display, bool* outSupport) = 0; |
| virtual Error getHdrCapabilities(Display display, std::vector<Hdr>* outHdrTypes, |
| float* outMaxLuminance, float* outMaxAverageLuminance, |
| float* outMinLuminance) = 0; |
| |
| virtual Error getReleaseFences(Display display, std::vector<Layer>* outLayers, |
| std::vector<int>* outReleaseFences) = 0; |
| |
| virtual Error presentDisplay(Display display, int* outPresentFence) = 0; |
| |
| virtual Error setActiveConfig(Display display, Config config) = 0; |
| |
| /* |
| * The composer caches client targets internally. When target is nullptr, |
| * the composer uses slot to look up the client target from its cache. |
| * When target is not nullptr, the cache is updated with the new target. |
| */ |
| virtual Error setClientTarget(Display display, uint32_t slot, const sp<GraphicBuffer>& target, |
| int acquireFence, Dataspace dataspace, |
| const std::vector<IComposerClient::Rect>& damage, |
| float hdrSdrRatio) = 0; |
| virtual Error setColorMode(Display display, ColorMode mode, RenderIntent renderIntent) = 0; |
| virtual Error setColorTransform(Display display, const float* matrix) = 0; |
| virtual Error setOutputBuffer(Display display, const native_handle_t* buffer, |
| int releaseFence) = 0; |
| virtual Error setPowerMode(Display display, IComposerClient::PowerMode mode) = 0; |
| virtual Error setVsyncEnabled(Display display, IComposerClient::Vsync enabled) = 0; |
| |
| virtual Error setClientTargetSlotCount(Display display) = 0; |
| |
| virtual Error validateDisplay(Display display, nsecs_t expectedPresentTime, |
| int32_t frameIntervalNs, uint32_t* outNumTypes, |
| uint32_t* outNumRequests) = 0; |
| |
| virtual Error presentOrValidateDisplay(Display display, nsecs_t expectedPresentTime, |
| int32_t frameIntervalNs, uint32_t* outNumTypes, |
| uint32_t* outNumRequests, int* outPresentFence, |
| uint32_t* state) = 0; |
| |
| virtual Error setCursorPosition(Display display, Layer layer, int32_t x, int32_t y) = 0; |
| /* see setClientTarget for the purpose of slot */ |
| virtual Error setLayerBuffer(Display display, Layer layer, uint32_t slot, |
| const sp<GraphicBuffer>& buffer, int acquireFence) = 0; |
| virtual Error setLayerBufferSlotsToClear(Display display, Layer layer, |
| const std::vector<uint32_t>& slotsToClear, |
| uint32_t activeBufferSlot) = 0; |
| virtual Error setLayerSurfaceDamage(Display display, Layer layer, |
| const std::vector<IComposerClient::Rect>& damage) = 0; |
| virtual Error setLayerBlendMode(Display display, Layer layer, |
| IComposerClient::BlendMode mode) = 0; |
| virtual Error setLayerColor( |
| Display display, Layer layer, |
| const aidl::android::hardware::graphics::composer3::Color& color) = 0; |
| virtual Error setLayerCompositionType( |
| Display display, Layer layer, |
| aidl::android::hardware::graphics::composer3::Composition type) = 0; |
| virtual Error setLayerDataspace(Display display, Layer layer, Dataspace dataspace) = 0; |
| virtual Error setLayerDisplayFrame(Display display, Layer layer, |
| const IComposerClient::Rect& frame) = 0; |
| virtual Error setLayerPlaneAlpha(Display display, Layer layer, float alpha) = 0; |
| virtual Error setLayerSidebandStream(Display display, Layer layer, |
| const native_handle_t* stream) = 0; |
| virtual Error setLayerSourceCrop(Display display, Layer layer, |
| const IComposerClient::FRect& crop) = 0; |
| virtual Error setLayerTransform(Display display, Layer layer, Transform transform) = 0; |
| virtual Error setLayerVisibleRegion(Display display, Layer layer, |
| const std::vector<IComposerClient::Rect>& visible) = 0; |
| virtual Error setLayerZOrder(Display display, Layer layer, uint32_t z) = 0; |
| |
| // Composer HAL 2.2 |
| virtual Error setLayerPerFrameMetadata( |
| Display display, Layer layer, |
| const std::vector<IComposerClient::PerFrameMetadata>& perFrameMetadatas) = 0; |
| virtual std::vector<IComposerClient::PerFrameMetadataKey> getPerFrameMetadataKeys( |
| Display display) = 0; |
| virtual Error getRenderIntents(Display display, ColorMode colorMode, |
| std::vector<RenderIntent>* outRenderIntents) = 0; |
| virtual Error getDataspaceSaturationMatrix(Dataspace dataspace, mat4* outMatrix) = 0; |
| |
| // Composer HAL 2.3 |
| virtual Error getDisplayIdentificationData(Display display, uint8_t* outPort, |
| std::vector<uint8_t>* outData) = 0; |
| virtual Error setLayerColorTransform(Display display, Layer layer, |
| const float* matrix) = 0; |
| virtual Error getDisplayedContentSamplingAttributes(Display display, PixelFormat* outFormat, |
| Dataspace* outDataspace, |
| uint8_t* outComponentMask) = 0; |
| virtual Error setDisplayContentSamplingEnabled(Display display, bool enabled, |
| uint8_t componentMask, uint64_t maxFrames) = 0; |
| virtual Error getDisplayedContentSample(Display display, uint64_t maxFrames, uint64_t timestamp, |
| DisplayedFrameStats* outStats) = 0; |
| virtual Error setLayerPerFrameMetadataBlobs( |
| Display display, Layer layer, const std::vector<PerFrameMetadataBlob>& metadata) = 0; |
| // Options for setting the display brightness |
| struct DisplayBrightnessOptions { |
| // If true, then immediately submits a brightness change request to composer. Otherwise, |
| // submission of the brightness change may be deferred until presenting the next frame. |
| // applyImmediately should only be false if OptionalFeature::DisplayBrightnessCommand is |
| // supported. |
| bool applyImmediately = true; |
| |
| bool operator==(const DisplayBrightnessOptions& other) const { |
| return applyImmediately == other.applyImmediately; |
| } |
| }; |
| virtual Error setDisplayBrightness(Display display, float brightness, float brightnessNits, |
| const DisplayBrightnessOptions& options) = 0; |
| |
| // Composer HAL 2.4 |
| virtual Error getDisplayCapabilities(Display display, |
| std::vector<V3_0::DisplayCapability>* outCapabilities) = 0; |
| virtual V2_4::Error getDisplayConnectionType( |
| Display display, IComposerClient::DisplayConnectionType* outType) = 0; |
| virtual V2_4::Error getDisplayVsyncPeriod(Display display, |
| VsyncPeriodNanos* outVsyncPeriod) = 0; |
| virtual V2_4::Error setActiveConfigWithConstraints( |
| Display display, Config config, |
| const IComposerClient::VsyncPeriodChangeConstraints& vsyncPeriodChangeConstraints, |
| VsyncPeriodChangeTimeline* outTimeline) = 0; |
| |
| virtual V2_4::Error setAutoLowLatencyMode(Display displayId, bool on) = 0; |
| virtual V2_4::Error getSupportedContentTypes( |
| Display displayId, |
| std::vector<IComposerClient::ContentType>* outSupportedContentTypes) = 0; |
| virtual V2_4::Error setContentType(Display displayId, |
| IComposerClient::ContentType contentType) = 0; |
| virtual V2_4::Error setLayerGenericMetadata(Display display, Layer layer, |
| const std::string& key, bool mandatory, |
| const std::vector<uint8_t>& value) = 0; |
| virtual V2_4::Error getLayerGenericMetadataKeys( |
| std::vector<IComposerClient::LayerGenericMetadataKey>* outKeys) = 0; |
| |
| virtual Error getClientTargetProperty( |
| Display display, V3_0::ClientTargetPropertyWithBrightness* outClientTargetProperty) = 0; |
| |
| // AIDL Composer |
| virtual Error setLayerBrightness(Display display, Layer layer, float brightness) = 0; |
| virtual Error setLayerBlockingRegion(Display display, Layer layer, |
| const std::vector<IComposerClient::Rect>& blocking) = 0; |
| virtual Error setBootDisplayConfig(Display displayId, Config) = 0; |
| virtual Error clearBootDisplayConfig(Display displayId) = 0; |
| virtual Error getPreferredBootDisplayConfig(Display displayId, Config*) = 0; |
| virtual Error getDisplayDecorationSupport( |
| Display display, |
| std::optional<::aidl::android::hardware::graphics::common::DisplayDecorationSupport>* |
| support) = 0; |
| virtual Error setIdleTimerEnabled(Display displayId, std::chrono::milliseconds timeout) = 0; |
| virtual Error getPhysicalDisplayOrientation(Display displayId, |
| AidlTransform* outDisplayOrientation) = 0; |
| virtual Error getOverlaySupport(V3_0::OverlayProperties* outProperties) = 0; |
| virtual void onHotplugConnect(Display) = 0; |
| virtual void onHotplugDisconnect(Display) = 0; |
| virtual Error getHdrConversionCapabilities( |
| std::vector<::aidl::android::hardware::graphics::common::HdrConversionCapability>*) = 0; |
| virtual Error setHdrConversionStrategy( |
| ::aidl::android::hardware::graphics::common::HdrConversionStrategy, Hdr*) = 0; |
| virtual Error setRefreshRateChangedCallbackDebugEnabled(Display, bool) = 0; |
| virtual Error notifyExpectedPresent(Display, nsecs_t expectedPresentTime, |
| int32_t frameIntervalNs) = 0; |
| }; |
| |
| } // namespace Hwc2 |
| } // namespace android |