X-Git-Url: http://review.tizen.org/git/?p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git;a=blobdiff_plain;f=dali-toolkit%2Finternal%2Fvisuals%2Fimage-atlas-manager.h;h=05ed3a5357235c0dc1ef218253a4059b81304a87;hp=4586236c339fb740f78e23a7cc41d35f7a41b954;hb=HEAD;hpb=41307f75478fd6c6fb5f9ae7e7de5036647f39b3 diff --git a/dali-toolkit/internal/visuals/image-atlas-manager.h b/dali-toolkit/internal/visuals/image-atlas-manager.h index 4586236..ec7a402 100644 --- a/dali-toolkit/internal/visuals/image-atlas-manager.h +++ b/dali-toolkit/internal/visuals/image-atlas-manager.h @@ -2,7 +2,7 @@ #define DALI_TOOLKIT_IMAGE_ATLAS_MANAGER_H /* - * Copyright (c) 2016 Samsung Electronics Co., Ltd. + * Copyright (c) 2022 Samsung Electronics Co., Ltd. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -18,34 +18,34 @@ */ // EXTERNAL INCLUDES -#include +#include #include #include #include +#include // INTERNAL INCLUDES #include +#include namespace Dali { - namespace Toolkit { +class AtlasUploadObserver; namespace Internal { - /** * The manager for automatic image atlasing. Owned by VisualFactory */ class ImageAtlasManager : public RefObject { public: - typedef std::vector< Toolkit::ImageAtlas > AtlasContainer; - typedef std::vector< TextureSet > TextureSetContainer; + typedef std::vector AtlasContainer; + typedef std::vector TextureSetContainer; public: - /** * Construtor * @@ -53,6 +53,15 @@ public: ImageAtlasManager(); /** + * @brief Check whether the image of url could be Atlas or not. + * + * @param [in] url The URL of the resource image file to use. + * @param [in] size The width and height to fit the loaded image to. + * @return True if the image could be Atlas. + */ + bool CheckAtlasAvailable(const VisualUrl& url, const ImageDimensions& size) const; + + /** * @brief Add an image to the atlas. * * @note To make the atlasing efficient, an valid size should be provided. @@ -62,16 +71,40 @@ public: * * @param [out] textureRect The texture area of the resource image in the atlas. * @param [in] url The URL of the resource image file to use. + * @param [in, out] size The width and height to fit the loaded image to. + * @param [in] fittingMode The method used to fit the shape of the image before loading to the shape defined by the size parameter. + * @param [in] orientationCorrection Reorient the image to respect any orientation metadata in its header. + * @param [in] atlasUploadObserver The object to observe the uploading state inside ImageAtlas. + * @return The texture set containing the image. + */ + TextureSet Add(Vector4& textureRect, + const VisualUrl& url, + ImageDimensions& size, + FittingMode::Type fittingMode = FittingMode::DEFAULT, + bool orientationCorrection = true, + AtlasUploadObserver* atlasUploadObserver = NULL); + + /** + * @brief Add an image to the atlas. + * + * @note To make the atlasing efficient, an valid size should be provided. + * + * SamplingMode::BOX_THEN_LINEAR is used to sampling pixels from the input image while fitting it to desired size. + * + * @param [out] textureRect The texture area of the resource image in the atlas. + * @param [in] encodedImageBuffer The encoded buffer of the resource image file to use. * @param [in] size The width and height to fit the loaded image to. * @param [in] fittingMode The method used to fit the shape of the image before loading to the shape defined by the size parameter. * @param [in] orientationCorrection Reorient the image to respect any orientation metadata in its header. + * @param [in] atlasUploadObserver The object to observe the uploading state inside ImageAtlas. * @return The texture set containing the image. */ - TextureSet Add( Vector4& textureRect, - const std::string& url, - ImageDimensions size = ImageDimensions(), - FittingMode::Type fittingMode = FittingMode::DEFAULT, - bool orientationCorrection = true ); + TextureSet Add(Vector4& textureRect, + const EncodedImageBuffer& encodedImageBuffer, + const ImageDimensions& size, + FittingMode::Type fittingMode = FittingMode::DEFAULT, + bool orientationCorrection = true, + AtlasUploadObserver* atlasUploadObserver = NULL); /** * @brief Add a pixel buffer to the atlas @@ -80,8 +113,8 @@ public: * @param [in] pixelData The pixel data. * @return The texture set containing the image. */ - TextureSet Add( Vector4& textureRect, - PixelData pixelData ); + TextureSet Add(Vector4& textureRect, + PixelData pixelData); /** * Remove the image at the given rectangle from the texture set. @@ -89,14 +122,14 @@ public: * @param [in] textureSet The texture set containing the atlas image. * @param [in] textureRect The texture area to be removed. */ - void Remove( TextureSet textureSet, const Vector4& textureRect ); + void Remove(TextureSet textureSet, const Vector4& textureRect); /** * @brief Set the broken image which is used to replace the image if loading fails. * * @param[in] brokenImageUrl The url of the broken image. */ - void SetBrokenImage( const std::string& brokenImageUrl ); + void SetBrokenImage(const std::string& brokenImageUrl); /** * @brief Get shader @@ -104,7 +137,6 @@ public: Shader GetShader() const; private: - /** * @brief Create a new atlas. * @@ -113,11 +145,10 @@ private: void CreateNewAtlas(); protected: - /** * Destructor */ - virtual ~ImageAtlasManager(); + ~ImageAtlasManager() override; /** * Undefined copy constructor. @@ -129,16 +160,13 @@ protected: */ ImageAtlasManager& operator=(const ImageAtlasManager& rhs); - private: - - AtlasContainer mAtlasList; + AtlasContainer mAtlasList; TextureSetContainer mTextureSetList; - std::string mBrokenImageUrl; - + std::string mBrokenImageUrl; }; -} // name Internal +} // namespace Internal } // namespace Toolkit