Deprecate all Image classes 13/131113/4
authorAdeel Kazmi <adeel.kazmi@samsung.com>
Thu, 25 May 2017 10:58:30 +0000 (11:58 +0100)
committerAdeel Kazmi <adeel.kazmi@samsung.com>
Thu, 25 May 2017 11:10:01 +0000 (11:10 +0000)
Change-Id: I399ca4be69c53e991825bbcafc1d3150fc2db235

dali/public-api/images/buffer-image.h
dali/public-api/images/encoded-buffer-image.h
dali/public-api/images/frame-buffer-image.h
dali/public-api/images/image.h
dali/public-api/images/native-image.h
dali/public-api/images/resource-image.h

index c2fad52..cc0280a 100644 (file)
@@ -2,7 +2,7 @@
 #define __DALI_BUFFER_IMAGE_H__
 
 /*
- * Copyright (c) 2015 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2017 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.
@@ -40,6 +40,8 @@ typedef Rect<unsigned int>    RectArea;     ///< rectangular area (x,y,w,h) @SIN
 
 
 /**
+ * @DEPRECATED_1_2.41
+ *
  * @brief BufferImage represents an image resource as a pixel data buffer.
  *
  * Its pixel buffer data is provided by the application developer.
@@ -53,15 +55,20 @@ typedef Rect<unsigned int>    RectArea;     ///< rectangular area (x,y,w,h) @SIN
 class DALI_IMPORT_API BufferImage : public Image
 {
 public:
+
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Constructor which creates an uninitialized BufferImage object.
    *
    * Use BufferImage::New(...) to create an initialized object.
    * @SINCE_1_0.0
    */
-  BufferImage();
+  BufferImage() DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Creates a new BufferImage.
    *
    * Also a pixel buffer for image data is allocated.
@@ -79,9 +86,11 @@ public:
    */
   static BufferImage New(unsigned int width,
                          unsigned int height,
-                         Pixel::Format pixelformat=Pixel::RGBA8888);
+                         Pixel::Format pixelformat=Pixel::RGBA8888) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Creates a new BufferImage, which uses an external data source.
    *
    * The PixelBuffer has to be allocated by application.
@@ -107,9 +116,11 @@ public:
                          unsigned int  width,
                          unsigned int  height,
                          Pixel::Format pixelFormat=Pixel::RGBA8888,
-                         unsigned int  stride=0);
+                         unsigned int  stride=0) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Downcasts a handle to BufferImage handle.
    *
    * If the handle points to a BufferImage, the downcast produces valid handle.
@@ -119,44 +130,55 @@ public:
    * @param[in] handle Handle to an object
    * @return Handle to a BufferImage or an uninitialized handle
    */
-  static BufferImage DownCast( BaseHandle handle );
+  static BufferImage DownCast( BaseHandle handle ) DALI_DEPRECATED_API;
 
   /**
+   * @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
    */
-  ~BufferImage();
+  ~BufferImage() 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
    */
