Background effect
该协议提供了一种通过在半透明表面后面应用模糊等效果来改善其视觉效果的方法。
当绑定全局对象时以及每次功能发生变化时，都会发送功能。请注意，当该功能不可用时，合成器将不再应用相应的效果，即使它之前已设置。
警告！此文件中描述的协议目前处于测试阶段。向后兼容的更改可能会与相应的接口版本升级一起添加。向后不兼容的更改只能通过创建扩展的新主要版本来完成。
destroy()
通知服务器客户端将不再使用此协议对象。此对象创建的现有对象不受影响。
get_background_effect(id: new_id<ext_background_effect_surface_v1>, surface: object<wl_surface>)
参数 | 类型 | 描述 |
|---|---|---|
| id | new_id<ext_background_effect_surface_v1> | the new ext_background_effect_surface_v1 object |
| surface | object<wl_surface> | the surface |
为给定的 wl_surface 实例化一个接口扩展，以为其后面的背景添加模糊等效果。
如果给定的 wl_surface 已经关联了一个 ext_background_effect_surface_v1 对象，则会引发 background_effect_exists 协议错误。
capabilities(flags: uint<ext_background_effect_manager_v1.capability>)
参数 | 类型 | 描述 |
|---|---|---|
| flags | uint<ext_background_effect_manager_v1.capability> |
error { background_effect_exists }
参数 | 值 | 描述 |
|---|---|---|
| background_effect_exists | 0 | 表面已经有一个背景效果对象 |
背景效果对象提供了一种方法来指定表面后面的一个区域，该区域应应用背景效果（如模糊）。
如果与 ext_background_effect_surface_v1 对象关联的 wl_surface 已被销毁，则此对象变为无效（inert）。
destroy()
通知服务器客户端将不再使用此协议对象。效果区域将在下一次提交时被移除。
此请求设置表面中将其背景模糊的区域。
模糊区域在表面局部坐标中指定，并由合成器裁剪为表面大小。
模糊区域的初始值为空。设置挂起的模糊区域具有复制语义，并且 wl_region 对象可以在此请求之后立即销毁。如果提供 null wl_region，则它被视为包含在表面中的空区域。
模糊区域是双重缓冲的状态，请参阅 wl_surface.commit。
背景模糊应用于背景和在此表面之上任何部分但在低于应用此效果的合成表面（如桌面小部件或弹出窗口）之下的效果。因此，如果半透明表面的任何部分在不透明窗口上方，则该区域将被模糊。
合成器支持
Copyright
Copyright (C) 2015 Martin Gräßlin Copyright (C) 2015 Marco Martin Copyright (C) 2020 Vlad Zahorodnii Copyright (C) 2024 Xaver Hugl
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.