Tablet

获取给定 seat 的 zwp_tablet_seat_v2 对象。此对象提供对该 seat 中所有图形数位板的访问。

销毁 zwp_tablet_manager_v2 对象。由此对象创建的对象不受影响，应单独销毁。

销毁 zwp_tablet_seat_v2 对象。由此对象创建的对象不受影响，应单独销毁。

每当新的数位板在此 seat 上可用时发送此事件。此事件仅提供数位板的对象 ID，任何关于数位板的静态信息（设备名称、vid/pid 等）通过 zwp_tablet_v2 接口发送。

每当先前未与数位板一起使用过的工具开始使用时发送此事件。此事件仅提供工具的对象 ID；任何关于工具的静态信息（功能、类型等）通过 zwp_tablet_tool_v2 接口发送。

每当系统获知新的 pad 时发送此事件。通常，pad 物理连接到数位板，pad_added 事件在 zwp_tablet_seat_v2.tablet_added 之后立即发送。但是，某些独立 pad 设备在运行时逻辑上附加到数位板，客户端必须等待 zwp_tablet_pad_v2.enter 才能知道 pad 附加到哪个数位板。

此事件仅提供 pad 的对象 ID。所有进一步的功能（按钮、触摸条、触摸环）通过 zwp_tablet_pad_v2 接口发送。

设置此工具在给定数位板上使用的光标 surface。此请求仅在工具接近请求客户端的某个 surface 或 surface 参数是当前指针 surface 时生效。如果之前通过此请求设置了 surface，它将被替换。如果 surface 为 NULL，则隐藏光标图像。

参数 hotspot_x 和 hotspot_y 定义了指针 surface 相对于指针位置的位置。其左上角始终位于 (x, y) - (hotspot_x, hotspot_y)，其中 (x, y) 是指针位置的坐标，以 surface 本地坐标表示。

在对指针 surface 进行 surface.attach 请求时，hotspot_x 和 hotspot_y 会分别减去传递给请求的 x 和 y 参数。Attach 必须像往常一样通过 wl_surface.commit 确认。

也可以通过将当前设置的指针 surface 传递给此请求并提供新的 hotspot_x 和 hotspot_y 值来更新热点。

wl_surface 的当前和待处理输入区域会被清除，并且在 wl_surface 不再用作光标之前，wl_surface.set_input_region 会被忽略。当用作光标结束时，当前和待处理输入区域变为未定义，且 wl_surface 被取消映射。

此请求赋予 surface zwp_tablet_tool_v2 光标的角色。一个 surface 只能用作一个 zwp_tablet_tool_v2 的光标 surface。如果 surface 已有其他角色或曾被用作不同工具的光标 surface，将触发协议错误。

销毁客户端的此工具对象资源。

工具类型是工具的高级类型，通常决定此工具预期的交互方式。

此事件在 zwp_tablet_tool_v2.done 事件之前的初始事件迸发中发送。

如果物理工具可以通过唯一的 64 位序列号标识，此事件通知客户端此序列号。

如果同一 seat 中有多个数位板可用且工具可以通过序列号唯一标识，则该工具可以在数位板之间移动。

否则，如果工具没有序列号且缺少此事件，则工具绑定到它首次接近的数位板。即使物理工具在多个数位板上使用，也会为每个数位板创建单独的 zwp_tablet_tool_v2 对象。

此事件在 zwp_tablet_tool_v2.done 事件之前的初始事件迸发中发送。

此事件通知客户端此工具上可用的硬件 ID。

硬件 ID 是设备特定的 64 位 ID，提供关于使用中工具的额外信息，超出 wl_tool.type 枚举。ID 的格式特定于 Wacom Inc. 制造的数位板。例如，Wacom Grip Pen（手写笔）的硬件 ID 是 0x802。

此事件在 zwp_tablet_tool_v2.done 事件之前的初始事件迸发中发送。

此事件通知客户端此工具的任何功能，超出主要的 x/y 轴和笔尖上下检测。

为此工具上的每个额外功能发送一个事件。

