From: Changyeon Lee <cyeon.lee@samsung.com>
Date: Fri, 14 Jul 2023 07:18:07 +0000 (+0900)
Subject: wtz-blender: add set_equation
X-Git-Tag: accepted/tizen/unified/20230718.162204~2
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=refs%2Fchanges%2F29%2F295829%2F2;p=platform%2Fcore%2Fuifw%2Fwayland-extension.git

wtz-blender: add set_equation

Change-Id: I6f9e71f7ad905b62d82544dd4f1a0d3c0481aede
---

diff --git a/protocol/tizen/wtz-blender.xml b/protocol/tizen/wtz-blender.xml
index fbe94eb..2e2e091 100644
--- a/protocol/tizen/wtz-blender.xml
+++ b/protocol/tizen/wtz-blender.xml
@@ -29,7 +29,7 @@
 
   <description summary="surface blending">
     This protocol allows clients to have more control over alpha compositing
-    of surface contents.
+    and blending of surface contents.
   </description>
 
   <interface name="wtz_blender" version="1">
@@ -64,8 +64,8 @@
 
   <interface name="wtz_blend" version="1">
     <description summary="advanced surface blending">
-      A surface extension interface for setting a global alpha value applied
-      to the whole surface.
+      A surface extension interface for setting a blending equation and
+      a global alpha value applied to the whole surface.
 
       When the blend object is created its its alpha value is UINT32_MAX
       (ie, opaque).
@@ -78,6 +78,10 @@
       the wtz_blend object becomes inert.
     </description>
 
+    <enum name="error">
+      <entry name="invalid_equation" value="0" summary="invalid blending equation"/>
+    </enum>
+
     <request name="destroy" type="destructor">
       <description summary="destroy the blend object">
         Destroy the blend object.
@@ -86,6 +90,16 @@
       </description>
     </request>
 
+    <enum name="equation">
+      <description summary="blending equations">
+        Blending equations that can be used when compositing a surface.
+
+        By default, "premultiplied" is used.
+      </description>
+      <entry name="premultiplied" value="0" summary="(one, one_minus_src_alpha)"/>
+      <entry name="none" value="1" summary="(one, zero)"/>
+    </enum>
+
     <request name="set_alpha">
       <description summary="set the alpha value">
         Set the alpha value applied to the whole surface for compositing. This
@@ -99,6 +113,19 @@
       </description>
       <arg name="value" type="uint" summary="alpha value"/>
     </request>
+
+    <request name="set_equation">
+      <description summary="set the blending equation">
+        Set the blending equation for compositing the surface.
+
+        If the blending equation is invalid, the invalid_equation protocol
+        error is raised.
+
+        The blending equation is double-buffered state, and will be applied on
+        the next wl_surface.commit.
+      </description>
+      <arg name="equation" type="uint" enum="equation" summary="blending equation"/>
+    </request>
   </interface>
 
 </protocol>