feat: implement wallpaper management system

1. Add wallpaper configuration management with support for multiple
screens and workspaces
2. Implement TreelandWallpaperShellInterfaceV1 protocol for wallpaper
communication
3. Replace WallpaperController with new WallpaperItem component
4. Add wallpaper launcher for managing wallpaper processes
5. Support both desktop and lockscreen wallpapers with different roles
6. Add configuration persistence through DConfig
7. Implement wallpaper type detection (image/video)
8. Add workspace synchronization for wallpaper configuration

Log: Added advanced wallpaper management system with multi-screen and
workspace support

Influence:
1. Test wallpaper loading on different outputs and workspaces
2. Verify lockscreen wallpaper functionality
3. Test wallpaper configuration changes through DConfig
4. Check wallpaper process management and lifecycle
5. Verify wallpaper protocol communication
6. Test multi-user wallpaper scenarios
7. Validate workspace switching with wallpaper changes
8. Check error handling for invalid wallpaper files

Author: zzxyb

misc/dconfig/org.deepin.dde.treeland.user.json

@@ -442,6 +442,17 @@
             "description[zh_CN]": "多任务视图加载因子",
             "permissions": "readonly",
             "visibility": "private"
+        },
+        "wallpaperConfig": {
+            "value": "",
+            "serial": 0,
+            "flags": ["global"],
+            "name": "Wallpaper Config",
+            "name[zh_CN]": "壁纸配置",
+            "description": "A configuration to manage wallpapers used by the system, including desktop and lockscreen wallpapers for each screen and workspace.",
+            "description[zh_CN]": "用于管理系统当前使用的壁纸配置，包括每个屏幕和工作区的桌面壁纸和锁屏壁纸。",
+            "permissions": "readwrite",
+            "visibility": "public"
         }
     }
 }

misc/systemd/treeland.service.in

@@ -17,6 +17,7 @@ Environment=DSG_APP_ID=org.deepin.dde.treeland
 Environment=ASAN_SYMBOLIZER_PATH=/usr/bin/llvm-symbolizer
 # For Debug: if enable asan, you can't get it's log from journalctl, so ensure the log to a file
 Environment=ASAN_OPTIONS=log_path=/tmp/treeland-asan:detect_leaks=0:abort_on_error=1:symbolize=1
+Environment=DDM_DISPLAY_MANAGER=1
 ExecStart=@CMAKE_INSTALL_FULL_BINDIR@/treeland.sh --lockscreen
 Restart=on-failure
 RestartSec=1s

src/CMakeLists.txt