-  BufferImage(const BufferImage& handle);
+  BufferImage(const BufferImage& 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
    * @return A reference to this
    */
-  BufferImage& operator=(const BufferImage& rhs);
+  BufferImage& operator=(const BufferImage& rhs) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief White pixel as image data.
    *
    * Can be used to create solid color actors.
    * @SINCE_1_0.0
    * @return 1 white pixel with 32 bit colordepth
    */
-  static const BufferImage WHITE();
+  static const BufferImage WHITE() DALI_DEPRECATED_API;
 
 public:
+
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Returns the pixel buffer of the Image.
    *
    * The application can write to the buffer to modify its contents.
@@ -168,33 +190,41 @@ public:
    * @SINCE_1_0.0
    * @return The pixel buffer
    */
-  PixelBuffer* GetBuffer();
+  PixelBuffer* GetBuffer() DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Returns buffer size in bytes.
    *
    * @SINCE_1_0.0
    * @return The buffer size in bytes
    */
-  unsigned int GetBufferSize() const;
+  unsigned int GetBufferSize() const DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Returns buffer stride (in bytes).
    *
    * @SINCE_1_0.0
    * @return The buffer stride
    */
-  unsigned int GetBufferStride() const;
+  unsigned int GetBufferStride() const DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Returns the pixel format of the contained buffer
    *
    * @SINCE_1_0.0
    * @return The pixel format
    */
-  Pixel::Format GetPixelFormat() const;
+  Pixel::Format GetPixelFormat() const DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Inform Dali that the contents of the buffer have changed.
    *
    * Image::UploadedSignal will be sent in response if the image is on stage
@@ -211,15 +241,19 @@ public:
    * @note Some GPUs may not support Non power of two buffer updates (for
    * example C110/SGX540)
    */
-  void Update();
+  void Update() DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @copydoc Update()
    * @param[in] updateArea Area that has changed in buffer
    */
-  void Update( RectArea updateArea );
+  void Update( RectArea updateArea ) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Returns whether BufferImage uses external data source or not.
    *
    * If not, dali holds ownership of the PixelBuffer, otherwise the application
@@ -231,7 +265,7 @@ public:
    * @SINCE_1_0.0
    * @return @c true if application owns data, @c false otherwise
    */
-  bool IsDataExternal() const;
+  bool IsDataExternal() const DALI_DEPRECATED_API;
 
 public: // Not intended for application developers
 
index 8a5a769..86489fe 100644 (file)
@@ -2,7 +2,7 @@
 #define __DALI_ENCODED_BUFFER_IMAGE_H__
 
 /*
- * Copyright (c) 2015 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2017 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.
@@ -42,6 +42,8 @@ typedef Uint16Pair ImageDimensions;
 
 
 /**
+ * @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
@@ -69,15 +71,20 @@ typedef Uint16Pair ImageDimensions;
 class DALI_IMPORT_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_2.41
+   *
    * @brief Creates an initialized image object from an encoded image buffer in memory.
    *
    * @SINCE_1_0.0
@@ -90,9 +97,11 @@ public:
    * by encodedImage.
    * @return A handle to a newly allocated object
    */
-  static EncodedBufferImage New( const uint8_t * const encodedImage, std::size_t encodedImageByteCount );
+  static EncodedBufferImage New( const uint8_t * const encodedImage, std::size_t encodedImageByteCount ) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Creates an initialized image object from an encoded image buffer in memory.
    *
    * @SINCE_1_1.4
@@ -111,9 +120,11 @@ public:
    * 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;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Downcasts a handle to EncodedBufferImage handle.
    *
    * If handle points to a EncodedBufferImage, the
@@ -122,32 +133,38 @@ public:
    * @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;
 
   /**
+   * @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
    */
-  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
    * @return A reference to this
    */
-  EncodedBufferImage& operator=(const EncodedBufferImage& rhs);
+  EncodedBufferImage& operator=(const EncodedBufferImage& rhs) DALI_DEPRECATED_API;
 
 public: // Not intended for application developers
 
index f2bce32..0249e8f 100644 (file)
@@ -2,7 +2,7 @@
 #define __DALI_FRAME_BUFFER_IMAGE_H__
 
 /*
- * Copyright (c) 2015 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2017 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.
@@ -54,6 +54,8 @@ enum Format ///< Framebuffer format, default color depth is RGBA 32 bit with alp
 }
 
 /**
+ * @DEPRECATED_1_2.41
+ *
  * @brief FrameBufferImage represents an Open GL ES Frame Buffer Object and contains the result
  * of an 'off screen' render pass of a RenderTask.
  *
@@ -63,15 +65,20 @@ enum Format ///< Framebuffer format, default color depth is RGBA 32 bit with alp
 class DALI_IMPORT_API FrameBufferImage : public Image
 {
 public:
+
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Constructor which creates an uninitialized FrameBufferImage object.
    *
    * Use @ref FrameBufferImage::New to create an initialized object.
    * @SINCE_1_0.0
    */
-  FrameBufferImage();
+  FrameBufferImage() DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Creates a new FrameBufferImage.
    *
    * The maximum size of the image is limited by GL_MAX_TEXTURE_SIZE.
@@ -85,9 +92,11 @@ public:
    * @post When the FrameBufferImage is first used as a render target, an exception may be thrown if pixelFormat is not supported on the hardware platform.
    */
   static FrameBufferImage New(unsigned int width = 0, unsigned int height = 0, Pixel::Format pixelFormat = Pixel::RGBA8888,
-                              RenderBuffer::Format bufferFormat = RenderBuffer::COLOR);
+                              RenderBuffer::Format bufferFormat = RenderBuffer::COLOR) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Creates a new FrameBufferImage.
    *
    * The maximum size of the image is limited by GL_MAX_TEXTURE_SIZE.
