Workspace protocol

客户端必须在完成发送其他请求后发送此请求。compositor 必须原子地处理在 commit 请求之前的一系列请求。

这允许对工作区属性的更改被视为原子操作，即使它们通过多个事件发生，甚至即使它们涉及多个 ext_workspace_handle_v1 对象，例如，停用一个工作区并激活另一个工作区。

指示客户端不再希望接收新工作区组的事件。但是，compositor 可能会发出更多工作区事件，直到发出 finished 事件。一旦处理了 stop 请求，compositor 预计将最终发送 finished 事件。

客户端不得在此请求之后发送任何请求，这样做将引发 wl_display invalid_object 错误。

每当创建新的工作区组时都会发出此事件。

工作区组的所有初始详细信息（output）将在此事件之后立即通过 ext_workspace_group_handle_v1 和 ext_workspace_handle_v1 中的相应事件发送。

每当创建新的工作区并将其添加到属于该管理器的组中时，都会发出此事件。

工作区的所有初始详细信息（名称、坐标、状态）将在此事件之后立即通过 ext_workspace_handle_v1 中的相应事件发送。

接收此事件的管理器应假定该工作区尚未通过调用其销毁事件而被销毁。

此事件在所有的 ext_workspace_group_handle_v1 和 ext_workspace_handle_v1 对象初始创建后发送。

一旦发出此事件，客户端就可以假定其具备了一组完整的工作区。

此事件表示 compositor 完成了向客户端发送事件。这可能发生在响应 ext_workspace_manager_v1.stop 请求时。

接收到此事件后，客户端应当销毁此对象并放弃所有相关的状态。

Request that the compositor create a new workspace with the given name and assign it to this group.

There is no guarantee that the compositor will create a new workspace, or that the created workspace will have the provided name.

销毁工作区组对象。

This event advertises the capabilities supported by the compositor. If a capability isn't supported, clients should hide or disable the UI elements that expose this functionality. For instance, if the compositor doesn't advertise support for creating workspaces, a button triggering the create_workspace request should not be displayed.

The compositor will ignore requests it doesn't support. For instance, a compositor which doesn't advertise support for creating workspaces will ignore create_workspace requests.

Compositors must send this event once after creation of an ext_workspace_group_handle_v1. When the capabilities change, compositors must send this event again.

当工作区组被分配给特定的 output 时发送此事件。这意味着该组中的工作区包含了来自此 output 的 surface。

这在此对象的整个生命周期中可能会发生变化。在客户端收到对应的输出离开事件之前，它应该假设工作区组与此 output 关联。

当工作区组不再被分配给特定的 output 时发送此事件。这意味着该组中的工作区不再包含来自此 output 的 surface。

This event is emitted whenever a workspace is assigned to this group. A workspace may only ever be assigned to a single group at a single point in time, but can be re-assigned during its lifetime.

This event is emitted whenever a workspace is removed from this group.

This event is send when the group associated with the ext_workspace_group_handle_v1 has been removed. After sending this request the compositor will immediately consider the object inert. Any requests will be ignored except the destroy request. It is guaranteed there won't be any more events referencing this ext_workspace_group_handle_v1.

The compositor must remove all workspaces belonging to a workspace group via a workspace_leave event before removing the workspace group.

此对象不再被需要。这并不影响 compositor 端的底层工作区。

请求 compositor 使此工作区成为“活动”状态。该请求是一个提示（hint），compositor 可以选择忽略它。

请求 compositor 使此工作区变为非活动状态。这是一个提示，compositor 可能选择忽略。

Requests that this workspace is assigned to the given workspace group.

There is no guarantee the workspace will be assigned.

Request that this workspace be removed.

There is no guarantee the workspace will be actually removed.

If this event is emitted, it will be send immediately after the ext_workspace_handle_v1 is created or when an id is assigned to a workspace (at most once during its lifetime).

An id will never change during the lifetime of the `ext_workspace_handle_v1` and is guaranteed to be unique during its lifetime.

Ids are not human-readable and shouldn't be displayed, use `name` for that purpose.

Compositors are expected to only send ids for workspaces likely stable across multiple sessions and can be used by clients to store preferences for workspaces. Workspaces without ids should be considered temporary and any data associated with them should be deleted once the respective object is lost.

发送此事件以提供或更新工作区的名称。

名称是用于标识工作区的字符串。它可以是一个数字，也可以是像“开发”或“网页浏览”这样的名称。名称不应包含换行符或其他控制字符。

工作区名称不一定唯一。

发送此事件以向工作区分配一个 N 维坐标，该坐标旨在将其与其他工作区在其组的 N 维网格中关联。

数组包含 32 位无符号整数，表示坐标。由于每个坐标必须在数组中作为无符号整数表示，并且坐标原点对于组中的所有工作区必须相同，因此它们只能是表示其在空间中相对位置的离散值。如果没有另外传达，应假定具有坐标数组 [0] 的工作区位于 N 维空间的原点。

通过比较它们的数组并基于数组中的索引关联坐标维度（例如，索引 0 代表 X 坐标，索引 1 代表 Y 坐标），可以将一个坐标分配给每个轴。客户端不需要支持任何特定数量的维度，尽管二维网格是最常见的。

发送此事件也是可选的；compositor 可以选择不将工作区排列在网格中，并仅依赖于接收到的创建事件来排序它们。

发送此事件以提供或更新工作区的状态。

数组包含一组表示工作区当前状态的枚举值。

This event advertises the capabilities supported by the compositor. If a capability isn't supported, clients should hide or disable the UI elements that expose this functionality. For instance, if the compositor doesn't advertise support for removing workspaces, a button triggering the remove request should not be displayed.

The compositor will ignore requests it doesn't support. For instance, a compositor which doesn't advertise support for remove will ignore remove requests.

Compositors must send this event once after creation of an ext_workspace_handle_v1 . When the capabilities change, compositors must send this event again.

This event is send when the workspace associated with the ext_workspace_handle_v1 has been removed. After sending this request, the compositor will immediately consider the object inert. Any requests will be ignored except the destroy request.

It is guaranteed there won't be any more events referencing this ext_workspace_handle_v1.

The compositor must only remove a workspaces not currently belonging to any workspace_group.

描述工作区各种状态的枚举值。