River window layout

此请求表示客户端将不再使用 river_layout_manager 对象。通过此实例创建的对象不受影响。

这会为给定的 wl_output 创建一个新的 river_layout_v3 对象。

所有与 layout 相关的通信均通过此接口完成。

compositor 使用 namespace 来决定哪个 river_layout_v3 对象将接收该 output 的 layout 需求（layout demands）。

要求每个 output 的 namespace 必须唯一。此外，两个不同的客户端不能在不同的 output 上共享同一个 namespace。如果不满足这些条件，将在创建 river_layout_v3 对象后立即发送 namespace_in_use 事件。

此请求表示客户端将不再使用 river_layout_v3 对象。

此请求为具有匹配 serial 的 layout 需求中的 view 提议尺寸和位置。

客户端必须为作为 layout 需求一部分的每个 view 发送此请求。layout 中的 view 数量由 layout_demand 事件的 view_count 参数给出。推送过多或过少的 view 尺寸都是协议错误。

x 和 y 坐标相对于 output 的可用区域，以 (0,0) 作为左上角。

此请求表示客户端已完成尺寸的推送，compositor 可以应用该 layout。这完成了具有匹配 serial 的 layout 需求，任何与该 serial 一起发送的其他请求都是协议错误。

layout_name 参数是正在提交的 layout 的面向用户的名称或简短描述。例如，compositor 可能会将其显示在状态栏上，但具体如何处理由 compositor 自行决定。

compositor 可以自由选择如何使用这个提议的 layout，包括忽略它。

发送此事件后，除了 destroy 事件之外的所有请求都将被服务器忽略。如果客户端希望使用不同的 namespace 重试，它们必须创建一个新的 river_layout_v3 对象。

compositor 发送此事件以通知客户端它需要一组 view 的 layout。

可用宽度（usable width）和高度（height）指示了客户端可以安全放置 view 的空间，而不会干扰如面板（panels）之类的桌面小部件。

此事件的 serial 用于将后续请求标识为属于此 layout 需求。请注意，客户端可能需要同时处理多个 layout 需求。

服务器将忽略除最近的 layout 需求以外的所有响应。因此，只要求客户端响应最近收到的 layout_demand。如果在客户端完成对旧需求的响应之前收到了较新的 layout_demand，客户端应该中止对旧需求的工作，因为任何进一步的工作都将被浪费。

此事件向客户端通知由用户发送给它的命令。

命令的语义含义由客户端决定。如果它愿意，它也可以完全忽略它。

如果 compositor 当前正在使用此 layout 对象来排列 output，则会在此事件之后发送一个 layout_demand。

如果绑定了 river_layout_v3 对象的版本 2 或更高版本，则保证在 user_command 事件之前直接发送 user_command_tags 事件。

如果绑定了 river_layout_v3 对象的版本 2 或更高版本，则此事件将在每个 user_command 事件之前直接发送。这允许 layout 生成器在发送用户命令时了解 active tags（活动标签）。对于希望在每个 tag 基础上保留设置的生成器来说，这是必要的。