@@ -97,9 +106,11 @@ public:
    * @return A handle to a new instance of a FrameBufferImage
    * @post When the FrameBufferImage is first used as a render target, an exception may be thrown if the NativeImage cannot be mapped to a texture.
    */
-  static FrameBufferImage New(NativeImageInterface& image);
+  static FrameBufferImage New(NativeImageInterface& image) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Downcasts a handle to FrameBufferImage handle.
    *
    * If handle points to a FrameBufferImage object, the
@@ -108,32 +119,38 @@ public:
    * @param[in] handle Handle to an object
    * @return Handle to a FrameBufferImage object or an uninitialized handle
    */
-  static FrameBufferImage DownCast( BaseHandle handle );
+  static FrameBufferImage DownCast( BaseHandle handle ) DALI_DEPRECATED_API;
 
   /**
+   * @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
    */
-  ~FrameBufferImage();
+  ~FrameBufferImage() 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
    */
-  FrameBufferImage(const FrameBufferImage& handle);
+  FrameBufferImage(const FrameBufferImage& 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
    * @return A reference to this
    */
-  FrameBufferImage& operator=(const FrameBufferImage& rhs);
+  FrameBufferImage& operator=(const FrameBufferImage& rhs) DALI_DEPRECATED_API;
 
 public: // Not intended for application developers
 
index a0e3da6..608a5bb 100644 (file)
@@ -2,7 +2,7 @@
 #define __DALI_IMAGE_H__
 
 /*
- * Copyright (c) 2015 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2017 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.
@@ -38,6 +38,8 @@ class Image;
 }
 
 /**
+ * @DEPRECATED_1_2.41
+ *
  * @brief An Image object represents an image resource that can be used for rendering.
  *
  * Image objects can be shared between Actors. This is practical if you have a visual element on screen
@@ -60,6 +62,8 @@ class DALI_IMPORT_API Image : public BaseHandle
 public:
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Type of signal for Image Uploaded.
    * @SINCE_1_0.0
    */
@@ -68,6 +72,8 @@ public:
 public:
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Constructor which creates an empty Image handle.
    *
    * This class has no New method.
@@ -76,34 +82,42 @@ public:
    * Dali::NativeImage::New(), Dali::ResourceImage::New()).
    * @SINCE_1_0.0
    */
-  Image();
+  Image() DALI_DEPRECATED_API;
 
   /**
+   * @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
    */
-  ~Image();
+  ~Image() 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
    */
