Functions
Functions to manipulate subsurfaces.

Functions to manipulate wayland subsurfaces, using Ecore_Wl_Subsurf. More...

Functions

EAPI Ecore_Wl_Subsurfecore_wl_subsurf_create (Ecore_Wl_Window *win)
 Creates and returns a new subsurface. More...
 
EAPI void ecore_wl_subsurf_del (Ecore_Wl_Subsurf *ess)
 Destroys the given subsurface, as well as the surface associated with it. More...
 
EAPI struct wl_surface * ecore_wl_subsurf_surface_get (Ecore_Wl_Subsurf *ess)
 Gets the wl_surface for this subsurface. More...
 
EAPI void ecore_wl_subsurf_position_set (Ecore_Wl_Subsurf *ess, int x, int y)
 Sets the position of this subsurface, relative to its parent surface. More...
 
EAPI void ecore_wl_subsurf_position_get (Ecore_Wl_Subsurf *ess, int *x, int *y)
 Gets the position of this subsurface, relative to its parent surface. More...
 
EAPI void ecore_wl_subsurf_place_above (Ecore_Wl_Subsurf *ess, struct wl_surface *surface)
 Places subsurface on layer above a reference surface. More...
 
EAPI void ecore_wl_subsurf_place_below (Ecore_Wl_Subsurf *ess, struct wl_surface *surface)
 Places subsurface on layer below a reference surface. More...
 
EAPI void ecore_wl_subsurf_sync_set (Ecore_Wl_Subsurf *ess, Eina_Bool val)
 Enables or disables sub-surface synchronization. More...
 
EAPI void ecore_wl_subsurf_opaque_region_set (Ecore_Wl_Subsurf *ess, int x, int y, int w, int h)
 Sets an opaque region for the given subsurface. More...
 

Detailed Description

Functions to manipulate wayland subsurfaces, using Ecore_Wl_Subsurf.

This API is intended to expose Wayland subsurface functionality, although it should not be necessary for most applications to use it, as soon as we have means to make Evas automatically switch Evas images to use subsurfaces.

It can/should be used, for instance, when subsurfaces are needed to be not in sync with the main window surface.

Function Documentation

◆ ecore_wl_subsurf_create()

EAPI Ecore_Wl_Subsurf * ecore_wl_subsurf_create ( Ecore_Wl_Window win)

Creates and returns a new subsurface.

Create a new surface (and subsurface interface), with the parent surface being the one associated with the given win.

win must be visible, otherwise there will be no surface created for it yet.

Parameters
winThe window
Returns
the allocated and initialized Ecore_Wl_Subsurf object, or NULL on failure
Since
1.8

References eina_inlist_append(), and EINA_INLIST_GET.

◆ ecore_wl_subsurf_del()

EAPI void ecore_wl_subsurf_del ( Ecore_Wl_Subsurf ess)

Destroys the given subsurface, as well as the surface associated with it.

Parameters
essthe subsurface
Since
1.8

◆ ecore_wl_subsurf_surface_get()

EAPI struct wl_surface * ecore_wl_subsurf_surface_get ( Ecore_Wl_Subsurf ess)

Gets the wl_surface for this subsurface.

Parameters
essthe subsurface
Returns
the wl_surface associated with this subsurface, or NULL on failure
Since
1.8

◆ ecore_wl_subsurf_position_set()

EAPI void ecore_wl_subsurf_position_set ( Ecore_Wl_Subsurf ess,
int  x,
int  y 
)

Sets the position of this subsurface, relative to its parent surface.

If ess is defined and the x, y coordinates differ from the currently tracked position, this also schedules a sub-surface position change.

Parameters
essthe subsurface
xcoordinate in the parent surface
ycoordinate in the parent surface
Since
1.8

◆ ecore_wl_subsurf_position_get()

EAPI void ecore_wl_subsurf_position_get ( Ecore_Wl_Subsurf ess,
int *  x,
int *  y 
)

Gets the position of this subsurface, relative to its parent surface.

Coordinates will be returned in x and y if non-NULL.

Parameters
essthe subsurface
xcoordinate in the parent surface, or NULL to ignore
ycoordinate in the parent surface, or NULL to ignore
Since
1.8

◆ ecore_wl_subsurf_place_above()

EAPI void ecore_wl_subsurf_place_above ( Ecore_Wl_Subsurf ess,
struct wl_surface *  surface 
)

Places subsurface on layer above a reference surface.

Moves the ess subsurface to just above the reference surface, changing the z-order. The reference surface must be either a sibling or parent surface, else a protocol error will be generated.

Parameters
essthe subsurface
surfacethe sibling reference surface
Since
1.8

◆ ecore_wl_subsurf_place_below()

EAPI void ecore_wl_subsurf_place_below ( Ecore_Wl_Subsurf ess,
struct wl_surface *  surface 
)

Places subsurface on layer below a reference surface.

See ecore_wl_subsurf_place_above.

Parameters
essthe subsurface
surfacethe sibling reference surface
Since
1.8

◆ ecore_wl_subsurf_sync_set()

EAPI void ecore_wl_subsurf_sync_set ( Ecore_Wl_Subsurf ess,
Eina_Bool  val 
)

Enables or disables sub-surface synchronization.

When synchronization is enabled, surface commits on the subsurface will be cached and only applied when the parent surface's state is applied. This ensures atomic updates of the parent and all of its synchronized sub-surfaces.

When synchronization is disabled, commits will apply to the pending state directly without caching, just like a normal wl_surface. If there are already cached events when this is set, those events are applied simultaneously with the desync event.

Attempting to enable synchronization when the subsurface already thinks it's sync'd, or desync when it believes its desync'd, will be trivially ignored and will not generate a Wayland event.

See Wayland's set_desync documentation for further details and exceptional cases.

Parameters
essthe subsurface
valtrue to enable synchronization, false to desynchronize
Since
1.8

◆ ecore_wl_subsurf_opaque_region_set()

EAPI void ecore_wl_subsurf_opaque_region_set ( Ecore_Wl_Subsurf ess,
int  x,
int  y,
int  w,
int  h 
)

Sets an opaque region for the given subsurface.

This is an optimization hint to the compositor to allow it avoid redrawing content unnecessarily. Note that marking transparent content as opaque will cause repaint artifacts.

Use a 0x0 region size to unset the opaque region.

Parameters
essthe subsurface
xcoordinate in the parent surface
ycoordinate in the parent surface
wwidth to set as opaque
hheight to set as opaque
Since
1.8