1 #ifndef DALI_INTERNAL_FRAME_BUFFER_H
2 #define DALI_INTERNAL_FRAME_BUFFER_H
5 * Copyright (c) 2019 Samsung Electronics Co., Ltd.
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
22 #include <dali/public-api/common/dali-common.h> // DALI_ASSERT_ALWAYS
23 #include <dali/public-api/common/intrusive-ptr.h> // Dali::IntrusivePtr
24 #include <dali/public-api/object/base-object.h>
25 #include <dali/public-api/rendering/frame-buffer.h>
26 #include <dali/internal/event/common/event-thread-services.h>
27 #include <dali/internal/event/rendering/texture-impl.h>
45 typedef IntrusivePtr<FrameBuffer> FrameBufferPtr;
47 class FrameBuffer : public BaseObject
51 using Mask = Dali::FrameBuffer::Attachment::Mask;
54 * @brief Create a new FrameBuffer
56 * @param[in] width The width of the FrameBuffer
57 * @param[in] height The height of the FrameBuffer
58 * @param[in] attachments The attachments comprising the format of the FrameBuffer (bit-mask)
59 * @return A smart-pointer to the newly allocated Texture.
61 static FrameBufferPtr New( uint32_t width, uint32_t height, Mask attachments );
64 * @brief Create a new FrameBuffer
66 * @param[in] renderSurface The render surface
67 * @param[in] attachments The attachments comprising the format of the FrameBuffer (bit-mask)
68 * @return A smart-pointer to the newly allocated Texture.
70 static FrameBufferPtr New( Dali::Integration::RenderSurface& renderSurface, Mask attachments );
73 * A reference counted object may only be deleted by calling Unreference()
75 virtual ~FrameBuffer();
78 * @brief Get the FrameBuffer render object
80 * @return the FrameBuffer render object
82 Render::FrameBuffer* GetRenderObject() const;
85 * @copydoc Dali::FrameBuffer::AttachColorTexture()
87 void AttachColorTexture( TexturePtr texture, uint32_t mipmapLevel, uint32_t layer );
90 * @copydoc Dali::FrameBuffer::GetColorTexture()
92 Texture* GetColorTexture();
95 * @brief Sets the frame buffer size.
96 * @param[in] width The width size
97 * @param[in] height The height size
99 void SetSize( uint32_t width, uint32_t height );
102 * @brief Mark the render surface as invalid
104 * The render surface is maked as invalid when it is deleted.
106 * @note Only for FrameBuffer backed by a render surface.
107 * @return True if the FrameBuffer is backed by a render surface
109 void MarkSurfaceAsInvalid();
111 private: // implementation
115 * @param[in] width The width of the FrameBuffer
116 * @param[in] height The height of the FrameBuffer
117 * @param[in] attachments The attachments comprising the format of the FrameBuffer (bit-mask)
119 FrameBuffer( uint32_t width, uint32_t height, Mask attachments );
122 * Second stage initialization of the Texture
124 void Initialize( Integration::RenderSurface* renderSurface = nullptr );
128 private: // unimplemented methods
130 FrameBuffer() = delete;
131 FrameBuffer( const FrameBuffer& ) = delete;
132 FrameBuffer& operator=( const FrameBuffer& ) = delete;
136 Internal::EventThreadServices& mEventThreadServices; ///< Used to send messages to the render thread via update thread
137 Internal::Render::FrameBuffer* mRenderObject; ///< The Render::Texture associated to this texture
142 Mask mAttachments; ///< Bit-mask of type FrameBuffer::Attachment::Mask
144 bool mIsSurfaceBacked:1;
148 } // namespace Internal
150 // Helpers for public-api forwarding methods
151 inline Internal::FrameBuffer& GetImplementation(Dali::FrameBuffer& handle)
153 DALI_ASSERT_ALWAYS(handle && "FrameBuffer handle is empty");
155 BaseObject& object = handle.GetBaseObject();
157 return static_cast<Internal::FrameBuffer&>(object);
160 inline const Internal::FrameBuffer& GetImplementation(const Dali::FrameBuffer& handle)
162 DALI_ASSERT_ALWAYS(handle && "FrameBuffer handle is empty");
164 const BaseObject& object = handle.GetBaseObject();
166 return static_cast<const Internal::FrameBuffer&>(object);
171 #endif // DALI_INTERNAL_FRAME_BUFFER_H