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=6f654ff76ca87cd6e8626f1ae62ebea493a74299;hp=55612fff72cb9315a5198c593d36557eb9f7481d;hb=5f6befa398f1c68fcc8edff409a086f54af4d5f9;hpb=fc2392c09ab526295f52c430ead7879e1e91a096 diff --git a/dali-toolkit/internal/atlas-manager/atlas-manager.h b/dali-toolkit/internal/atlas-manager/atlas-manager.h index 55612ff..6f654ff 100644 --- a/dali-toolkit/internal/atlas-manager/atlas-manager.h +++ b/dali-toolkit/internal/atlas-manager/atlas-manager.h @@ -20,9 +20,9 @@ // EXTERNAL INCLUDES #include #include -#include #include #include +#include namespace Dali { @@ -160,6 +160,45 @@ 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 + }; + + struct Vertex2D + { + Vector2 mPosition; + Vector2 mTexCoords; + }; + + struct Mesh2D + { + Vector< Vertex2D > mVertices; + Vector< unsigned short> mIndices; + }; + /** * Create an AtlasManager handle; this can be initialised with AtlasManager::New() * Calling member functions with an uninitialised handle is not allowed. @@ -203,19 +242,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 @@ -257,7 +289,7 @@ public: */ void GenerateMeshData( ImageId id, const Vector2& position, - MeshData& mesh ); + Mesh2D& mesh ); /** * @brief Append second mesh to the first mesh @@ -266,8 +298,8 @@ public: * @param[in] second Second mesh * @param[in] optimize should we optimize vertex data */ - void StitchMesh( MeshData& first, - const MeshData& second, + void StitchMesh( Mesh2D& first, + const Mesh2D& second, bool optimize = false ); /** @@ -278,15 +310,16 @@ public: * @param[in] optimize should we optimize vertex data * @param[out] out resulting mesh */ - void StitchMesh( const MeshData& first, - const MeshData& second, - MeshData& out, + void StitchMesh( const Mesh2D& first, + const Mesh2D& second, + Mesh2D& out, bool optimize = false ); /** * @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 +327,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[in] atlas AtlasId * - * @param atlas AtlasId - * @return width and height of the blocks used + * @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 +353,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 +369,28 @@ 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 ); + + /** + * @brief Get Material used by atlas + * + * @param atlas[in] atlas AtlasId + * + * @return Material used by atlas + */ + Material GetMaterial( AtlasId atlas ) const; + private: explicit DALI_INTERNAL AtlasManager(Internal::AtlasManager *impl);