Plug

Widget Description

An object that allows one to show an image which other process created. It can be used anywhere like any other elementary widget.

Emitted signals

  • clicked - the user clicked the image (press/release).

  • image,deleted - the server side was deleted.

  • image,resized - the server side was resized. The event_info parameter of the callback will be Evas_Coord_Size (two integers).

Note

the event “image,resized” will be sent whenever the server resized its image and this always happen on the first time. Then it can be used to track when the server-side image is fully known (client connected to server, retrieved its image buffer through shared memory and resized the evas object).

Inheritance diagram

Inheritance diagram of Plug
class efl.elementary.Plug(Object parent, *args, **kwargs)

Bases: efl.elementary.__init__.Object

An object that allows one to show an image which other process created. It can be used anywhere like any other elementary widget.

Parameters
  • parent (efl.evas.Object) – The parent object

  • **kwargs – All the remaining keyword arguments are interpreted as properties of the instance

callback_clicked_add(func, *args, **kwargs)

the user clicked the image (press/release).

callback_clicked_del(func)
callback_image_deleted_add(func, *args, **kwargs)

the server side was deleted.

callback_image_deleted_del(func)
connect(svcname, svcnum, svcsys)

Connect a plug widget to service provided by socket image.

Parameters
  • svcname (string) – The service name to connect to set up by the socket.

  • svcnum (int) – The service number to connect to (set up by socket).

  • svcsys (bool) – Boolean to set if the service is a system one or not (set up by socket).

Raises

RuntimeError – on failure

Changed in version 1.8: Raises RuntimeError if adding the child fails

image_object

Get the basic Image object from this object (widget).

This function allows one to get the underlying Object of type Image from this elementary widget. It can be useful to do things like get the pixel data, save the image to a file, etc.

Note

Be careful to not manipulate it, as it is under control of elementary.

Type

Image