wayland::serve...pad_group_v2_t(3)

📦
version 1.0.1 · 11 versions
, in ubuntu stonking

💅 wayland::server::zwp_tablet_pad_group_v2_t(3) — Wayland++

okay bestie so this is the wayland::server::zwp_tablet_pad_group_v2_t page from Wayland++, and it's genuinely giving "tablet pad group lore" ✨ it's a whole class that represents a set of buttons, rings and strips, and we are going to get into all of it, no skips, no cap 💖

🌸 NAME 🌸

wayland::server::zwp_tablet_pad_group_v2_t — literally a set of buttons, rings and strips 🎀

✨ SYNOPSIS ✨

#include <wayland-server-protocol-unstable.hpp>

🫶 Public Member Functions

  • std::function< void()> & on_destroy () — destroy the pad object
  • void buttons (array_t const &buttons, bool post=true) — buttons announced
  • void ring (bool post=true) — ring announced
  • void strip (bool post=true) — strip announced
  • void modes (uint32_t modes, bool post=true) — mode-switch ability announced
  • void done (bool post=true) — tablet group description events sequence complete
  • void mode_switch (uint32_t time, uint32_t serial, uint32_t mode, bool post=true) — mode switch event
  • bool proxy_has_object () const — Check whether this wrapper actually wraps an object.
  • void post_no_memory () const
  • uint32_t get_id () const
  • client_t get_client () const
  • unsigned int get_version () const
  • std::string get_class ()

🦋 Static Public Attributes

  • static constexpr std::uint32_t buttons_since_version = 1 — Minimum protocol version required for the buttons function.
  • static constexpr std::uint32_t ring_since_version = 1 — Minimum protocol version required for the ring function.
  • static constexpr std::uint32_t strip_since_version = 1 — Minimum protocol version required for the strip function.
  • static constexpr std::uint32_t modes_since_version = 1 — Minimum protocol version required for the modes function.
  • static constexpr std::uint32_t done_since_version = 1 — Minimum protocol version required for the done function.
  • static constexpr std::uint32_t mode_switch_since_version = 1 — Minimum protocol version required for the mode_switch function.

💜 Detailed Description 💜

a set of buttons, rings and strips 👑

