</copyright>
<description summary="surface blur">
- This protocol allows clients to have more control over blurring background
- of surface.
+ This protocol allows clients to have more control over blurring
+ a surface background and behind.
</description>
<interface name="wtz_blur_manager" version="1">
</request>
<request name="get_blur">
- <description summary="create a blur object for a surface">
- Create a blur object for a surface.
+ <description summary="create a blur object for a surface background">
+ Create a blur object for a surface background.
If the wl_surface already has a blur object associated, the
blur_exists protocol error is raised.
<arg name="surface" type="object" interface="wl_surface"
summary="the surface to associate the blur object to"/>
</request>
+
+ <request name="get_blur_behind">
+ <description summary="create a blur object for a surface behind">
+ Create a blur behind object for a surface behind.
+
+ If the wl_surface already has a blur behind object associated, the
+ blur_exists protocol error is raised.
+ </description>
+ <arg name="id" type="new_id" interface="wtz_blur_behind"
+ summary="the new blur behind object"/>
+ <arg name="surface" type="object" interface="wl_surface"
+ summary="the surface to associate the blur behind object to"/>
+ </request>
</interface>
<interface name="wtz_blur" version="1">
<description summary="advanced surface blurring">
- A surface extension interface for setting a blurring background
- to the surface.
+ A surface extension interface for setting a blurring to a surface
+ background.
Use of this interface has no effect on the surface's opaque region
as set by wl_surface.set_opaque_region.
</request>
</interface>
+ <interface name="wtz_blur_behind" version="1">
+ <description summary="advanced surface blurring">
+ A surface extension interface for setting a fullscreen blurring to
+ a surface behind.
+
+ Use of this interface has no effect on the surface's opaque region
+ as set by wl_surface.set_opaque_region.
+
+ If the wl_surface associated with the wtz_blur_behind is destroyed,
+ the wtz_blur object becomes inert.
+ </description>
+
+ <request name="destroy" type="destructor">
+ <description summary="destroy the blur object">
+ Destroy the blur object.
+
+ On the next wl_surface.commit, the blur object state is withdrawn.
+ </description>
+ </request>
+
+ <request name="set_radius">
+ <description summary="set the blur radius">
+ Set the blur radius for compositing a surface behind.
+
+ The blur radius is double-buffered state, and will be applied on
+ the next wl_surface.commit.
+
+ The initial value for an blur radius is zero. That means a blurring
+ behind will be disabled.
+ </description>
+ <arg name="radius" type="uint" summary="blur radius"/>
+ </request>
+ </interface>
+
</protocol>