[3.0] Remove/move experimental features
[platform/core/uifw/dali-core.git] / dali / public-api / images / image.h
index 9adf2cd..0ba35a6 100644 (file)
@@ -38,11 +38,12 @@ class Image;
 }
 
 /**
- * @brief An Image object represents an image resource that can be added to ImageViews.
+ * @brief An Image object represents an image resource that can be used for rendering.
  *
- * Image objects can be shared between ImageViews. This is practical if you have a visual element on screen
- * which is repeatedly used. An example would be a button background image.
- * The image resource is discarded when all ImageViews using the Image object are discarded.
+ * Image objects can be shared between Actors. This is practical if you have a visual element on screen
+ * which is repeatedly used.
+ *
+ * The image resource is released as soon as the last Image handle is released.
  * @SINCE_1_0.0
  * @note If a resource was shared between Image objects it exists until its last reference is gone.
  *
@@ -57,22 +58,6 @@ class Image;
 class DALI_IMPORT_API Image : public BaseHandle
 {
 public:
-  /**
-   * @brief Resource management options.
-   */
-
-  /**
-   * @DEPRECATED_1_1.3. Image resource is released as soon as last handle is released.
-   * @brief ReleasePolicy controls the way images are deleted from memory.
-   * @SINCE_1_0.0
-   * @remarks This is an experimental feature and might not be supported in the next release.
-   * We do recommend not to use it.
-   */
-  enum ReleasePolicy
-  {
-    UNUSED, ///< release resource once image is not in use anymore (eg. all actors using it become offstage). Reload when resource is required again. @SINCE_1_0.0
-    NEVER   ///< keep image data for the lifetime of the object. (default) @SINCE_1_0.0
-  };
 
   /**
    * @brief Type of signal for Image Uploaded.
@@ -127,18 +112,6 @@ public:
   static Image DownCast( BaseHandle handle );
 
   /**
-   * @DEPRECATED_1_1.3
-   *
-   * @brief Return resource release policy.
-   *
-   * @SINCE_1_0.0
-   * @remarks This is an experimental feature and might not be supported in the next release.
-   * We do recommend not to use it.
-   * @return Resource release policy
-   */
-  ReleasePolicy GetReleasePolicy() const;
-
-  /**
    * @brief Returns the width of the image.
    *
    * Returns either the requested width or the actual loaded width if no specific size was requested.