From: Changyeon Lee <cyeon.lee@samsung.com>
Date: Tue, 20 Aug 2024 03:11:19 +0000 (+0900)
Subject: wtz-blur: Add wtz_blur_behid
X-Git-Tag: accepted/tizen/unified/20240828.164016~1
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=23e3e5cb6fd6fdaf38cb43751a5344182953f8b6;p=platform%2Fcore%2Fuifw%2Fwayland-extension.git

wtz-blur: Add wtz_blur_behid

Change-Id: Ieba8e0385c133b6d6862c4c74b1f5e42fbe0ff99
---

diff --git a/protocol/tizen/wtz-blur.xml b/protocol/tizen/wtz-blur.xml
index 4dd6392..062620c 100644
--- a/protocol/tizen/wtz-blur.xml
+++ b/protocol/tizen/wtz-blur.xml
@@ -25,8 +25,8 @@
   </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">
@@ -46,8 +46,8 @@
     </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.
@@ -57,12 +57,25 @@
       <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.
@@ -149,4 +162,38 @@
     </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>