KDE plasma shell

为已有的 surface 创建一个 shell surface。 一个 surface 只能关联一个 shell surface。

The org_kde_plasma_surface interface is removed from the wl_surface object that was turned into a shell surface with the org_kde_plasma_shell.get_surface request. The shell surface role is lost and wl_surface is unmapped.

将输出分配给此 shell surface。合成器将在调用 org_kde_plasma_surface.set_position 请求时使用此信息来设置位置。

将 surface 移动到新坐标。

坐标是全局的，例如对于 1920,0+1920x1080 输出，50,50 在全局坐标空间中为 1970,50。

使用 org_kde_plasma_surface.set_output 为此 surface 分配输出。

为 shell surface 分配角色。

合成器根据 surface 的角色对其进行处理。参见下面的说明。

如果 surface 已有角色，此请求将失败，这意味着 surface 角色只能分配一次。

== 带有 splash 角色的 surface ==

Splash surface 在 shell 启动阶段放置在所有其他 surface 之上。

这些 surface 根据输出坐标放置。不会对这些 surface 施加大小限制，shell 需要根据输出大小调整它们的尺寸。

这些 surface 用于在启动阶段隐藏桌面，使用户始终看到准备就绪的桌面。

如果合成器以其他方式显示桌面（例如使用淡入效果），则 shell 可能不会创建 splash surface。

这取决于桌面通常需要多少时间准备工作区或特定的设计决策。本规范不强制任何特定设计。

当启动阶段完成后，shell 将向合成器发送 org_kde_plasma.desktop_ready 请求。

== 带有 desktop 角色的 surface ==

Desktop surface 放置在所有其他 surface 之下，用于显示带有图标、搜索结果或用户交互控件的实际桌面视图。显示内容取决于 shell 实现。

这些 surface 根据输出坐标放置。不会对这些 surface 施加大小限制，shell 需要根据输出大小调整它们的尺寸。

每个输出只能有一个 surface 具有 desktop 角色。

== 带有 dashboard 角色的 surface ==

Dashboard surface 放置在 desktop surface 之上，用于显示额外的小部件和控件。

这些 surface 根据输出坐标放置。不会对这些 surface 施加大小限制，shell 需要根据输出大小调整它们的尺寸。

每个输出只能有一个 surface 具有 dashboard 角色。

== 带有 config 角色的 surface ==

配置 surface 用于桌面配置。

按 flag enum 中描述的设置标志位掩码。传入 0 以取消设置任何标志，surface 将恢复默认行为。

在 Plasma 6 中已弃用。设置此标志将不起作用。应用应在适当时使用 layer shell。

将此位设置到窗口上，将使其表示倾向于不在任务栏中列出。任务栏实现可能会也可能不会遵循此提示。

带有 panel_behavior auto_hide 的面板 surface 可以执行此请求，在不取消映射的情况下隐藏屏幕边缘的面板。合成器通过 auto_hidden_panel_hidden 事件通知客户端面板已被隐藏。

当指针触及面板边界的屏幕边缘时，合成器将恢复 surface 的可见性状态。一旦合成器恢复可见性，将发送 auto_hidden_panel_shown 事件。如果合成器无法隐藏面板，也会发送此事件。

客户端也可以使用 panel_auto_hide_show 请求再次显示面板。

带有 panel_behavior auto_hide 的面板 surface 可以执行此请求，再次显示通过 panel_auto_hide_hide 隐藏的面板。

默认情况下，各种 org_kde_plasma_surface 角色不会获取焦点且无法激活。通过此请求，可以指示合成器将焦点也传递给此 org_kde_plasma_surface。

设置此位将指示窗口倾向于不在切换器中列出。

请求此 surface 的初始位置在当前光标位置下方。必须在向此 surface 附加任何缓冲区之前调用。

自动隐藏面板已被合成器隐藏。

自动隐藏面板已被合成器显示。