Relative pointer

相对指针运动事件协议

此协议规定了一组接口，用于使客户端能够接收不受屏障（如显示器边缘或其他指针屏障）阻碍的相对指针事件。

要开始接收相对指针事件，客户端必须首先绑定全局接口 "wp_relative_pointer_manager"（如果 compositor 支持相对指针运动事件，该接口将由 registry 暴露）。创建相对指针管理器代理对象后，客户端使用它通过 "get_relative_pointer" 请求（传入 wl_pointer）创建实际的相对指针对象。然后，相对指针运动事件将在适用时通过新创建的相对指针对象的代理传输。有关更多详细信息，请参阅相对指针接口的文档。

警告！此文件中描述的实验性协议可能会进行不向后兼容的更改。向后兼容的更改可能会与相应的接口版本号递增一起添加。不向后兼容的更改通过提升协议和接口名称中的版本号并重置接口版本来完成。一旦协议被声明为稳定版本，协议和接口名称中的 'z' 前缀和版本号将被移除，接口版本号也将被重置。

zwp_relative_pointer_manager_v1

版本 1

获取相对指针对象

用于获取给定指针的相对指针对象的全局接口。

zwp_relative_pointer_manager_v1::destroy

类型: destructor

destroy()

销毁相对指针管理器对象

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

zwp_relative_pointer_manager_v1::get_relative_pointer

get_relative_pointer(id: new_id<zwp_relative_pointer_v1>, pointer: object<wl_pointer>)

参数	类型	描述
id	new_id<zwp_relative_pointer_v1>
pointer	object<wl_pointer>

获取相对指针对象

给定 wl_pointer 对象，创建相对指针接口。有关更多详细信息，请参阅 wp_relative_pointer 接口。

zwp_relative_pointer_v1

版本 1

相对指针对象

wp_relative_pointer 对象是 wl_pointer 接口的扩展，用于发送相对指针事件。它与同一 seat 的 wl_pointer 对象共享相同的焦点，并且仅在拥有焦点时才会发送事件。

zwp_relative_pointer_v1::destroy

类型: destructor

destroy()

释放相对指针对象

zwp_relative_pointer_v1::relative_motion

relative_motion(utime_hi: uint, utime_lo: uint, dx: fixed, dy: fixed, dx_unaccel: fixed, dy_unaccel: fixed)

参数	类型	描述
utime_hi	uint	high 32 bits of a 64 bit timestamp with microsecond granularity
utime_lo	uint	low 32 bits of a 64 bit timestamp with microsecond granularity
dx	fixed	the x component of the motion vector
dy	fixed	the y component of the motion vector
dx_unaccel	fixed	the x component of the unaccelerated motion vector
dy_unaccel	fixed	the y component of the unaccelerated motion vector

相对指针运动

来自与此对象关联的 seat 的指针的相对 x/y 指针运动。

相对运动与常规 wl_pointer 运动事件具有相同的维度，只是它们不代表绝对位置。例如，将指针从 (x, y) 移动到 (x', y') 将具有等效的相对运动 (x' - x, y' - y)。如果指针运动导致绝对指针位置被裁剪（例如被显示器边缘裁剪），相对运动不受裁剪影响，将代表未裁剪的运动。

此事件还包含非加速运动增量。非加速增量在适用时是应用运动加速和其他变换（如规范化）之前的常规指针运动增量。

请注意，非加速增量不代表从某些设备读取的 "原始" 事件。指针运动加速是设备和配置特定的，非加速增量和加速增量在某些设备上可能具有相同的值。

相对运动不与 wl_pointer.motion 事件耦合，可以与此类事件组合发送，也可以独立发送。也可能存在发送 wl_pointer.motion 但没有相对运动的场景。源自同一物理运动的绝对和相对运动事件的顺序不保证。

如果客户端需要按钮事件或焦点状态，它可以从与 wp_relative_pointer 对象关联的同一 seat 的 wl_pointer 对象接收它们。

合成器支持

	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
zwp_relative_pointer_manager_v1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	1	x	1	1

Copyright

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice (including the next paragraph) shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.