COSMIC workspace v1

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

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

表示客户端不再希望接收新工作区组的事件。但合成器可能会发出更多工作区事件，直到发出 finished 事件。

客户端在此请求之后不得发送任何更多请求。

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

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

在所有工作区组中的所有更改发送完毕后发送此事件。

这允许将一个或多个 zcosmic_workspace_group_handle_v1 属性和 zcosmic_workspace_handle_v1 属性的更改视为原子的，即使它们通过多个事件发生。特别是，当输出从一个工作区组移动到另一个时，会向两个相关的 zcosmic_workspace_group_handle_v1 对象发送 output_enter 和 output_leave 事件。合成器仅在更新两个工作区组中的输出信息后才发送 done 事件。

此事件表示合成器已完成向 zcosmic_workspace_manager_v1 发送事件。服务器将在发送此请求后立即销毁该对象，因此它将变为无效，客户端应释放与其关联的任何资源。

请求合成器创建具有给定名称的新工作区。

不保证合成器会创建新工作区，也不保证创建的工作区会有提供的名称。

销毁 zcosmic_workspace_group_handle_v1 对象。

当客户端不再想使用工作区对象或在 remove 事件之后最终确定对象销毁时，应调用此请求。

此事件公布合成器支持的功能。如果某个功能不受支持，客户端应隐藏或禁用暴露此功能的 UI 元素。例如，如果合成器不公布创建工作区的支持，则不应显示触发 create_workspace 请求的按钮。

合成器将忽略它不支持的请求。例如，不公布创建工作区支持的合成器将忽略 create_workspace 请求。

合成器必须在创建 zcosmic_workspace_group_handle_v1 后发送此事件一次。当功能发生变化时，合成器必须再次发送此事件。

功能以本机字节序的 32 位无符号整数数组形式发送。

每当输出被分配到工作区组时，都会发出此事件。

每当输出从工作区组中移除时，都会发出此事件。

每当创建新工作区时，都会发出此事件。工作区只能是单个工作区组的成员，不能被重新分配。

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

此事件意味着 zcosmic_workspace_group_handle_v1 已被销毁。保证不会再有此 zcosmic_workspace_group_handle_v1 的任何事件。zext_workspace_group_handle_v1 变为惰性，因此除 destroy 请求外，任何请求都将被忽略。

合成器必须在移除工作区组之前移除属于该工作区组的所有工作区。

销毁 zcosmic_workspace_handle_v1 对象。

当客户端不再想使用工作区对象或在 remove 事件之后最终确定对象销毁时，应调用此请求。

请求激活此工作区。

不保证工作区会被实际激活，行为可能取决于合成器。例如，激活工作区可能会也可能不会停用同一组中的所有其他工作区。

请求停用此工作区。

不保证工作区会被实际停用。

请求移除此工作区。

不保证工作区会被实际移除。

请求重命名此工作区。

不保证工作区会被实际重命名。

请求更改此工作区的平铺状态。

不保证工作区会实际更改其平铺状态。

在 zcosmic_workspace_handle_v1 创建后立即发出此事件，并在工作区名称每次更改时发出。

此事件用于将工作区组织到工作区组内的 N 维网格中，如果支持，在 zcosmic_workspace_handle_v1 创建后立即发出，并在工作区坐标每次更改时发出。如果合成器不以这种方式在概念上排列工作区，则可能不发送此事件。如果合成器只是简单编号工作区而没有任何几何解释，它们可以发送 1D 坐标，客户端不应将其解释为暗示任何几何形状。发送空数组表示合成器不再以几何方式排序工作区。

坐标有任意 N 个维度，每个维度有一个 uint32 位置。按照惯例，如果 N > 1，第一个维度是 X，第二个是 Y，第三个是 Z，依此类推。但合成器可以选择利用这些事件来实现更新颖的工作区布局约定。不保证网格被填充或有界；坐标 1 可能有一个工作区，坐标 1000 有另一个，中间没有。但在工作区组内，工作区必须具有相同维度的唯一坐标。

在 zcosmic_workspace_handle_v1 创建后立即发出此事件，并在工作区状态每次更改时发出，无论是由于合成器操作还是此协议中的请求。

此事件公布合成器支持的功能。如果某个功能不受支持，客户端应隐藏或禁用暴露此功能的 UI 元素。例如，如果合成器不公布移除工作区的支持，则不应显示触发 remove 请求的按钮。

合成器将忽略它不支持的请求。例如，不公布移除支持的合成器将忽略 remove 请求。

合成器必须在创建 zcosmic_workspace_handle_v1 后发送此事件一次。当功能发生变化时，合成器必须再次发送此事件。

功能以本机字节序的 32 位无符号整数数组形式发送。

此事件意味着 zcosmic_workspace_handle_v1 已被销毁。保证不会再有此 zcosmic_workspace_handle_v1 的任何事件。zext_workspace_handle_v1 变为惰性，因此除 destroy 请求外，任何请求都将被忽略。

在 zcosmic_workspace_handle_v1 创建后立即发出此事件，并在工作区平铺状态每次更改时发出，无论是由于合成器操作还是此协议中的请求。

工作区可以具有的不同状态。