From e43bf9dadc713a004ed3daa2d41fc42ca4590622 Mon Sep 17 00:00:00 2001
From: Kun Zhang <zhangkun2@uniontech.com>
Date: Fri, 3 Jul 2026 10:37:04 +0800
Subject: [PATCH] feat(wallpaper): add shader source protocol
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Bump the wallpaper manager and notifier protocols to version 2 and add shader as a wallpaper source type. Add set_shader_source so clients can pass a precompiled shader wallpaper package to the compositor.

Log: 增加 shader 壁纸协议支持
---
 ...treeland-wallpaper-manager-unstable-v1.xml | 24 +++++++++++++++++--
 xml/treeland-wallpaper-shell-unstable-v1.xml  |  3 ++-
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/xml/treeland-wallpaper-manager-unstable-v1.xml b/xml/treeland-wallpaper-manager-unstable-v1.xml
index 0ed2ed7..aac96ae 100644
--- a/xml/treeland-wallpaper-manager-unstable-v1.xml
+++ b/xml/treeland-wallpaper-manager-unstable-v1.xml
@@ -5,7 +5,7 @@
     SPDX-License-Identifier: MIT
     ]]></copyright>
 
-    <interface name="treeland_wallpaper_manager_v1" version="1">
+    <interface name="treeland_wallpaper_manager_v1" version="2">
         <description summary="Wallpaper manager interface">
             The treeland_wallpaper_manager_v1 interface is a global object used to
             create wallpaper objects for specific outputs.
@@ -46,7 +46,7 @@
         </request>
     </interface>
 
-    <interface name="treeland_wallpaper_v1" version="1">
+    <interface name="treeland_wallpaper_v1" version="2">
         <description summary="Wallpaper object interface for setting and managing wallpaper content">
             The treeland_wallpaper_v1 interface represents a wallpaper instance
             created by the compositor for a specific output, role.
@@ -69,6 +69,7 @@
         <enum name="wallpaper_source_type">
             <entry name="image" value="0" summary="The wallpaper source is an image"/>
             <entry name="video" value="1" summary="The wallpaper source is a video"/>
+            <entry name="shader" value="2" summary="The wallpaper source is a shader package"/>
         </enum>
 
         <enum name="wallpaper_role">
@@ -183,5 +184,24 @@
             <arg name="file_source" type="string"
                 summary="The file path of the current wallpaper source"/>
         </event>
+
+        <request name="set_shader_source" since="2">
+            <description summary="Set a shader wallpaper source">
+                Sets a shader package as the wallpaper source, apply to the current
+                wl_output and the active workspace. except for lockscreen
+                wallpapers, only one wallpaper can be set per wl_output.
+
+                The source must identify a package directory prepared by the client
+                or system wallpaper importer. The package is expected to contain
+                precompiled shader data that the wallpaper renderer can load without
+                compiling shader source during wallpaper activation.
+
+                If the shader package cannot be opened, validated, or rendered, a
+                failed event will be emitted.
+            </description>
+            <arg name="file_source" type="string"
+                summary="Path to the shader package directory to be used as the wallpaper"/>
+            <arg name="role" type="uint" summary="wallpaper role"/>
+        </request>
     </interface>
 </protocol>
diff --git a/xml/treeland-wallpaper-shell-unstable-v1.xml b/xml/treeland-wallpaper-shell-unstable-v1.xml
index 0e38afd..67ecdf8 100644
--- a/xml/treeland-wallpaper-shell-unstable-v1.xml
+++ b/xml/treeland-wallpaper-shell-unstable-v1.xml
@@ -5,7 +5,7 @@
     SPDX-License-Identifier: MIT
     ]]></copyright>
 
-    <interface name="treeland_wallpaper_notifier_v1" version="1">
+    <interface name="treeland_wallpaper_notifier_v1" version="2">
         <description summary="Notification interface for wallpaper source changes">
             The treeland_wallpaper_notifier_v1 interface provides notifications
             about the availability and lifetime of wallpaper sources managed by
@@ -19,6 +19,7 @@
         <enum name="wallpaper_source_type">
             <entry name="image" value="0" summary="The wallpaper source is an image"/>
             <entry name="video" value="1" summary="The wallpaper source is a video"/>
+            <entry name="shader" value="2" summary="The wallpaper source is a shader package"/>
         </enum>
 
         <request name="destroy" type="destructor">