#define __DALI_ENCODED_BUFFER_IMAGE_H__
/*
- * Copyright (c) 2015 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2018 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.
*
*/
-// EXTERNAL INCLUDES
-#include <stdint.h>
-
// INTERNAL INCLUDES
#include <dali/public-api/images/image.h>
#include <dali/public-api/images/image-operations.h>
/**
+ * @DEPRECATED_1_2.41
+ *
* @brief EncodedBufferImage represents an image resource as a buffer of encoded pixel data.
*
* A memory buffer of encoded image data is provided by the application and
* uploaded to the OpenGL ES implementation.
* @SINCE_1_0.0
*/
-class DALI_IMPORT_API EncodedBufferImage : public Image
+class DALI_CORE_API EncodedBufferImage : public Image
{
public:
+
/**
+ * @DEPRECATED_1_2.41
+ *
* @brief Constructor which creates an uninitialized EncodedBufferImage object.
*
* Use @ref EncodedBufferImage::New to create an initialised object.
* @SINCE_1_0.0
*/
- EncodedBufferImage();
+ EncodedBufferImage() DALI_DEPRECATED_API;
/**
- * @DEPRECATED_1_1.3. Use New(const uint8_t* const, std::size_t,ImageDimensions,FittingMode::Type,SamplingMode::Type,bool) instead.
+ * @DEPRECATED_1_2.41
*
- * @brief Create an initialised image object from an encoded image buffer in memory.
+ * @brief Creates an initialized image object from an encoded image buffer in memory.
*
* @SINCE_1_0.0
- * @remarks Image::ReleasePolicy is an experimental feature and might not be supported in the next release.
- * We do recommend not to use this method.
- * Please refer the remarks of ReleasePolicy for more information.
- * @param [in] encodedImage The encoded bytes of an image, in a supported
+ * @param[in] encodedImage The encoded bytes of an image, in a supported
* image format such as PNG, JPEG, GIF, BMP, KTX, ICO, and WBMP, organised
* exactly as it would be as a file in the filesystem.
* The caller retains ownership of this buffer and is free to modify or
- * discard it as soon as the function returns.
- * @param [in] encodedImageByteCount The size in bytes of the buffer pointed to
+ * discard it as soon as the function returns
+ * @param[in] encodedImageByteCount The size in bytes of the buffer pointed to
* by encodedImage.
- * @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] samplingMode The filtering method used when sampling pixels from the input image while fitting it to desired size.
- * @param [in] releasePol The releasePolicy to apply to Image. The default value is Image::NEVER.
- * @param [in] orientationCorrection Reorient the image to respect any orientation metadata in its header.
- * policy is set, a reload will not be possible, so the Image should never be
- * used once all actors using it have gone off-stage.
- * @return A handle to a newly allocated object.
+ * @return A handle to a newly allocated object
*/
- static EncodedBufferImage New( const uint8_t * const encodedImage, std::size_t encodedImageByteCount, ImageDimensions size, FittingMode::Type fittingMode, SamplingMode::Type samplingMode, ReleasePolicy releasePol, bool orientationCorrection = true );
+ static EncodedBufferImage New( const uint8_t * const encodedImage, std::size_t encodedImageByteCount ) DALI_DEPRECATED_API;
/**
- * @brief Create an initialised image object from an encoded image buffer in memory.
+ * @DEPRECATED_1_2.41
*
- * @SINCE_1_0.0
- * @param [in] encodedImage The encoded bytes of an image, in a supported
- * image format such as PNG, JPEG, GIF, BMP, KTX, ICO, and WBMP, organised
- * exactly as it would be as a file in the filesystem.
- * The caller retains ownership of this buffer and is free to modify or
- * discard it as soon as the function returns.
- * @param [in] encodedImageByteCount The size in bytes of the buffer pointed to
- * by encodedImage.
- * @return A handle to a newly allocated object.
- */
- static EncodedBufferImage New( const uint8_t * const encodedImage, std::size_t encodedImageByteCount );
-
- /**
- * @brief Create an initialised image object from an encoded image buffer in memory.
+ * @brief Creates an initialized image object from an encoded image buffer in memory.
*
* @SINCE_1_1.4
- * @param [in] encodedImage The encoded bytes of an image, in a supported
+ * @param[in] encodedImage The encoded bytes of an image, in a supported
* image format such as PNG, JPEG, GIF, BMP, KTX, ICO, and WBMP, organised
* exactly as it would be as a file in the filesystem.
* The caller retains ownership of this buffer and is free to modify or
- * discard it as soon as the function returns.
- * @param [in] encodedImageByteCount The size in bytes of the buffer pointed to
- * by encodedImage.
- * @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] samplingMode The filtering method used when sampling pixels from the input image while fitting it to desired size.
- * @param [in] orientationCorrection Reorient the image to respect any orientation metadata in its header.
+ * discard it as soon as the function returns
+ * @param[in] encodedImageByteCount The size in bytes of the buffer pointed to
+ * by encodedImage
+ * @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] samplingMode The filtering method used when sampling pixels from the input image while fitting it to desired size
+ * @param[in] orientationCorrection Reorient the image to respect any orientation metadata in its header
* policy is set, a reload will not be possible, so the Image should never be
- * used once all actors using it have gone off-stage.
- * @return A handle to a newly allocated object.
+ * used once all actors using it have gone off-stage
+ * @return A handle to a newly allocated object
*/
- static EncodedBufferImage New( const uint8_t * const encodedImage, std::size_t encodedImageByteCount, ImageDimensions size, FittingMode::Type fittingMode, SamplingMode::Type samplingMode, bool orientationCorrection = true );
+ static EncodedBufferImage New( const uint8_t * const encodedImage, std::size_t encodedImageByteCount, ImageDimensions size, FittingMode::Type fittingMode, SamplingMode::Type samplingMode, bool orientationCorrection = true ) DALI_DEPRECATED_API;
/**
- * @brief Downcast a handle to EncodedBufferImage handle.
+ * @DEPRECATED_1_2.41
*
- * If handle points to a EncodedBufferImage the
- * downcast produces valid handle. If not the returned handle is left uninitialized.
+ * @brief Downcasts a handle to EncodedBufferImage handle.
+ *
+ * If handle points to a EncodedBufferImage, the
+ * downcast produces valid handle. If not, the returned handle is left uninitialized.
* @SINCE_1_0.0
* @param[in] handle Handle to an object
* @return Handle to a EncodedBufferImage or an uninitialized handle
*/
- static EncodedBufferImage DownCast( BaseHandle handle );
+ static EncodedBufferImage DownCast( BaseHandle handle ) DALI_DEPRECATED_API;
/**
- * @brief Destructor
+ * @DEPRECATED_1_2.41
+ *
+ * @brief Destructor.
*
* This is non-virtual since derived Handle types must not contain data or virtual methods.
* @SINCE_1_0.0
*/
- ~EncodedBufferImage();
+ ~EncodedBufferImage() DALI_DEPRECATED_API;
/**
+ * @DEPRECATED_1_2.41
+ *
* @brief This copy constructor is required for (smart) pointer semantics.
*
* @SINCE_1_0.0
- * @param [in] handle A reference to the copied handle
+ * @param[in] handle A reference to the copied handle
*/
- EncodedBufferImage(const EncodedBufferImage& handle);
+ EncodedBufferImage(const EncodedBufferImage& handle) DALI_DEPRECATED_API;
/**
+ * @DEPRECATED_1_2.41
+ *
* @brief This assignment operator is required for (smart) pointer semantics.
*
* @SINCE_1_0.0
- * @param [in] rhs A reference to the copied handle
+ * @param[in] rhs A reference to the copied handle
* @return A reference to this
*/
- EncodedBufferImage& operator=(const EncodedBufferImage& rhs);
+ EncodedBufferImage& operator=(const EncodedBufferImage& rhs) DALI_DEPRECATED_API;
public: // Not intended for application developers
projects / platform / core / uifw / dali-core.git / blobdiff