此事件在 zwp_tablet_tool_v2.done 事件之前的初始事件迸发中发送。

此事件标志着初始描述性事件迸发的结束。客户端可以认为工具的静态描述已完成并最终确定工具的初始化。

当工具从系统中移除且将不再发送任何事件时发送此事件。如果物理工具之后再次接近，将创建一个新的 zwp_tablet_tool_v2 对象。

工具何时被移除取决于合成器。合成器可以在 proximity out 时、数位板移除时或任何其他原因移除工具。合成器也可以保持工具存活直到关闭。

如果工具当前处于接近状态，在 removed 事件之前将发送 proximity_out 事件。有关任何逻辑上按下的按钮的处理，请参阅 zwp_tablet_tool_v2.proximity_out。

收到此事件时，客户端必须 zwp_tablet_tool_v2.destroy 该对象。

通知此工具聚焦在某个 surface 上。

当工具从一个 surface 移动到另一个 surface 时，或当工具再次接近 surface 时，可以收到此事件。

如果工具接近时任何按钮逻辑上处于按下状态，相应的按钮事件在 proximity_in 事件之后但在同一帧中发送。

通知此工具已离开接近状态或不再聚焦于某个 surface。

当数位板工具离开数位板的接近范围时，为当时仍处于按下状态的每个按钮发送按钮释放事件。这些事件在 proximity_out 事件之前但在同一 zwp_tablet_v2.frame 中发送。

如果工具保持在数位板的接近范围内，但焦点从一个 surface 更改到另一个 surface，按钮释放事件可能要到按钮实际释放或工具离开数位板的接近范围时才发送。

每当数位板工具与数位板表面接触时发送。

如果工具在进入输入区域时已与数位板接触，拥有该区域的客户端将收到 zwp_tablet_v2.proximity_in 事件，后跟 zwp_tablet_v2.down 事件和 zwp_tablet_v2.frame 事件。

请注意，此事件描述的是逻辑接触，而非物理接触。在某些设备上，合成器可能要到超过最小物理压力阈值时才认为工具处于逻辑接触状态。

每当数位板工具停止与数位板表面接触时，或当数位板工具移出输入区域且合成器抓取（如果有）被解除时发送。

如果数位板工具在与数位板表面接触时移出输入区域，且合成器没有对该 surface 的持续抓取，拥有该区域的客户端将收到 zwp_tablet_v2.up 事件，后跟 zwp_tablet_v2.proximity_out 事件和 zwp_tablet_v2.frame 事件。如果合成器对该设备有持续抓取，此事件序列将在将来抓取被解除时发送。

请注意，此事件描述的是逻辑接触，而非物理接触。在某些设备上，合成器可能要到物理压力降到特定阈值以下时才认为工具脱离逻辑接触。

每当数位板工具移动时发送。

每当工具上的压力轴变化时发送。此事件的值归一化为 0 到 65535 之间的值。

请注意，即使工具未处于逻辑接触状态，压力也可能非零。有关更多详细信息，请参阅 down 和 up 事件。

每当工具上的距离轴变化时发送。此事件的值归一化为 0 到 65535 之间的值。

请注意，即使工具未处于逻辑接触状态，距离也可能非零。有关更多详细信息，请参阅 down 和 up 事件。

每当工具上的一个或两个倾斜轴变化时发送。每个倾斜值以度为单位，相对于数位板的 z 轴。当工具顶部沿正 x 或 y 轴倾斜时，角度为正。

每当工具上的 z 旋转轴变化时发送。旋转值以度为单位，从工具的逻辑中性位置顺时针计算。

每当工具上的滑块位置变化时发送。值归一化在 -65535 到 65535 之间，0 表示滑块的逻辑中性位置。

滑块可用于例如 Wacom Airbrush 工具。

每当工具上的滚轮发出事件时发送。此事件包含同一轴变化的两个值。degrees 值与 wl_pointer.vertical_scroll 轴的方向相同。clicks 值是鼠标滚轮的离散逻辑刻度。如果滚轮移动不到一个逻辑刻度，此值可能为零。