-  Image(const Image& handle);
+  Image(const Image& 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
    * @return A reference to this
    */
-  Image& operator=(const Image& rhs);
+  Image& operator=(const Image& rhs) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Downcasts a handle to Image handle.
    *
    * If handle points to a Image object, the
@@ -112,9 +126,11 @@ public:
    * @param[in] handle Handle to an object
    * @return Handle to a Image object or an uninitialized handle
    */
-  static Image DownCast( BaseHandle handle );
+  static Image DownCast( BaseHandle handle ) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Returns the width of the image.
    *
    * Returns either the requested width or the actual loaded width if no specific size was requested.
@@ -122,9 +138,11 @@ public:
    * @SINCE_1_0.0
    * @return Width of the image in pixels
    */
-  unsigned int GetWidth() const;
+  unsigned int GetWidth() const DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Returns the height of the image.
    *
    * Returns either the requested height or the actual loaded height if no specific size was requested.
@@ -132,11 +150,13 @@ public:
    * @SINCE_1_0.0
    * @return Height of the image in pixels
    */
-  unsigned int GetHeight() const;
+  unsigned int GetHeight() const DALI_DEPRECATED_API;
 
 public: // Signals
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief This signal is emitted when the image data gets uploaded to GL.
    *
    * It Will be sent after an actor using the image is added to
@@ -145,7 +165,7 @@ public: // Signals
    * @SINCE_1_0.0
    * @return A signal object to Connect() with
    */
-  ImageSignalType& UploadedSignal();
+  ImageSignalType& UploadedSignal() DALI_DEPRECATED_API;
 
 public: // Not intended for application developers
 
index 3a28aff..819cab0 100644 (file)
@@ -2,7 +2,7 @@
 #define __DALI_NATIVE_IMAGE_H__
 
 /*
- * Copyright (c) 2015 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2017 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.
@@ -35,6 +35,8 @@ class NativeImage;
 }
 
 /**
+ * @DEPRECATED_1_2.41
+ *
  * @brief NativeImage represents a platform specific image resource.
  *
  * Its data is provided by native resources, such as shared bitmap memory or pixmap.
@@ -45,39 +47,49 @@ class DALI_IMPORT_API  NativeImage : public Image
 public:
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Constructor with creates an uninitialized NativeImage object.
    *
    * Use NativeImage::New(...) to create an initialised object.
    * @SINCE_1_0.0
    */
-  NativeImage();
+  NativeImage() DALI_DEPRECATED_API;
 
   /**
+   * @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
    */
-   ~NativeImage();
+   ~NativeImage() DALI_DEPRECATED_API;
 
-   /**
-    * @brief This copy constructor is required for (smart) pointer semantics.
-    *
-    * @SINCE_1_0.0
-    * @param[in] handle A reference to the copied handle
-    */
-   NativeImage( const NativeImage& handle );
+  /**
+   * @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
+   */
+  NativeImage( const NativeImage& 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
    * @return A reference to this
    */
-  NativeImage& operator=( const NativeImage& rhs );
+  NativeImage& operator=( const NativeImage& rhs ) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Triggers asynchronous creation of backing GL texture immediately.
    *
    * The normal policy is for a GL texture to created lazily when needed.
@@ -89,9 +101,11 @@ public:
    * GL textures. This function can be called again after context regain to force
    * the creation of the GL texture if still needed.
    */
-  void CreateGlTexture();
+  void CreateGlTexture() DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Creates a new NativeImage, which used native resources.
    *
    * The maximum size of the image is limited by GL_MAX_TEXTURE_SIZE
@@ -99,9 +113,11 @@ public:
    * @param[in] nativeImageInterface An reference to the object of the interface implementation
    * @return A handle to a newly allocated object
    */
-  static NativeImage New( NativeImageInterface& nativeImageInterface );
+  static NativeImage New( NativeImageInterface& nativeImageInterface ) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Downcasts a handle to NativeImage handle.
    *
    * If handle points to a NativeImage object, the downcast produces valid handle.
@@ -110,25 +126,29 @@ public:
    * @param[in] handle Handle to an object
    * @return handle to a NativeImage or an uninitialized handle
    */
-  static NativeImage DownCast( BaseHandle handle );
+  static NativeImage DownCast( BaseHandle handle ) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Gets custom fragment prefix for rendering a native image.
    *
    * @return String for custom fragment prefix
    */
-  const char* GetCustomFragmentPreFix();
+  const char* GetCustomFragmentPreFix() DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Gets custom sampler type name for rendering a native image.
    *
    * @return String for custom sampler type name
    */
-  const char* GetCustomSamplerTypename();
+  const char* GetCustomSamplerTypename() DALI_DEPRECATED_API;
 
 public: // Not intended for application developers
 
-  explicit DALI_INTERNAL NativeImage( Internal::NativeImage* );
+  explicit DALI_INTERNAL NativeImage( Internal::NativeImage* ) DALI_DEPRECATED_API;
 
 };
 
index 2573a31..dae5411 100644 (file)
@@ -2,7 +2,7 @@
 #define __DALI_RESOURCE_IMAGE_H__
 
 /*
- * Copyright (c) 2015 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2017 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.
@@ -40,6 +40,8 @@ class ResourceImage;
 }
 
 /**
+ * @DEPRECATED_1_2.41
+ *
  * @brief ResourceImage is an image loaded using a URL.
  *
  * <i>Customizing load requests</i>
@@ -63,6 +65,8 @@ class DALI_IMPORT_API ResourceImage : public Image
 public:
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Type of signal for LoadingFinished and Uploaded.
    * @SINCE_1_0.0
    */
@@ -71,6 +75,8 @@ public:
 public:
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Gets the size of an image from disk.
    *
    * This function will read the header info from file on disk and is
@@ -82,40 +88,48 @@ public:
    * @param[in] url The URL of the image file
    * @return The width and height in pixels of the image
    */
-  static ImageDimensions GetImageSize( const std::string& url );
+  static ImageDimensions GetImageSize( const std::string& url ) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Constructor which creates an empty ResourceImage object.
    *
    * Use ResourceImage::New(...) to create an initialised object.
    * @SINCE_1_0.0
    */
-  ResourceImage();
+  ResourceImage() DALI_DEPRECATED_API;
 
   /**
+   * @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
    */
-  ~ResourceImage();
+  ~ResourceImage() 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
    */
-  ResourceImage( const ResourceImage& handle );
+  ResourceImage( const ResourceImage& 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
    * @return A reference to this
    */
-  ResourceImage& operator=( const ResourceImage& rhs );
+  ResourceImage& operator=( const ResourceImage& rhs ) DALI_DEPRECATED_API;
 
   /**
    * @name ResourceImageFactoryFunctions
@@ -124,6 +138,8 @@ public:
   ///@{
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Creates an initialized ResourceImage object.
    *
    * Uses defaults for all options.
@@ -136,9 +152,11 @@ public:
    * @param[in] orientationCorrection Reorient the image to respect any orientation metadata in its header
    * @return A handle to a newly allocated object
    */
-  static ResourceImage New( const std::string& url, bool orientationCorrection = true );
+  static ResourceImage New( const std::string& url, bool orientationCorrection = true ) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Creates an initialized ResourceImage object.
    *
    * @SINCE_1_0.0
@@ -155,11 +173,13 @@ public:
                             ImageDimensions size,
                             FittingMode::Type fittingMode = FittingMode::DEFAULT,
                             SamplingMode::Type samplingMode = SamplingMode::DEFAULT,
-                            bool orientationCorrection = true );
+                            bool orientationCorrection = true ) DALI_DEPRECATED_API;
 
   ///@}
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Downcasts a handle to ResourceImage handle.
    *
    * If handle points to a ResourceImage object, the
