Functions
Wayland Library Display Functions

Functions that deal with creating, connecting, or interacting with Wayland displays. More...

Functions

EAPI Ecore_Wl2_Display * ecore_wl2_display_create (const char *name)
 Create a new Wayland display. More...
 
EAPI void ecore_wl2_display_destroy (Ecore_Wl2_Display *display)
 Destroy an existing Wayland display. More...
 
EAPI Ecore_Wl2_Display * ecore_wl2_display_connect (const char *name)
 Connect to an existing Wayland display. More...
 
EAPI void ecore_wl2_display_disconnect (Ecore_Wl2_Display *display)
 Disconnect an existing Wayland display. More...
 
EAPI void ecore_wl2_display_terminate (Ecore_Wl2_Display *display)
 Terminate a Wayland display's main loop. More...
 
EAPI struct wl_display * ecore_wl2_display_get (Ecore_Wl2_Display *display)
 Retrieve the existing Wayland display. More...
 
EAPI struct wl_shm * ecore_wl2_display_shm_get (Ecore_Wl2_Display *display)
 Retrieve the wl_shm from a given Ecore_Wl2_Display. More...
 
EAPI void * ecore_wl2_display_dmabuf_get (Ecore_Wl2_Display *display)
 Retrieve the wl_dmabuf from a given Ecore_Wl2_Display. More...
 
EAPI Eina_Iteratorecore_wl2_display_globals_get (Ecore_Wl2_Display *display)
 Return an Eina_Iterator that can be used to iterate through globals. More...
 
EAPI void ecore_wl2_display_screen_size_get (Ecore_Wl2_Display *display, int *w, int *h)
 Retrieves the size of the current screen. More...
 
EAPI Ecore_Wl2_Window * ecore_wl2_display_window_find (Ecore_Wl2_Display *display, unsigned int id)
 Find an Ecore_Wl2_Window based on id. More...
 
EAPI struct wl_registry * ecore_wl2_display_registry_get (Ecore_Wl2_Display *display)
 Retrieves the Wayland Registry used for the current Wayland display. More...
 
EAPI int ecore_wl2_display_compositor_version_get (Ecore_Wl2_Display *disp)
 Return the version of the display's compositor object. More...
 

Detailed Description

Functions that deal with creating, connecting, or interacting with Wayland displays.

Function Documentation

§ ecore_wl2_display_create()

EAPI Ecore_Wl2_Display* ecore_wl2_display_create ( const char *  name)

Create a new Wayland display.

This function is typically used to create a new display for use with compositors, or to create a new display for use in nested compositors.

Parameters
nameThe display target name to create. If NULL, a default display name will be assigned.
Returns
The newly created Ecore_Wl2_Display
Since
1.17

References DBG, ECORE_FD_ERROR, ECORE_FD_READ, ecore_main_fd_handler_add(), ecore_main_fd_handler_prepare_callback_set(), EINA_FALSE, eina_hash_add(), eina_hash_find(), eina_hash_iterator_data_new(), eina_hash_population(), eina_hash_string_superfast_new(), eina_iterator_free(), eina_iterator_next(), EINA_TRUE, ERR, and setenv().

§ ecore_wl2_display_destroy()

EAPI void ecore_wl2_display_destroy ( Ecore_Wl2_Display *  display)

Destroy an existing Wayland display.

This function is typically used by servers to terminate an existing Wayland display.

Parameters
displayThe display to terminate
Since
1.17

§ ecore_wl2_display_connect()

EAPI Ecore_Wl2_Display* ecore_wl2_display_connect ( const char *  name)

Connect to an existing Wayland display.

This function is typically used by clients to connect to an existing Wayland display.

Parameters
nameThe display target name to connect to. If NULL, the default display is assumed.
Returns
The Ecore_Wl2_Display which was connected to
Since
1.17

References ecore_main_fd_handler_del(), eina_hash_add(), eina_hash_find(), eina_hash_free(), eina_hash_int32_new(), and eina_hash_string_superfast_new().

