1 #ifndef DALI_NATIVE_IMAGE_SOURCE_H
2 #define DALI_NATIVE_IMAGE_SOURCE_H
5 * Copyright (c) 2023 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.
24 #include <dali/public-api/common/vector-wrapper.h>
25 #include <dali/public-api/images/native-image-interface.h>
26 #include <dali/public-api/images/pixel.h>
27 #include <dali/public-api/object/any.h>
30 #include <dali/public-api/dali-adaptor-common.h>
35 * @addtogroup dali_adaptor_framework
39 namespace Internal DALI_INTERNAL
43 class NativeImageSource;
45 } // namespace DALI_INTERNAL
47 class NativeImageSource;
49 * @brief Pointer to Dali::NativeImageSource.
52 typedef Dali::IntrusivePtr<Dali::NativeImageSource> NativeImageSourcePtr;
55 * @brief Used for displaying native images.
57 * NativeImageSource can be created internally or
58 * externally by native image source.
59 * NativeImage is a platform specific way of providing pixel data to the GPU for rendering,
60 * for example via an EGL image.
65 class DALI_ADAPTOR_API NativeImageSource : public NativeImageInterface
69 * @brief Enumeration for the instance when creating a native image, the color depth has to be specified.
74 COLOR_DEPTH_DEFAULT, ///< Uses the current screen default depth (recommended) @SINCE_1_0.0
75 COLOR_DEPTH_8, ///< 8 bits per pixel @SINCE_1_0.0
76 COLOR_DEPTH_16, ///< 16 bits per pixel @SINCE_1_0.0
77 COLOR_DEPTH_24, ///< 24 bits per pixel @SINCE_1_0.0
78 COLOR_DEPTH_32 ///< 32 bits per pixel @SINCE_1_0.0
82 * @brief Creates a new NativeImageSource.
84 * Depending on hardware, the width and height may have to be a power of two.
86 * @param[in] width The width of the image
87 * @param[in] height The height of the image
88 * @param[in] depth color depth of the image
89 * @return A smart-pointer to a newly allocated image
91 static NativeImageSourcePtr New(uint32_t width, uint32_t height, ColorDepth depth);
94 * @brief Creates a new NativeImageSource from an existing native image source.
97 * @param[in] nativeImageSource NativeImageSource must be a any handle with native image source
98 * @return A smart-pointer to a newly allocated image
99 * @see NativeImageInterface
101 static NativeImageSourcePtr New(Any nativeImageSource);
104 * @brief Retrieves the internal native image.
107 * @return Any object containing the internal native image source
109 Any GetNativeImageSource();
112 * @brief Gets a copy of the pixels used by NativeImageSource.
114 * This is only supported for 24 bit RGB and 32 bit RGBA internal formats
115 * (COLOR_DEPTH_24 and COLOR_DEPTH_32).
117 * @param[out] pixbuf A vector to store the pixels in
118 * @param[out] width The width of image
119 * @param[out] height The height of image
120 * @param[out] pixelFormat pixel format used by image
121 * @return @c true if the pixels were gotten, and @c false otherwise
123 bool GetPixels(std::vector<uint8_t>& pixbuf, uint32_t& width, uint32_t& height, Pixel::Format& pixelFormat) const;
126 * @brief Converts the current pixel contents to either a JPEG or PNG format
127 * and write that to the filesystem.
130 * @param[in] filename Identify the filesystem location at which to write the encoded image.
131 * The extension determines the encoding used.
132 * The two valid encoding are (".jpeg"|".jpg") and ".png".
133 * @return @c true if the pixels were written, and @c false otherwise
135 bool EncodeToFile(const std::string& filename) const;
138 * @brief Sets an existing source.
141 * @param[in] source Any handle with the source
143 void SetSource(Any source);
146 * @brief Checks if the specified color depth is supported.
149 * @param[in] colorDepth The color depth to check
150 * @return @c true if colorDepth is supported, @c false otherwise
152 bool IsColorDepthSupported(ColorDepth colorDepth);
154 public: // native image
156 * @copydoc Dali::NativeImageInterface::GetWidth()
158 uint32_t GetWidth() const override;
161 * @copydoc Dali::NativeImageInterface::GetHeight()
163 uint32_t GetHeight() const override;
166 * @copydoc Dali::NativeImageInterface::GetTextureTarget()
168 int GetTextureTarget() const override;
171 * @copydoc Dali::NativeImageInterface::ApplyNativeFragmentShader()
173 bool ApplyNativeFragmentShader(std::string& shader) override;
176 * @copydoc Dali::NativeImageInterface::GetCustomSamplerTypename()
178 const char* GetCustomSamplerTypename() const override;
180 private: // native image
182 * @copydoc Dali::NativeImageInterface::CreateResource()
184 bool CreateResource() override;
187 * @copydoc Dali::NativeImageInterface::DestroyResource()
189 void DestroyResource() override;
192 * @copydoc Dali::NativeImageInterface::TargetTexture()
194 uint32_t TargetTexture() override;
197 * @copydoc Dali::NativeImageInterface::PrepareTexture()
199 void PrepareTexture() override;
202 * @copydoc Dali::NativeImageInterface::RequiresBlending()
204 bool RequiresBlending() const override;
207 * @copydoc Dali::NativeImageInterface::GetNativeImageHandle()
209 Any GetNativeImageHandle() const override;
212 * @copydoc Dali::NativeImageInterface::SourceChanged()
214 bool SourceChanged() const override;
217 * @copydoc Dali::NativeImageInterface::GetUpdatedArea()
219 Rect<uint32_t> GetUpdatedArea() override;
222 * @copydoc Dali::NativeImageInterface::GetExtension()
224 NativeImageInterface::Extension* GetExtension() override;
229 * @brief Private constructor.
231 * @param[in] width The width of the image
232 * @param[in] height The height of the image
233 * @param[in] depth color depth of the image
234 * @param[in] nativeImageSource contains either: native image source or is empty
236 DALI_INTERNAL NativeImageSource(uint32_t width, uint32_t height, ColorDepth depth, Any nativeImageSource);
239 * @brief A reference counted object may only be deleted by calling Unreference().
241 * The implementation should destroy the NativeImage resources.
244 DALI_INTERNAL ~NativeImageSource() override;
247 * @brief Undefined copy constructor.
249 * This avoids accidental calls to a default copy constructor.
251 * @param[in] nativeImageSource A reference to the object to copy
253 DALI_INTERNAL NativeImageSource(const NativeImageSource& nativeImageSource);
256 * @brief Undefined assignment operator.
258 * This avoids accidental calls to a default assignment operator.
260 * @param[in] rhs A reference to the object to copy
262 DALI_INTERNAL NativeImageSource& operator=(const NativeImageSource& rhs);
267 Internal::Adaptor::NativeImageSource* mImpl; ///< Implementation pointer
268 friend class Internal::Adaptor::NativeImageSource;
278 #endif // DALI_NATIVE_IMAGE_SOURCE_H