merge commits of 2.2.1 to public
[platform/framework/native/image.git] / inc / FMediaImage.h
old mode 100644 (file)
new mode 100755 (executable)
index 7c440cb..4bb1207
@@ -39,7 +39,7 @@ namespace Tizen { namespace Media
  * @brief      This class is used for handling images.
  *
  * @since      2.0
- * @remarks The minimum dimension is 16x16 for JPEG encoding and 8x8 for PNG encoding.
+ * @remarks The minimum dimension for JPEG encoding is 16x16 and for PNG encoding is 8x8.
  *
  * The %Image class is used for handling images, including image decoding, encoding, and conversion. @n
  *
@@ -189,12 +189,12 @@ public:
        result Construct(void);
 
        /**
-       * Decodes an image file into the decoded bitmap container. @n
+       * Decodes the image file into the decoded bitmap container. @n
        * The currently supported decoding formats are JPEG, GIF, PNG, BMP, TIFF, and WBMP. @n
        * The %DecodeN() method retains the aspect ratio of the original image.
        *
        * @if OSPCOMPAT
-       * @brief <i> [Compatibility] </i>
+       * @brief                <i> [Compatibility] </i>
        * @endif
        * @since                2.0
        * @if OSPCOMPAT
@@ -202,32 +202,32 @@ public:
        *                                       For more information, see @ref CompIoPathPage "here".
        * @endif
        *
-       * @return               A decoded bitmap that is not resized
+       * @return               The decoded bitmap that is not resized
        * @param[in]    srcImagePath                    The local file path of the image file to open
        * @param[in]    pixelFormat                             The output pixel format defined by Tizen::Graphics::BitmapPixelFormat
        * @exception    E_SUCCESS                               The method is successful.
-       * @exception    E_INVALID_ARG                   The specified pixel format is not supported.
+       * @exception    E_INVALID_ARG                   The specified @c pixelFormat is not supported.
        * @exception    E_INVALID_DATA                  The specified input instance has invalid data.
        * @exception    E_OVERFLOW                              The specified input instance has overflowed.
        * @exception    E_UNSUPPORTED_FORMAT    The specified format is not supported.
        * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
        * @exception    E_FILE_NOT_FOUND                The specified file cannot be found or accessed.
        * @remarks
-       *                         - @c E_OUT_OF_MEMORY can be returned if there is no available memory when decoding a large image.
+       *                         - @c E_OUT_OF_MEMORY is returned if there is no available memory for decoding a large image.
        *                         - The specific error code can be accessed using the GetLastResult() method.
        *                         - This method returns an auto-scaled bitmap, @n
-       *                           so the dimension can be different from the dimension of source image if the returned bitmap is locked.
+       *                         so the dimension can be different from the dimension of the source image, if the returned bitmap is locked.
        */
        Tizen::Graphics::Bitmap* DecodeN(const Tizen::Base::String& srcImagePath, Tizen::Graphics::BitmapPixelFormat pixelFormat) const;
 
        /**
-       * Decodes an image file into the decoded bitmap container after resizing it as per the specified width and height. @n
+       * Decodes the image file into the decoded bitmap container after resizing it as per the specified width and height. @n
        * The currently supported decoding formats are JPEG, GIF, PNG, BMP, TIFF, and WBMP. @n
        * The %DecodeN() method retains the aspect ratio of the original image. @n
-       * It supports only the downscaling of an image.
+       * It supports only the downscaling of the image.
        *
        * @if OSPCOMPAT
-       * @brief <i> [Compatibility] </i>
+       * @brief                <i> [Compatibility] </i>
        * @endif
        * @since                2.0
        * @if OSPCOMPAT
@@ -235,7 +235,7 @@ public:
        *                                       For more information, see @ref CompIoPathPage "here".
        * @endif
        *
-       * @return               A decoded bitmap data with the specified destination width and height
+       * @return               The decoded bitmap data with the specified destination width and height
        * @param[in]    srcImagePath                    The local file path of the image file to open
        * @param[in]    pixelFormat                             The output pixel format defined by Tizen::Graphics::BitmapPixelFormat
        * @param[in]    destWidth                               The intended width of the image @n
@@ -243,77 +243,81 @@ public:
        * @param[in]    destHeight                              The intended height of the image @n
        *                                                                               An exception is returned if the value is less than @c 0.
        * @exception    E_SUCCESS                               The method is successful.
-       * @exception    E_INVALID_ARG                   The specified pixel format is not supported.
+       * @exception    E_INVALID_ARG                   The specified @c pixelFormat is not supported.
        * @exception    E_INVALID_DATA                  The specified input instance has invalid data.
        * @exception    E_OVERFLOW                              The specified input instance has overflowed.
        * @exception    E_UNSUPPORTED_FORMAT    The specified format is not supported.
        * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
        * @exception    E_FILE_NOT_FOUND                The specified file cannot be found or accessed.
-       * @exception    E_OUT_OF_RANGE                  The specified size is out of range.
+       * @exception    E_OUT_OF_RANGE                  The specified size is out of the valid range.
        * @remarks
        *                         - The specific error code can be accessed using the GetLastResult() method.
        *                         - This method returns an auto-scaled bitmap, @n
-       *                           so the dimension can be different from the requested dimension if the returned bitmap is locked.
+       *                         so the dimension can be different from the requested dimension, if the returned bitmap is locked.
        */
        Tizen::Graphics::Bitmap* DecodeN(const Tizen::Base::String& srcImagePath, Tizen::Graphics::BitmapPixelFormat pixelFormat, int destWidth, int destHeight) const;
 
        /**
-       * Decodes an image data into the decoded bitmap container after resizing it as per a specified width and height. @n
+       * Decodes the image data into the decoded bitmap container after resizing it as per the specified width and height. @n
        * The currently supported decoding formats are JPEG, GIF, PNG, BMP, TIFF, and WBMP. @n
        * The %DecodeN() method retains the aspect ratio of the original image.
        *
        * @since                2.1
        *
-       * @return               A decoded bitmap data with the specified destination width and height
+       * @return               The decoded bitmap data with the specified destination width and height
        * @param[in]    srcImageBuf                             The data to decode
        * @param[in]    pixelFormat                             The output pixel format defined by Tizen::Graphics::BitmapPixelFormat
        * @param[in]    destWidth                               The intended width of the image
        * @param[in]    destHeight                              The intended height of the image
        * @exception    E_SUCCESS                               The method is successful.
        * @exception    E_INVALID_DATA                  The specified input instance has invalid data.
-       * @exception    E_INVALID_ARG                   The specified pixel format is not supported.
+       * @exception    E_INVALID_ARG                   The specified @c pixelFormat is not supported.
        * @exception    E_UNSUPPORTED_FORMAT    The specified format is not supported.
        * @exception    E_OBJ_NOT_FOUND                 The specified image buffer cannot be found.
        * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
        * @remarks
        *                         - The specific error code can be accessed using the GetLastResult() method.
-       *                         - There is a high probability for an occurrence of an out-of-memory exception. If possible, check whether the exception is @c E_OUT_OF_MEMORY or not.
-       *                           For more information on how to handle the out-of-memory exception, refer <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/exception_check.htm">here</a>.
-       *                         - This method returns an auto-scaled bitmap to support logical coordinate system, so the actual dimension of the returned bitmap can vary depending on the physical dimension of the target device.
+       *                         - There is a high probability for an occurrence of an out-of-memory exception. If possible, check whether the exception is 
+       *                       @c E_OUT_OF_MEMORY or not. For more information on how to handle the out-of-memory exception, 
+       *                       refer <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/exception_check.htm">here</a>.
+       *                         - This method returns an auto-scaled bitmap to support the logical coordinate system, so the actual dimension of the returned bitmap can 
+       *                         vary depending on the physical dimension of the target device.
        */
        Tizen::Graphics::Bitmap* DecodeN(const Tizen::Base::ByteBuffer& srcImageBuf, Tizen::Graphics::BitmapPixelFormat pixelFormat, float destWidth, float destHeight) const;
 
        /**
-       * Decodes an image file into the decoded bitmap container after resizing it as per a specified width and height. @n
+       * Decodes the image file into the decoded bitmap container after resizing it as per the specified width and height. @n
        * The currently supported decoding formats are JPEG, GIF, PNG, BMP, TIFF, and WBMP. @n
        * The %DecodeN() method retains the aspect ratio of the original image.
        *
        * @since                2.1
        *
-       * @return               A decoded bitmap data with the specified destination width and height
+       * @return               The decoded bitmap data with the specified destination width and height
        * @param[in]    srcImagePath                    The local file path of the image file to open
        * @param[in]    pixelFormat                             The output pixel format defined by Tizen::Graphics::BitmapPixelFormat
        * @param[in]    destWidth                               The intended width of the image
        * @param[in]    destHeight                              The intended height of the image
        * @exception    E_SUCCESS                               The method is successful.
-       * @exception    E_INVALID_ARG                   The specified pixel format is not supported.
+       * @exception    E_INVALID_ARG                   The specified @c pixelFormat is not supported.
        * @exception    E_INVALID_DATA                  The specified input instance has invalid data.
        * @exception    E_UNSUPPORTED_FORMAT    The specified format is not supported.
        * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
        * @exception    E_FILE_NOT_FOUND                The specified file cannot be found or accessed.
        * @remarks
        *                         - The specific error code can be accessed using the GetLastResult() method.
-       *                         - There is a high probability for an occurrence of an out-of-memory exception. If possible, check whether the exception is @c E_OUT_OF_MEMORY or not.
-       *                           For more information on how to handle the out-of-memory exception, refer <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/exception_check.htm">here</a>.
-       *                         - This method returns an auto-scaled bitmap to support logical coordinate system, so the actual dimension of the returned bitmap can vary depending on the physical dimension of the target device.
+       *                         - There is a high probability for an occurrence of an out-of-memory exception. If possible, check whether the exception is @c E_OUT_OF_MEMORY 
+       *                       or not. For more information on how to handle the out-of-memory exception, 
+       *                       refer <a href="../org.tizen.native.appprogramming/html/basics_tizen_programming/exception_check.htm">here</a>.
+       *                         - This method returns an auto-scaled bitmap to support the logical coordinate system, so the actual dimension of the returned bitmap can 
+       *                         vary depending on the physical dimension of the target device.
        */
        Tizen::Graphics::Bitmap* DecodeN(const Tizen::Base::String& srcImagePath, Tizen::Graphics::BitmapPixelFormat pixelFormat, float destWidth, float destHeight) const;
 
        /**
-       * Decodes an image data into the decoded bitmap as per the specified width and height. @n
+       * Decodes the image data into the decoded bitmap as per the specified width and height. @n
        * The currently supported decoding formats are JPEG, GIF, PNG, BMP, TIFF, and WBMP. @n
        * The %DecodeUrl() method retains the aspect ratio of the original image. @n
-       * It supports only the downscaling of an image.
+       * It supports only the downscaling of the image.
        *
        * @since                2.0
        *
@@ -330,11 +334,11 @@ public:
        *                                                                       Set to @c TIMEOUT_INFINITE to make the @c timeout period infinite.
        * @exception    E_SUCCESS                       The method is successful.
        * @exception    E_INVALID_DATA          The specified input instance has invalid data.
-       * @exception    E_INVALID_ARG           The specified pixel format is not supported.
-       * @exception    E_OUT_OF_RANGE          The specified size is out of range.
+       * @exception    E_INVALID_ARG           The specified @c pixelFormat is not supported.
+       * @exception    E_OUT_OF_RANGE          The specified size is out of the valid range.
        * @exception    E_OUT_OF_MEMORY         The memory is insufficient.
        * @exception    E_NETWORK_FAILED        The network is unavailable.
-       * @exception    E_MAX_EXCEEDED          The number of concurrent accesses to the URLs has reached the maximum limit.
+       * @exception    E_MAX_EXCEEDED          The number of concurrent accesses to the URLs have reached the maximum limit.
        * @remarks
        *                         - The maximum limit for downloading is @c 3.
        *                         - The supported protocol is HTTP.
@@ -342,40 +346,40 @@ public:
        result DecodeUrl(const Tizen::Base::Utility::Uri& srcImageUrl, Tizen::Graphics::BitmapPixelFormat pixelFormat, int destWidth, int destHeight, RequestId& reqId, const IImageDecodeUrlEventListener& listener, long timeout) const;
 
        /**
-       * Decodes an image data into the decoded bitmap container without resizing. @n
+       * Decodes the image data into the decoded bitmap container without resizing. @n
        * The currently supported decoding formats are JPEG, GIF, PNG, BMP, TIFF, and WBMP. @n
        * The %DecodeN() method retains the aspect ratio of the original image.
        *
        * @since                2.0
        *
-       * @return               A decoded bitmap data that has not been resized
+       * @return               The decoded bitmap data that has not been resized
        * @param[in]    srcImageBuf                             The data to decode
        * @param[in]    srcImageFormat                  The image format of the input file
        * @param[in]    pixelFormat                             The output pixel format defined by Tizen::Graphics::BitmapPixelFormat
        * @exception    E_SUCCESS                               The method is successful.
        * @exception    E_INVALID_DATA                  The specified input instance has invalid data.
-       * @exception    E_INVALID_ARG                   The specified pixel format is not supported.
+       * @exception    E_INVALID_ARG                   The specified @c pixelFormat is not supported.
        * @exception    E_OVERFLOW                              The specified input instance has overflowed.
        * @exception    E_UNSUPPORTED_FORMAT    The specified format is not supported.
        * @exception    E_OBJ_NOT_FOUND                 The specified image buffer cannot be found.
        * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
        * @remarks
-       *                         - @c E_OUT_OF_MEMORY is returned if the memory is not available when decoding a large image.
+       *                         - @c E_OUT_OF_MEMORY is returned if there is no available memory for decoding a large image.
        *                         - The specific error code can be accessed using the GetLastResult() method.
        *                         - This method returns an auto-scaled bitmap, @n
-       *                           so the dimension can be different from the dimension of source image if the returned bitmap is locked.
+       *                         so the dimension can be different from the dimension of the source image if the returned bitmap is locked.
        */
        Tizen::Graphics::Bitmap* DecodeN(const Tizen::Base::ByteBuffer& srcImageBuf, ImageFormat srcImageFormat, Tizen::Graphics::BitmapPixelFormat pixelFormat) const;
 
        /**
-       * Decodes an image data into the decoded bitmap container after resizing it as per the specified width and height. @n
+       * Decodes the image data into the decoded bitmap container after resizing it as per the specified width and height. @n
        * The currently supported decoding formats are JPEG, GIF, PNG, BMP, TIFF, and WBMP. @n
        * The %DecodeN() method retains the aspect ratio of the original image. @n
-       * It supports only the downscaling of an image.
+       * It supports only the downscaling of the image.
        *
        * @since                2.0
        *
-       * @return               A decoded bitmap data with the specified destination width and height
+       * @return               The decoded bitmap data with the specified destination width and height
        * @param[in]    srcImageBuf                             The data to decode
        * @param[in]    srcImageFormat                  The image format of the input file
        * @param[in]    pixelFormat                             The output pixel format defined by Tizen::Graphics::BitmapPixelFormat
@@ -384,27 +388,27 @@ public:
        * @param[in]    destHeight                              The intended height of the image @n
        *                                                                               An exception is returned if the value is less than @c 0.
        * @exception    E_SUCCESS                               The method is successful.
-       * @exception    E_INVALID_ARG                   The specified pixel format is not supported.
+       * @exception    E_INVALID_ARG                   The specified @c pixelFormat is not supported.
        * @exception    E_INVALID_DATA                  The specified input instance has invalid data.
        * @exception    E_OVERFLOW                              The specified input instance has overflowed.
        * @exception    E_UNSUPPORTED_FORMAT    The specified format is not supported.
        * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
        * @exception    E_OBJ_NOT_FOUND                 The specified image buffer cannot be found.
-       * @exception    E_OUT_OF_RANGE                  The specified size is out of range.
+       * @exception    E_OUT_OF_RANGE                  The specified size is out of the valid range.
        * @remarks
        *                         - The specific error code can be accessed using the GetLastResult() method.
        *                         - This method returns an auto-scaled bitmap, @n
-       *                           so the dimension can be different from the requested dimension if the returned bitmap is locked.
+       *                         so the dimension can be different from the requested dimension if the returned bitmap is locked.
        */
        Tizen::Graphics::Bitmap* DecodeN(const Tizen::Base::ByteBuffer& srcImageBuf, ImageFormat srcImageFormat, Tizen::Graphics::BitmapPixelFormat pixelFormat, int destWidth, int destHeight) const;
 
        /**
-       * Encodes the specified bitmap data into a byte buffer. @n
+       * Encodes the specified bitmap data into the byte buffer. @n
        * The currently supported encoding formats are JPEG, BMP, and PNG.
        *
        * @since                2.0
        *
-       * @return               A byte buffer containing encoded image data
+       * @return               The byte buffer that contains the encoded image data
        * @param[in]    srcBitmap                               The bitmap data to encode
        * @param[in]    destImageFormat                 The intended image format
        * @exception    E_SUCCESS                               The method is successful.
@@ -414,8 +418,8 @@ public:
        * @exception    E_OBJ_NOT_FOUND                 The specified bitmap data cannot be found.
        * @remarks
        *                         - The specific error code can be accessed using the GetLastResult() method.
-       *                         - This method uses raw RGB data from locked bitmap, @n
-       *                           so the dimension of encoded data can be different from the dimension of source bitmap if the bitmap is auto-scaled.
+       *                         - This method uses the raw RGB data from the locked bitmap, @n
+       *                         so the dimension of the encoded data can be different from the dimension of the source bitmap if the bitmap is auto-scaled.
        */
        Tizen::Base::ByteBuffer* EncodeToBufferN(const Tizen::Graphics::Bitmap& srcBitmap, ImageFormat destImageFormat) const;
 
@@ -424,7 +428,7 @@ public:
        * The currently supported encoding formats are JPEG, BMP, and PNG.
        *
        * @if OSPCOMPAT
-       * @brief <i> [Compatibility] </i>
+       * @brief                <i> [Compatibility] </i>
        * @endif
        * @since                2.0
        * @if OSPCOMPAT
@@ -435,11 +439,11 @@ public:
        * @return               An error code
        * @param[in]    srcBitmap                               The bitmap data to encode
        * @param[in]    destImageFormat                 The intended image format
-       * @param[in]    destImagePath                   The intended name of encoded image file @n
-       *                                                                       The available paths start with prefixes retrieved from the functions such as: @n
-       *                                                                       Tizen::App::App::GetInstance()->GetAppRootPath() @n
-       *                                                                       Tizen::System::Environment::GetMediaPath() @n
-       *                                                                       Tizen::System::Environment::GetExternalStoragePath()
+       * @param[in]    destImagePath                   The intended name of the encoded image file @n
+       *                                                                               The available paths start with the prefixes retrieved from the functions such as: @n
+       *                                                                               Tizen::App::App::GetInstance()->GetAppRootPath() @n
+       *                                                                               Tizen::System::Environment::GetMediaPath() @n
+       *                                                                               Tizen::System::Environment::GetExternalStoragePath().
        * @param[in]    overwrite                               Set to @c true to overwrite the file, @n
        *                                                                               else @c false
        * @exception    E_SUCCESS                               The method is successful.
@@ -453,15 +457,15 @@ public:
        * @exception    E_STORAGE_FULL          The storage is full.
        * @remarks
        *                         - The specific error code can be accessed using the GetLastResult() method.
-       *                         - The application should use Tizen::Content::ContentManager::CreateContent() to register the created file into the Contents database.
-       *                         - This method uses raw RGB data from locked bitmap, @n
-       *                           so the dimension of encoded data can be different from the dimension of source bitmap if the bitmap is auto-scaled.
+       *                         - The application should use the Tizen::Content::ContentManager::CreateContent() method to register the created file into the Contents database.
+       *                         - This method uses the raw RGB data from the locked bitmap, @n
+       *                         so the dimension of the encoded data can be different from the dimension of the source bitmap if the bitmap is auto-scaled.
        */
        result EncodeToFile(const Tizen::Graphics::Bitmap& srcBitmap, ImageFormat destImageFormat, const Tizen::Base::String& destImagePath, bool overwrite) const;
 
        /**
        * Converts the image file to the specified image format. @n
-       * This is a synchronous method. The converting formats currently supported are JPEG, BMP, and PNG.
+       * This is a synchronous method. The currently supported converting formats are JPEG, BMP, and PNG.
        *
        * @if OSPCOMPAT
        * @brief <i> [Compatibility] </i>
@@ -472,7 +476,7 @@ public:
        *                                       For more information, see @ref CompIoPathPage "here".
        * @endif
        *
-       * @return               The byte buffer containing image data
+       * @return               The byte buffer that contains the image data
        * @param[in]    srcImagePath                    The local file path of the image file to open
        * @param[in]    destImageFormat                 The intended image format
        * @exception    E_SUCCESS                               The method is successful.
@@ -486,13 +490,12 @@ public:
        Tizen::Base::ByteBuffer* ConvertN(const Tizen::Base::String& srcImagePath, ImageFormat destImageFormat) const;
 
        /**
-       * @{
-       * @if OSPDEPREC
-       * Compresses an encoded image file to reduce its size as per the specified limit. @n
+       * @cond OSPDEPREC
+       * Compresses the encoded image file to reduce its size as per the specified limit. @n
        * The only supported compression format is JPEG.
        *
        * @if OSPCOMPAT
-       * @brief <i> [Deprecated] [Compatibility] </i>
+       * @brief           <i> [Deprecated] [Compatibility] </i>
        * @deprecated  This method is deprecated.
        * @endif
        * @since                2.0
@@ -504,40 +507,38 @@ public:
        * @return               An error code
        * @param[in]    srcImagePath                    The local file path of the image file to open
        * @param[in]    destImagePath                   The destination file path @n
-       *                                                                               If the file already exists, it is overwritten. @n
-       *                                                                               The available paths start with prefix such as: @n
+       *                                                                               If the file already exists, it is overwritten @n
+       *                                                                               The available paths start with the prefixes retrieved from the functions such as: @n
        *                                                                               Tizen::App::App::GetInstance()->GetAppRootPath() @n
        *                                                                               Tizen::System::Environment::GetMediaPath() @n
-       *                                                                               Tizen::System::Environment::GetExternalStoragePath()
+       *                                                                               Tizen::System::Environment::GetExternalStoragePath().
        * @param[in]    limitSize                               The maximum compressed data size in bytes @n
-       *                                                                               If the data size is too small, the width and height of the original
-       *                                                                               image can be reduced. @n The size must be less than the original size
-       *                                                                               and greater than @c 1024 byte.
+       *                                                                               If the data size is too small, the width and the height of the original image can be reduced @n 
+       *                                                                               The size must be less than the original size and greater than @c 1024 bytes.
        * @exception    E_SUCCESS                               The method is successful.
        * @exception    E_OVERFLOW                              The specified input instance has overflowed.
        * @exception    E_OUT_OF_MEMORY                 The memory is insufficient.
        * @exception    E_FILE_NOT_FOUND                The specified file cannot be found or accessed.
        * @exception    E_UNSUPPORTED_FORMAT    The specified format is not supported.
        * @exception    E_SYSTEM                                A system error has occurred.
-       * @exception    E_STORAGE_FULL          The file cannot be created because the file has reached its size limit.
-       * @exception    E_OUT_OF_RANGE                  The specified size is out of range.
-       * @endif
-       * @}
+       * @exception    E_STORAGE_FULL          The file cannot be created as it has reached the maximum size limit.
+       * @exception    E_OUT_OF_RANGE                  The specified size is out of the valid range.
+       * @endcond
        */
        result CompressJpeg(const Tizen::Base::String& srcImagePath, const Tizen::Base::String& destImagePath, int limitSize) const;
 
        /**
        * @if OSPDEPREC
-       * Compresses an encoded image data to the byte buffer to reduce its data size as per the specified limit. @n
+       * Compresses the encoded image data into the byte buffer to reduce its data size as per the specified limit. @n
        * The only supported compression format is JPEG.
        *
-       * @brief <i> [Deprecated] </i>
+       * @brief           <i> [Deprecated] </i>
        * @deprecated  This method is deprecated.
        * @since                2.0
        *
-       * @return               A byte buffer containing the compressed image data as per the specified size
+       * @return               The byte buffer that contains the compressed image data as per the specified size
        * @param[in]    srcImageBuf                             The encoded image source in the byte buffer
-       * @param[in]    limitSize                               The limit size to compress in bytes @n
+       * @param[in]    limitSize                               The size limit within which to compress in bytes @n
        *                                                                               The size must be less than the original size and greater than @c 1024 bytes.
        * @exception    E_SUCCESS                               The method is successful.
        * @exception    E_OVERFLOW                              The specified input instance has overflowed.
@@ -545,26 +546,26 @@ public:
        * @exception    E_UNSUPPORTED_FORMAT    The specified format is not supported.
        * @exception    E_OBJ_NOT_FOUND                 The specified image buffer cannot be found.
        * @exception    E_SYSTEM                                A system error has occurred.
-       * @exception    E_OUT_OF_RANGE                  The specified size is out of range.
+       * @exception    E_OUT_OF_RANGE                  The specified size is out of the valid range.
        * @remarks              The specific error code can be accessed using the GetLastResult() method.
        * @endif
        */
        Tizen::Base::ByteBuffer* CompressJpegN(const Tizen::Base::ByteBuffer& srcImageBuf, int limitSize) const;
 
        /**
-       * Decodes an image data into the decoded byte buffer container without resizing. @n
+       * Decodes the image data into the decoded byte buffer container without resizing. @n
        * The currently supported decoding formats are JPEG, GIF, PNG, BMP, TIFF, and WBMP.
        *
        * @since                2.0
        *
-       * @return               A decoded byte data that is not resized, @n
+       * @return               The decoded byte data that is not resized, @n
        *                               else @c null if an exception occurs
        * @param[in]    srcImageBuf                             The data to decode
        * @param[in]    srcImageFormat                  The image format of the input data
        * @param[in]    pixelFormat                             The output pixel format defined by Tizen::Graphics::BitmapPixelFormat
-       * @param[out]   imageWidth                      The original width of the image @n
+       * @param[out]   imageWidth                              The original width of the image @n
        *                                                                               An exception is returned if the value is less than @c 0.
-       * @param[out]   imageHeight                     The original height of the image @n
+       * @param[out]   imageHeight                             The original height of the image @n
        *                                                                               An exception is returned if the value is less than @c 0.
        * @exception    E_SUCCESS                               The method is successful.
        * @exception    E_INVALID_ARG                   The specified color format is not supported.
@@ -578,11 +579,11 @@ public:
        Tizen::Base::ByteBuffer* DecodeToBufferN(const Tizen::Base::ByteBuffer& srcImageBuf, ImageFormat srcImageFormat, Tizen::Graphics::BitmapPixelFormat pixelFormat, int& imageWidth, int& imageHeight) const;
 
        /**
-       * Decodes an image file into the decoded byte buffer container without resizing. @n
+       * Decodes the image file into the decoded byte buffer container without resizing. @n
        * The currently supported decoding formats are JPEG, GIF, PNG, BMP, TIFF, and WBMP.
        *
        * @if OSPCOMPAT
-       * @brief <i> [Compatibility] </i>
+       * @brief                <i> [Compatibility] </i>
        * @endif
        * @since                2.0
        * @if OSPCOMPAT
@@ -590,13 +591,13 @@ public:
        *                                       For more information, see @ref CompIoPathPage "here".
        * @endif
        *
-       * @return               A decoded byte data that is not resized, @n
+       * @return               The decoded byte data that is not resized, @n
        *                               else @c null if an exception occurs
        * @param[in]    srcImagePath                    The local file path of the image file to decode
        * @param[in]    pixelFormat                             The output pixel format defined by Tizen::Graphics::BitmapPixelFormat
-       * @param[out]   imageWidth                      The original width of the image @n
+       * @param[out]   imageWidth                              The original width of the image @n
        *                                                                               An exception is returned if the value is less than @c 0.
-       * @param[out]   imageHeight                     The original height of the image @n
+       * @param[out]   imageHeight                             The original height of the image @n
        *                                                                               An exception is returned if the value is less than @c 0.
        * @exception    E_SUCCESS                               The method is successful.
        * @exception    E_INVALID_ARG                   The specified color format is not supported.
@@ -621,7 +622,7 @@ public:
        * Gets the format of the image in the specified file.
        *
        * @if OSPCOMPAT
-       * @brief <i> [Compatibility] </i>
+       * @brief                <i> [Compatibility] </i>
        * @endif
        * @since                2.0
        * @if OSPCOMPAT
@@ -640,12 +641,12 @@ public:
        Tizen::Media::ImageFormat GetImageFormat(const Tizen::Base::String& srcImagePath) const;
 
        /**
-       * Gets the image format from an image buffer.
+       * Gets the image format from the image buffer.
        *
        * @since                2.0
        *
        * @return               The format of the image
-       * @param[in]    srcImageBuf                             The Tizen::Base::ByteBuffer containing the image data
+       * @param[in]    srcImageBuf                             The Tizen::Base::ByteBuffer that contains the image data
        * @exception    E_SUCCESS                               The method is successful.
        * @exception    E_UNSUPPORTED_FORMAT    The specified format is not supported.
        * @exception    E_OBJ_NOT_FOUND                 The specified image buffer cannot be found.
@@ -659,7 +660,7 @@ public:
        * Currently only 32-bit PNG images are supported.
        *
        * @if OSPCOMPAT
-       * @brief <i> [Compatibility] </i>
+       * @brief                <i> [Compatibility] </i>
        * @endif
        * @since                2.0
        * @if OSPCOMPAT
@@ -687,7 +688,7 @@ public:
        *
        * @return               @c true if the image has alpha channels, @n
        *                               else @c false
-       * @param[in]    srcImageBuf                             The Tizen::Base::ByteBuffer containing the image data
+       * @param[in]    srcImageBuf                             The Tizen::Base::ByteBuffer that contains the image data
        * @exception    E_SUCCESS                               The method is successful.
        * @exception    E_UNSUPPORTED_FORMAT    The specified format is not supported.
        * @exception    E_OBJ_NOT_FOUND                 The specified image buffer cannot be found.