客户端应选择其中一个值并避免混合使用 degrees 和 clicks。合成器可以累积小于一个逻辑刻度的值，并在达到特定阈值时模拟点击事件。因此，具有非零 clicks 值的 zwp_tablet_tool_v2.wheel 事件可能具有不同的 degrees 值。

每当工具上的按钮被按下或释放时发送。

如果工具进入或离开接近范围时有按钮被按住，合成器会生成按钮事件。详情请参阅 zwp_tablet_tool_v2.proximity_in 和 zwp_tablet_tool_v2.proximity_out。

标记来自数位板的一系列轴和/或按钮更新的结束。Wayland 协议要求轴更新按顺序发送，但帧中的所有事件应被视为一个硬件事件。

描述工具的物理类型。工具的物理类型通常决定其基本用途。

鼠标工具代表鼠标形状的工具，它不是相对设备而是绑定到数位板的表面，提供绝对坐标。

镜头工具是鼠标形状的工具，带有附加镜头以提供精确聚焦。

描述数位板上的额外功能。

任何工具都必须提供 x 和 y 值，额外的轴是设备特定的。

描述产生按钮事件的按钮的物理状态。

销毁客户端的此数位板对象资源。

数位板设备的描述性名称。

如果设备没有描述性名称，则不发送此事件。

此事件在 zwp_tablet_v2.done 事件之前的初始事件迸发中发送。

数位板设备的供应商和产品 ID。

ID 的解释取决于 zwp_tablet_v2.bustype。在此协议的 v2 之前，ID 隐含为 USB 供应商和产品 ID。如果未发送 zwp_tablet_v2.bustype，则 ID 将被解释为 USB 供应商和产品 ID。

如果设备没有供应商/产品 ID，则不发送此事件。例如虚拟设备或非 USB 设备可能发生这种情况。

此事件在 zwp_tablet_v2.done 事件之前的初始事件迸发中发送。

指示此 zwp_tablet_v2 背后设备的系统特定设备路径。此信息可用于获取关于设备的更多信息，例如通过 libwacom。

设备可能有多个设备路径。如果是这样，会发送多个 zwp_tablet_v2.path 事件。设备可能是模拟的且没有设备路径，在这种情况下不会发送此事件。

路径的格式未指定，可能是设备节点、sysfs 路径或其他标识符。由客户端负责识别所提供的字符串。

此事件在 zwp_tablet_v2.done 事件之前的初始事件迸发中发送。

此事件立即发送以标志初始描述性事件迸发的结束。客户端可以认为数位板的静态描述已完成并最终确定数位板的初始化。

当数位板从系统中移除时发送。当数位板被移除时，某些工具可能也会被移除。

收到此事件时，客户端必须 zwp_tablet_v2.destroy 该对象。

bustype 参数是 Linux 内核 linux/input.h 中 BUS_ 定义之一。

如果设备没有已知的总线类型或无法查询总线类型，则不发送此事件。

此事件在 zwp_tablet_v2.done 事件之前的初始事件迸发中发送。

描述此数位板连接的总线类型。

请求合成器使用与此环关联的提供的反馈字符串。此请求应在收到来自相应组的 zwp_tablet_pad_group_v2.mode_switch 事件后立即发出，或在环被映射到不同操作时发出。详情请参阅 zwp_tablet_pad_group_v2.mode_switch。

鼓励客户端为与环关联的操作提供上下文相关的描述；合成器可以使用此信息提供关于按钮布局的视觉反馈（例如屏幕显示）。

提供的字符串 'description' 是与此环关联的 UTF-8 编码字符串，被视为用户可见的；适用一般的国际化规则。

serial 参数将是此环所在组收到的最后一个 zwp_tablet_pad_group_v2.mode_switch 事件的 serial。提供非最近 serial 的请求将被忽略。

销毁客户端的此环对象资源。

触摸环事件的源信息。

此事件不会单独出现。它在 zwp_tablet_pad_ring_v2.frame 事件之前发送，并携带该帧中所有事件的源信息。

