An Elementary image object allows one to load and display an image file on it, be it from a disk file or from a memory region.
Exceptionally, one may also load an Edje group as the contents of the image. In this case, though, most of the functions of the image API will act as a no-op.
One can tune various properties of the image, like:
pre-scaling,
smooth scaling,
orientation,
aspect ratio during resizes, etc.
An image object may also be made valid source and destination for drag
and drop actions by setting editable
.
drop
- This is called when a user has dropped an image
typed object onto the object in question – the
event info argument is the path to that image file
clicked
- This is called when a user has clicked the image
download,start
- remote url download has started
download,progress
- url download in progress
download,end
- remote url download has finished
download,error
- remote url download has finished with errors
load,open
- Triggered when the file has been opened, if async open is
enabled (image size is known). (since 1.19)
load,ready
- Triggered when the image file is ready for display, if
preload is enabled. (since 1.19)
load,error
- Triggered if an async I/O or decoding error occurred, if
async open or preload is enabled (since 1.19)
load,cancel
- Triggered whenener async I/O was cancelled. (since 1.19)
efl.elementary.
ELM_IMAGE_ORIENT_NONE
¶No orientation change
efl.elementary.
ELM_IMAGE_ORIENT_0
¶No orientation change
efl.elementary.
ELM_IMAGE_ROTATE_90
¶Rotate 90 degrees clockwise
efl.elementary.
ELM_IMAGE_ROTATE_180
¶Rotate 180 degrees clockwise
efl.elementary.
ELM_IMAGE_ROTATE_270
¶Rotate 270 degrees clockwise
efl.elementary.
ELM_IMAGE_FLIP_HORIZONTAL
¶Flip the image horizontally
efl.elementary.
ELM_IMAGE_FLIP_VERTICAL
¶Flip the image vertically
efl.elementary.
ELM_IMAGE_FLIP_TRANSPOSE
¶Flip the image along the y = (width - x) line (bottom-left to top-right)
efl.elementary.
ELM_IMAGE_FLIP_TRANSVERSE
¶Flip the image along the y = x line (top-left to bottom-right)
efl.elementary.
Image
(Object parent, *args, **kwargs)¶parent (efl.evas.Object
) – The parent object
**kwargs – All the remaining keyword arguments are interpreted as properties of the instance