so a pad group describes a distinct (sub)set of buttons, rings and strips that are present in the tablet. the criteria for this grouping is usually positional — like, eg. if a tablet has buttons on the left and right side, 2 groups will be presented. the physical arrangement of groups is undisclosed and may change on the fly 😭 (yes, on the fly, don't @ me).

pad groups will announce their features during pad initialization. between the corresponding wp_tablet_pad.group event and wp_tablet_pad_group.done, the pad group will announce the buttons, rings and strips contained in it, plus the number of supported modes ✨

modes are a mechanism to allow multiple groups of actions for every element in the pad group. the number of groups and available modes in each is persistent across device plugs. the current mode is user-switchable, and it will be announced through the wp_tablet_pad_group.mode_switch event both whenever it is switched, and after wp_tablet_pad.enter.

the current mode logically applies to all elements in the pad group, although it is at clients' discretion whether to actually perform different actions, and/or issue the respective .set_feedback requests to notify the compositor. see the wp_tablet_pad_group.mode_switch event for more details 👀

Definition at line 5994 of file wayland-server-protocol-unstable.hpp. 📌

🎀 Member Function Documentation 🎀

💖 void zwp_tablet_pad_group_v2_t::buttons (array_t const & buttons, bool post = true)

buttons announced — iconic, honestly.

Parameters

  • buttons — buttons in this group

sent on wp_tablet_pad_group initialization to announce the available buttons in the group. button indices start at 0, and a button may only be in one group at a time. periodt.

this event is first sent in the initial burst of events before the wp_tablet_pad_group.done event.

some buttons are reserved by the compositor. these buttons may not be assigned to any wp_tablet_pad_group. compositors may broadcast this event in the case of changes to the mapping of these reserved buttons. if the compositor happens to reserve all buttons in a group, this event will be sent with an empty array 🫥

Definition at line 6839 of file wayland-server-protocol-unstable.cpp.

🌈 void zwp_tablet_pad_group_v2_t::done (bool post = true)

tablet group description events sequence complete — the finale, the curtain call 🎬

this event is sent immediately to signal the end of the initial burst of descriptive events. a client may consider the static description of the tablet to be complete and finalize initialization of the tablet group. slay, you're initialized 💅

Definition at line 6859 of file wayland-server-protocol-unstable.cpp.

🧚 std::string wayland::server::resource_t::get_class () [inherited]

retrieve the interface name (class) of a resource object.

Returns

  • interface name of the resource object.

🍓 client_t wayland::server::resource_t::get_client () const [inherited]

get the associated client 💌

Returns

  • the client that owns the resource.

⭐ uint32_t wayland::server::resource_t::get_id () const [inherited]

get the internal ID of the resource

Returns

  • the internal ID of the resource

🦋 unsigned int wayland::server::resource_t::get_version () const [inherited]

get interface version

Returns

  • interface version this resource has been constructed with.

🔥 void zwp_tablet_pad_group_v2_t::mode_switch (uint32_t time, uint32_t serial, uint32_t mode, bool post = true)

mode switch event — the main character moment of this whole page ngl

Parameters

  • time — the time of the event with millisecond granularity
  • serial
  • mode — the new mode of the pad

notification that the mode was switched.

a mode applies to all buttons, rings and strips in a group simultaneously, but a client is not required to assign different actions for each mode. for example, a client may have mode-specific button mappings but map the ring to vertical scrolling in all modes. mode indices start at 0.

switching modes is compositor-dependent. the compositor may provide visual cues to the client about the mode, e.g. by toggling LEDs on the tablet device. mode-switching may be software-controlled or controlled by one or more physical buttons. for example, on a Wacom Intuos Pro, the button inside the ring may be assigned to switch between modes 🖊️✨

the compositor will also send this event after wp_tablet_pad.enter on each group in order to notify of the current mode. groups that only feature one mode will use mode=0 when emitting this event.

if a button action in the new mode differs from the action in the previous mode, the client should immediately issue a wp_tablet_pad.set_feedback request for each changed button.

if a ring or strip action in the new mode differs from the action in the previous mode, the client should immediately issue a wp_tablet_ring.set_feedback or wp_tablet_strip.set_feedback request for each changed ring or strip.

Definition at line 6864 of file wayland-server-protocol-unstable.cpp.

🌸 void zwp_tablet_pad_group_v2_t::modes (uint32_t modes, bool post = true)

mode-switch ability announced

Parameters

  • modes — the number of modes

sent on wp_tablet_pad_group initialization to announce that the pad group may switch between modes. a client may use a mode to store a specific configuration for buttons, rings and strips and use the wl_tablet_pad_group.mode_switch event to toggle between these configurations. mode indices start at 0.

switching modes is compositor-dependent. see the wp_tablet_pad_group.mode_switch event for more details.

this event is sent in the initial burst of events before the wp_tablet_pad_group.done event. this event is only sent when more than more than one mode is available. (yes, the original says "more than more than" — not a typo on my end, bestie, i'm keeping it exactly as the source has it 😭💀)

Definition at line 6854 of file wayland-server-protocol-unstable.cpp.

👑 std::function< void()> & zwp_tablet_pad_group_v2_t::on_destroy ()

destroy the pad object — bye bestie 🫶

destroy the wp_tablet_pad_group object. objects created from this object are unaffected and should be destroyed separately. no take-backs, no cascading deletes, that's the rule 📜

Definition at line 6833 of file wayland-server-protocol-unstable.cpp.

💜 void wayland::server::resource_t::post_no_memory () const [inherited]

post "not enough memory" error to the client

if the compositor has not enough memory to fulfill a certail request of the client, this function can be called to notify the client of this circumstance. (and yes, "certail" is spelled that way in the source, keeping it 100% verbatim 🙈)

🎀 bool wayland::server::resource_t::proxy_has_object () const [inherited]

check whether this wrapper actually wraps an object 🔍

Returns

  • true if there is an underlying object, false if this wrapper is empty

🌈 void zwp_tablet_pad_group_v2_t::ring (bool post = true)

ring announced — sent on wp_tablet_pad_group initialization to announce available rings. one event is sent for each ring available on this pad group.

this event is sent in the initial burst of events before the wp_tablet_pad_group.done event.

Definition at line 6844 of file wayland-server-protocol-unstable.cpp.

🧚 void zwp_tablet_pad_group_v2_t::strip (bool post = true)

strip announced — sent on wp_tablet_pad initialization to announce available strips. one event is sent for each strip available on this pad group.

this event is sent in the initial burst of events before the wp_tablet_pad_group.done event.

Definition at line 6849 of file wayland-server-protocol-unstable.cpp.

💅 Member Data Documentation 💅

🌟 std::uint32_t wayland::server::zwp_tablet_pad_group_v2_t::buttons_since_version = 1 [static], [constexpr]

minimum protocol version required for the buttons function.

Definition at line 6049 of file wayland-server-protocol-unstable.hpp.

🌟 std::uint32_t wayland::server::zwp_tablet_pad_group_v2_t::done_since_version = 1 [static], [constexpr]

minimum protocol version required for the done function.

Definition at line 6116 of file wayland-server-protocol-unstable.hpp.

🌟 std::uint32_t wayland::server::zwp_tablet_pad_group_v2_t::mode_switch_since_version = 1 [static], [constexpr]

minimum protocol version required for the mode_switch function.

Definition at line 6156 of file wayland-server-protocol-unstable.hpp.

🌟 std::uint32_t wayland::server::zwp_tablet_pad_group_v2_t::modes_since_version = 1 [static], [constexpr]

minimum protocol version required for the modes function.

Definition at line 6102 of file wayland-server-protocol-unstable.hpp.

🌟 std::uint32_t wayland::server::zwp_tablet_pad_group_v2_t::ring_since_version = 1 [static], [constexpr]

minimum protocol version required for the ring function.

Definition at line 6064 of file wayland-server-protocol-unstable.hpp.

🌟 std::uint32_t wayland::server::zwp_tablet_pad_group_v2_t::strip_since_version = 1 [static], [constexpr]

minimum protocol version required for the strip function.

Definition at line 6079 of file wayland-server-protocol-unstable.hpp.

🦋 Author 🦋

generated automatically by Doxygen for Wayland++ from the source code 🤖 (the bots ate, honestly)

Version 1.0.1 — Fri Mar 27 2026 🗓️✨ and that's the whole page bestie, wayland::server::zwp_tablet_pad_group_v2_t(3) signing off — go forth and group those buttons, rings and strips 💖🎀🫶
📦 where this page comes from