Treeland virtual output manager

treeland_virtual_output_manager_v1

版本 1

管理器创建虚拟输出

此接口是一个管理器，允许创建复制输出。

create_virtual_output(id: new_id<treeland_virtual_output_v1>, name: string, outputs: array)

参数	类型	描述
id	new_id<treeland_virtual_output_v1>
name	string	The name of the user readable virtual output
outputs	array	Screen name array

创建虚拟输出

创建虚拟输出，可在设置屏幕复制模式用于多屏时使用。虚拟输出用于镜像多个 wl_output 输出。

数组中的元素是屏幕名称。

数组 outputs 的第一个元素是要复制的屏幕，后续元素是要镜像的屏幕。

调用此接口的客户端不会在客户端上生成额外的 wl_output 对象。

get_virtual_output_list()

获取虚拟输出名称列表

获取虚拟输出名称列表。

get_virtual_output(name: string, id: new_id<treeland_virtual_output_v1>)

参数	类型	描述
name	string	The name of the user readable virtual output
id	new_id<treeland_virtual_output_v1>

获取虚拟输出

客户端通过虚拟输出名称获取对应的 virtual_output_v1 对象。

virtual_output_list(names: array)

参数	类型	描述
names	array	List of virtual output names

发送虚拟输出名称列表

向客户端发送虚拟输出名称列表。

版本 1

屏幕输出对象

treeland_virtual_output_v1 表示一个集合虚拟屏幕输出对象。

类型: destructor

destroy()

销毁输出

销毁该输出。

outputs(name: string, outputs: array)

参数	类型	描述
name	string	The name of the user readable virtual output
outputs	array	Screen name array

屏幕输出变化

当数组中的任何屏幕发生变化时，此事件发送给客户端。

数组中的元素是屏幕名称。

数组 outputs 的第一个元素是要复制的屏幕，后续元素是要镜像的屏幕。

当主屏幕（被复制的屏幕）被移除时，将从队列中选择一个后继者作为主屏幕，并更新队列信息。

error(code: uint, message: string)

参数	类型	描述
code	uint	error code
message	string	error description

屏幕复制模式错误事件

当发生错误时，发出错误事件，终止客户端发出的复制模式请求。

error { invalid_group_name, invalid_screen_number, invalid_output }

	Cage 0.2.0	COSMIC 1.0.0~beta.8	GameScope 3.15.14	Hyprland 0.52.1	Jay 1.12.0	KWin 6.6	Labwc 0.9.2	Louvre 2.14.1	Mir 2.26	Muffin 6.6.0	Mutter 49.2	niri 25.11	phoc 0.52	river 0.3.13	Sway 1.11	Treeland 0.8.0	Wayfire 0.9.0	Weston 14.0.2
treeland_virtual_output_manager_v1	x	x	x	x	x	x	x	x	x	x	x	x	x	x	x	1	x	x

SPDX-FileCopyrightText: 2024 UnionTech Software Technology Co., Ltd. SPDX-License-Identifier: MIT