1 /* 2 * Copyright (c) 2021 Huawei Device Co., Ltd. 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 * See the License for the specific language governing permissions and 13 * limitations under the License. 14 */ 15 16 #ifndef INTERFACES_INNERKITS_SURFACE_SURFACE_BUFFER_H 17 #define INTERFACES_INNERKITS_SURFACE_SURFACE_BUFFER_H 18 19 #include <functional> 20 21 #include <memory> 22 #include <refbase.h> 23 24 #include "buffer_handle_utils.h" 25 #include "surface_type.h" 26 #include "egl_data.h" 27 #include "buffer_extra_data.h" 28 #include "native_buffer.h" 29 30 struct BufferWrapper; 31 32 namespace OHOS { 33 class MessageParcel; 34 class SyncFence; 35 class SurfaceBuffer : public RefBase { 36 public: 37 virtual BufferHandle *GetBufferHandle() const = 0; 38 virtual int32_t GetWidth() const = 0; 39 virtual int32_t GetHeight() const = 0; 40 virtual int32_t GetStride() const = 0; 41 virtual int32_t GetFormat() const = 0; 42 virtual uint64_t GetUsage() const = 0; 43 virtual uint64_t GetPhyAddr() const = 0; 44 virtual void* GetVirAddr() = 0; 45 virtual int32_t GetFileDescriptor() const = 0; 46 virtual uint32_t GetSize() const = 0; 47 48 virtual GraphicColorGamut GetSurfaceBufferColorGamut() const = 0; 49 virtual GraphicTransformType GetSurfaceBufferTransform() const = 0; 50 virtual void SetSurfaceBufferColorGamut(const GraphicColorGamut& colorGamut) = 0; 51 virtual void SetSurfaceBufferTransform(const GraphicTransformType& transform) = 0; 52 53 virtual int32_t GetSurfaceBufferWidth() const = 0; 54 virtual int32_t GetSurfaceBufferHeight() const = 0; 55 virtual void SetSurfaceBufferWidth(int32_t width) = 0; 56 virtual void SetSurfaceBufferHeight(int32_t width) = 0; 57 58 virtual uint32_t GetSeqNum() const = 0; 59 60 // opt EglData 61 virtual sptr<EglData> GetEglData() const = 0; 62 virtual void SetEglData(const sptr<EglData>& data) = 0; 63 64 virtual void SetExtraData(sptr<BufferExtraData> bedata) = 0; 65 virtual sptr<BufferExtraData> GetExtraData() const = 0; 66 virtual GSError WriteToMessageParcel(MessageParcel &parcel) = 0; 67 virtual GSError ReadFromMessageParcel(MessageParcel &parcel) = 0; 68 virtual void SetBufferHandle(BufferHandle *handle) = 0; 69 70 virtual BufferWrapper GetBufferWrapper() = 0; 71 virtual void SetBufferWrapper(BufferWrapper wrapper) = 0; 72 73 // gralloc 74 virtual GSError Alloc(const BufferRequestConfig &config) = 0; 75 virtual GSError Map() = 0; 76 virtual GSError Unmap() = 0; 77 virtual GSError FlushCache() = 0; 78 virtual GSError InvalidateCache() = 0; 79 80 // metadata 81 virtual GSError SetMetadata(uint32_t key, const std::vector<uint8_t>& value) = 0; 82 virtual GSError GetMetadata(uint32_t key, std::vector<uint8_t>& value) = 0; 83 virtual GSError ListMetadataKeys(std::vector<uint32_t>& keys) = 0; 84 virtual GSError EraseMetadataKey(uint32_t key) = 0; 85 NativeBufferToSurfaceBuffer(OH_NativeBuffer * buffer)86 static SurfaceBuffer* NativeBufferToSurfaceBuffer(OH_NativeBuffer* buffer) 87 { 88 return reinterpret_cast<SurfaceBuffer *>(buffer); 89 }; 90 NativeBufferToSurfaceBuffer(OH_NativeBuffer const * buffer)91 static const SurfaceBuffer* NativeBufferToSurfaceBuffer(OH_NativeBuffer const* buffer) 92 { 93 return reinterpret_cast<SurfaceBuffer const*>(buffer); 94 }; 95 96 virtual OH_NativeBuffer* SurfaceBufferToNativeBuffer() = 0; 97 98 static sptr<SurfaceBuffer> Create(); 99 WriteBufferRequestConfig(MessageParcel & parcel)100 virtual GSError WriteBufferRequestConfig(MessageParcel &parcel) 101 { 102 (void)parcel; 103 return GSERROR_OK; 104 }; ReadBufferRequestConfig(MessageParcel & parcel)105 virtual GSError ReadBufferRequestConfig(MessageParcel &parcel) 106 { 107 (void)parcel; 108 return GSERROR_OK; 109 }; GetBufferRequestConfig()110 virtual BufferRequestConfig GetBufferRequestConfig() const 111 { 112 return {}; 113 } SetBufferRequestConfig(const BufferRequestConfig & config)114 virtual void SetBufferRequestConfig(const BufferRequestConfig &config) 115 { 116 (void)config; 117 }; SetConsumerAttachBufferFlag(bool value)118 virtual void SetConsumerAttachBufferFlag(bool value) 119 { 120 (void)value; 121 }; GetConsumerAttachBufferFlag()122 virtual bool GetConsumerAttachBufferFlag() 123 { 124 return false; 125 }; GetPlanesInfo(void ** planesInfo)126 virtual GSError GetPlanesInfo(void **planesInfo) 127 { 128 (void)planesInfo; 129 return GSERROR_OK; 130 }; 131 132 protected: SurfaceBuffer()133 SurfaceBuffer() {} 134 SurfaceBuffer(const SurfaceBuffer&) = delete; 135 SurfaceBuffer& operator=(const SurfaceBuffer&) = delete; ~SurfaceBuffer()136 virtual ~SurfaceBuffer() {} 137 }; 138 139 using OnReleaseFunc = std::function<GSError(sptr<SurfaceBuffer> &)>; 140 using OnDeleteBufferFunc = std::function<void(int32_t)>; 141 using OnReleaseFuncWithFence = std::function<GSError(const sptr<SurfaceBuffer>&, const sptr<SyncFence>&)>; 142 using OnUserDataChangeFunc = std::function<void(const std::string& key, const std::string& value)>; 143 } // namespace OHOS 144 145 #endif // INTERFACES_INNERKITS_SURFACE_SURFACE_BUFFER_H 146