}
/**
- * @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.
*
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.
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.