@@ -186,12 +186,16 @@ qt_add_qml_module(libtreeland
         utils/loginddbustypes.cpp
         utils/fpsdisplaymanager.cpp
         utils/fpsdisplaymanager.h
-        wallpaper/wallpapercontroller.cpp
-        wallpaper/wallpapercontroller.h
-        wallpaper/wallpaperimage.cpp
-        wallpaper/wallpaperimage.h
+        wallpaper/wallpapersurface.h
+        wallpaper/wallpapersurface.cpp
+        wallpaper/wallpaperitem.cpp
+        wallpaper/wallpaperitem.h
         wallpaper/wallpapermanager.cpp
         wallpaper/wallpapermanager.h
+        wallpaper/wallpaperconfig.h
+        wallpaper/wallpaperconfig.cpp
+        wallpaper/wallpaperlauncher.h
+        wallpaper/wallpaperlauncher.cpp
         workspace/workspace.cpp
         workspace/workspace.h
         workspace/workspaceanimationcontroller.cpp

src/core/qml/Effects/LaunchpadCover.qml

@@ -18,16 +18,15 @@ Item {
     z: (wrapper.z ?? 0) - 1
     anchors.fill: wrapper
 
-    WallpaperController {
-        id: wallpaperController
+    Wallpaper {
+        id: wallpaper
         output: root.output
-        lock: true
-        type: mapped ? WallpaperController.Scale : WallpaperController.Normal
+        workspace: Helper.workspace.current
     }
 
     ShaderEffectSource {
-        id: wallpaper
-        sourceItem: wallpaperController.proxy
+        id: wallpaperSource
+        sourceItem: wallpaper
         recursive: true
         live: true
         smooth: true
@@ -38,14 +37,14 @@ Item {
             State {
                 name: "Normal"
                 PropertyChanges {
-                    target: wallpaper
+                    target: wallpaperSource
                     scale: 1
                 }
             },
             State {
                 name: "Scale"
                 PropertyChanges {
-                    target: wallpaper
+                    target: wallpaperSource
                     scale: 1.4
                 }
             }
@@ -75,7 +74,7 @@ Item {
 
     Blur {
         anchors.fill: parent
-        z: wallpaper.z + 1
+        z: wallpaperSource.z + 1
     }
 
     Rectangle {
@@ -92,4 +91,8 @@ Item {
             easing.type: Easing.OutExpo
         }
     }
+
+    onMappedChanged: {
+        Helper.setLaunchpadMapped(root.output, root.mapped)
+    }
 }

src/core/qml/PrimaryOutput.qml

@@ -9,7 +9,6 @@ import Treeland
 OutputItem {
     id: rootOutputItem
     readonly property OutputViewport screenViewport: outputViewport
-    property alias wallpaperVisible: wallpaper.visible
     property bool forceSoftwareCursor: false
 
     devicePixelRatio: output?.scale ?? devicePixelRatio
@@ -102,8 +101,6 @@ OutputItem {
             output: rootOutputItem.output
             workspace: Helper.workspace.current
             anchors.fill: parent
-            fillMode: Image.PreserveAspectCrop
-            retainWhileLoading: true
             clip: true
 
             states: [
@@ -121,6 +118,13 @@ OutputItem {
                         scale: 1.4
                     }
                 },
+                State {
+                    name: "ScaleTo1.2"
+                    PropertyChanges {
+                        target: wallpaper
+                        scale: 1.2
+                    }
+                },
                 State {
                     name: "ScaleWithoutAnimation"
                     PropertyChanges {
@@ -149,6 +153,15 @@ OutputItem {
                         easing.type: Easing.OutExpo
                     }
                 },
+                Transition {
+                    from: "*"
+                    to: "ScaleTo1.2"
+                    PropertyAnimation {
+                        property: "scale"
+                        duration: 1000
+                        easing.type: Easing.OutExpo
+                    }
+                },
                 Transition {
                     from: "*"
                     to: "ScaleWithoutAnimation"
@@ -158,6 +171,32 @@ OutputItem {
                     }
                 }
             ]
+
+            Connections {
+                target: Helper
+                function onLaunchpadMappedChanged(output, mapped) {
+                    if (output !== rootOutputItem.output) {
+                        return;
+                    }
+
+                    wallpaper.state = mapped ? "Scale" : "Normal"
+                }
+
+                function onShowDesktopRequested(output) {
+                    if (output !== rootOutputItem.output) {
+                        return;
+                    }
+
+                    wallpaper.state = "Normal"
+                    wallpaper.play = true
+                    wallpaper.slowDown()
+                }
+
+                function onStartLockscreened(showAnimation) {
+                    wallpaper.play = false
+                    wallpaper.state = showAnimation ? "ScaleTo1.2" : "ScaleWithoutAnimation"
+                }
+            }
         }
     }
 

src/core/qml/WorkspaceSwitcher.qml

@@ -27,13 +27,6 @@ Item {
             width: output.outputItem.width
             height: output.outputItem.height
 
-            WallpaperController {
-                id: wpCtrl
-                output: animationDelegate.output.outputItem.output
-                type: WallpaperController.Normal
-                lock: true
-            }
-
             Row {
                 x: - Helper.workspace.animationController.viewportPos * animationDelegate.localAnimationScaleFactor
                 spacing: Helper.workspace.animationController.refGap * animationDelegate.localAnimationScaleFactor
@@ -44,12 +37,11 @@ Item {
                         height: animationDelegate.output.outputItem.height
                         id: workspaceDelegate
                         required property WorkspaceModel workspace
-                        ShaderEffectSource {
-                            id: wallpaperShot
-                            sourceItem: wpCtrl.proxy
-                            hideSource: false
-                            anchors.fill: parent
+                        Wallpaper {
+                            workspace: workspaceDelegate.workspace
+                            output: animationDelegate.output
                         }
+
                         WorkspaceProxy {
                             workspace: workspaceDelegate.workspace
                             output: animationDelegate.output

src/core/shellhandler.cpp

@@ -15,6 +15,8 @@
 #include "treelandconfig.hpp"
 #include "treelanduserconfig.hpp"
 #include "workspace/workspace.h"
+#include "session/session.h"
+#include "wallpapershellinterfacev1.h"
 
 #include <xcb/xcb.h>
 
@@ -248,6 +250,15 @@ void ShellHandler::initLayerShell(WServer *server)
     connect(m_layerShell, &WLayerShell::surfaceRemoved, this, &ShellHandler::onLayerSurfaceRemoved);
 }
 
+void ShellHandler::initWallpaperShell(Waylib::Server::WServer *server)
+{
+    Q_ASSERT_X(!m_wallpaperShell, Q_FUNC_INFO, "Only init once!");
+    m_wallpaperShell = server->attach<TreelandWallpaperShellInterfaceV1>(m_wallpaperShell);
+    if (qEnvironmentVariableIsSet("DDM_DISPLAY_MANAGER")) {
+        m_wallpaperShell->setFilter([this](WClient *client) { return Helper::instance()->sessionManager()->isDDEUserClient(client); });
+    }
+}
+
 WXWayland *ShellHandler::createXWayland(WServer *server,
                                         WSeat *seat,
                                         qw_compositor *compositor,

src/core/shellhandler.h

@@ -55,6 +55,8 @@ QT_END_NAMESPACE
 
 class AppIdResolverManager; // forward declare new protocol manager
 class WindowConfigStore;    // forward declare config store
+class TreelandWallpaperShellInterfaceV1;
+class TreelandWallpaperSurfaceInterfaceV1;
 
 class ShellHandler : public QObject
 {
@@ -68,6 +70,7 @@ class ShellHandler : public QObject
     void createComponent(QmlEngine *engine);
     void initXdgShell(WAYLIB_SERVER_NAMESPACE::WServer *server);
     void initLayerShell(WAYLIB_SERVER_NAMESPACE::WServer *server);
+    void initWallpaperShell(WAYLIB_SERVER_NAMESPACE::WServer *server);
     [[nodiscard]] WAYLIB_SERVER_NAMESPACE::WXWayland *createXWayland(
         WAYLIB_SERVER_NAMESPACE::WServer *server,
         WAYLIB_SERVER_NAMESPACE::WSeat *seat,
@@ -79,6 +82,9 @@ class ShellHandler : public QObject
                                WAYLIB_SERVER_NAMESPACE::WSeat *seat);
 
     WAYLIB_SERVER_NAMESPACE::WXWayland *defaultXWaylandSocket() const;
+    TreelandWallpaperShellInterfaceV1 *wallpaperShell() const {
+        return m_wallpaperShell;
+    }
 Q_SIGNALS:
     void surfaceWrapperAdded(SurfaceWrapper *wrapper);
     void surfaceWrapperAboutToRemove(SurfaceWrapper *wrapper);
@@ -129,6 +135,7 @@ private Q_SLOTS:
 
     WAYLIB_SERVER_NAMESPACE::WXdgShell *m_xdgShell = nullptr;
     WAYLIB_SERVER_NAMESPACE::WLayerShell *m_layerShell = nullptr;
+    TreelandWallpaperShellInterfaceV1 *m_wallpaperShell = nullptr;
     WAYLIB_SERVER_NAMESPACE::WInputMethodHelper *m_inputMethodHelper = nullptr;
     QList<WAYLIB_SERVER_NAMESPACE::WXWayland *> m_xwaylands;
 

src/modules/wallpaper/wallpapershellinterfacev1.cpp

@@ -1,6 +1,7 @@
 // Copyright (C) 2026 UnionTech Software Technology Co., Ltd.
 // SPDX-License-Identifier: Apache-2.0 OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
 
+#include "wallpapersurface.h"
 #include "wallpapershellinterfacev1.h"
 #include "qwayland-server-treeland-wallpaper-shell-unstable-v1.h"
 
@@ -18,6 +19,7 @@ class TreelandWallpaperShellInterfaceV1Private : public QtWaylandServer::treelan
     wl_global *global() const;
 
     TreelandWallpaperShellInterfaceV1 *q = nullptr;
+    QList<QString> producedWallpapers;
 
 protected:
     void treeland_wallpaper_shell_v1_destroy_global() override;
@@ -58,6 +60,7 @@ void TreelandWallpaperShellInterfaceV1Private::treeland_wallpaper_shell_v1_get_t
         return;
     }
 
+    producedWallpapers.append(file_source);
     wl_resource *surfaceResource = wl_resource_create(resource->client(),
                                                       &treeland_wallpaper_surface_v1_interface,
                                                       resource->version(),
@@ -83,6 +86,16 @@ TreelandWallpaperShellInterfaceV1::TreelandWallpaperShellInterfaceV1(QObject *pa
 {
 }
 
+QList<QString> TreelandWallpaperShellInterfaceV1::producedWallpapers() const
+{
+    return d->producedWallpapers;
+}
+
+void TreelandWallpaperShellInterfaceV1::removeProducedWallpaper(const QString &path)
+{
+    d->producedWallpapers.removeOne(path);
+}
+
 TreelandWallpaperShellInterfaceV1::~TreelandWallpaperShellInterfaceV1() = default;
 
 void TreelandWallpaperShellInterfaceV1::create(WServer *server)
@@ -116,6 +129,7 @@ class TreelandWallpaperSurfaceInterfaceV1Private : public QtWaylandServer::treel
     TreelandWallpaperSurfaceInterfaceV1 *q;
     wl_resource *surfaceResource = nullptr;
     wl_resource *resource = nullptr;
+    WallPaperSurface *surface = nullptr;
     QString wallpaperSource;
 
 protected:
@@ -198,9 +212,24 @@ TreelandWallpaperSurfaceInterfaceV1 *TreelandWallpaperSurfaceInterfaceV1::get(co
     return nullptr;
 }
 
+void TreelandWallpaperSurfaceInterfaceV1::setPlay(bool value)
+{
+    if (value) {
+        d->send_play();
+    } else {
+        d->send_pause();
+    }
+}
+
+void TreelandWallpaperSurfaceInterfaceV1::slowDown()
+{
+    d->send_slow_down(3000);
+}
+
 TreelandWallpaperSurfaceInterfaceV1::TreelandWallpaperSurfaceInterfaceV1(wl_resource *surface,
                                                                          const QString &source,
                                                                          wl_resource *resource)
     : d(new TreelandWallpaperSurfaceInterfaceV1Private(this, source, surface, resource))
 {
+    d->surface = new WallPaperSurface(this, this);
 }

src/modules/wallpaper/wallpapershellinterfacev1.h

@@ -23,6 +23,8 @@ class TreelandWallpaperShellInterfaceV1 : public QObject , public WServerInterfa
     ~TreelandWallpaperShellInterfaceV1() override;
 
     static constexpr int InterfaceVersion = 1;
+    QList<QString> producedWallpapers() const;
+    void removeProducedWallpaper(const QString &path);
 
 Q_SIGNALS:
     void wallpaperSurfaceAdded(TreelandWallpaperSurfaceInterfaceV1 *interface);
@@ -50,6 +52,8 @@ class TreelandWallpaperSurfaceInterfaceV1 : public QObject
 
     static TreelandWallpaperSurfaceInterfaceV1 *get(WSurface *surface);
     static TreelandWallpaperSurfaceInterfaceV1 *get(const QString &source);
+    void setPlay(bool value);
+    void slowDown();
 
 Q_SIGNALS:
     void failed(uint32_t error);