源指定此事件是如何生成的。如果源是 zwp_tablet_pad_ring_v2.source.finger，当用户将手指从设备上抬起时将发送 zwp_tablet_pad_ring_v2.stop 事件。

此事件是可选的。如果交互的源未知，则不发送事件。

每当触摸环上的角度变化时发送。

角度以度为单位，从 pad 当前旋转中环的逻辑北方顺时针计算。

触摸环事件的停止通知。

对于某些 zwp_tablet_pad_ring_v2.source 类型，会发送 zwp_tablet_pad_ring_v2.stop 事件来通知客户端与环的交互已终止。这使客户端能够实现动力滚动。有关何时可能生成此事件的信息，请参阅 zwp_tablet_pad_ring_v2.source 文档。

此后具有相同源的任何 zwp_tablet_pad_ring_v2.angle 事件应被视为新交互的开始。

指示一组逻辑上属于一起的触摸环事件的结束。客户端应累积帧中所有事件的数据后再继续处理。

zwp_tablet_pad_ring_v2.frame 事件之前的所有 zwp_tablet_pad_ring_v2 事件在逻辑上属于一起。例如，在终止触摸环上的手指交互时，合成器将发送 zwp_tablet_pad_ring_v2.source 事件、zwp_tablet_pad_ring_v2.stop 事件和 zwp_tablet_pad_ring_v2.frame 事件。

zwp_tablet_pad_ring_v2.frame 事件为每个逻辑事件组发送，即使该组只包含单个 zwp_tablet_pad_ring_v2 事件。具体来说，客户端可能获得序列：angle, frame, angle, frame 等。

描述触摸环事件的源类型。这向客户端指示触摸环事件是如何物理生成的；客户端可以相应地调整用户界面。例如，来自"手指"源的事件可能触发动力滚动。

请求合成器使用与此触摸条关联的提供的反馈字符串。此请求应在收到来自相应组的 zwp_tablet_pad_group_v2.mode_switch 事件后立即发出，或在触摸条被映射到不同操作时发出。详情请参阅 zwp_tablet_pad_group_v2.mode_switch。

鼓励客户端为与触摸条关联的操作提供上下文相关的描述，合成器可以使用此信息提供关于按钮布局的视觉反馈（例如屏幕显示）。

提供的字符串 'description' 是与此触摸条关联的 UTF-8 编码字符串，被视为用户可见的；适用一般的国际化规则。

serial 参数将是此触摸条所在组收到的最后一个 zwp_tablet_pad_group_v2.mode_switch 事件的 serial。提供非最近 serial 的请求将被忽略。

销毁客户端的此触摸条对象资源。

触摸条事件的源信息。

此事件不会单独出现。它在 zwp_tablet_pad_strip_v2.frame 事件之前发送，并携带该帧中所有事件的源信息。

源指定此事件是如何生成的。如果源是 zwp_tablet_pad_strip_v2.source.finger，当用户将手指从设备上抬起时将发送 zwp_tablet_pad_strip_v2.stop 事件。

此事件是可选的。如果交互的源未知，则不发送事件。

每当触摸条上的位置变化时发送。

位置归一化为 [0, 65535] 的范围，0 值表示 pad 当前旋转中触摸条的最顶部和/或最左侧位置。

触摸条事件的停止通知。

对于某些 zwp_tablet_pad_strip_v2.source 类型，会发送 zwp_tablet_pad_strip_v2.stop 事件来通知客户端与触摸条的交互已终止。这使客户端能够实现动力滚动。有关何时可能生成此事件的信息，请参阅 zwp_tablet_pad_strip_v2.source 文档。

此后具有相同源的任何 zwp_tablet_pad_strip_v2.position 事件应被视为新交互的开始。

指示代表一个逻辑硬件触摸条事件的一组事件的结束。客户端应累积帧中所有事件的数据后再继续处理。

zwp_tablet_pad_strip_v2.frame 事件之前的所有 zwp_tablet_pad_strip_v2 事件在逻辑上属于一起。例如，在终止触摸条上的手指交互时，合成器将发送 zwp_tablet_pad_strip_v2.source 事件、zwp_tablet_pad_strip_v2.stop 事件和 zwp_tablet_pad_strip_v2.frame 事件。