@@ -168,9 +188,11 @@ public:
    * @param[in] handle Handle to an object
    * @return Handle to a Image object or an uninitialized handle
    */
-  static ResourceImage DownCast( BaseHandle handle );
+  static ResourceImage DownCast( BaseHandle handle ) DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Queries whether the image data has loaded.
    *
    * The asynchronous loading begins when the Image object is created.
@@ -178,17 +200,21 @@ public:
    * @SINCE_1_0.0
    * @return The loading state, either Loading, Success or Failed
    */
-  LoadingState GetLoadingState() const;
+  LoadingState GetLoadingState() const DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Returns the URL of the image.
    *
    * @SINCE_1_0.0
    * @return The URL of the image file
    */
-  std::string GetUrl() const;
+  std::string GetUrl() const DALI_DEPRECATED_API;
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Reloads image from filesystem.
    *
    * The original set of image loading attributes (requested dimensions, scaling
@@ -196,17 +222,19 @@ public:
    * @SINCE_1_0.0
    * @note If image is offstage and OnDemand policy is set, the reload request is ignored.
    */
-  void Reload();
+  void Reload() DALI_DEPRECATED_API;
 
 public: // Signals
 
   /**
+   * @DEPRECATED_1_2.41
+   *
    * @brief Emitted when the image data loads successfully, or when the loading fails.
    *
    * @SINCE_1_0.0
    * @return A signal object to Connect() with
    */
-  ResourceImageSignal& LoadingFinishedSignal();
+  ResourceImageSignal& LoadingFinishedSignal() DALI_DEPRECATED_API;
 
 public: // Not intended for application developers