Pointer constraints

客户端用于通知服务器它将不再使用此指针约束对象。

lock_pointer 请求允许客户端请求禁用虚拟指针（即光标）的移动，从而有效地将指针锁定在某个位置。此请求可能不会立即生效；将来当合成器认为特定于实现的约束已满足时，指针锁定将被激活，合成器将发送 locked 事件。

协议不保证约束会被满足，也不要求合成器在约束永远无法满足时发送错误。因此，有可能请求一个永远不会激活的锁定。

在请求锁定时，传入的指针的 seat 的任何 wl_pointer 对象上不得有其他任何类型的指针约束处于请求或活动状态。如果有，将引发错误。详见通用指针锁定文档。

此请求传入的区域与表面的输入区域的交集用于确定指针必须位于何处才能激活锁定。是否需要移动指针或要求某种用户交互才能激活锁定取决于合成器。如果区域为 null，则使用表面输入区域。

表面可以在锁定未激活的情况下接收指针焦点。

此请求创建一个新的 wp_locked_pointer 对象，用于与锁定交互以及接收其状态更新。详见 wp_locked_pointer 的描述。

注意，当指针被锁定时，相应 seat 的 wl_pointer 对象不会发出任何 wl_pointer.motion 事件，但相对运动事件仍将通过同一 seat 的 wp_relative_pointer 对象发出。wl_pointer.axis 和 wl_pointer.button 事件不受影响。

confine_pointer 请求允许客户端请求将指针光标限制在给定区域内。此请求可能不会立即生效；将来当合成器认为特定于实现的约束已满足时，指针约束将被激活，合成器将发送 confined 事件。

此请求传入的区域与表面的输入区域的交集用于确定指针必须位于何处才能激活约束。是否需要移动指针或要求某种用户交互才能激活约束取决于合成器。如果区域为 null，则使用表面输入区域。

此请求将创建一个新的 wp_confined_pointer 对象，用于与约束交互以及接收其状态更新。详见 wp_confined_pointer 的描述。

这些错误可以响应 wp_pointer_constraints 请求而发出。

这些值代表不同的生命周期语义。它们作为参数传递给工厂请求，以指定应如何管理约束的生命周期。

销毁锁定指针对象。如果适用，合成器将解锁指针。

设置相对于表面左上角的光标位置提示。

如果客户端正在绘制自己的光标，它应将位置提示更新为其自身光标的位置。合成器可以使用此信息在解锁时移动指针，以避免指针跳动。

光标位置提示是双缓冲状态，参见 wl_surface.commit。

设置用于锁定指针的新区域。

新的锁定区域是双缓冲的，参见 wl_surface.commit。

有关锁定区域的详细信息，请参阅 wp_locked_pointer。

通知 seat 的指针锁定已被激活。

通知 seat 的指针锁定不再活动。如果这是一次性指针锁定（参见 wp_pointer_constraints.lifetime），此对象现已失效，应被销毁。如果是持久性指针锁定（参见 wp_pointer_constraints.lifetime），此指针锁定将来可能会重新激活。

销毁受限指针对象。如果适用，合成器将取消约束指针。

设置用于约束指针的新区域。

新的约束区域是双缓冲的，参见 wl_surface.commit。

如果在应用新约束区域时约束处于活动状态，并且指针最终位于新应用区域之外，指针可能会被移动到新约束区域内的位置。如果发生移动，将发出 wl_pointer.motion 事件，但不会发出 wp_relative_pointer.relative_motion 事件。

合成器也可以选择不使用新区域，而是取消约束指针。

有关约束区域的详细信息，请参阅 wp_confined_pointer。

通知 seat 的指针约束已被激活。

通知 seat 的指针约束不再活动。如果这是一次性指针约束（参见 wp_pointer_constraints.lifetime），此对象现已失效，应被销毁。如果是持久性指针约束（参见 wp_pointer_constraints.lifetime），此指针约束将来可能会重新激活。