zwp_tablet_pad_strip_v2.frame 事件为每个逻辑事件组发送，即使该组只包含单个 zwp_tablet_pad_strip_v2 事件。具体来说，客户端可能获得序列：position, frame, position, frame 等。

描述触摸条事件的源类型。这向客户端指示触摸条事件是如何物理生成的；客户端可以相应地调整用户界面。例如，来自"手指"源的事件可能触发动力滚动。

销毁 zwp_tablet_pad_group_v2 对象。由此对象创建的对象不受影响，应单独销毁。

在 zwp_tablet_pad_group_v2 初始化时发送以宣告组中可用的按钮。按钮索引从 0 开始，一个按钮一次只能在一个组中。

此事件在 zwp_tablet_pad_group_v2.done 事件之前的初始事件迸发中首次发送。

某些按钮由合成器保留。这些按钮不能分配给任何 zwp_tablet_pad_group_v2。合成器可以在这些保留按钮的映射更改时广播此事件。如果合成器恰好保留了组中的所有按钮，此事件将发送空数组。

在 zwp_tablet_pad_group_v2 初始化时发送以宣告可用的触摸环。为此 pad 组中的每个触摸环发送一个事件。

此事件在 zwp_tablet_pad_group_v2.done 事件之前的初始事件迸发中发送。

在 zwp_tablet_pad_v2 初始化时发送以宣告可用的触摸条。为此 pad 组中的每个触摸条发送一个事件。

此事件在 zwp_tablet_pad_group_v2.done 事件之前的初始事件迸发中发送。

在 zwp_tablet_pad_group_v2 初始化时发送以宣告 pad 组可以在模式之间切换。客户端可以使用模式为按钮、触摸环和触摸条存储特定配置，并使用 zwp_tablet_pad_group_v2.mode_switch 事件在这些配置之间切换。模式索引从 0 开始。

模式切换取决于合成器。详情请参阅 zwp_tablet_pad_group_v2.mode_switch 事件。

此事件在 zwp_tablet_pad_group_v2.done 事件之前的初始事件迸发中发送。仅当有多个可用模式时才发送此事件。

此事件立即发送以标志初始描述性事件迸发的结束。客户端可以认为数位板的静态描述已完成并最终确定 tablet 组的初始化。

通知模式已切换。

模式同时应用于组中的所有按钮、触摸环、触摸条和拨盘，但客户端不需要为每个模式分配不同的操作。例如，客户端可以有模式特定的按钮映射，但在所有模式中将触摸环映射到垂直滚动。模式索引从 0 开始。

模式切换取决于合成器。合成器可以向用户提供关于模式的视觉提示，例如通过切换数位板设备上的 LED。模式切换可以是软件控制的，也可以由一个或多个物理按钮控制。例如，在 Wacom Intuos Pro 上，触摸环内的按钮可以分配为在模式之间切换。

合成器还会在 zwp_tablet_pad_v2.enter 之后为每个组发送此事件以通知当前模式。只有一个模式的组在发出此事件时将使用 mode=0。

如果新模式中的按钮操作与前一个模式不同，客户端应立即为每个更改的按钮发出 zwp_tablet_pad_v2.set_feedback 请求。

如果新模式中的触摸环、触摸条或拨盘操作与前一个模式不同，客户端应立即为每个更改的触摸环、触摸条或拨盘发出 zwp_tablet_ring_v2.set_feedback、zwp_tablet_strip_v2.set_feedback 或 zwp_tablet_dial_v2.set_feedback 请求。

在 zwp_tablet_pad_v2 初始化时发送以宣告可用的拨盘。为此 pad 组中的每个拨盘发送一个事件。

此事件在 zwp_tablet_pad_group_v2.done 事件之前的初始事件迸发中发送。

请求合成器使用与此按钮关联的提供的反馈字符串。此请求应在收到来自相应组的 zwp_tablet_pad_group_v2.mode_switch 事件后立即发出，或在按钮被映射到不同操作时发出。详情请参阅 zwp_tablet_pad_group_v2.mode_switch。