§ ecore_wl2_display_disconnect()

EAPI void ecore_wl2_display_disconnect ( Ecore_Wl2_Display *  display)

Disconnect an existing Wayland display.

This function is typically used by clients to disconnect from an existing Wayland display.

Parameters
displayThe display to disconnect from
Since
1.17

§ ecore_wl2_display_terminate()

EAPI void ecore_wl2_display_terminate ( Ecore_Wl2_Display *  display)

Terminate a Wayland display's main loop.

This function is typically used by servers to terminate the Wayland display main loop. This is usually only called when a server encounters an error.

Parameters
displayThe Ecore_Wl2_Display to terminate
Since
1.17

§ ecore_wl2_display_get()

EAPI struct wl_display* ecore_wl2_display_get ( Ecore_Wl2_Display *  display)

Retrieve the existing Wayland display.

Parameters
displayThe Ecore_Wl2_Display for which to retrieve the existing Wayland display from
Returns
The wl_display which this Ecore_Wl2_Display is using
Since
1.17

§ ecore_wl2_display_shm_get()

EAPI struct wl_shm* ecore_wl2_display_shm_get ( Ecore_Wl2_Display *  display)

Retrieve the wl_shm from a given Ecore_Wl2_Display.

Parameters
displayThe Ecore_Wl2_Display for which to retrieve the existing Wayland shm interface from
Returns
The wl_shm which this Ecore_Wl2_Display is using
Since
1.17

§ ecore_wl2_display_dmabuf_get()

EAPI void* ecore_wl2_display_dmabuf_get ( Ecore_Wl2_Display *  display)

Retrieve the wl_dmabuf from a given Ecore_Wl2_Display.

Parameters
displayThe Ecore_Wl2_Display for which to retrieve the existing Wayland dmabuf interface from
Returns
The wl_dmabuf which this Ecore_Wl2_Display is using
Note
This is intended for client use only and should be used only after ecore_wl2_display_connect(). Also, the return type is void * instead of zpw_linux_dmabuf_v1 * since we don't want to change our public API every time the version changes in wayland-protocols.
Since
1.18

§ ecore_wl2_display_globals_get()

EAPI Eina_Iterator* ecore_wl2_display_globals_get ( Ecore_Wl2_Display *  display)

Return an Eina_Iterator that can be used to iterate through globals.

Parameters
displayThe Ecore_Wl2_Display for which to return a global iterator
Note
The caller of this function should free the returned Eina_Iterator when finished with it.
Since
1.17

§ ecore_wl2_display_screen_size_get()

EAPI void ecore_wl2_display_screen_size_get ( Ecore_Wl2_Display *  display,
int *  w,
int *  h 
)

Retrieves the size of the current screen.

Parameters
displayThe display to get the screen size of
wwhere to return the width. May be NULL. Returns 0 on error.
hwhere to return the height. May be NULL. Returns 0 on error.
Since
1.17

§ ecore_wl2_display_window_find()

EAPI Ecore_Wl2_Window* ecore_wl2_display_window_find ( Ecore_Wl2_Display *  display,
unsigned int  id 
)

Find an Ecore_Wl2_Window based on id.

Parameters
displayThe display to search for the window
idThe id of the window to find
Returns
The Ecore_Wl2_Window if found, or NULL if no such window exists
Since
1.17

§ ecore_wl2_display_registry_get()

EAPI struct wl_registry* ecore_wl2_display_registry_get ( Ecore_Wl2_Display *  display)

Retrieves the Wayland Registry used for the current Wayland display.

Parameters
displayThe display to get the registry of
Returns
The current wayland registry, or NULL on error
Since
1.17

§ ecore_wl2_display_compositor_version_get()

EAPI int ecore_wl2_display_compositor_version_get ( Ecore_Wl2_Display *  disp)

Return the version of the display's compositor object.

Parameters
dispthe display to get the compositor object version from
Returns
the version of the display's compositor object
Since
1.17