/* * Copyright (c) 2021 Huawei Device Co., Ltd. * 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. */ #ifndef FRAMEWORKS_SURFACE_INCLUDE_BUFFER_QUEUE_H #define FRAMEWORKS_SURFACE_INCLUDE_BUFFER_QUEUE_H #include #include #include #include #include #include #include "iconsumer_surface.h" #include "surface_type.h" #include #include "surface_buffer.h" #include "consumer_surface_delegator.h" namespace OHOS { enum BufferState { BUFFER_STATE_RELEASED, BUFFER_STATE_REQUESTED, BUFFER_STATE_FLUSHED, BUFFER_STATE_ACQUIRED, BUFFER_STATE_ATTACHED, }; enum InvokerType { PRODUCER_INVOKER, CONSUMER_INVOKER, }; using BufferElement = struct BufferElement { sptr buffer; BufferState state; bool isDeleting; BufferRequestConfig config; sptr fence; int64_t timestamp; std::vector damages; HDRMetaDataType hdrMetaDataType = HDRMetaDataType::HDR_NOT_USED; std::vector metaData; GraphicHDRMetadataKey key; std::vector metaDataSet; GraphicPresentTimestamp presentTimestamp = {GRAPHIC_DISPLAY_PTS_UNSUPPORTED, 0}; /** * The desired time to present the buffer in nanoseconds. * The buffer should wait until desiredPresentTimestamp is reached before being consumed and displayed. * If multiple buffers reach desiredPresentTimestamp, the earlier buffer should be dropped. */ int64_t desiredPresentTimestamp; /** * The desiredPresentTimestamp is automatically generated by the system, isAutoTimestamp is true. * The desiredPresentTimestamp is manually set by the producer, isAutoTimestamp is false. */ bool isAutoTimestamp; }; using BufferAndFence = std::pair, sptr>; class BufferQueue : public RefBase { public: BufferQueue(const std::string &name, bool isShared = false); virtual ~BufferQueue(); GSError GetProducerInitInfo(ProducerInitInfo &info); GSError RequestBuffer(const BufferRequestConfig &config, sptr &bedata, struct IBufferProducer::RequestBufferReturnValue &retval); GSError ReuseBuffer(const BufferRequestConfig &config, sptr &bedata, struct IBufferProducer::RequestBufferReturnValue &retval); GSError CancelBuffer(uint32_t sequence, sptr bedata); GSError FlushBuffer(uint32_t sequence, sptr bedata, sptr fence, const BufferFlushConfigWithDamages &config); GSError DoFlushBuffer(uint32_t sequence, sptr bedata, sptr fence, const BufferFlushConfigWithDamages &config); GSError GetLastFlushedBuffer(sptr& buffer, sptr& fence, float matrix[16], uint32_t matrixSize, bool isUseNewMatrix, bool needRecordSequence = false); GSError AcquireBuffer(sptr& buffer, sptr& fence, int64_t ×tamp, std::vector &damages); GSError AcquireBuffer(IConsumerSurface::AcquireBufferReturnValue &returnValue, int64_t expectPresentTimestamp, bool isUsingAutoTimestamp); GSError ReleaseBuffer(sptr& buffer, const sptr& fence); GSError AttachBuffer(sptr& buffer, int32_t timeOut); GSError DetachBuffer(sptr& buffer); GSError RegisterSurfaceDelegator(sptr client, sptr cSurface); bool QueryIfBufferAvailable(); uint32_t GetQueueSize(); GSError SetQueueSize(uint32_t queueSize); GSError GetName(std::string &name); GSError RegisterConsumerListener(sptr& listener); GSError RegisterConsumerListener(IBufferConsumerListenerClazz *listener); GSError RegisterReleaseListener(OnReleaseFunc func); GSError RegisterProducerReleaseListener(sptr listener); GSError UnRegisterProducerReleaseListener(); GSError RegisterDeleteBufferListener(OnDeleteBufferFunc func, bool isForUniRedraw = false); GSError UnregisterConsumerListener(); GSError SetDefaultWidthAndHeight(int32_t width, int32_t height); int32_t GetDefaultWidth(); int32_t GetDefaultHeight(); GSError SetDefaultUsage(uint64_t usage); uint64_t GetDefaultUsage(); GSError CleanCache(bool cleanAll); GSError GoBackground(); GSError OnConsumerDied(); uint64_t GetUniqueId() const; void Dump(std::string &result); GSError SetTransform(GraphicTransformType transform); GraphicTransformType GetTransform() const; GSError IsSupportedAlloc(const std::vector &infos, std::vector &supporteds) const; GSError SetBufferHold(bool hold); inline bool IsBufferHold() { return isBufferHold_; } GSError SetScalingMode(uint32_t sequence, ScalingMode scalingMode); GSError GetScalingMode(uint32_t sequence, ScalingMode &scalingMode); GSError SetMetaData(uint32_t sequence, const std::vector &metaData); GSError SetMetaDataSet(uint32_t sequence, GraphicHDRMetadataKey key, const std::vector &metaData); GSError QueryMetaDataType(uint32_t sequence, HDRMetaDataType &type); GSError GetMetaData(uint32_t sequence, std::vector &metaData); GSError GetMetaDataSet(uint32_t sequence, GraphicHDRMetadataKey &key, std::vector &metaData); GSError SetTunnelHandle(const sptr &handle); sptr GetTunnelHandle(); GSError SetPresentTimestamp(uint32_t sequence, const GraphicPresentTimestamp ×tamp); GSError GetPresentTimestamp(uint32_t sequence, GraphicPresentTimestampType type, int64_t &time); bool GetStatus() const; void SetStatus(bool status); void SetBatchHandle(bool batch); GSError SetProducerCacheCleanFlag(bool flag); inline void ConsumerRequestCpuAccess(bool on) { isCpuAccessable_ = on; } GSError AttachBufferToQueue(sptr buffer, InvokerType invokerType); GSError DetachBufferFromQueue(sptr buffer, InvokerType invokerType); GSError SetTransformHint(GraphicTransformType transformHint); GraphicTransformType GetTransformHint() const; GSError SetScalingMode(ScalingMode scalingMode); GSError SetSurfaceSourceType(OHSurfaceSource sourceType); OHSurfaceSource GetSurfaceSourceType() const; GSError SetSurfaceAppFrameworkType(std::string appFrameworkType); std::string GetSurfaceAppFrameworkType() const; GSError SetHdrWhitePointBrightness(float brightness); GSError SetSdrWhitePointBrightness(float brightness); float GetHdrWhitePointBrightness() const; float GetSdrWhitePointBrightness() const; GSError IsSurfaceBufferInCache(uint32_t seqNum, bool &isInCache); GSError AcquireLastFlushedBuffer(sptr &buffer, sptr &fence, float matrix[16], uint32_t matrixSize, bool isUseNewMatrix); GSError ReleaseLastFlushedBuffer(uint32_t sequence); uint32_t GetAvailableBufferCount(); GSError RequestAndDetachBuffer(const BufferRequestConfig& config, sptr& bedata, struct IBufferProducer::RequestBufferReturnValue& retval); GSError AttachAndFlushBuffer(sptr& buffer, sptr& bedata, const sptr& fence, BufferFlushConfigWithDamages& config, bool needMap); private: GSError AllocBuffer(sptr& buffer, const BufferRequestConfig &config); void DeleteBufferInCache(uint32_t sequence); uint32_t GetUsedSize(); void DeleteBuffersLocked(int32_t count); GSError PopFromFreeList(sptr& buffer, const BufferRequestConfig &config); GSError PopFromDirtyList(sptr& buffer); GSError CheckRequestConfig(const BufferRequestConfig &config); GSError CheckFlushConfig(const BufferFlushConfigWithDamages &config); void DumpCache(std::string &result); void DumpMetadata(std::string &result, BufferElement element); void ClearLocked(); bool CheckProducerCacheList(); GSError SetProducerCacheCleanFlagLocked(bool flag); GSError AttachBufferUpdateStatus(std::unique_lock &lock, uint32_t sequence, int32_t timeOut); void AttachBufferUpdateBufferInfo(sptr& buffer, bool needMap); void ListenerBufferReleasedCb(sptr &buffer, const sptr &fence); void OnBufferDeleteCbForHardwareThreadLocked(const sptr &buffer) const; GSError CheckBufferQueueCache(uint32_t sequence); GSError ReallocBuffer(const BufferRequestConfig &config, struct IBufferProducer::RequestBufferReturnValue &retval); void SetSurfaceBufferHebcMetaLocked(sptr buffer); GSError RequestBufferCheckStatus(); GSError DelegatorQueueBuffer(uint32_t sequence, sptr fence); bool WaitForCondition(); void RequestBufferDebugInfo(); bool GetStatusLocked() const; void CallConsumerListener(); void LogAndTraceAllBufferInBufferQueueCache(); bool IsPresentTimestampReady(int64_t desiredPresentTimestamp, int64_t expectPresentTimestamp); void SetDesiredPresentTimestampAndUiTimestamp(uint32_t sequence, int64_t desiredPresentTimestamp, uint64_t uiTimestamp); void DropFirstDirtyBuffer(BufferElement &frontBufferElement, BufferElement &secondBufferElement, int64_t &frontDesiredPresentTimestamp, bool &frontIsAutoTimestamp, std::vector &dropBuffers); void ReleaseDropBuffers(std::vector &dropBuffers); void OnBufferDeleteForRS(uint32_t sequence); void AddDeletingBuffersLocked(std::vector &deletingBuffers); GSError DetachBufferFromQueueLocked(uint32_t sequence, InvokerType invokerType); GSError AttachBufferToQueueLocked(sptr buffer, InvokerType invokerType, bool needMap); GSError FlushBufferImprovedLocked(uint32_t sequence, sptr &bedata, const sptr &fence, const BufferFlushConfigWithDamages &config); GSError CheckBufferQueueCacheLocked(uint32_t sequence); GSError DoFlushBufferLocked(uint32_t sequence, sptr bedata, sptr fence, const BufferFlushConfigWithDamages &config); GSError RequestBufferLocked(const BufferRequestConfig &config, sptr &bedata, struct IBufferProducer::RequestBufferReturnValue &retval, std::unique_lock &lock); int32_t defaultWidth_ = 0; int32_t defaultHeight_ = 0; uint64_t defaultUsage_ = 0; uint32_t queueSize_ = SURFACE_DEFAULT_QUEUE_SIZE; ScalingMode scalingMode_ = ScalingMode::SCALING_MODE_SCALE_TO_WINDOW; GraphicTransformType transform_ = GraphicTransformType::GRAPHIC_ROTATE_NONE; GraphicTransformType lastFlushedTransform_ = GraphicTransformType::GRAPHIC_ROTATE_NONE; std::string name_; std::list freeList_; std::list dirtyList_; std::list deletingList_; std::list producerCacheList_; std::map bufferQueueCache_; sptr listener_ = nullptr; IBufferConsumerListenerClazz *listenerClazz_ = nullptr; mutable std::mutex mutex_; std::mutex listenerMutex_; std::mutex producerListenerMutex_; const uint64_t uniqueId_; OnReleaseFunc onBufferRelease_ = nullptr; std::mutex onBufferReleaseMutex_; sptr producerListener_ = nullptr; OnDeleteBufferFunc onBufferDeleteForRSMainThread_; OnDeleteBufferFunc onBufferDeleteForRSHardwareThread_; bool isShared_ = false; std::condition_variable waitReqCon_; std::condition_variable waitAttachCon_; sptr tunnelHandle_ = nullptr; std::atomic_bool isValidStatus_ = true; std::atomic_bool producerCacheClean_ = false; const bool isLocalRender_; uint32_t lastFlusedSequence_ = 0; sptr lastFlusedFence_; wptr wpCSurfaceDelegator_; bool isCpuAccessable_ = false; GraphicTransformType transformHint_ = GraphicTransformType::GRAPHIC_ROTATE_NONE; bool isBufferHold_ = false; bool isBatch_ = false; OHSurfaceSource sourceType_ = OHSurfaceSource::OH_SURFACE_SOURCE_DEFAULT; std::string appFrameworkType_ = ""; float hdrWhitePointBrightness_ = 0.0; float sdrWhitePointBrightness_ = 0.0; uint32_t acquireLastFlushedBufSequence_; std::string requestBufferStateStr_; std::string acquireBufferStateStr_; }; }; // namespace OHOS #endif // FRAMEWORKS_SURFACE_INCLUDE_BUFFER_QUEUE_H