鼓励客户端为与每个按钮关联的操作提供上下文相关的描述，合成器可以使用此信息提供关于按钮布局的视觉反馈（例如屏幕显示）。

按钮索引从 0 开始。对合成器保留的按钮（即不属于任何 zwp_tablet_pad_group_v2）设置反馈字符串不会生成错误，但合成器可以忽略该请求。

提供的字符串 'description' 是与此按钮关联的 UTF-8 编码字符串，被视为用户可见的；适用一般的国际化规则。

serial 参数将是此按钮所在组收到的最后一个 zwp_tablet_pad_group_v2.mode_switch 事件的 serial。提供非最近 serial 的请求将被忽略。

销毁 zwp_tablet_pad_v2 对象。由此对象创建的对象不受影响，应单独销毁。

在 zwp_tablet_pad_v2 初始化时发送以宣告可用的组。为每个可用的 pad 组发送一个事件。

此事件在 zwp_tablet_pad_v2.done 事件之前的初始事件迸发中发送。至少会宣告一个组。

指示此 zwp_tablet_pad_v2 背后设备的系统特定设备路径。此信息可用于获取关于设备的更多信息，例如通过 libwacom。

路径的格式未指定，可能是设备节点、sysfs 路径或其他标识符。由客户端负责识别所提供的字符串。

此事件在 zwp_tablet_pad_v2.done 事件之前的初始事件迸发中发送。

在 zwp_tablet_pad_v2 初始化时发送以宣告可用的按钮。

此事件在 zwp_tablet_pad_v2.done 事件之前的初始事件迸发中发送。仅当至少有一个按钮可用时才发送此事件。

此事件标志初始描述性事件迸发的结束。客户端可以认为 pad 的静态描述已完成并最终确定 pad 的初始化。

每当按钮的物理状态变化时发送。

通知此 pad 聚焦在指定的 surface 上。

通知此 pad 不再聚焦在指定的 surface 上。

当 pad 从系统中移除时发送。当数位板被移除时，其 pad 也会被移除。

收到此事件时，客户端必须销毁此 pad 提供的所有触摸环、触摸条和组，并发出 zwp_tablet_pad_v2.destroy 销毁 pad 本身。

描述导致按钮事件的按钮的物理状态。

请求合成器使用与此拨盘关联的提供的反馈字符串。此请求应在收到来自相应组的 zwp_tablet_pad_group_v2.mode_switch 事件后立即发出，或在拨盘被映射到不同操作时发出。详情请参阅 zwp_tablet_pad_group_v2.mode_switch。

鼓励客户端为与拨盘关联的操作提供上下文相关的描述，合成器可以使用此信息提供关于按钮布局的视觉反馈（例如屏幕显示）。

提供的字符串 'description' 是与此拨盘关联的 UTF-8 编码字符串，被视为用户可见的；适用一般的国际化规则。

serial 参数将是此拨盘所在组收到的最后一个 zwp_tablet_pad_group_v2.mode_switch 事件的 serial。提供非最近 serial 的请求将被忽略。

销毁客户端的此拨盘对象资源。

每当拨盘上的位置变化时发送。

此事件携带滚轮增量值，以 120 的倍数或分数表示，每个 120 的倍数代表一个逻辑滚轮刻度。例如，axis_value120 为 30 表示正方向上四分之一个逻辑滚轮步长，value120 为 -240 表示同一硬件事件中负方向上两个逻辑滚轮步长。详情请参阅 wl_pointer.axis_value120。

value120 不得为零。

指示代表一个逻辑硬件拨盘事件的一组事件的结束。客户端应累积帧中所有事件的数据后再继续处理。

zwp_tablet_pad_dial_v2.frame 事件之前的所有 zwp_tablet_pad_dial_v2 事件在逻辑上属于一起。

zwp_tablet_pad_dial_v2.frame 事件为每个逻辑事件组发送，即使该组只包含单个 zwp_tablet_pad_dial_v2 事件。具体来说，客户端可能获得序列：delta, frame, delta, frame 等。