X-Git-Url: http://review.tizen.org/git/?p=platform%2Fcore%2Fuifw%2Fdali-toolkit.git;a=blobdiff_plain;f=dali-toolkit%2Fdevel-api%2Fimage-loader%2Fimage-atlas.h;h=98796bdfeacceac46b766879315a1007e42d854d;hp=c85194f2e9537750908634208ca5c8eaf91dca80;hb=refs%2Fchanges%2F62%2F88562%2F16;hpb=7d13f3aa3f4ccf7c9c1c72ef182fd311663c6cd6 diff --git a/dali-toolkit/devel-api/image-loader/image-atlas.h b/dali-toolkit/devel-api/image-loader/image-atlas.h index c85194f..98796bd 100644 --- a/dali-toolkit/devel-api/image-loader/image-atlas.h +++ b/dali-toolkit/devel-api/image-loader/image-atlas.h @@ -26,6 +26,9 @@ #include #include +// INTERNAL INCLUDES +#include + namespace Dali { @@ -114,7 +117,7 @@ public: /** * @brief Upload a resource image to the atlas. * - * @note To make the atlasing efficient, an valid size should be provided. + * @note To make the atlasing efficient, a valid size should be provided. * If size is not provided, then the image file will be opened to read the actual size for loading. * Do not set a size that is bigger than the actual image size, as the up-scaling is not available, * the content of the area not covered by actual image is undefined, it will not be cleared. @@ -135,6 +138,32 @@ public: bool orientationCorrection = true ); /** + * @brief Upload a resource image to the atlas. + * + * @note To make the atlasing efficient, a valid size should be provided. + * If size is not provided, then the image file will be opened to read the actual size for loading. + * Do not set a size that is bigger than the actual image size, as the up-scaling is not available, + * the content of the area not covered by actual image is undefined, it will not be cleared. + * + * 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] url The URL 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 observer to observe the upload state inside the ImageAtlas. + * @return True if there is enough space to fit this image in,false otherwise. + * @note The valid callback function here is required to have the signature of void( void ). + */ + bool Upload( Vector4& textureRect, + const std::string& url, + ImageDimensions size, + FittingMode::Type fittingMode, + bool orientationCorrection, + AtlasUploadObserver* atlasUploadObserver ); + + /** * @brief Upload a pixel buffer to atlas * * @param [out] textureRect The texture area of the resource image in the atlas.