You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
366 lines
18 KiB
366 lines
18 KiB
/*
|
|
* Copyright 2015 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 <android-base/expected.h>
|
|
#include <gui/HdrMetadata.h>
|
|
#include <math/mat4.h>
|
|
#include <ui/HdrCapabilities.h>
|
|
#include <ui/Region.h>
|
|
#include <ui/StaticDisplayInfo.h>
|
|
#include <utils/Log.h>
|
|
#include <utils/StrongPointer.h>
|
|
#include <utils/Timers.h>
|
|
|
|
#include <functional>
|
|
#include <future>
|
|
#include <string>
|
|
#include <unordered_map>
|
|
#include <unordered_set>
|
|
#include <vector>
|
|
|
|
#include "Hal.h"
|
|
|
|
namespace android {
|
|
|
|
class Fence;
|
|
class FloatRect;
|
|
class GraphicBuffer;
|
|
class TestableSurfaceFlinger;
|
|
struct DisplayedFrameStats;
|
|
|
|
namespace Hwc2 {
|
|
class Composer;
|
|
} // namespace Hwc2
|
|
|
|
namespace HWC2 {
|
|
|
|
class Layer;
|
|
|
|
namespace hal = android::hardware::graphics::composer::hal;
|
|
|
|
// Implement this interface to receive hardware composer events.
|
|
//
|
|
// These callback functions will generally be called on a hwbinder thread, but
|
|
// when first registering the callback the onComposerHalHotplug() function will
|
|
// immediately be called on the thread calling registerCallback().
|
|
struct ComposerCallback {
|
|
virtual void onComposerHalHotplug(hal::HWDisplayId, hal::Connection) = 0;
|
|
virtual void onComposerHalRefresh(hal::HWDisplayId) = 0;
|
|
virtual void onComposerHalVsync(hal::HWDisplayId, int64_t timestamp,
|
|
std::optional<hal::VsyncPeriodNanos>) = 0;
|
|
virtual void onComposerHalVsyncPeriodTimingChanged(hal::HWDisplayId,
|
|
const hal::VsyncPeriodChangeTimeline&) = 0;
|
|
virtual void onComposerHalSeamlessPossible(hal::HWDisplayId) = 0;
|
|
|
|
protected:
|
|
~ComposerCallback() = default;
|
|
};
|
|
|
|
// Convenience C++ class to access per display functions directly.
|
|
class Display {
|
|
public:
|
|
virtual ~Display();
|
|
|
|
virtual hal::HWDisplayId getId() const = 0;
|
|
virtual bool isConnected() const = 0;
|
|
virtual void setConnected(bool connected) = 0; // For use by Device only
|
|
virtual const std::unordered_set<hal::DisplayCapability>& getCapabilities() const = 0;
|
|
virtual bool isVsyncPeriodSwitchSupported() const = 0;
|
|
virtual void onLayerDestroyed(hal::HWLayerId layerId) = 0;
|
|
|
|
[[clang::warn_unused_result]] virtual hal::Error acceptChanges() = 0;
|
|
[[clang::warn_unused_result]] virtual base::expected<std::shared_ptr<HWC2::Layer>, hal::Error>
|
|
createLayer() = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error getChangedCompositionTypes(
|
|
std::unordered_map<Layer*, hal::Composition>* outTypes) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error getColorModes(
|
|
std::vector<hal::ColorMode>* outModes) const = 0;
|
|
// Returns a bitmask which contains HdrMetadata::Type::*.
|
|
[[clang::warn_unused_result]] virtual int32_t getSupportedPerFrameMetadata() const = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error getRenderIntents(
|
|
hal::ColorMode colorMode, std::vector<hal::RenderIntent>* outRenderIntents) const = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error getDataspaceSaturationMatrix(
|
|
hal::Dataspace dataspace, android::mat4* outMatrix) = 0;
|
|
|
|
[[clang::warn_unused_result]] virtual hal::Error getName(std::string* outName) const = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error getRequests(
|
|
hal::DisplayRequest* outDisplayRequests,
|
|
std::unordered_map<Layer*, hal::LayerRequest>* outLayerRequests) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error getConnectionType(
|
|
ui::DisplayConnectionType*) const = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error supportsDoze(bool* outSupport) const = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error getHdrCapabilities(
|
|
android::HdrCapabilities* outCapabilities) const = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error getDisplayedContentSamplingAttributes(
|
|
hal::PixelFormat* outFormat, hal::Dataspace* outDataspace,
|
|
uint8_t* outComponentMask) const = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setDisplayContentSamplingEnabled(
|
|
bool enabled, uint8_t componentMask, uint64_t maxFrames) const = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error getDisplayedContentSample(
|
|
uint64_t maxFrames, uint64_t timestamp,
|
|
android::DisplayedFrameStats* outStats) const = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error getReleaseFences(
|
|
std::unordered_map<Layer*, android::sp<android::Fence>>* outFences) const = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error present(
|
|
android::sp<android::Fence>* outPresentFence) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setClientTarget(
|
|
uint32_t slot, const android::sp<android::GraphicBuffer>& target,
|
|
const android::sp<android::Fence>& acquireFence, hal::Dataspace dataspace) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setColorMode(
|
|
hal::ColorMode mode, hal::RenderIntent renderIntent) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setColorTransform(
|
|
const android::mat4& matrix, hal::ColorTransform hint) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setOutputBuffer(
|
|
const android::sp<android::GraphicBuffer>& buffer,
|
|
const android::sp<android::Fence>& releaseFence) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setPowerMode(hal::PowerMode mode) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setVsyncEnabled(hal::Vsync enabled) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error validate(uint32_t* outNumTypes,
|
|
uint32_t* outNumRequests) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error presentOrValidate(
|
|
uint32_t* outNumTypes, uint32_t* outNumRequests,
|
|
android::sp<android::Fence>* outPresentFence, uint32_t* state) = 0;
|
|
[[clang::warn_unused_result]] virtual std::future<hal::Error> setDisplayBrightness(
|
|
float brightness) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setActiveConfigWithConstraints(
|
|
hal::HWConfigId configId, const hal::VsyncPeriodChangeConstraints& constraints,
|
|
hal::VsyncPeriodChangeTimeline* outTimeline) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setAutoLowLatencyMode(bool on) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error getSupportedContentTypes(
|
|
std::vector<hal::ContentType>*) const = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setContentType(hal::ContentType) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error getClientTargetProperty(
|
|
hal::ClientTargetProperty* outClientTargetProperty) = 0;
|
|
};
|
|
|
|
namespace impl {
|
|
|
|
class Layer;
|
|
|
|
class Display : public HWC2::Display {
|
|
public:
|
|
Display(android::Hwc2::Composer&, const std::unordered_set<hal::Capability>&, hal::HWDisplayId,
|
|
hal::DisplayType);
|
|
~Display() override;
|
|
|
|
// Required by HWC2
|
|
hal::Error acceptChanges() override;
|
|
base::expected<std::shared_ptr<HWC2::Layer>, hal::Error> createLayer() override;
|
|
hal::Error getChangedCompositionTypes(
|
|
std::unordered_map<HWC2::Layer*, hal::Composition>* outTypes) override;
|
|
hal::Error getColorModes(std::vector<hal::ColorMode>* outModes) const override;
|
|
// Returns a bitmask which contains HdrMetadata::Type::*.
|
|
int32_t getSupportedPerFrameMetadata() const override;
|
|
hal::Error getRenderIntents(hal::ColorMode colorMode,
|
|
std::vector<hal::RenderIntent>* outRenderIntents) const override;
|
|
hal::Error getDataspaceSaturationMatrix(hal::Dataspace, android::mat4* outMatrix) override;
|
|
|
|
hal::Error getName(std::string* outName) const override;
|
|
hal::Error getRequests(
|
|
hal::DisplayRequest* outDisplayRequests,
|
|
std::unordered_map<HWC2::Layer*, hal::LayerRequest>* outLayerRequests) override;
|
|
hal::Error getConnectionType(ui::DisplayConnectionType*) const override;
|
|
hal::Error supportsDoze(bool* outSupport) const override;
|
|
hal::Error getHdrCapabilities(android::HdrCapabilities* outCapabilities) const override;
|
|
hal::Error getDisplayedContentSamplingAttributes(hal::PixelFormat* outFormat,
|
|
hal::Dataspace* outDataspace,
|
|
uint8_t* outComponentMask) const override;
|
|
hal::Error setDisplayContentSamplingEnabled(bool enabled, uint8_t componentMask,
|
|
uint64_t maxFrames) const override;
|
|
hal::Error getDisplayedContentSample(uint64_t maxFrames, uint64_t timestamp,
|
|
android::DisplayedFrameStats* outStats) const override;
|
|
hal::Error getReleaseFences(std::unordered_map<HWC2::Layer*, android::sp<android::Fence>>*
|
|
outFences) const override;
|
|
hal::Error present(android::sp<android::Fence>* outPresentFence) override;
|
|
hal::Error setClientTarget(uint32_t slot, const android::sp<android::GraphicBuffer>& target,
|
|
const android::sp<android::Fence>& acquireFence,
|
|
hal::Dataspace dataspace) override;
|
|
hal::Error setColorMode(hal::ColorMode, hal::RenderIntent) override;
|
|
hal::Error setColorTransform(const android::mat4& matrix, hal::ColorTransform hint) override;
|
|
hal::Error setOutputBuffer(const android::sp<android::GraphicBuffer>&,
|
|
const android::sp<android::Fence>& releaseFence) override;
|
|
hal::Error setPowerMode(hal::PowerMode) override;
|
|
hal::Error setVsyncEnabled(hal::Vsync enabled) override;
|
|
hal::Error validate(uint32_t* outNumTypes, uint32_t* outNumRequests) override;
|
|
hal::Error presentOrValidate(uint32_t* outNumTypes, uint32_t* outNumRequests,
|
|
android::sp<android::Fence>* outPresentFence,
|
|
uint32_t* state) override;
|
|
std::future<hal::Error> setDisplayBrightness(float brightness) override;
|
|
hal::Error setActiveConfigWithConstraints(hal::HWConfigId configId,
|
|
const hal::VsyncPeriodChangeConstraints& constraints,
|
|
hal::VsyncPeriodChangeTimeline* outTimeline) override;
|
|
hal::Error setAutoLowLatencyMode(bool on) override;
|
|
hal::Error getSupportedContentTypes(
|
|
std::vector<hal::ContentType>* outSupportedContentTypes) const override;
|
|
hal::Error setContentType(hal::ContentType) override;
|
|
hal::Error getClientTargetProperty(hal::ClientTargetProperty* outClientTargetProperty) override;
|
|
|
|
// Other Display methods
|
|
hal::HWDisplayId getId() const override { return mId; }
|
|
bool isConnected() const override { return mIsConnected; }
|
|
void setConnected(bool connected) override; // For use by Device only
|
|
const std::unordered_set<hal::DisplayCapability>& getCapabilities() const override {
|
|
return mDisplayCapabilities;
|
|
};
|
|
bool isVsyncPeriodSwitchSupported() const override;
|
|
void onLayerDestroyed(hal::HWLayerId layerId) override;
|
|
|
|
private:
|
|
|
|
// This may fail (and return a null pointer) if no layer with this ID exists
|
|
// on this display
|
|
std::shared_ptr<HWC2::Layer> getLayerById(hal::HWLayerId id) const;
|
|
|
|
friend android::TestableSurfaceFlinger;
|
|
|
|
// Member variables
|
|
|
|
// These are references to data owned by HWC2::Device, which will outlive
|
|
// this HWC2::Display, so these references are guaranteed to be valid for
|
|
// the lifetime of this object.
|
|
android::Hwc2::Composer& mComposer;
|
|
const std::unordered_set<hal::Capability>& mCapabilities;
|
|
|
|
const hal::HWDisplayId mId;
|
|
hal::DisplayType mType;
|
|
bool mIsConnected = false;
|
|
|
|
using Layers = std::unordered_map<hal::HWLayerId, std::weak_ptr<HWC2::impl::Layer>>;
|
|
Layers mLayers;
|
|
|
|
std::once_flag mDisplayCapabilityQueryFlag;
|
|
std::unordered_set<hal::DisplayCapability> mDisplayCapabilities;
|
|
};
|
|
|
|
} // namespace impl
|
|
|
|
class Layer {
|
|
public:
|
|
virtual ~Layer();
|
|
|
|
virtual hal::HWLayerId getId() const = 0;
|
|
|
|
// HUANGLONG begin
|
|
// For dual-screen display, sidebandstream for hwcLayer when external displays have same content.
|
|
virtual HWC2::Display* getDisplay() const;
|
|
// HUANGLONG end
|
|
|
|
[[clang::warn_unused_result]] virtual hal::Error setCursorPosition(int32_t x, int32_t y) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setBuffer(
|
|
uint32_t slot, const android::sp<android::GraphicBuffer>& buffer,
|
|
const android::sp<android::Fence>& acquireFence) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setSurfaceDamage(
|
|
const android::Region& damage) = 0;
|
|
|
|
[[clang::warn_unused_result]] virtual hal::Error setBlendMode(hal::BlendMode mode) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setColor(hal::Color color) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setCompositionType(hal::Composition type) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setDataspace(hal::Dataspace dataspace) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setPerFrameMetadata(
|
|
const int32_t supportedPerFrameMetadata, const android::HdrMetadata& metadata) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setDisplayFrame(
|
|
const android::Rect& frame) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setPlaneAlpha(float alpha) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setSidebandStream(
|
|
const native_handle_t* stream) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setSourceCrop(
|
|
const android::FloatRect& crop) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setTransform(hal::Transform transform) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setVisibleRegion(
|
|
const android::Region& region) = 0;
|
|
[[clang::warn_unused_result]] virtual hal::Error setZOrder(uint32_t z) = 0;
|
|
|
|
// Composer HAL 2.3
|
|
[[clang::warn_unused_result]] virtual hal::Error setColorTransform(
|
|
const android::mat4& matrix) = 0;
|
|
|
|
// Composer HAL 2.4
|
|
[[clang::warn_unused_result]] virtual hal::Error setLayerGenericMetadata(
|
|
const std::string& name, bool mandatory, const std::vector<uint8_t>& value) = 0;
|
|
};
|
|
|
|
namespace impl {
|
|
|
|
// Convenience C++ class to access per layer functions directly.
|
|
|
|
class Layer : public HWC2::Layer {
|
|
public:
|
|
Layer(android::Hwc2::Composer& composer,
|
|
const std::unordered_set<hal::Capability>& capabilities, HWC2::Display& display,
|
|
hal::HWLayerId layerId);
|
|
~Layer() override;
|
|
|
|
void onOwningDisplayDestroyed();
|
|
|
|
// HUANGLONG begin
|
|
// For dual-screen display, sidebandstream for hwcLayer when external displays have same content.
|
|
HWC2::Display* getDisplay() const override { return mDisplay; }
|
|
// HUANGLONG end
|
|
|
|
hal::HWLayerId getId() const override { return mId; }
|
|
|
|
hal::Error setCursorPosition(int32_t x, int32_t y) override;
|
|
hal::Error setBuffer(uint32_t slot, const android::sp<android::GraphicBuffer>& buffer,
|
|
const android::sp<android::Fence>& acquireFence) override;
|
|
hal::Error setSurfaceDamage(const android::Region& damage) override;
|
|
|
|
hal::Error setBlendMode(hal::BlendMode mode) override;
|
|
hal::Error setColor(hal::Color color) override;
|
|
hal::Error setCompositionType(hal::Composition type) override;
|
|
hal::Error setDataspace(hal::Dataspace dataspace) override;
|
|
hal::Error setPerFrameMetadata(const int32_t supportedPerFrameMetadata,
|
|
const android::HdrMetadata& metadata) override;
|
|
hal::Error setDisplayFrame(const android::Rect& frame) override;
|
|
hal::Error setPlaneAlpha(float alpha) override;
|
|
hal::Error setSidebandStream(const native_handle_t* stream) override;
|
|
hal::Error setSourceCrop(const android::FloatRect& crop) override;
|
|
hal::Error setTransform(hal::Transform transform) override;
|
|
hal::Error setVisibleRegion(const android::Region& region) override;
|
|
hal::Error setZOrder(uint32_t z) override;
|
|
|
|
// Composer HAL 2.3
|
|
hal::Error setColorTransform(const android::mat4& matrix) override;
|
|
|
|
// Composer HAL 2.4
|
|
hal::Error setLayerGenericMetadata(const std::string& name, bool mandatory,
|
|
const std::vector<uint8_t>& value) override;
|
|
|
|
private:
|
|
// These are references to data owned by HWC2::Device, which will outlive
|
|
// this HWC2::Layer, so these references are guaranteed to be valid for
|
|
// the lifetime of this object.
|
|
android::Hwc2::Composer& mComposer;
|
|
const std::unordered_set<hal::Capability>& mCapabilities;
|
|
|
|
HWC2::Display* mDisplay;
|
|
hal::HWLayerId mId;
|
|
|
|
// Cached HWC2 data, to ensure the same commands aren't sent to the HWC
|
|
// multiple times.
|
|
android::Region mVisibleRegion = android::Region::INVALID_REGION;
|
|
android::Region mDamageRegion = android::Region::INVALID_REGION;
|
|
hal::Dataspace mDataSpace = hal::Dataspace::UNKNOWN;
|
|
android::HdrMetadata mHdrMetadata;
|
|
android::mat4 mColorMatrix;
|
|
uint32_t mBufferSlot;
|
|
};
|
|
|
|
} // namespace impl
|
|
} // namespace HWC2
|
|
} // namespace android
|