Image

../_images/image-preview.png

Widget description

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.

Emitted signals

  • 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)

Enumerations

Image manipulation types

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)

Inheritance diagram