1 #ifndef DALI_INTERNAL_NEW_TEXTURE_H
2 #define DALI_INTERNAL_NEW_TEXTURE_H
5 * Copyright (c) 2020 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/internal/event/common/event-thread-services.h>
23 #include <dali/internal/event/images/pixel-data-impl.h>
24 #include <dali/public-api/common/dali-common.h> // DALI_ASSERT_ALWAYS
25 #include <dali/public-api/common/intrusive-ptr.h> // Dali::IntrusivePtr
26 #include <dali/public-api/images/image-operations.h> // Dali::ImageDimensions
27 #include <dali/public-api/images/pixel.h>
28 #include <dali/public-api/object/base-object.h>
29 #include <dali/public-api/rendering/texture.h> // Dali::Internal::Render::Texture
41 using TexturePtr = IntrusivePtr<Texture>;
43 class Texture : public BaseObject
47 * @brief Structure used to pass parameters to the Upload method
51 uint16_t layer; ///< Specifies the layer of a cube map or array texture
52 uint16_t mipmap; ///< Specifies the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
53 uint16_t xOffset; ///< Specifies a texel offset in the x direction within the texture array.
54 uint16_t yOffset; ///< Specifies a texel offset in the y direction within the texture array.
55 uint16_t width; ///< Specifies the width of the texture subimage
56 uint16_t height; ///< Specifies the height of the texture subimage.
60 * @brief Create a new Texture.
62 * @param[in] type The type of the texture
63 * @param[in] format The format of the pixel data
64 * @param[in] width The width of the texture
65 * @param[in] height The height of the texture
66 * @return A smart-pointer to the newly allocated Texture.
68 static TexturePtr New(TextureType::Type type, Pixel::Format format, unsigned int width, unsigned int height);
71 * @brief Creates a new Texture from a native image
72 * @param[in] nativeImageInterface The native image
73 * @return A smart-pointer to the newly allocated Texture.
75 static TexturePtr New(NativeImageInterface& nativeImageInterface);
78 * @brief Get the texture render object
80 * @return the texture render object
82 Render::Texture* GetRenderObject() const;
85 * @copydoc Dali::Texture::Upload()
87 bool Upload(PixelDataPtr pixelData);
90 * @copydoc Dali::Texture::Upload()
92 bool Upload(PixelDataPtr pixelData,
101 * @copydoc Dali::Texture::GenerateMipmaps()
103 void GenerateMipmaps();
106 * @copydoc Dali::Texture::GetWidth()
108 unsigned int GetWidth() const;
111 * @copydoc Dali::Texture::GetHeight()
113 unsigned int GetHeight() const;
116 * @brief Determine if the texture is a native image
118 * @return true if the texture has been initialized with a native image
120 bool IsNative() const;
123 * @brief Apply any native texture code to the given fragment shader
125 * @param[in,out] shader The fragment shader
126 * @return true if the shader has been modified.
128 bool ApplyNativeFragmentShader(std::string& shader);
130 private: // implementation
133 * @param[in] type The type of the texture
134 * @param[in] format The format of the pixel data
135 * @param[in] size The size of the texture
137 Texture(TextureType::Type type, Pixel::Format format, ImageDimensions size);
140 * Constructor from native image
141 * @param[in] nativeImageInterface The native image
143 Texture(NativeImageInterfacePtr nativeImageInterface);
146 * Second stage initialization of the Texture
152 * A reference counted object may only be deleted by calling Unreference()
156 private: // unimplemented methods
157 Texture(const Texture&);
158 Texture& operator=(const Texture&);
161 Internal::EventThreadServices& mEventThreadServices; ///<Used to send messages to the render thread via update thread
162 Internal::Render::Texture* mRenderObject; ///<The Render::Texture associated to this texture
164 NativeImageInterfacePtr mNativeImage; ///< Pointer to native image
165 ImageDimensions mSize; ///< Size of the texture
166 Dali::TextureType::Type mType; ///< Texture type (cached)
167 Pixel::Format mFormat; ///< Pixel format
170 } // namespace Internal
172 // Helpers for public-api forwarding methods
173 inline Internal::Texture& GetImplementation(Dali::Texture& handle)
175 DALI_ASSERT_ALWAYS(handle && "Texture handle is empty");
177 BaseObject& object = handle.GetBaseObject();
179 return static_cast<Internal::Texture&>(object);
182 inline const Internal::Texture& GetImplementation(const Dali::Texture& handle)
184 DALI_ASSERT_ALWAYS(handle && "Texture handle is empty");
186 const BaseObject& object = handle.GetBaseObject();
188 return static_cast<const Internal::Texture&>(object);
193 #endif // DALI_INTERNAL_TEXTURE_H