X-Git-Url: http://review.tizen.org/git/?p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git;a=blobdiff_plain;f=dali-toolkit%2Finternal%2Fatlas-manager%2Fatlas-manager.h;h=2bf79f0b03d34ba38b9e1b048526a0322b76a688;hp=55612fff72cb9315a5198c593d36557eb9f7481d;hb=2d7d2f05438ef19f3fce46214d2dbc38cb1ba8c0;hpb=fc2392c09ab526295f52c430ead7879e1e91a096 diff --git a/dali-toolkit/internal/atlas-manager/atlas-manager.h b/dali-toolkit/internal/atlas-manager/atlas-manager.h index 55612ff..2bf79f0 100644 --- a/dali-toolkit/internal/atlas-manager/atlas-manager.h +++ b/dali-toolkit/internal/atlas-manager/atlas-manager.h @@ -20,8 +20,8 @@ // EXTERNAL INCLUDES #include #include -#include -#include +#include +#include #include namespace Dali @@ -160,6 +160,33 @@ public: typedef SizeType ImageId; static const bool MESH_OPTIMIZE = true; + struct AtlasSize + { + SizeType mWidth; // width of the atlas in pixels + SizeType mHeight; // height of the atlas in pixels + SizeType mBlockWidth; // width of a block in pixels + SizeType mBlockHeight; // height of a block in pixels + }; + + /** + * Metrics structures to describe Atlas Manager state + * + */ + struct AtlasMetricsEntry + { + AtlasSize mSize; // size of atlas and blocks + SizeType mBlocksUsed; // number of blocks used in the atlas + SizeType mTotalBlocks; // total blocks used by atlas + Pixel::Format mPixelFormat; // pixel format of the atlas + }; + + struct Metrics + { + SizeType mAtlasCount; // number of atlases + SizeType mTextureMemoryUsed; // texture memory used by atlases + Dali::Vector< AtlasMetricsEntry > mAtlasMetrics; // container of atlas information + }; + /** * Create an AtlasManager handle; this can be initialised with AtlasManager::New() * Calling member functions with an uninitialised handle is not allowed. @@ -203,19 +230,12 @@ public: /** * @brief Create a blank atlas of specific dimensions and pixel format with a certain block size * - * @param width desired atlas width in pixels - * @param height desired atlas height in pixels - * @param blockWidth block width to use in atlas in pixels - * @param blockHeight block height to use in atlas in pixels - * @param pixelformat format of a pixel in atlas + * @param[in] size desired atlas dimensions + * @param[in] pixelformat format of a pixel in atlas * * @return atlas Id */ - AtlasId CreateAtlas( SizeType width, - SizeType height, - SizeType blockWidth, - SizeType blockHeight, - Pixel::Format pixelformat = Pixel::RGBA8888 ); + AtlasId CreateAtlas( const AtlasSize& size, Pixel::Format pixelformat = Pixel::RGBA8888 ); /** * @brief Set the policy on failure to add an image to an atlas @@ -286,7 +306,8 @@ public: /** * @brief Get the BufferImage containing an atlas * - * @param atlas AtlasId returned when atlas was created + * @param[in] atlas AtlasId returned when atlas was created + * * @return Atlas Handle */ Dali::Atlas GetAtlasContainer( AtlasId atlas ) const; @@ -294,23 +315,25 @@ public: /** * @brief Get the Id of the atlas containing an image * - * @param id ImageId + * @param[in] id ImageId + * * @return Atlas Id */ AtlasId GetAtlas( ImageId id ); - /** - * @brief Get the size of the blocks used in an atlas + * @brief Get the current size of an atlas * - * @param atlas AtlasId - * @return width and height of the blocks used + * @param[in] atlas AtlasId + * + * @return AtlasSize structure for the atlas */ - Vector2 GetBlockSize( AtlasId atlas ); + const AtlasSize& GetAtlasSize( AtlasId atlas ); /** * @brief Get the number of blocks available in an atlas * - * @param atlas AtlasId + * @param[in] atlas AtlasId + * * @return Number of blocks free in this atlas */ SizeType GetFreeBlocks( AtlasId atlas ); @@ -318,11 +341,11 @@ public: /** * @brief Sets the pixel area of any new atlas and also the individual block size * - * @param size pixel area of atlas + * @param[in] size Atlas size structure + * * @param blockSize pixel area in atlas for a block */ - void SetAtlasSize( const Vector2& size, - const Vector2& blockSize ); + void SetNewAtlasSize( const AtlasSize& size ); /** * @brief Get the number of atlases created @@ -334,11 +357,19 @@ public: /** * @brief Get the pixel format used by an atlas * - * @param atlas AtlasId + * @param[in] atlas AtlasId + * * @return Pixel format used by this atlas */ Pixel::Format GetPixelFormat( AtlasId atlas ); + /** + * @brief Fill in a metrics structure showing current status of this Atlas Manager + * + * @param[in] metrics metrics structure to be filled + */ + void GetMetrics( Metrics& metrics ); + private: explicit DALI_INTERNAL AtlasManager(Internal::AtlasManager *impl);