#include "wayland-client.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @page page_tablet_v2 The tablet_v2 protocol
* Wayland protocol for graphics tablets
*
* @section page_desc_tablet_v2 Description
*
* This description provides a high-level overview of the interplay between
* the interfaces defined this protocol. For details, see the protocol
* specification.
*
* More than one tablet may exist, and device-specifics matter. Tablets are
* not represented by a single virtual device like wl_pointer. A client
* binds to the tablet manager object which is just a proxy object. From
* that, the client requests wp_tablet_manager.get_tablet_seat(wl_seat)
* and that returns the actual interface that has all the tablets. With
* this indirection, we can avoid merging wp_tablet into the actual Wayland
* protocol, a long-term benefit.
*
* The wp_tablet_seat sends a "tablet added" event for each tablet
* connected. That event is followed by descriptive events about the
* hardware; currently that includes events for name, vid/pid and
* a wp_tablet.path event that describes a local path. This path can be
* used to uniquely identify a tablet or get more information through
* libwacom. Emulated or nested tablets can skip any of those, e.g. a
* virtual tablet may not have a vid/pid. The sequence of descriptive
* events is terminated by a wp_tablet.done event to signal that a client
* may now finalize any initialization for that tablet.
*
* Events from tablets require a tool in proximity. Tools are also managed
* by the tablet seat; a "tool added" event is sent whenever a tool is new
* to the compositor. That event is followed by a number of descriptive
* events about the hardware; currently that includes capabilities,
* hardware id and serial number, and tool type. Similar to the tablet
* interface, a wp_tablet_tool.done event is sent to terminate that initial
* sequence.
*
* Any event from a tool happens on the wp_tablet_tool interface. When the
* tool gets into proximity of the tablet, a proximity_in event is sent on
* the wp_tablet_tool interface, listing the tablet and the surface. That
* event is followed by a motion event with the coordinates. After that,
* it's the usual motion, axis, button, etc. events. The protocol's
* serialisation means events are grouped by wp_tablet_tool.frame events.
*
* Two special events (that don't exist in X) are down and up. They signal
* "tip touching the surface". For tablets without real proximity
* detection, the sequence is: proximity_in, motion, down, frame.
*
* When the tool leaves proximity, a proximity_out event is sent. If any
* button is still down, a button release event is sent before this
* proximity event. These button events are sent in the same frame as the
* proximity event to signal to the client that the buttons were held when
* the tool left proximity.
*
* If the tool moves out of the surface but stays in proximity (i.e.
* between windows), compositor-specific grab policies apply. This usually
* means that the proximity-out is delayed until all buttons are released.
*
* Moving a tool physically from one tablet to the other has no real effect
* on the protocol, since we already have the tool object from the "tool
* added" event. All the information is already there and the proximity
* events on both tablets are all a client needs to reconstruct what
* happened.
*
* Some extra axes are normalized, i.e. the client knows the range as
* specified in the protocol (e.g. [0, 65535]), the granularity however is
* unknown. The current normalized axes are pressure, distance, and slider.
*
* Other extra axes are in physical units as specified in the protocol.
* The current extra axes with physical units are tilt, rotation and
* wheel rotation.
*
* Since tablets work independently of the pointer controlled by the mouse,
* the focus handling is independent too and controlled by proximity.
* The wp_tablet_tool.set_cursor request sets a tool-specific cursor.
* This cursor surface may be the same as the mouse cursor, and it may be
* the same across tools but it is possible to be more fine-grained. For
* example, a client may set different cursors for the pen and eraser.
*
* Tools are generally independent of tablets and it is
* compositor-specific policy when a tool can be removed. Common approaches
* will likely include some form of removing a tool when all tablets the
* tool was used on are removed.
*
* @section page_ifaces_tablet_v2 Interfaces
* - @subpage page_iface_zwp_tablet_manager_v2 - controller object for graphic tablet devices
* - @subpage page_iface_zwp_tablet_seat_v2 - controller object for graphic tablet devices of a seat
* - @subpage page_iface_zwp_tablet_tool_v2 - a physical tablet tool
* - @subpage page_iface_zwp_tablet_v2 - graphics tablet device
* - @subpage page_iface_zwp_tablet_pad_ring_v2 - pad ring
* - @subpage page_iface_zwp_tablet_pad_strip_v2 - pad strip
* - @subpage page_iface_zwp_tablet_pad_group_v2 - a set of buttons, rings and strips
* - @subpage page_iface_zwp_tablet_pad_v2 - a set of buttons, rings, strips and dials
* - @subpage page_iface_zwp_tablet_pad_dial_v2 - pad dial
* @section page_copyright_tablet_v2 Copyright
*
*
* Copyright 2014 © Stephen "Lyude" Chandler Paul
* Copyright 2015-2024 © Red Hat, Inc.
*
* 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.
*
*/
struct wl_seat;
struct wl_surface;
struct zwp_tablet_manager_v2;
struct zwp_tablet_pad_dial_v2;
struct zwp_tablet_pad_group_v2;
struct zwp_tablet_pad_ring_v2;
struct zwp_tablet_pad_strip_v2;
struct zwp_tablet_pad_v2;
struct zwp_tablet_seat_v2;
struct zwp_tablet_tool_v2;
struct zwp_tablet_v2;
#ifndef ZWP_TABLET_MANAGER_V2_INTERFACE
#define ZWP_TABLET_MANAGER_V2_INTERFACE
/**
* @page page_iface_zwp_tablet_manager_v2 zwp_tablet_manager_v2
* @section page_iface_zwp_tablet_manager_v2_desc Description
*
* An object that provides access to the graphics tablets available on this
* system. All tablets are associated with a seat, to get access to the
* actual tablets, use wp_tablet_manager.get_tablet_seat.
* @section page_iface_zwp_tablet_manager_v2_api API
* See @ref iface_zwp_tablet_manager_v2.
*/
/**
* @defgroup iface_zwp_tablet_manager_v2 The zwp_tablet_manager_v2 interface
*
* An object that provides access to the graphics tablets available on this
* system. All tablets are associated with a seat, to get access to the
* actual tablets, use wp_tablet_manager.get_tablet_seat.
*/
extern const struct wl_interface zwp_tablet_manager_v2_interface;
#endif
#ifndef ZWP_TABLET_SEAT_V2_INTERFACE
#define ZWP_TABLET_SEAT_V2_INTERFACE
/**
* @page page_iface_zwp_tablet_seat_v2 zwp_tablet_seat_v2
* @section page_iface_zwp_tablet_seat_v2_desc Description
*
* An object that provides access to the graphics tablets available on this
* seat. After binding to this interface, the compositor sends a set of
* wp_tablet_seat.tablet_added and wp_tablet_seat.tool_added events.
* @section page_iface_zwp_tablet_seat_v2_api API
* See @ref iface_zwp_tablet_seat_v2.
*/
/**
* @defgroup iface_zwp_tablet_seat_v2 The zwp_tablet_seat_v2 interface
*
* An object that provides access to the graphics tablets available on this
* seat. After binding to this interface, the compositor sends a set of
* wp_tablet_seat.tablet_added and wp_tablet_seat.tool_added events.
*/
extern const struct wl_interface zwp_tablet_seat_v2_interface;
#endif
#ifndef ZWP_TABLET_TOOL_V2_INTERFACE
#define ZWP_TABLET_TOOL_V2_INTERFACE
/**
* @page page_iface_zwp_tablet_tool_v2 zwp_tablet_tool_v2
* @section page_iface_zwp_tablet_tool_v2_desc Description
*
* An object that represents a physical tool that has been, or is
* currently in use with a tablet in this seat. Each wp_tablet_tool
* object stays valid until the client destroys it; the compositor
* reuses the wp_tablet_tool object to indicate that the object's
* respective physical tool has come into proximity of a tablet again.
*
* A wp_tablet_tool object's relation to a physical tool depends on the
* tablet's ability to report serial numbers. If the tablet supports
* this capability, then the object represents a specific physical tool
* and can be identified even when used on multiple tablets.
*
* A tablet tool has a number of static characteristics, e.g. tool type,
* hardware_serial and capabilities. These capabilities are sent in an
* event sequence after the wp_tablet_seat.tool_added event before any
* actual events from this tool. This initial event sequence is
* terminated by a wp_tablet_tool.done event.
*
* Tablet tool events are grouped by wp_tablet_tool.frame events.
* Any events received before a wp_tablet_tool.frame event should be
* considered part of the same hardware state change.
* @section page_iface_zwp_tablet_tool_v2_api API
* See @ref iface_zwp_tablet_tool_v2.
*/
/**
* @defgroup iface_zwp_tablet_tool_v2 The zwp_tablet_tool_v2 interface
*
* An object that represents a physical tool that has been, or is
* currently in use with a tablet in this seat. Each wp_tablet_tool
* object stays valid until the client destroys it; the compositor
* reuses the wp_tablet_tool object to indicate that the object's
* respective physical tool has come into proximity of a tablet again.
*
* A wp_tablet_tool object's relation to a physical tool depends on the
* tablet's ability to report serial numbers. If the tablet supports
* this capability, then the object represents a specific physical tool
* and can be identified even when used on multiple tablets.
*
* A tablet tool has a number of static characteristics, e.g. tool type,
* hardware_serial and capabilities. These capabilities are sent in an
* event sequence after the wp_tablet_seat.tool_added event before any
* actual events from this tool. This initial event sequence is
* terminated by a wp_tablet_tool.done event.
*
* Tablet tool events are grouped by wp_tablet_tool.frame events.
* Any events received before a wp_tablet_tool.frame event should be
* considered part of the same hardware state change.
*/
extern const struct wl_interface zwp_tablet_tool_v2_interface;
#endif
#ifndef ZWP_TABLET_V2_INTERFACE
#define ZWP_TABLET_V2_INTERFACE
/**
* @page page_iface_zwp_tablet_v2 zwp_tablet_v2
* @section page_iface_zwp_tablet_v2_desc Description
*
* The wp_tablet interface represents one graphics tablet device. The
* tablet interface itself does not generate events; all events are
* generated by wp_tablet_tool objects when in proximity above a tablet.
*
* A tablet has a number of static characteristics, e.g. device name and
* pid/vid. These capabilities are sent in an event sequence after the
* wp_tablet_seat.tablet_added event. This initial event sequence is
* terminated by a wp_tablet.done event.
* @section page_iface_zwp_tablet_v2_api API
* See @ref iface_zwp_tablet_v2.
*/
/**
* @defgroup iface_zwp_tablet_v2 The zwp_tablet_v2 interface
*
* The wp_tablet interface represents one graphics tablet device. The
* tablet interface itself does not generate events; all events are
* generated by wp_tablet_tool objects when in proximity above a tablet.
*
* A tablet has a number of static characteristics, e.g. device name and
* pid/vid. These capabilities are sent in an event sequence after the
* wp_tablet_seat.tablet_added event. This initial event sequence is
* terminated by a wp_tablet.done event.
*/
extern const struct wl_interface zwp_tablet_v2_interface;
#endif
#ifndef ZWP_TABLET_PAD_RING_V2_INTERFACE
#define ZWP_TABLET_PAD_RING_V2_INTERFACE
/**
* @page page_iface_zwp_tablet_pad_ring_v2 zwp_tablet_pad_ring_v2
* @section page_iface_zwp_tablet_pad_ring_v2_desc Description
*
* A circular interaction area, such as the touch ring on the Wacom Intuos
* Pro series tablets.
*
* Events on a ring are logically grouped by the wl_tablet_pad_ring.frame
* event.
* @section page_iface_zwp_tablet_pad_ring_v2_api API
* See @ref iface_zwp_tablet_pad_ring_v2.
*/
/**
* @defgroup iface_zwp_tablet_pad_ring_v2 The zwp_tablet_pad_ring_v2 interface
*
* A circular interaction area, such as the touch ring on the Wacom Intuos
* Pro series tablets.
*
* Events on a ring are logically grouped by the wl_tablet_pad_ring.frame
* event.
*/
extern const struct wl_interface zwp_tablet_pad_ring_v2_interface;
#endif
#ifndef ZWP_TABLET_PAD_STRIP_V2_INTERFACE
#define ZWP_TABLET_PAD_STRIP_V2_INTERFACE
/**
* @page page_iface_zwp_tablet_pad_strip_v2 zwp_tablet_pad_strip_v2
* @section page_iface_zwp_tablet_pad_strip_v2_desc Description
*
* A linear interaction area, such as the strips found in Wacom Cintiq
* models.
*
* Events on a strip are logically grouped by the wl_tablet_pad_strip.frame
* event.
* @section page_iface_zwp_tablet_pad_strip_v2_api API
* See @ref iface_zwp_tablet_pad_strip_v2.
*/
/**
* @defgroup iface_zwp_tablet_pad_strip_v2 The zwp_tablet_pad_strip_v2 interface
*
* A linear interaction area, such as the strips found in Wacom Cintiq
* models.
*
* Events on a strip are logically grouped by the wl_tablet_pad_strip.frame
* event.
*/
extern const struct wl_interface zwp_tablet_pad_strip_v2_interface;
#endif
#ifndef ZWP_TABLET_PAD_GROUP_V2_INTERFACE
#define ZWP_TABLET_PAD_GROUP_V2_INTERFACE
/**
* @page page_iface_zwp_tablet_pad_group_v2 zwp_tablet_pad_group_v2
* @section page_iface_zwp_tablet_pad_group_v2_desc Description
*
* A pad group describes a distinct (sub)set of buttons, rings and strips
* present in the tablet. The criteria of this grouping is usually positional,
* 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.
*
* 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, 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.
* @section page_iface_zwp_tablet_pad_group_v2_api API
* See @ref iface_zwp_tablet_pad_group_v2.
*/
/**
* @defgroup iface_zwp_tablet_pad_group_v2 The zwp_tablet_pad_group_v2 interface
*
* A pad group describes a distinct (sub)set of buttons, rings and strips
* present in the tablet. The criteria of this grouping is usually positional,
* 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.
*
* 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, 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.
*/
extern const struct wl_interface zwp_tablet_pad_group_v2_interface;
#endif
#ifndef ZWP_TABLET_PAD_V2_INTERFACE
#define ZWP_TABLET_PAD_V2_INTERFACE
/**
* @page page_iface_zwp_tablet_pad_v2 zwp_tablet_pad_v2
* @section page_iface_zwp_tablet_pad_v2_desc Description
*
* A pad device is a set of buttons, rings, strips and dials
* usually physically present on the tablet device itself. Some
* exceptions exist where the pad device is physically detached, e.g. the
* Wacom ExpressKey Remote.
*
* Pad devices have no axes that control the cursor and are generally
* auxiliary devices to the tool devices used on the tablet surface.
*
* A pad device has a number of static characteristics, e.g. the number
* of rings. These capabilities are sent in an event sequence after the
* wp_tablet_seat.pad_added event before any actual events from this pad.
* This initial event sequence is terminated by a wp_tablet_pad.done
* event.
*
* All pad features (buttons, rings, strips and dials) are logically divided into
* groups and all pads have at least one group. The available groups are
* notified through the wp_tablet_pad.group event; the compositor will
* emit one event per group before emitting wp_tablet_pad.done.
*
* Groups may have multiple modes. Modes allow clients to map multiple
* actions to a single pad feature. Only one mode can be active per group,
* although different groups may have different active modes.
* @section page_iface_zwp_tablet_pad_v2_api API
* See @ref iface_zwp_tablet_pad_v2.
*/
/**
* @defgroup iface_zwp_tablet_pad_v2 The zwp_tablet_pad_v2 interface
*
* A pad device is a set of buttons, rings, strips and dials
* usually physically present on the tablet device itself. Some
* exceptions exist where the pad device is physically detached, e.g. the
* Wacom ExpressKey Remote.
*
* Pad devices have no axes that control the cursor and are generally
* auxiliary devices to the tool devices used on the tablet surface.
*
* A pad device has a number of static characteristics, e.g. the number
* of rings. These capabilities are sent in an event sequence after the
* wp_tablet_seat.pad_added event before any actual events from this pad.
* This initial event sequence is terminated by a wp_tablet_pad.done
* event.
*
* All pad features (buttons, rings, strips and dials) are logically divided into
* groups and all pads have at least one group. The available groups are
* notified through the wp_tablet_pad.group event; the compositor will
* emit one event per group before emitting wp_tablet_pad.done.
*
* Groups may have multiple modes. Modes allow clients to map multiple
* actions to a single pad feature. Only one mode can be active per group,
* although different groups may have different active modes.
*/
extern const struct wl_interface zwp_tablet_pad_v2_interface;
#endif
#ifndef ZWP_TABLET_PAD_DIAL_V2_INTERFACE
#define ZWP_TABLET_PAD_DIAL_V2_INTERFACE
/**
* @page page_iface_zwp_tablet_pad_dial_v2 zwp_tablet_pad_dial_v2
* @section page_iface_zwp_tablet_pad_dial_v2_desc Description
*
* A rotary control, e.g. a dial or a wheel.
*
* Events on a dial are logically grouped by the wl_tablet_pad_dial.frame
* event.
* @section page_iface_zwp_tablet_pad_dial_v2_api API
* See @ref iface_zwp_tablet_pad_dial_v2.
*/
/**
* @defgroup iface_zwp_tablet_pad_dial_v2 The zwp_tablet_pad_dial_v2 interface
*
* A rotary control, e.g. a dial or a wheel.
*
* Events on a dial are logically grouped by the wl_tablet_pad_dial.frame
* event.
*/
extern const struct wl_interface zwp_tablet_pad_dial_v2_interface;
#endif
#define ZWP_TABLET_MANAGER_V2_GET_TABLET_SEAT 0
#define ZWP_TABLET_MANAGER_V2_DESTROY 1
/**
* @ingroup iface_zwp_tablet_manager_v2
*/
#define ZWP_TABLET_MANAGER_V2_GET_TABLET_SEAT_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_manager_v2
*/
#define ZWP_TABLET_MANAGER_V2_DESTROY_SINCE_VERSION 1
/** @ingroup iface_zwp_tablet_manager_v2 */
static inline void
zwp_tablet_manager_v2_set_user_data(struct zwp_tablet_manager_v2 *zwp_tablet_manager_v2, void *user_data)
{
wl_proxy_set_user_data((struct wl_proxy *) zwp_tablet_manager_v2, user_data);
}
/** @ingroup iface_zwp_tablet_manager_v2 */
static inline void *
zwp_tablet_manager_v2_get_user_data(struct zwp_tablet_manager_v2 *zwp_tablet_manager_v2)
{
return wl_proxy_get_user_data((struct wl_proxy *) zwp_tablet_manager_v2);
}
static inline uint32_t
zwp_tablet_manager_v2_get_version(struct zwp_tablet_manager_v2 *zwp_tablet_manager_v2)
{
return wl_proxy_get_version((struct wl_proxy *) zwp_tablet_manager_v2);
}
/**
* @ingroup iface_zwp_tablet_manager_v2
*
* Get the wp_tablet_seat object for the given seat. This object
* provides access to all graphics tablets in this seat.
*/
static inline struct zwp_tablet_seat_v2 *
zwp_tablet_manager_v2_get_tablet_seat(struct zwp_tablet_manager_v2 *zwp_tablet_manager_v2, struct wl_seat *seat)
{
struct wl_proxy *tablet_seat;
tablet_seat = wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_manager_v2,
ZWP_TABLET_MANAGER_V2_GET_TABLET_SEAT, &zwp_tablet_seat_v2_interface, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_manager_v2), 0, NULL, seat);
return (struct zwp_tablet_seat_v2 *) tablet_seat;
}
/**
* @ingroup iface_zwp_tablet_manager_v2
*
* Destroy the wp_tablet_manager object. Objects created from this
* object are unaffected and should be destroyed separately.
*/
static inline void
zwp_tablet_manager_v2_destroy(struct zwp_tablet_manager_v2 *zwp_tablet_manager_v2)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_manager_v2,
ZWP_TABLET_MANAGER_V2_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_manager_v2), WL_MARSHAL_FLAG_DESTROY);
}
/**
* @ingroup iface_zwp_tablet_seat_v2
* @struct zwp_tablet_seat_v2_listener
*/
struct zwp_tablet_seat_v2_listener {
/**
* new device notification
*
* This event is sent whenever a new tablet becomes available on
* this seat. This event only provides the object id of the tablet,
* any static information about the tablet (device name, vid/pid,
* etc.) is sent through the wp_tablet interface.
* @param id the newly added graphics tablet
*/
void (*tablet_added)(void *data,
struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2,
struct zwp_tablet_v2 *id);
/**
* a new tool has been used with a tablet
*
* This event is sent whenever a tool that has not previously
* been used with a tablet comes into use. This event only provides
* the object id of the tool; any static information about the tool
* (capabilities, type, etc.) is sent through the wp_tablet_tool
* interface.
* @param id the newly added tablet tool
*/
void (*tool_added)(void *data,
struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2,
struct zwp_tablet_tool_v2 *id);
/**
* new pad notification
*
* This event is sent whenever a new pad is known to the system.
* Typically, pads are physically attached to tablets and a
* pad_added event is sent immediately after the
* wp_tablet_seat.tablet_added. However, some standalone pad
* devices logically attach to tablets at runtime, and the client
* must wait for wp_tablet_pad.enter to know the tablet a pad is
* attached to.
*
* This event only provides the object id of the pad. All further
* features (buttons, strips, rings) are sent through the
* wp_tablet_pad interface.
* @param id the newly added pad
*/
void (*pad_added)(void *data,
struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2,
struct zwp_tablet_pad_v2 *id);
};
/**
* @ingroup iface_zwp_tablet_seat_v2
*/
static inline int
zwp_tablet_seat_v2_add_listener(struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2,
const struct zwp_tablet_seat_v2_listener *listener, void *data)
{
return wl_proxy_add_listener((struct wl_proxy *) zwp_tablet_seat_v2,
(void (**)(void)) listener, data);
}
#define ZWP_TABLET_SEAT_V2_DESTROY 0
/**
* @ingroup iface_zwp_tablet_seat_v2
*/
#define ZWP_TABLET_SEAT_V2_TABLET_ADDED_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_seat_v2
*/
#define ZWP_TABLET_SEAT_V2_TOOL_ADDED_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_seat_v2
*/
#define ZWP_TABLET_SEAT_V2_PAD_ADDED_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_seat_v2
*/
#define ZWP_TABLET_SEAT_V2_DESTROY_SINCE_VERSION 1
/** @ingroup iface_zwp_tablet_seat_v2 */
static inline void
zwp_tablet_seat_v2_set_user_data(struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2, void *user_data)
{
wl_proxy_set_user_data((struct wl_proxy *) zwp_tablet_seat_v2, user_data);
}
/** @ingroup iface_zwp_tablet_seat_v2 */
static inline void *
zwp_tablet_seat_v2_get_user_data(struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2)
{
return wl_proxy_get_user_data((struct wl_proxy *) zwp_tablet_seat_v2);
}
static inline uint32_t
zwp_tablet_seat_v2_get_version(struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2)
{
return wl_proxy_get_version((struct wl_proxy *) zwp_tablet_seat_v2);
}
/**
* @ingroup iface_zwp_tablet_seat_v2
*
* Destroy the wp_tablet_seat object. Objects created from this
* object are unaffected and should be destroyed separately.
*/
static inline void
zwp_tablet_seat_v2_destroy(struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_seat_v2,
ZWP_TABLET_SEAT_V2_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_seat_v2), WL_MARSHAL_FLAG_DESTROY);
}
#ifndef ZWP_TABLET_TOOL_V2_TYPE_ENUM
#define ZWP_TABLET_TOOL_V2_TYPE_ENUM
/**
* @ingroup iface_zwp_tablet_tool_v2
* a physical tool type
*
* Describes the physical type of a tool. The physical type of a tool
* generally defines its base usage.
*
* The mouse tool represents a mouse-shaped tool that is not a relative
* device but bound to the tablet's surface, providing absolute
* coordinates.
*
* The lens tool is a mouse-shaped tool with an attached lens to
* provide precision focus.
*/
enum zwp_tablet_tool_v2_type {
/**
* Pen
*/
ZWP_TABLET_TOOL_V2_TYPE_PEN = 0x140,
/**
* Eraser
*/
ZWP_TABLET_TOOL_V2_TYPE_ERASER = 0x141,
/**
* Brush
*/
ZWP_TABLET_TOOL_V2_TYPE_BRUSH = 0x142,
/**
* Pencil
*/
ZWP_TABLET_TOOL_V2_TYPE_PENCIL = 0x143,
/**
* Airbrush
*/
ZWP_TABLET_TOOL_V2_TYPE_AIRBRUSH = 0x144,
/**
* Finger
*/
ZWP_TABLET_TOOL_V2_TYPE_FINGER = 0x145,
/**
* Mouse
*/
ZWP_TABLET_TOOL_V2_TYPE_MOUSE = 0x146,
/**
* Lens
*/
ZWP_TABLET_TOOL_V2_TYPE_LENS = 0x147,
};
#endif /* ZWP_TABLET_TOOL_V2_TYPE_ENUM */
#ifndef ZWP_TABLET_TOOL_V2_CAPABILITY_ENUM
#define ZWP_TABLET_TOOL_V2_CAPABILITY_ENUM
/**
* @ingroup iface_zwp_tablet_tool_v2
* capability flags for a tool
*
* Describes extra capabilities on a tablet.
*
* Any tool must provide x and y values, extra axes are
* device-specific.
*/
enum zwp_tablet_tool_v2_capability {
/**
* Tilt axes
*/
ZWP_TABLET_TOOL_V2_CAPABILITY_TILT = 1,
/**
* Pressure axis
*/
ZWP_TABLET_TOOL_V2_CAPABILITY_PRESSURE = 2,
/**
* Distance axis
*/
ZWP_TABLET_TOOL_V2_CAPABILITY_DISTANCE = 3,
/**
* Z-rotation axis
*/
ZWP_TABLET_TOOL_V2_CAPABILITY_ROTATION = 4,
/**
* Slider axis
*/
ZWP_TABLET_TOOL_V2_CAPABILITY_SLIDER = 5,
/**
* Wheel axis
*/
ZWP_TABLET_TOOL_V2_CAPABILITY_WHEEL = 6,
};
#endif /* ZWP_TABLET_TOOL_V2_CAPABILITY_ENUM */
#ifndef ZWP_TABLET_TOOL_V2_BUTTON_STATE_ENUM
#define ZWP_TABLET_TOOL_V2_BUTTON_STATE_ENUM
/**
* @ingroup iface_zwp_tablet_tool_v2
* physical button state
*
* Describes the physical state of a button that produced the button event.
*/
enum zwp_tablet_tool_v2_button_state {
/**
* button is not pressed
*/
ZWP_TABLET_TOOL_V2_BUTTON_STATE_RELEASED = 0,
/**
* button is pressed
*/
ZWP_TABLET_TOOL_V2_BUTTON_STATE_PRESSED = 1,
};
#endif /* ZWP_TABLET_TOOL_V2_BUTTON_STATE_ENUM */
#ifndef ZWP_TABLET_TOOL_V2_ERROR_ENUM
#define ZWP_TABLET_TOOL_V2_ERROR_ENUM
enum zwp_tablet_tool_v2_error {
/**
* given wl_surface has another role
*/
ZWP_TABLET_TOOL_V2_ERROR_ROLE = 0,
};
#endif /* ZWP_TABLET_TOOL_V2_ERROR_ENUM */
/**
* @ingroup iface_zwp_tablet_tool_v2
* @struct zwp_tablet_tool_v2_listener
*/
struct zwp_tablet_tool_v2_listener {
/**
* tool type
*
* The tool type is the high-level type of the tool and usually
* decides the interaction expected from this tool.
*
* This event is sent in the initial burst of events before the
* wp_tablet_tool.done event.
* @param tool_type the physical tool type
*/
void (*type)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
uint32_t tool_type);
/**
* unique hardware serial number of the tool
*
* If the physical tool can be identified by a unique 64-bit
* serial number, this event notifies the client of this serial
* number.
*
* If multiple tablets are available in the same seat and the tool
* is uniquely identifiable by the serial number, that tool may
* move between tablets.
*
* Otherwise, if the tool has no serial number and this event is
* missing, the tool is tied to the tablet it first comes into
* proximity with. Even if the physical tool is used on multiple
* tablets, separate wp_tablet_tool objects will be created, one
* per tablet.
*
* This event is sent in the initial burst of events before the
* wp_tablet_tool.done event.
* @param hardware_serial_hi the unique serial number of the tool, most significant bits
* @param hardware_serial_lo the unique serial number of the tool, least significant bits
*/
void (*hardware_serial)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
uint32_t hardware_serial_hi,
uint32_t hardware_serial_lo);
/**
* hardware id notification in Wacom's format
*
* This event notifies the client of a hardware id available on
* this tool.
*
* The hardware id is a device-specific 64-bit id that provides
* extra information about the tool in use, beyond the wl_tool.type
* enumeration. The format of the id is specific to tablets made by
* Wacom Inc. For example, the hardware id of a Wacom Grip Pen (a
* stylus) is 0x802.
*
* This event is sent in the initial burst of events before the
* wp_tablet_tool.done event.
* @param hardware_id_hi the hardware id, most significant bits
* @param hardware_id_lo the hardware id, least significant bits
*/
void (*hardware_id_wacom)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
uint32_t hardware_id_hi,
uint32_t hardware_id_lo);
/**
* tool capability notification
*
* This event notifies the client of any capabilities of this
* tool, beyond the main set of x/y axes and tip up/down detection.
*
* One event is sent for each extra capability available on this
* tool.
*
* This event is sent in the initial burst of events before the
* wp_tablet_tool.done event.
* @param capability the capability
*/
void (*capability)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
uint32_t capability);
/**
* tool description events sequence complete
*
* This event signals the end of the initial burst of descriptive
* events. A client may consider the static description of the tool
* to be complete and finalize initialization of the tool.
*/
void (*done)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2);
/**
* tool removed
*
* This event is sent when the tool is removed from the system
* and will send no further events. Should the physical tool come
* back into proximity later, a new wp_tablet_tool object will be
* created.
*
* It is compositor-dependent when a tool is removed. A compositor
* may remove a tool on proximity out, tablet removal or any other
* reason. A compositor may also keep a tool alive until shutdown.
*
* If the tool is currently in proximity, a proximity_out event
* will be sent before the removed event. See
* wp_tablet_tool.proximity_out for the handling of any buttons
* logically down.
*
* When this event is received, the client must
* wp_tablet_tool.destroy the object.
*/
void (*removed)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2);
/**
* proximity in event
*
* Notification that this tool is focused on a certain surface.
*
* This event can be received when the tool has moved from one
* surface to another, or when the tool has come back into
* proximity above the surface.
*
* If any button is logically down when the tool comes into
* proximity, the respective button event is sent after the
* proximity_in event but within the same frame as the proximity_in
* event.
* @param tablet The tablet the tool is in proximity of
* @param surface The current surface the tablet tool is over
*/
void (*proximity_in)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
uint32_t serial,
struct zwp_tablet_v2 *tablet,
struct wl_surface *surface);
/**
* proximity out event
*
* Notification that this tool has either left proximity, or is
* no longer focused on a certain surface.
*
* When the tablet tool leaves proximity of the tablet, button
* release events are sent for each button that was held down at
* the time of leaving proximity. These events are sent before the
* proximity_out event but within the same wp_tablet.frame.
*
* If the tool stays within proximity of the tablet, but the focus
* changes from one surface to another, a button release event may
* not be sent until the button is actually released or the tool
* leaves the proximity of the tablet.
*/
void (*proximity_out)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2);
/**
* tablet tool is making contact
*
* Sent whenever the tablet tool comes in contact with the
* surface of the tablet.
*
* If the tool is already in contact with the tablet when entering
* the input region, the client owning said region will receive a
* wp_tablet.proximity_in event, followed by a wp_tablet.down event
* and a wp_tablet.frame event.
*
* Note that this event describes logical contact, not physical
* contact. On some devices, a compositor may not consider a tool
* in logical contact until a minimum physical pressure threshold
* is exceeded.
*/
void (*down)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
uint32_t serial);
/**
* tablet tool is no longer making contact
*
* Sent whenever the tablet tool stops making contact with the
* surface of the tablet, or when the tablet tool moves out of the
* input region and the compositor grab (if any) is dismissed.
*
* If the tablet tool moves out of the input region while in
* contact with the surface of the tablet and the compositor does
* not have an ongoing grab on the surface, the client owning said
* region will receive a wp_tablet.up event, followed by a
* wp_tablet.proximity_out event and a wp_tablet.frame event. If
* the compositor has an ongoing grab on this device, this event
* sequence is sent whenever the grab is dismissed in the future.
*
* Note that this event describes logical contact, not physical
* contact. On some devices, a compositor may not consider a tool
* out of logical contact until physical pressure falls below a
* specific threshold.
*/
void (*up)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2);
/**
* motion event
*
* Sent whenever a tablet tool moves.
* @param x surface-local x coordinate
* @param y surface-local y coordinate
*/
void (*motion)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
wl_fixed_t x,
wl_fixed_t y);
/**
* pressure change event
*
* Sent whenever the pressure axis on a tool changes. The value
* of this event is normalized to a value between 0 and 65535.
*
* Note that pressure may be nonzero even when a tool is not in
* logical contact. See the down and up events for more details.
* @param pressure The current pressure value
*/
void (*pressure)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
uint32_t pressure);
/**
* distance change event
*
* Sent whenever the distance axis on a tool changes. The value
* of this event is normalized to a value between 0 and 65535.
*
* Note that distance may be nonzero even when a tool is not in
* logical contact. See the down and up events for more details.
* @param distance The current distance value
*/
void (*distance)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
uint32_t distance);
/**
* tilt change event
*
* Sent whenever one or both of the tilt axes on a tool change.
* Each tilt value is in degrees, relative to the z-axis of the
* tablet. The angle is positive when the top of a tool tilts along
* the positive x or y axis.
* @param tilt_x The current value of the X tilt axis
* @param tilt_y The current value of the Y tilt axis
*/
void (*tilt)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
wl_fixed_t tilt_x,
wl_fixed_t tilt_y);
/**
* z-rotation change event
*
* Sent whenever the z-rotation axis on the tool changes. The
* rotation value is in degrees clockwise from the tool's logical
* neutral position.
* @param degrees The current rotation of the Z axis
*/
void (*rotation)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
wl_fixed_t degrees);
/**
* Slider position change event
*
* Sent whenever the slider position on the tool changes. The
* value is normalized between -65535 and 65535, with 0 as the
* logical neutral position of the slider.
*
* The slider is available on e.g. the Wacom Airbrush tool.
* @param position The current position of slider
*/
void (*slider)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
int32_t position);
/**
* Wheel delta event
*
* Sent whenever the wheel on the tool emits an event. This event
* contains two values for the same axis change. The degrees value
* is in the same orientation as the wl_pointer.vertical_scroll
* axis. The clicks value is in discrete logical clicks of the
* mouse wheel. This value may be zero if the movement of the wheel
* was less than one logical click.
*
* Clients should choose either value and avoid mixing degrees and
* clicks. The compositor may accumulate values smaller than a
* logical click and emulate click events when a certain threshold
* is met. Thus, wl_tablet_tool.wheel events with non-zero clicks
* values may have different degrees values.
* @param degrees The wheel delta in degrees
* @param clicks The wheel delta in discrete clicks
*/
void (*wheel)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
wl_fixed_t degrees,
int32_t clicks);
/**
* button event
*
* Sent whenever a button on the tool is pressed or released.
*
* If a button is held down when the tool moves in or out of
* proximity, button events are generated by the compositor. See
* wp_tablet_tool.proximity_in and wp_tablet_tool.proximity_out for
* details.
* @param button The button whose state has changed
* @param state Whether the button was pressed or released
*/
void (*button)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
uint32_t serial,
uint32_t button,
uint32_t state);
/**
* frame event
*
* Marks the end of a series of axis and/or button updates from
* the tablet. The Wayland protocol requires axis updates to be
* sent sequentially, however all events within a frame should be
* considered one hardware event.
* @param time The time of the event with millisecond granularity
*/
void (*frame)(void *data,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
uint32_t time);
};
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
static inline int
zwp_tablet_tool_v2_add_listener(struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2,
const struct zwp_tablet_tool_v2_listener *listener, void *data)
{
return wl_proxy_add_listener((struct wl_proxy *) zwp_tablet_tool_v2,
(void (**)(void)) listener, data);
}
#define ZWP_TABLET_TOOL_V2_SET_CURSOR 0
#define ZWP_TABLET_TOOL_V2_DESTROY 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_TYPE_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_HARDWARE_SERIAL_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_HARDWARE_ID_WACOM_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_CAPABILITY_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_DONE_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_REMOVED_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_PROXIMITY_IN_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_PROXIMITY_OUT_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_DOWN_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_UP_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_MOTION_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_PRESSURE_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_DISTANCE_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_TILT_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_ROTATION_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_SLIDER_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_WHEEL_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_BUTTON_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_FRAME_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_SET_CURSOR_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_tool_v2
*/
#define ZWP_TABLET_TOOL_V2_DESTROY_SINCE_VERSION 1
/** @ingroup iface_zwp_tablet_tool_v2 */
static inline void
zwp_tablet_tool_v2_set_user_data(struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2, void *user_data)
{
wl_proxy_set_user_data((struct wl_proxy *) zwp_tablet_tool_v2, user_data);
}
/** @ingroup iface_zwp_tablet_tool_v2 */
static inline void *
zwp_tablet_tool_v2_get_user_data(struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2)
{
return wl_proxy_get_user_data((struct wl_proxy *) zwp_tablet_tool_v2);
}
static inline uint32_t
zwp_tablet_tool_v2_get_version(struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2)
{
return wl_proxy_get_version((struct wl_proxy *) zwp_tablet_tool_v2);
}
/**
* @ingroup iface_zwp_tablet_tool_v2
*
* Sets the surface of the cursor used for this tool on the given
* tablet. This request only takes effect if the tool is in proximity
* of one of the requesting client's surfaces or the surface parameter
* is the current pointer surface. If there was a previous surface set
* with this request it is replaced. If surface is NULL, the cursor
* image is hidden.
*
* The parameters hotspot_x and hotspot_y define the position of the
* pointer surface relative to the pointer location. Its top-left corner
* is always at (x, y) - (hotspot_x, hotspot_y), where (x, y) are the
* coordinates of the pointer location, in surface-local coordinates.
*
* On surface.attach requests to the pointer surface, hotspot_x and
* hotspot_y are decremented by the x and y parameters passed to the
* request. Attach must be confirmed by wl_surface.commit as usual.
*
* The hotspot can also be updated by passing the currently set pointer
* surface to this request with new values for hotspot_x and hotspot_y.
*
* The current and pending input regions of the wl_surface are cleared,
* and wl_surface.set_input_region is ignored until the wl_surface is no
* longer used as the cursor. When the use as a cursor ends, the current
* and pending input regions become undefined, and the wl_surface is
* unmapped.
*
* This request gives the surface the role of a wp_tablet_tool cursor. A
* surface may only ever be used as the cursor surface for one
* wp_tablet_tool. If the surface already has another role or has
* previously been used as cursor surface for a different tool, a
* protocol error is raised.
*/
static inline void
zwp_tablet_tool_v2_set_cursor(struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2, uint32_t serial, struct wl_surface *surface, int32_t hotspot_x, int32_t hotspot_y)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_tool_v2,
ZWP_TABLET_TOOL_V2_SET_CURSOR, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_tool_v2), 0, serial, surface, hotspot_x, hotspot_y);
}
/**
* @ingroup iface_zwp_tablet_tool_v2
*
* This destroys the client's resource for this tool object.
*/
static inline void
zwp_tablet_tool_v2_destroy(struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_tool_v2,
ZWP_TABLET_TOOL_V2_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_tool_v2), WL_MARSHAL_FLAG_DESTROY);
}
#ifndef ZWP_TABLET_V2_BUSTYPE_ENUM
#define ZWP_TABLET_V2_BUSTYPE_ENUM
/**
* @ingroup iface_zwp_tablet_v2
* bus type
*
* Describes the bus types this tablet is connected to.
*/
enum zwp_tablet_v2_bustype {
/**
* USB
*/
ZWP_TABLET_V2_BUSTYPE_USB = 3,
/**
* Bluetooth
*/
ZWP_TABLET_V2_BUSTYPE_BLUETOOTH = 5,
/**
* Virtual
*/
ZWP_TABLET_V2_BUSTYPE_VIRTUAL = 6,
/**
* Serial
*/
ZWP_TABLET_V2_BUSTYPE_SERIAL = 17,
/**
* I2C
*/
ZWP_TABLET_V2_BUSTYPE_I2C = 24,
};
#endif /* ZWP_TABLET_V2_BUSTYPE_ENUM */
/**
* @ingroup iface_zwp_tablet_v2
* @struct zwp_tablet_v2_listener
*/
struct zwp_tablet_v2_listener {
/**
* tablet device name
*
* A descriptive name for the tablet device.
*
* If the device has no descriptive name, this event is not sent.
*
* This event is sent in the initial burst of events before the
* wp_tablet.done event.
* @param name the device name
*/
void (*name)(void *data,
struct zwp_tablet_v2 *zwp_tablet_v2,
const char *name);
/**
* tablet device vendor/product id
*
* The vendor and product IDs for the tablet device.
*
* The interpretation of the id depends on the wp_tablet.bustype.
* Prior to version v2 of this protocol, the id was implied to be a
* USB vendor and product ID. If no wp_tablet.bustype is sent, the
* ID is to be interpreted as USB vendor and product ID.
*
* If the device has no vendor/product ID, this event is not sent.
* This can happen for virtual devices or non-USB devices, for
* instance.
*
* This event is sent in the initial burst of events before the
* wp_tablet.done event.
* @param vid vendor id
* @param pid product id
*/
void (*id)(void *data,
struct zwp_tablet_v2 *zwp_tablet_v2,
uint32_t vid,
uint32_t pid);
/**
* path to the device
*
* A system-specific device path that indicates which device is
* behind this wp_tablet. This information may be used to gather
* additional information about the device, e.g. through libwacom.
*
* A device may have more than one device path. If so, multiple
* wp_tablet.path events are sent. A device may be emulated and not
* have a device path, and in that case this event will not be
* sent.
*
* The format of the path is unspecified, it may be a device node,
* a sysfs path, or some other identifier. It is up to the client
* to identify the string provided.
*
* This event is sent in the initial burst of events before the
* wp_tablet.done event.
* @param path path to local device
*/
void (*path)(void *data,
struct zwp_tablet_v2 *zwp_tablet_v2,
const char *path);
/**
* tablet description events sequence complete
*
* 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.
*/
void (*done)(void *data,
struct zwp_tablet_v2 *zwp_tablet_v2);
/**
* tablet removed event
*
* Sent when the tablet has been removed from the system. When a
* tablet is removed, some tools may be removed.
*
* When this event is received, the client must wp_tablet.destroy
* the object.
*/
void (*removed)(void *data,
struct zwp_tablet_v2 *zwp_tablet_v2);
/**
* tablet device bus type
*
* The bustype argument is one of the BUS_ defines in the Linux
* kernel's linux/input.h
*
* If the device has no known bustype or the bustype cannot be
* queried, this event is not sent.
*
* This event is sent in the initial burst of events before the
* wp_tablet.done event.
* @param bustype bus type
* @since 2
*/
void (*bustype)(void *data,
struct zwp_tablet_v2 *zwp_tablet_v2,
uint32_t bustype);
};
/**
* @ingroup iface_zwp_tablet_v2
*/
static inline int
zwp_tablet_v2_add_listener(struct zwp_tablet_v2 *zwp_tablet_v2,
const struct zwp_tablet_v2_listener *listener, void *data)
{
return wl_proxy_add_listener((struct wl_proxy *) zwp_tablet_v2,
(void (**)(void)) listener, data);
}
#define ZWP_TABLET_V2_DESTROY 0
/**
* @ingroup iface_zwp_tablet_v2
*/
#define ZWP_TABLET_V2_NAME_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_v2
*/
#define ZWP_TABLET_V2_ID_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_v2
*/
#define ZWP_TABLET_V2_PATH_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_v2
*/
#define ZWP_TABLET_V2_DONE_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_v2
*/
#define ZWP_TABLET_V2_REMOVED_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_v2
*/
#define ZWP_TABLET_V2_BUSTYPE_SINCE_VERSION 2
/**
* @ingroup iface_zwp_tablet_v2
*/
#define ZWP_TABLET_V2_DESTROY_SINCE_VERSION 1
/** @ingroup iface_zwp_tablet_v2 */
static inline void
zwp_tablet_v2_set_user_data(struct zwp_tablet_v2 *zwp_tablet_v2, void *user_data)
{
wl_proxy_set_user_data((struct wl_proxy *) zwp_tablet_v2, user_data);
}
/** @ingroup iface_zwp_tablet_v2 */
static inline void *
zwp_tablet_v2_get_user_data(struct zwp_tablet_v2 *zwp_tablet_v2)
{
return wl_proxy_get_user_data((struct wl_proxy *) zwp_tablet_v2);
}
static inline uint32_t
zwp_tablet_v2_get_version(struct zwp_tablet_v2 *zwp_tablet_v2)
{
return wl_proxy_get_version((struct wl_proxy *) zwp_tablet_v2);
}
/**
* @ingroup iface_zwp_tablet_v2
*
* This destroys the client's resource for this tablet object.
*/
static inline void
zwp_tablet_v2_destroy(struct zwp_tablet_v2 *zwp_tablet_v2)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_v2,
ZWP_TABLET_V2_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_v2), WL_MARSHAL_FLAG_DESTROY);
}
#ifndef ZWP_TABLET_PAD_RING_V2_SOURCE_ENUM
#define ZWP_TABLET_PAD_RING_V2_SOURCE_ENUM
/**
* @ingroup iface_zwp_tablet_pad_ring_v2
* ring axis source
*
* Describes the source types for ring events. This indicates to the
* client how a ring event was physically generated; a client may
* adjust the user interface accordingly. For example, events
* from a "finger" source may trigger kinetic scrolling.
*/
enum zwp_tablet_pad_ring_v2_source {
/**
* finger
*/
ZWP_TABLET_PAD_RING_V2_SOURCE_FINGER = 1,
};
#endif /* ZWP_TABLET_PAD_RING_V2_SOURCE_ENUM */
/**
* @ingroup iface_zwp_tablet_pad_ring_v2
* @struct zwp_tablet_pad_ring_v2_listener
*/
struct zwp_tablet_pad_ring_v2_listener {
/**
* ring event source
*
* Source information for ring events.
*
* This event does not occur on its own. It is sent before a
* wp_tablet_pad_ring.frame event and carries the source
* information for all events within that frame.
*
* The source specifies how this event was generated. If the source
* is wp_tablet_pad_ring.source.finger, a wp_tablet_pad_ring.stop
* event will be sent when the user lifts the finger off the
* device.
*
* This event is optional. If the source is unknown for an
* interaction, no event is sent.
* @param source the event source
*/
void (*source)(void *data,
struct zwp_tablet_pad_ring_v2 *zwp_tablet_pad_ring_v2,
uint32_t source);
/**
* angle changed
*
* Sent whenever the angle on a ring changes.
*
* The angle is provided in degrees clockwise from the logical
* north of the ring in the pad's current rotation.
* @param degrees the current angle in degrees
*/
void (*angle)(void *data,
struct zwp_tablet_pad_ring_v2 *zwp_tablet_pad_ring_v2,
wl_fixed_t degrees);
/**
* interaction stopped
*
* Stop notification for ring events.
*
* For some wp_tablet_pad_ring.source types, a
* wp_tablet_pad_ring.stop event is sent to notify a client that
* the interaction with the ring has terminated. This enables the
* client to implement kinetic scrolling. See the
* wp_tablet_pad_ring.source documentation for information on when
* this event may be generated.
*
* Any wp_tablet_pad_ring.angle events with the same source after
* this event should be considered as the start of a new
* interaction.
*/
void (*stop)(void *data,
struct zwp_tablet_pad_ring_v2 *zwp_tablet_pad_ring_v2);
/**
* end of a ring event sequence
*
* Indicates the end of a set of ring events that logically
* belong together. A client is expected to accumulate the data in
* all events within the frame before proceeding.
*
* All wp_tablet_pad_ring events before a wp_tablet_pad_ring.frame
* event belong logically together. For example, on termination of
* a finger interaction on a ring the compositor will send a
* wp_tablet_pad_ring.source event, a wp_tablet_pad_ring.stop event
* and a wp_tablet_pad_ring.frame event.
*
* A wp_tablet_pad_ring.frame event is sent for every logical event
* group, even if the group only contains a single
* wp_tablet_pad_ring event. Specifically, a client may get a
* sequence: angle, frame, angle, frame, etc.
* @param time timestamp with millisecond granularity
*/
void (*frame)(void *data,
struct zwp_tablet_pad_ring_v2 *zwp_tablet_pad_ring_v2,
uint32_t time);
};
/**
* @ingroup iface_zwp_tablet_pad_ring_v2
*/
static inline int
zwp_tablet_pad_ring_v2_add_listener(struct zwp_tablet_pad_ring_v2 *zwp_tablet_pad_ring_v2,
const struct zwp_tablet_pad_ring_v2_listener *listener, void *data)
{
return wl_proxy_add_listener((struct wl_proxy *) zwp_tablet_pad_ring_v2,
(void (**)(void)) listener, data);
}
#define ZWP_TABLET_PAD_RING_V2_SET_FEEDBACK 0
#define ZWP_TABLET_PAD_RING_V2_DESTROY 1
/**
* @ingroup iface_zwp_tablet_pad_ring_v2
*/
#define ZWP_TABLET_PAD_RING_V2_SOURCE_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_ring_v2
*/
#define ZWP_TABLET_PAD_RING_V2_ANGLE_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_ring_v2
*/
#define ZWP_TABLET_PAD_RING_V2_STOP_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_ring_v2
*/
#define ZWP_TABLET_PAD_RING_V2_FRAME_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_ring_v2
*/
#define ZWP_TABLET_PAD_RING_V2_SET_FEEDBACK_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_ring_v2
*/
#define ZWP_TABLET_PAD_RING_V2_DESTROY_SINCE_VERSION 1
/** @ingroup iface_zwp_tablet_pad_ring_v2 */
static inline void
zwp_tablet_pad_ring_v2_set_user_data(struct zwp_tablet_pad_ring_v2 *zwp_tablet_pad_ring_v2, void *user_data)
{
wl_proxy_set_user_data((struct wl_proxy *) zwp_tablet_pad_ring_v2, user_data);
}
/** @ingroup iface_zwp_tablet_pad_ring_v2 */
static inline void *
zwp_tablet_pad_ring_v2_get_user_data(struct zwp_tablet_pad_ring_v2 *zwp_tablet_pad_ring_v2)
{
return wl_proxy_get_user_data((struct wl_proxy *) zwp_tablet_pad_ring_v2);
}
static inline uint32_t
zwp_tablet_pad_ring_v2_get_version(struct zwp_tablet_pad_ring_v2 *zwp_tablet_pad_ring_v2)
{
return wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_ring_v2);
}
/**
* @ingroup iface_zwp_tablet_pad_ring_v2
*
* Request that the compositor use the provided feedback string
* associated with this ring. This request should be issued immediately
* after a wp_tablet_pad_group.mode_switch event from the corresponding
* group is received, or whenever the ring is mapped to a different
* action. See wp_tablet_pad_group.mode_switch for more details.
*
* Clients are encouraged to provide context-aware descriptions for
* the actions associated with the ring; compositors may use this
* information to offer visual feedback about the button layout
* (eg. on-screen displays).
*
* The provided string 'description' is a UTF-8 encoded string to be
* associated with this ring, and is considered user-visible; general
* internationalization rules apply.
*
* The serial argument will be that of the last
* wp_tablet_pad_group.mode_switch event received for the group of this
* ring. Requests providing other serials than the most recent one will be
* ignored.
*/
static inline void
zwp_tablet_pad_ring_v2_set_feedback(struct zwp_tablet_pad_ring_v2 *zwp_tablet_pad_ring_v2, const char *description, uint32_t serial)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_pad_ring_v2,
ZWP_TABLET_PAD_RING_V2_SET_FEEDBACK, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_ring_v2), 0, description, serial);
}
/**
* @ingroup iface_zwp_tablet_pad_ring_v2
*
* This destroys the client's resource for this ring object.
*/
static inline void
zwp_tablet_pad_ring_v2_destroy(struct zwp_tablet_pad_ring_v2 *zwp_tablet_pad_ring_v2)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_pad_ring_v2,
ZWP_TABLET_PAD_RING_V2_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_ring_v2), WL_MARSHAL_FLAG_DESTROY);
}
#ifndef ZWP_TABLET_PAD_STRIP_V2_SOURCE_ENUM
#define ZWP_TABLET_PAD_STRIP_V2_SOURCE_ENUM
/**
* @ingroup iface_zwp_tablet_pad_strip_v2
* strip axis source
*
* Describes the source types for strip events. This indicates to the
* client how a strip event was physically generated; a client may
* adjust the user interface accordingly. For example, events
* from a "finger" source may trigger kinetic scrolling.
*/
enum zwp_tablet_pad_strip_v2_source {
/**
* finger
*/
ZWP_TABLET_PAD_STRIP_V2_SOURCE_FINGER = 1,
};
#endif /* ZWP_TABLET_PAD_STRIP_V2_SOURCE_ENUM */
/**
* @ingroup iface_zwp_tablet_pad_strip_v2
* @struct zwp_tablet_pad_strip_v2_listener
*/
struct zwp_tablet_pad_strip_v2_listener {
/**
* strip event source
*
* Source information for strip events.
*
* This event does not occur on its own. It is sent before a
* wp_tablet_pad_strip.frame event and carries the source
* information for all events within that frame.
*
* The source specifies how this event was generated. If the source
* is wp_tablet_pad_strip.source.finger, a wp_tablet_pad_strip.stop
* event will be sent when the user lifts their finger off the
* device.
*
* This event is optional. If the source is unknown for an
* interaction, no event is sent.
* @param source the event source
*/
void (*source)(void *data,
struct zwp_tablet_pad_strip_v2 *zwp_tablet_pad_strip_v2,
uint32_t source);
/**
* position changed
*
* Sent whenever the position on a strip changes.
*
* The position is normalized to a range of [0, 65535], the 0-value
* represents the top-most and/or left-most position of the strip
* in the pad's current rotation.
* @param position the current position
*/
void (*position)(void *data,
struct zwp_tablet_pad_strip_v2 *zwp_tablet_pad_strip_v2,
uint32_t position);
/**
* interaction stopped
*
* Stop notification for strip events.
*
* For some wp_tablet_pad_strip.source types, a
* wp_tablet_pad_strip.stop event is sent to notify a client that
* the interaction with the strip has terminated. This enables the
* client to implement kinetic scrolling. See the
* wp_tablet_pad_strip.source documentation for information on when
* this event may be generated.
*
* Any wp_tablet_pad_strip.position events with the same source
* after this event should be considered as the start of a new
* interaction.
*/
void (*stop)(void *data,
struct zwp_tablet_pad_strip_v2 *zwp_tablet_pad_strip_v2);
/**
* end of a strip event sequence
*
* Indicates the end of a set of events that represent one
* logical hardware strip event. A client is expected to accumulate
* the data in all events within the frame before proceeding.
*
* All wp_tablet_pad_strip events before a
* wp_tablet_pad_strip.frame event belong logically together. For
* example, on termination of a finger interaction on a strip the
* compositor will send a wp_tablet_pad_strip.source event, a
* wp_tablet_pad_strip.stop event and a wp_tablet_pad_strip.frame
* event.
*
* A wp_tablet_pad_strip.frame event is sent for every logical
* event group, even if the group only contains a single
* wp_tablet_pad_strip event. Specifically, a client may get a
* sequence: position, frame, position, frame, etc.
* @param time timestamp with millisecond granularity
*/
void (*frame)(void *data,
struct zwp_tablet_pad_strip_v2 *zwp_tablet_pad_strip_v2,
uint32_t time);
};
/**
* @ingroup iface_zwp_tablet_pad_strip_v2
*/
static inline int
zwp_tablet_pad_strip_v2_add_listener(struct zwp_tablet_pad_strip_v2 *zwp_tablet_pad_strip_v2,
const struct zwp_tablet_pad_strip_v2_listener *listener, void *data)
{
return wl_proxy_add_listener((struct wl_proxy *) zwp_tablet_pad_strip_v2,
(void (**)(void)) listener, data);
}
#define ZWP_TABLET_PAD_STRIP_V2_SET_FEEDBACK 0
#define ZWP_TABLET_PAD_STRIP_V2_DESTROY 1
/**
* @ingroup iface_zwp_tablet_pad_strip_v2
*/
#define ZWP_TABLET_PAD_STRIP_V2_SOURCE_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_strip_v2
*/
#define ZWP_TABLET_PAD_STRIP_V2_POSITION_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_strip_v2
*/
#define ZWP_TABLET_PAD_STRIP_V2_STOP_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_strip_v2
*/
#define ZWP_TABLET_PAD_STRIP_V2_FRAME_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_strip_v2
*/
#define ZWP_TABLET_PAD_STRIP_V2_SET_FEEDBACK_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_strip_v2
*/
#define ZWP_TABLET_PAD_STRIP_V2_DESTROY_SINCE_VERSION 1
/** @ingroup iface_zwp_tablet_pad_strip_v2 */
static inline void
zwp_tablet_pad_strip_v2_set_user_data(struct zwp_tablet_pad_strip_v2 *zwp_tablet_pad_strip_v2, void *user_data)
{
wl_proxy_set_user_data((struct wl_proxy *) zwp_tablet_pad_strip_v2, user_data);
}
/** @ingroup iface_zwp_tablet_pad_strip_v2 */
static inline void *
zwp_tablet_pad_strip_v2_get_user_data(struct zwp_tablet_pad_strip_v2 *zwp_tablet_pad_strip_v2)
{
return wl_proxy_get_user_data((struct wl_proxy *) zwp_tablet_pad_strip_v2);
}
static inline uint32_t
zwp_tablet_pad_strip_v2_get_version(struct zwp_tablet_pad_strip_v2 *zwp_tablet_pad_strip_v2)
{
return wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_strip_v2);
}
/**
* @ingroup iface_zwp_tablet_pad_strip_v2
*
* Requests the compositor to use the provided feedback string
* associated with this strip. This request should be issued immediately
* after a wp_tablet_pad_group.mode_switch event from the corresponding
* group is received, or whenever the strip is mapped to a different
* action. See wp_tablet_pad_group.mode_switch for more details.
*
* Clients are encouraged to provide context-aware descriptions for
* the actions associated with the strip, and compositors may use this
* information to offer visual feedback about the button layout
* (eg. on-screen displays).
*
* The provided string 'description' is a UTF-8 encoded string to be
* associated with this ring, and is considered user-visible; general
* internationalization rules apply.
*
* The serial argument will be that of the last
* wp_tablet_pad_group.mode_switch event received for the group of this
* strip. Requests providing other serials than the most recent one will be
* ignored.
*/
static inline void
zwp_tablet_pad_strip_v2_set_feedback(struct zwp_tablet_pad_strip_v2 *zwp_tablet_pad_strip_v2, const char *description, uint32_t serial)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_pad_strip_v2,
ZWP_TABLET_PAD_STRIP_V2_SET_FEEDBACK, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_strip_v2), 0, description, serial);
}
/**
* @ingroup iface_zwp_tablet_pad_strip_v2
*
* This destroys the client's resource for this strip object.
*/
static inline void
zwp_tablet_pad_strip_v2_destroy(struct zwp_tablet_pad_strip_v2 *zwp_tablet_pad_strip_v2)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_pad_strip_v2,
ZWP_TABLET_PAD_STRIP_V2_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_strip_v2), WL_MARSHAL_FLAG_DESTROY);
}
/**
* @ingroup iface_zwp_tablet_pad_group_v2
* @struct zwp_tablet_pad_group_v2_listener
*/
struct zwp_tablet_pad_group_v2_listener {
/**
* buttons announced
*
* Sent on wp_tablet_pad_group initialization to announce the
* available buttons in the group. Button indices start at 0, a
* button may only be in one group at a time.
*
* 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.
* @param buttons buttons in this group
*/
void (*buttons)(void *data,
struct zwp_tablet_pad_group_v2 *zwp_tablet_pad_group_v2,
struct wl_array *buttons);
/**
* 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.
*/
void (*ring)(void *data,
struct zwp_tablet_pad_group_v2 *zwp_tablet_pad_group_v2,
struct zwp_tablet_pad_ring_v2 *ring);
/**
* 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.
*/
void (*strip)(void *data,
struct zwp_tablet_pad_group_v2 *zwp_tablet_pad_group_v2,
struct zwp_tablet_pad_strip_v2 *strip);
/**
* mode-switch ability announced
*
* 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.
* @param modes the number of modes
*/
void (*modes)(void *data,
struct zwp_tablet_pad_group_v2 *zwp_tablet_pad_group_v2,
uint32_t modes);
/**
* tablet group description events sequence complete
*
* 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.
*/
void (*done)(void *data,
struct zwp_tablet_pad_group_v2 *zwp_tablet_pad_group_v2);
/**
* mode switch event
*
* Notification that the mode was switched.
*
* A mode applies to all buttons, rings, strips and dials 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 user 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, strip or dial action in the new mode differs from the
* action in the previous mode, the client should immediately issue
* a wp_tablet_ring.set_feedback, wp_tablet_strip.set_feedback or
* wp_tablet_dial.set_feedback request for each changed ring, strip
* or dial.
* @param time the time of the event with millisecond granularity
* @param mode the new mode of the pad
*/
void (*mode_switch)(void *data,
struct zwp_tablet_pad_group_v2 *zwp_tablet_pad_group_v2,
uint32_t time,
uint32_t serial,
uint32_t mode);
/**
* dial announced
*
* Sent on wp_tablet_pad initialization to announce available
* dials. One event is sent for each dial available on this pad
* group.
*
* This event is sent in the initial burst of events before the
* wp_tablet_pad_group.done event.
* @since 2
*/
void (*dial)(void *data,
struct zwp_tablet_pad_group_v2 *zwp_tablet_pad_group_v2,
struct zwp_tablet_pad_dial_v2 *dial);
};
/**
* @ingroup iface_zwp_tablet_pad_group_v2
*/
static inline int
zwp_tablet_pad_group_v2_add_listener(struct zwp_tablet_pad_group_v2 *zwp_tablet_pad_group_v2,
const struct zwp_tablet_pad_group_v2_listener *listener, void *data)
{
return wl_proxy_add_listener((struct wl_proxy *) zwp_tablet_pad_group_v2,
(void (**)(void)) listener, data);
}
#define ZWP_TABLET_PAD_GROUP_V2_DESTROY 0
/**
* @ingroup iface_zwp_tablet_pad_group_v2
*/
#define ZWP_TABLET_PAD_GROUP_V2_BUTTONS_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_group_v2
*/
#define ZWP_TABLET_PAD_GROUP_V2_RING_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_group_v2
*/
#define ZWP_TABLET_PAD_GROUP_V2_STRIP_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_group_v2
*/
#define ZWP_TABLET_PAD_GROUP_V2_MODES_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_group_v2
*/
#define ZWP_TABLET_PAD_GROUP_V2_DONE_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_group_v2
*/
#define ZWP_TABLET_PAD_GROUP_V2_MODE_SWITCH_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_group_v2
*/
#define ZWP_TABLET_PAD_GROUP_V2_DIAL_SINCE_VERSION 2
/**
* @ingroup iface_zwp_tablet_pad_group_v2
*/
#define ZWP_TABLET_PAD_GROUP_V2_DESTROY_SINCE_VERSION 1
/** @ingroup iface_zwp_tablet_pad_group_v2 */
static inline void
zwp_tablet_pad_group_v2_set_user_data(struct zwp_tablet_pad_group_v2 *zwp_tablet_pad_group_v2, void *user_data)
{
wl_proxy_set_user_data((struct wl_proxy *) zwp_tablet_pad_group_v2, user_data);
}
/** @ingroup iface_zwp_tablet_pad_group_v2 */
static inline void *
zwp_tablet_pad_group_v2_get_user_data(struct zwp_tablet_pad_group_v2 *zwp_tablet_pad_group_v2)
{
return wl_proxy_get_user_data((struct wl_proxy *) zwp_tablet_pad_group_v2);
}
static inline uint32_t
zwp_tablet_pad_group_v2_get_version(struct zwp_tablet_pad_group_v2 *zwp_tablet_pad_group_v2)
{
return wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_group_v2);
}
/**
* @ingroup iface_zwp_tablet_pad_group_v2
*
* Destroy the wp_tablet_pad_group object. Objects created from this object
* are unaffected and should be destroyed separately.
*/
static inline void
zwp_tablet_pad_group_v2_destroy(struct zwp_tablet_pad_group_v2 *zwp_tablet_pad_group_v2)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_pad_group_v2,
ZWP_TABLET_PAD_GROUP_V2_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_group_v2), WL_MARSHAL_FLAG_DESTROY);
}
#ifndef ZWP_TABLET_PAD_V2_BUTTON_STATE_ENUM
#define ZWP_TABLET_PAD_V2_BUTTON_STATE_ENUM
/**
* @ingroup iface_zwp_tablet_pad_v2
* physical button state
*
* Describes the physical state of a button that caused the button
* event.
*/
enum zwp_tablet_pad_v2_button_state {
/**
* the button is not pressed
*/
ZWP_TABLET_PAD_V2_BUTTON_STATE_RELEASED = 0,
/**
* the button is pressed
*/
ZWP_TABLET_PAD_V2_BUTTON_STATE_PRESSED = 1,
};
#endif /* ZWP_TABLET_PAD_V2_BUTTON_STATE_ENUM */
/**
* @ingroup iface_zwp_tablet_pad_v2
* @struct zwp_tablet_pad_v2_listener
*/
struct zwp_tablet_pad_v2_listener {
/**
* group announced
*
* Sent on wp_tablet_pad initialization to announce available
* groups. One event is sent for each pad group available.
*
* This event is sent in the initial burst of events before the
* wp_tablet_pad.done event. At least one group will be announced.
*/
void (*group)(void *data,
struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2,
struct zwp_tablet_pad_group_v2 *pad_group);
/**
* path to the device
*
* A system-specific device path that indicates which device is
* behind this wp_tablet_pad. This information may be used to
* gather additional information about the device, e.g. through
* libwacom.
*
* The format of the path is unspecified, it may be a device node,
* a sysfs path, or some other identifier. It is up to the client
* to identify the string provided.
*
* This event is sent in the initial burst of events before the
* wp_tablet_pad.done event.
* @param path path to local device
*/
void (*path)(void *data,
struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2,
const char *path);
/**
* buttons announced
*
* Sent on wp_tablet_pad initialization to announce the available
* buttons.
*
* This event is sent in the initial burst of events before the
* wp_tablet_pad.done event. This event is only sent when at least
* one button is available.
* @param buttons the number of buttons
*/
void (*buttons)(void *data,
struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2,
uint32_t buttons);
/**
* pad description event sequence complete
*
* This event signals the end of the initial burst of descriptive
* events. A client may consider the static description of the pad
* to be complete and finalize initialization of the pad.
*/
void (*done)(void *data,
struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2);
/**
* physical button state
*
* Sent whenever the physical state of a button changes.
* @param time the time of the event with millisecond granularity
* @param button the index of the button that changed state
*/
void (*button)(void *data,
struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2,
uint32_t time,
uint32_t button,
uint32_t state);
/**
* enter event
*
* Notification that this pad is focused on the specified
* surface.
* @param serial serial number of the enter event
* @param tablet the tablet the pad is attached to
* @param surface surface the pad is focused on
*/
void (*enter)(void *data,
struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2,
uint32_t serial,
struct zwp_tablet_v2 *tablet,
struct wl_surface *surface);
/**
* leave event
*
* Notification that this pad is no longer focused on the
* specified surface.
* @param serial serial number of the leave event
* @param surface surface the pad is no longer focused on
*/
void (*leave)(void *data,
struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2,
uint32_t serial,
struct wl_surface *surface);
/**
* pad removed event
*
* Sent when the pad has been removed from the system. When a
* tablet is removed its pad(s) will be removed too.
*
* When this event is received, the client must destroy all rings,
* strips and groups that were offered by this pad, and issue
* wp_tablet_pad.destroy the pad itself.
*/
void (*removed)(void *data,
struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2);
};
/**
* @ingroup iface_zwp_tablet_pad_v2
*/
static inline int
zwp_tablet_pad_v2_add_listener(struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2,
const struct zwp_tablet_pad_v2_listener *listener, void *data)
{
return wl_proxy_add_listener((struct wl_proxy *) zwp_tablet_pad_v2,
(void (**)(void)) listener, data);
}
#define ZWP_TABLET_PAD_V2_SET_FEEDBACK 0
#define ZWP_TABLET_PAD_V2_DESTROY 1
/**
* @ingroup iface_zwp_tablet_pad_v2
*/
#define ZWP_TABLET_PAD_V2_GROUP_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_v2
*/
#define ZWP_TABLET_PAD_V2_PATH_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_v2
*/
#define ZWP_TABLET_PAD_V2_BUTTONS_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_v2
*/
#define ZWP_TABLET_PAD_V2_DONE_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_v2
*/
#define ZWP_TABLET_PAD_V2_BUTTON_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_v2
*/
#define ZWP_TABLET_PAD_V2_ENTER_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_v2
*/
#define ZWP_TABLET_PAD_V2_LEAVE_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_v2
*/
#define ZWP_TABLET_PAD_V2_REMOVED_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_v2
*/
#define ZWP_TABLET_PAD_V2_SET_FEEDBACK_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_v2
*/
#define ZWP_TABLET_PAD_V2_DESTROY_SINCE_VERSION 1
/** @ingroup iface_zwp_tablet_pad_v2 */
static inline void
zwp_tablet_pad_v2_set_user_data(struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2, void *user_data)
{
wl_proxy_set_user_data((struct wl_proxy *) zwp_tablet_pad_v2, user_data);
}
/** @ingroup iface_zwp_tablet_pad_v2 */
static inline void *
zwp_tablet_pad_v2_get_user_data(struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2)
{
return wl_proxy_get_user_data((struct wl_proxy *) zwp_tablet_pad_v2);
}
static inline uint32_t
zwp_tablet_pad_v2_get_version(struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2)
{
return wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_v2);
}
/**
* @ingroup iface_zwp_tablet_pad_v2
*
* Requests the compositor to use the provided feedback string
* associated with this button. This request should be issued immediately
* after a wp_tablet_pad_group.mode_switch event from the corresponding
* group is received, or whenever a button is mapped to a different
* action. See wp_tablet_pad_group.mode_switch for more details.
*
* Clients are encouraged to provide context-aware descriptions for
* the actions associated with each button, and compositors may use
* this information to offer visual feedback on the button layout
* (e.g. on-screen displays).
*
* Button indices start at 0. Setting the feedback string on a button
* that is reserved by the compositor (i.e. not belonging to any
* wp_tablet_pad_group) does not generate an error but the compositor
* is free to ignore the request.
*
* The provided string 'description' is a UTF-8 encoded string to be
* associated with this ring, and is considered user-visible; general
* internationalization rules apply.
*
* The serial argument will be that of the last
* wp_tablet_pad_group.mode_switch event received for the group of this
* button. Requests providing other serials than the most recent one will
* be ignored.
*/
static inline void
zwp_tablet_pad_v2_set_feedback(struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2, uint32_t button, const char *description, uint32_t serial)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_pad_v2,
ZWP_TABLET_PAD_V2_SET_FEEDBACK, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_v2), 0, button, description, serial);
}
/**
* @ingroup iface_zwp_tablet_pad_v2
*
* Destroy the wp_tablet_pad object. Objects created from this object
* are unaffected and should be destroyed separately.
*/
static inline void
zwp_tablet_pad_v2_destroy(struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_pad_v2,
ZWP_TABLET_PAD_V2_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_v2), WL_MARSHAL_FLAG_DESTROY);
}
/**
* @ingroup iface_zwp_tablet_pad_dial_v2
* @struct zwp_tablet_pad_dial_v2_listener
*/
struct zwp_tablet_pad_dial_v2_listener {
/**
* delta movement
*
* Sent whenever the position on a dial changes.
*
* This event carries the wheel delta as multiples or fractions of
* 120 with each multiple of 120 representing one logical wheel
* detent. For example, an axis_value120 of 30 is one quarter of a
* logical wheel step in the positive direction, a value120 of -240
* are two logical wheel steps in the negative direction within the
* same hardware event. See the wl_pointer.axis_value120 for more
* details.
*
* The value120 must not be zero.
* @param value120 rotation distance as fraction of 120
*/
void (*delta)(void *data,
struct zwp_tablet_pad_dial_v2 *zwp_tablet_pad_dial_v2,
int32_t value120);
/**
* end of a dial event sequence
*
* Indicates the end of a set of events that represent one
* logical hardware dial event. A client is expected to accumulate
* the data in all events within the frame before proceeding.
*
* All wp_tablet_pad_dial events before a wp_tablet_pad_dial.frame
* event belong logically together.
*
* A wp_tablet_pad_dial.frame event is sent for every logical event
* group, even if the group only contains a single
* wp_tablet_pad_dial event. Specifically, a client may get a
* sequence: delta, frame, delta, frame, etc.
* @param time timestamp with millisecond granularity
*/
void (*frame)(void *data,
struct zwp_tablet_pad_dial_v2 *zwp_tablet_pad_dial_v2,
uint32_t time);
};
/**
* @ingroup iface_zwp_tablet_pad_dial_v2
*/
static inline int
zwp_tablet_pad_dial_v2_add_listener(struct zwp_tablet_pad_dial_v2 *zwp_tablet_pad_dial_v2,
const struct zwp_tablet_pad_dial_v2_listener *listener, void *data)
{
return wl_proxy_add_listener((struct wl_proxy *) zwp_tablet_pad_dial_v2,
(void (**)(void)) listener, data);
}
#define ZWP_TABLET_PAD_DIAL_V2_SET_FEEDBACK 0
#define ZWP_TABLET_PAD_DIAL_V2_DESTROY 1
/**
* @ingroup iface_zwp_tablet_pad_dial_v2
*/
#define ZWP_TABLET_PAD_DIAL_V2_DELTA_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_dial_v2
*/
#define ZWP_TABLET_PAD_DIAL_V2_FRAME_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_dial_v2
*/
#define ZWP_TABLET_PAD_DIAL_V2_SET_FEEDBACK_SINCE_VERSION 1
/**
* @ingroup iface_zwp_tablet_pad_dial_v2
*/
#define ZWP_TABLET_PAD_DIAL_V2_DESTROY_SINCE_VERSION 1
/** @ingroup iface_zwp_tablet_pad_dial_v2 */
static inline void
zwp_tablet_pad_dial_v2_set_user_data(struct zwp_tablet_pad_dial_v2 *zwp_tablet_pad_dial_v2, void *user_data)
{
wl_proxy_set_user_data((struct wl_proxy *) zwp_tablet_pad_dial_v2, user_data);
}
/** @ingroup iface_zwp_tablet_pad_dial_v2 */
static inline void *
zwp_tablet_pad_dial_v2_get_user_data(struct zwp_tablet_pad_dial_v2 *zwp_tablet_pad_dial_v2)
{
return wl_proxy_get_user_data((struct wl_proxy *) zwp_tablet_pad_dial_v2);
}
static inline uint32_t
zwp_tablet_pad_dial_v2_get_version(struct zwp_tablet_pad_dial_v2 *zwp_tablet_pad_dial_v2)
{
return wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_dial_v2);
}
/**
* @ingroup iface_zwp_tablet_pad_dial_v2
*
* Requests the compositor to use the provided feedback string
* associated with this dial. This request should be issued immediately
* after a wp_tablet_pad_group.mode_switch event from the corresponding
* group is received, or whenever the dial is mapped to a different
* action. See wp_tablet_pad_group.mode_switch for more details.
*
* Clients are encouraged to provide context-aware descriptions for
* the actions associated with the dial, and compositors may use this
* information to offer visual feedback about the button layout
* (eg. on-screen displays).
*
* The provided string 'description' is a UTF-8 encoded string to be
* associated with this ring, and is considered user-visible; general
* internationalization rules apply.
*
* The serial argument will be that of the last
* wp_tablet_pad_group.mode_switch event received for the group of this
* dial. Requests providing other serials than the most recent one will be
* ignored.
*/
static inline void
zwp_tablet_pad_dial_v2_set_feedback(struct zwp_tablet_pad_dial_v2 *zwp_tablet_pad_dial_v2, const char *description, uint32_t serial)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_pad_dial_v2,
ZWP_TABLET_PAD_DIAL_V2_SET_FEEDBACK, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_dial_v2), 0, description, serial);
}
/**
* @ingroup iface_zwp_tablet_pad_dial_v2
*
* This destroys the client's resource for this dial object.
*/
static inline void
zwp_tablet_pad_dial_v2_destroy(struct zwp_tablet_pad_dial_v2 *zwp_tablet_pad_dial_v2)
{
wl_proxy_marshal_flags((struct wl_proxy *) zwp_tablet_pad_dial_v2,
ZWP_TABLET_PAD_DIAL_V2_DESTROY, NULL, wl_proxy_get_version((struct wl_proxy *) zwp_tablet_pad_dial_v2), WL_MARSHAL_FLAG_DESTROY);
}
#ifdef __cplusplus
}
#endif
#endif
================================================
FILE: pkg/wayland/wayland.c
================================================
#include "wayland.h"
#include "keyboard-shortcuts-inhibit-client.h"
#include "tablet-v2.h"
#include "wlr-layer-shell-client.h"
#include
#include
#include
#include
#include
#ifndef __has_attribute
#define __has_attribute(x) 0
#endif
#if (__has_attribute(visibility) || defined(__GNUC__) && __GNUC__ >= 4)
#define WL_PRIVATE __attribute__((visibility("hidden")))
#else
#define WL_PRIVATE
#endif
extern const struct wl_interface wl_output_interface;
extern const struct wl_interface wl_surface_interface;
extern const struct wl_interface zwlr_layer_surface_v1_interface;
static const struct wl_interface xdg_popup_interface = {
"xdg_popup", 0, 0, NULL, 0, NULL,
};
static const struct wl_interface *wlr_layer_shell_unstable_v1_types[] = {
NULL,
NULL,
NULL,
NULL,
&zwlr_layer_surface_v1_interface,
&wl_surface_interface,
&wl_output_interface,
NULL,
NULL,
&xdg_popup_interface,
};
static const struct wl_message zwlr_layer_shell_v1_requests[] = {
{"get_layer_surface", "no?ous", wlr_layer_shell_unstable_v1_types + 4},
{"destroy", "3", wlr_layer_shell_unstable_v1_types + 0},
};
WL_PRIVATE const struct wl_interface zwlr_layer_shell_v1_interface = {
"zwlr_layer_shell_v1", 4, 2, zwlr_layer_shell_v1_requests, 0, NULL,
};
static const struct wl_message zwlr_layer_surface_v1_requests[] = {
{"set_size", "uu", wlr_layer_shell_unstable_v1_types + 0},
{"set_anchor", "u", wlr_layer_shell_unstable_v1_types + 0},
{"set_exclusive_zone", "i", wlr_layer_shell_unstable_v1_types + 0},
{"set_margin", "iiii", wlr_layer_shell_unstable_v1_types + 0},
{"set_keyboard_interactivity", "u", wlr_layer_shell_unstable_v1_types + 0},
{"get_popup", "o", wlr_layer_shell_unstable_v1_types + 9},
{"ack_configure", "u", wlr_layer_shell_unstable_v1_types + 0},
{"destroy", "", wlr_layer_shell_unstable_v1_types + 0},
{"set_layer", "2u", wlr_layer_shell_unstable_v1_types + 0},
};
static const struct wl_message zwlr_layer_surface_v1_events[] = {
{"configure", "uuu", wlr_layer_shell_unstable_v1_types + 0},
{"closed", "", wlr_layer_shell_unstable_v1_types + 0},
};
WL_PRIVATE const struct wl_interface zwlr_layer_surface_v1_interface = {
"zwlr_layer_surface_v1", 4, 9,
zwlr_layer_surface_v1_requests, 2, zwlr_layer_surface_v1_events,
};
static const struct wl_interface
*keyboard_shortcuts_inhibit_unstable_v1_types[] = {
&zwp_keyboard_shortcuts_inhibitor_v1_interface,
&wl_surface_interface,
&wl_seat_interface,
};
static const struct wl_message
zwp_keyboard_shortcuts_inhibit_manager_v1_requests[] = {
{"destroy", "", keyboard_shortcuts_inhibit_unstable_v1_types + 0},
{"inhibit_shortcuts", "noo",
keyboard_shortcuts_inhibit_unstable_v1_types + 0},
};
WL_PRIVATE const struct wl_interface
zwp_keyboard_shortcuts_inhibit_manager_v1_interface = {
"zwp_keyboard_shortcuts_inhibit_manager_v1", 1, 2,
zwp_keyboard_shortcuts_inhibit_manager_v1_requests, 0, NULL,
};
static const struct wl_message zwp_keyboard_shortcuts_inhibitor_v1_requests[] =
{
{"destroy", "", keyboard_shortcuts_inhibit_unstable_v1_types + 0},
};
static const struct wl_message zwp_keyboard_shortcuts_inhibitor_v1_events[] = {
{"active", "", keyboard_shortcuts_inhibit_unstable_v1_types + 0},
{"inactive", "", keyboard_shortcuts_inhibit_unstable_v1_types + 0},
};
WL_PRIVATE const struct wl_interface
zwp_keyboard_shortcuts_inhibitor_v1_interface = {
"zwp_keyboard_shortcuts_inhibitor_v1",
1,
1,
zwp_keyboard_shortcuts_inhibitor_v1_requests,
2,
zwp_keyboard_shortcuts_inhibitor_v1_events,
};
struct wl_compositor *compositor = NULL;
struct zwlr_layer_shell_v1 *layer_shell = NULL;
struct wl_seat *seat = NULL;
struct wl_pointer *pointer = NULL;
struct wl_touch *touch = NULL;
struct wl_keyboard *keyboard = NULL;
struct zwp_tablet_manager_v2 *tablet_manager = NULL;
struct zwp_tablet_tool_v2 *tablet_tool = NULL;
struct zwp_tablet_seat_v2 *tablet_seat = NULL;
struct zwp_keyboard_shortcuts_inhibit_manager_v1 *shortcuts_inhibit_manager =
NULL;
struct zwp_keyboard_shortcuts_inhibitor_v1 *shortcuts_inhibitor = NULL;
struct zwlr_layer_surface_v1 *layer_surface_global = NULL;
struct xkb_context *xkb_context;
struct xkb_keymap *xkb_keymap;
struct xkb_state *xkb_state;
int32_t width_global = 0;
int32_t height_global = 0;
void layer_surface_configure(void *data, struct zwlr_layer_surface_v1 *surface,
uint32_t serial, uint32_t width, uint32_t height) {
width_global = width;
height_global = height;
zwlr_layer_surface_v1_ack_configure(surface, serial);
}
void layer_surface_closed(void *data, struct zwlr_layer_surface_v1 *surface) {}
static struct zwlr_layer_surface_v1_listener layer_surface_listener = {
.configure = layer_surface_configure,
.closed = layer_surface_closed,
};
// Forward declarations for seat
void seat_capabilities(void *data, struct wl_seat *seat, uint32_t capabilities);
void seat_name(void *data, struct wl_seat *seat, const char *name);
static const struct wl_seat_listener seat_listener = {
.capabilities = seat_capabilities,
.name = seat_name,
};
void registry_global(void *data, struct wl_registry *registry, uint32_t name,
const char *interface, uint32_t version) {
if (strcmp(interface, "wl_compositor") == 0) {
compositor = wl_registry_bind(registry, name, &wl_compositor_interface, 4);
} else if (strcmp(interface, "zwlr_layer_shell_v1") == 0) {
layer_shell = (struct zwlr_layer_shell_v1 *)wl_registry_bind(
registry, name, &zwlr_layer_shell_v1_interface, 1);
} else if (strcmp(interface, "wl_seat") == 0) {
seat = wl_registry_bind(registry, name, &wl_seat_interface, 1);
wl_seat_add_listener(seat, &seat_listener, NULL);
} else if (strcmp(interface, "zwp_keyboard_shortcuts_inhibit_manager_v1") ==
0) {
shortcuts_inhibit_manager =
(struct zwp_keyboard_shortcuts_inhibit_manager_v1 *)wl_registry_bind(
registry, name,
&zwp_keyboard_shortcuts_inhibit_manager_v1_interface, 1);
} else if (strcmp(interface, zwp_tablet_manager_v2_interface.name) == 0) {
tablet_manager = (struct zwp_tablet_manager_v2 *)wl_registry_bind(
registry, name, &zwp_tablet_manager_v2_interface, 1);
}
}
void registry_global_remove(void *data, struct wl_registry *registry,
uint32_t name) {}
static const struct wl_registry_listener registry_listener = {
.global = registry_global,
.global_remove = registry_global_remove,
};
struct wl_registry *get_registry(struct wl_display *display) {
return wl_display_get_registry(display);
}
void add_registry_listener(struct wl_registry *registry) {
wl_registry_add_listener(registry, ®istry_listener, NULL);
}
struct wl_surface *surface_global = NULL;
struct zwlr_layer_surface_v1 *create_layer_surface(struct wl_surface *surface) {
surface_global = surface;
layer_surface_global = zwlr_layer_shell_v1_get_layer_surface(
layer_shell, surface, NULL, ZWLR_LAYER_SHELL_V1_LAYER_OVERLAY,
"hexecute");
zwlr_layer_surface_v1_set_anchor(layer_surface_global,
ZWLR_LAYER_SURFACE_V1_ANCHOR_TOP |
ZWLR_LAYER_SURFACE_V1_ANCHOR_BOTTOM |
ZWLR_LAYER_SURFACE_V1_ANCHOR_LEFT |
ZWLR_LAYER_SURFACE_V1_ANCHOR_RIGHT);
zwlr_layer_surface_v1_set_exclusive_zone(layer_surface_global, -1);
zwlr_layer_surface_v1_set_keyboard_interactivity(
layer_surface_global,
ZWLR_LAYER_SURFACE_V1_KEYBOARD_INTERACTIVITY_EXCLUSIVE);
zwlr_layer_surface_v1_add_listener(layer_surface_global,
&layer_surface_listener, NULL);
wl_surface_commit(surface);
return layer_surface_global;
}
void set_input_region(int32_t width, int32_t height) {
if (surface_global) {
struct wl_region *region = wl_compositor_create_region(compositor);
wl_region_add(region, 0, 0, width, height);
wl_surface_set_input_region(surface_global, region);
wl_region_destroy(region);
wl_surface_commit(surface_global);
}
}
void disable_all_input() {
if (shortcuts_inhibitor) {
zwp_keyboard_shortcuts_inhibitor_v1_destroy(shortcuts_inhibitor);
shortcuts_inhibitor = NULL;
}
if (layer_surface_global) {
zwlr_layer_surface_v1_set_keyboard_interactivity(
layer_surface_global,
ZWLR_LAYER_SURFACE_V1_KEYBOARD_INTERACTIVITY_NONE);
}
if (surface_global) {
struct wl_region *region = wl_compositor_create_region(compositor);
wl_surface_set_input_region(surface_global, region);
wl_region_destroy(region);
wl_surface_commit(surface_global);
}
}
static int button_state = 0;
static double mouse_x = 0;
static double mouse_y = 0;
static int32_t touch_id = -1;
void pointer_enter(void *data, struct wl_pointer *pointer, uint32_t serial,
struct wl_surface *surface, wl_fixed_t x, wl_fixed_t y) {
mouse_x = wl_fixed_to_double(x);
mouse_y = wl_fixed_to_double(y);
wl_pointer_set_cursor(pointer, serial, NULL, 0, 0);
}
void pointer_leave(void *data, struct wl_pointer *pointer, uint32_t serial,
struct wl_surface *surface) {}
void pointer_motion(void *data, struct wl_pointer *pointer, uint32_t time,
wl_fixed_t x, wl_fixed_t y) {
mouse_x = wl_fixed_to_double(x);
mouse_y = wl_fixed_to_double(y);
}
void pointer_button(void *data, struct wl_pointer *pointer, uint32_t serial,
uint32_t time, uint32_t button, uint32_t state) {
if (button == 272) {
button_state = state;
}
}
void pointer_axis(void *data, struct wl_pointer *pointer, uint32_t time,
uint32_t axis, wl_fixed_t value) {}
void pointer_frame(void *data, struct wl_pointer *pointer) {}
void pointer_axis_source(void *data, struct wl_pointer *pointer,
uint32_t source) {}
void pointer_axis_stop(void *data, struct wl_pointer *pointer, uint32_t time,
uint32_t axis) {}
void pointer_axis_discrete(void *data, struct wl_pointer *pointer,
uint32_t axis, int32_t discrete) {}
static const struct wl_pointer_listener pointer_listener = {
.enter = pointer_enter,
.leave = pointer_leave,
.motion = pointer_motion,
.button = pointer_button,
.axis = pointer_axis,
.frame = pointer_frame,
.axis_source = pointer_axis_source,
.axis_stop = pointer_axis_stop,
.axis_discrete = pointer_axis_discrete,
};
void tablet_tool_removed(void *data, struct zwp_tablet_tool_v2 *id) {
button_state = 0;
}
void tablet_tool_down(void *data, struct zwp_tablet_tool_v2 *id,
unsigned int serial) {
button_state = 1;
}
void tablet_tool_up(void *data, struct zwp_tablet_tool_v2 *id) {
button_state = 0;
}
void tablet_tool_motion(void *data, struct zwp_tablet_tool_v2 *id, wl_fixed_t x,
wl_fixed_t y) {
mouse_x = wl_fixed_to_double(x);
mouse_y = wl_fixed_to_double(y);
}
void tablet_tool_type(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t tool_type) {}
void tablet_tool_serial(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t high, uint32_t low) {}
void tablet_tool_id_wacom(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t high, uint32_t low) {}
void tablet_tool_capability(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t capability) {}
void tablet_tool_proximity_in(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t serial, struct zwp_tablet_v2 *tablet_id,
struct wl_surface *surface) {}
void tablet_tool_proximity_out(void *data, struct zwp_tablet_tool_v2 *id) {}
void tablet_tool_pressure(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t pressure) {}
void tablet_tool_distance(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t distance) {}
void tablet_tool_tilt(void *data, struct zwp_tablet_tool_v2 *id, wl_fixed_t x,
wl_fixed_t y) {}
void tablet_tool_rotation(void *data, struct zwp_tablet_tool_v2 *id,
wl_fixed_t rotation) {}
void tablet_tool_slider(void *data, struct zwp_tablet_tool_v2 *id, int slider) {
}
void tablet_tool_wheel(void *data, struct zwp_tablet_tool_v2 *id,
wl_fixed_t degree, int clicks) {}
void tablet_tool_button(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t serial, uint32_t button, uint32_t state) {}
void tablet_tool_frame(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t time) {}
void tablet_tool_done(void *data, struct zwp_tablet_tool_v2 *id) { /* empty */ }
static const struct zwp_tablet_tool_v2_listener tablet_tool_listener = {
.removed = tablet_tool_removed,
.down = tablet_tool_down,
.up = tablet_tool_up,
.motion = tablet_tool_motion,
.type = tablet_tool_type,
.hardware_serial = tablet_tool_serial,
.hardware_id_wacom = tablet_tool_id_wacom,
.capability = tablet_tool_capability,
.done = tablet_tool_done,
.proximity_in = tablet_tool_proximity_in,
.proximity_out = tablet_tool_proximity_out,
.pressure = tablet_tool_pressure,
.distance = tablet_tool_distance,
.tilt = tablet_tool_tilt,
.rotation = tablet_tool_rotation,
.slider = tablet_tool_slider,
.wheel = tablet_tool_wheel,
.button = tablet_tool_button,
.frame = tablet_tool_frame,
};
void tablet_added(void *data, struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2,
struct zwp_tablet_v2 *zwp_tablet_v2) {}
void tool_added(void *data, struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2) {
tablet_tool = zwp_tablet_tool_v2;
zwp_tablet_tool_v2_add_listener(tablet_tool, &tablet_tool_listener, NULL);
}
void pad_added(void *data, struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2,
struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2) {}
static const struct zwp_tablet_seat_v2_listener tablet_seat_listener = {
.tablet_added = tablet_added,
.tool_added = tool_added,
.pad_added = pad_added,
};
void touch_down(void *data, struct wl_touch *wl_touch, uint serial, uint time,
struct wl_surface *surface, int id, wl_fixed_t x,
wl_fixed_t y) {
if (touch_id == -1) {
mouse_x = wl_fixed_to_double(x);
mouse_y = wl_fixed_to_double(y);
touch_id = id;
button_state = 1;
}
}
void touch_up(void *data, struct wl_touch *wl_touch, uint serial, uint time,
int id) {
if (touch_id == id) {
touch_id = -1;
button_state = 0;
}
}
void touch_motion(void *data, struct wl_touch *wl_touch, uint time, int id,
wl_fixed_t x, wl_fixed_t y) {
if (touch_id == id) {
mouse_x = wl_fixed_to_double(x);
mouse_y = wl_fixed_to_double(y);
}
}
void touch_frame(void *data, struct wl_touch *wl_touch) {}
void touch_cancel(void *data, struct wl_touch *wl_touch) {}
void touch_shape(void *data, struct wl_touch *wl_touch, int32_t id,
wl_fixed_t major, wl_fixed_t minor) {}
void touch_orientation(void *data, struct wl_touch *wl_touch, int32_t id,
wl_fixed_t orientation) {}
static const struct wl_touch_listener touch_listener = {
.down = touch_down,
.up = touch_up,
.motion = touch_motion,
.frame = touch_frame,
.cancel = touch_cancel,
.shape = touch_shape,
.orientation = touch_orientation,
};
static uint32_t last_key = 0;
static uint32_t last_key_state = 0;
void keyboard_keymap(void *data, struct wl_keyboard *keyboard, uint32_t format,
int32_t fd, uint32_t size) {
if (format != WL_KEYBOARD_KEYMAP_FORMAT_XKB_V1) {
close(fd);
return;
}
char *map_shm = mmap(NULL, size, PROT_READ, MAP_PRIVATE, fd, 0);
if (map_shm == MAP_FAILED) {
close(fd);
return;
}
xkb_keymap = xkb_keymap_new_from_string(xkb_context, map_shm,
XKB_KEYMAP_FORMAT_TEXT_V1,
XKB_KEYMAP_COMPILE_NO_FLAGS);
munmap(map_shm, size);
close(fd);
if (!xkb_keymap) {
return;
}
xkb_state = xkb_state_new(xkb_keymap);
if (!xkb_state) {
return;
}
}
void keyboard_enter(void *data, struct wl_keyboard *keyboard, uint32_t serial,
struct wl_surface *surface, struct wl_array *keys) {}
void keyboard_leave(void *data, struct wl_keyboard *keyboard, uint32_t serial,
struct wl_surface *surface) {}
void keyboard_key(void *data, struct wl_keyboard *keyboard, uint32_t serial,
uint32_t time, uint32_t key, uint32_t state) {
if (xkb_state) {
xkb_keysym_t sym = xkb_state_key_get_one_sym(xkb_state, key + 8);
if (state == WL_KEYBOARD_KEY_STATE_PRESSED) {
last_key = sym;
last_key_state = 1;
} else {
last_key = 0;
last_key_state = 0;
}
}
}
void keyboard_modifiers(void *data, struct wl_keyboard *keyboard,
uint32_t serial, uint32_t mods_depressed,
uint32_t mods_latched, uint32_t mods_locked,
uint32_t group) {
if (xkb_state) {
xkb_state_update_mask(xkb_state, mods_depressed, mods_latched, mods_locked,
0, 0, group);
}
}
void keyboard_repeat_info(void *data, struct wl_keyboard *keyboard,
int32_t rate, int32_t delay) {}
static const struct wl_keyboard_listener keyboard_listener = {
.keymap = keyboard_keymap,
.enter = keyboard_enter,
.leave = keyboard_leave,
.key = keyboard_key,
.modifiers = keyboard_modifiers,
.repeat_info = keyboard_repeat_info,
};
// Seat listener
void seat_capabilities(void *data, struct wl_seat *seat,
uint32_t capabilities) {
if (capabilities & WL_SEAT_CAPABILITY_POINTER) {
pointer = wl_seat_get_pointer(seat);
wl_pointer_add_listener(pointer, &pointer_listener, NULL);
}
if (capabilities & WL_SEAT_CAPABILITY_KEYBOARD) {
keyboard = wl_seat_get_keyboard(seat);
wl_keyboard_add_listener(keyboard, &keyboard_listener, NULL);
if (shortcuts_inhibit_manager && surface_global && !shortcuts_inhibitor) {
shortcuts_inhibitor =
zwp_keyboard_shortcuts_inhibit_manager_v1_inhibit_shortcuts(
shortcuts_inhibit_manager, surface_global, seat);
}
}
if (capabilities & WL_SEAT_CAPABILITY_TOUCH) {
touch = wl_seat_get_touch(seat);
wl_touch_add_listener(touch, &touch_listener, NULL);
}
tablet_seat = zwp_tablet_manager_v2_get_tablet_seat(tablet_manager, seat);
zwp_tablet_seat_v2_add_listener(tablet_seat, &tablet_seat_listener, seat);
}
void seat_name(void *data, struct wl_seat *seat, const char *name) {}
int get_button_state() { return button_state; }
void get_mouse_pos(double *x, double *y) {
*x = mouse_x;
*y = mouse_y;
}
void get_dimensions(int32_t *w, int32_t *h) {
*w = width_global;
*h = height_global;
}
uint32_t get_last_key() { return last_key; }
uint32_t get_last_key_state() { return last_key_state; }
void clear_last_key() {
last_key = 0;
last_key_state = 0;
}
EGLNativeWindowType native_window(struct wl_egl_window *egl_window) {
return (EGLNativeWindowType)egl_window;
}
================================================
FILE: pkg/wayland/wayland.go
================================================
package wayland
/*
#cgo pkg-config: wayland-client wayland-egl egl gl xkbcommon
#cgo LDFLAGS: -lwayland-client -lwayland-egl -lEGL -lGL -lxkbcommon
#cgo CFLAGS: -I.
#include "wayland.h"
#include "wayland-client.h"
*/
import "C"
import (
"fmt"
)
type WaylandError struct {
msg string
}
func (e *WaylandError) Error() string {
return e.msg
}
type WaylandWindow struct {
display *C.struct_wl_display
registry *C.struct_wl_registry
surface *C.struct_wl_surface
layerSurface *C.struct_zwlr_layer_surface_v1
eglWindow *C.struct_wl_egl_window
eglDisplay C.EGLDisplay
eglContext C.EGLContext
eglSurface C.EGLSurface
width, height int32
}
func NewWaylandWindow() (*WaylandWindow, error) {
w := &WaylandWindow{}
C.xkb_context = C.xkb_context_new(C.XKB_CONTEXT_NO_FLAGS)
if C.xkb_context == nil {
return nil, &WaylandError{"failed to create xkb context"}
}
w.display = C.wl_display_connect(nil)
if w.display == nil {
return nil, &WaylandError{"failed to connect to Wayland display"}
}
w.registry = C.get_registry(w.display)
C.add_registry_listener(w.registry)
C.wl_display_roundtrip(w.display)
if C.compositor == nil {
return nil, &WaylandError{"compositor not available"}
}
if C.layer_shell == nil {
return nil, &WaylandError{"layer shell not available"}
}
w.surface = C.wl_compositor_create_surface(C.compositor)
if w.surface == nil {
return nil, &WaylandError{"failed to create surface"}
}
w.layerSurface = C.create_layer_surface(w.surface)
C.wl_display_roundtrip(w.display)
var width, height C.int32_t
C.get_dimensions(&width, &height)
w.width = int32(width)
w.height = int32(height)
if w.width == 0 || w.height == 0 {
w.width = 1920
w.height = 1080
}
C.wl_display_roundtrip(w.display)
C.set_input_region(C.int32_t(w.width), C.int32_t(w.height))
if err := w.initEGL(); err != nil {
return nil, err
}
C.wl_surface_commit(w.surface)
C.wl_display_flush(w.display)
C.wl_display_roundtrip(w.display)
C.wl_display_roundtrip(w.display)
C.wl_display_flush(w.display)
return w, nil
}
func (w *WaylandWindow) initEGL() error {
w.eglWindow = C.wl_egl_window_create(w.surface, C.int(w.width), C.int(w.height))
if w.eglWindow == nil {
return fmt.Errorf("failed to create EGL window")
}
w.eglDisplay = C.eglGetDisplay(C.EGLNativeDisplayType(w.display))
if w.eglDisplay == C.EGLDisplay(C.EGL_NO_DISPLAY) {
return fmt.Errorf("failed to get EGL display")
}
var major, minor C.EGLint
if C.eglInitialize(w.eglDisplay, &major, &minor) == C.EGL_FALSE {
return fmt.Errorf("failed to initialize EGL")
}
configAttribs := []C.EGLint{
C.EGL_SURFACE_TYPE, C.EGL_WINDOW_BIT,
C.EGL_RED_SIZE, 8,
C.EGL_GREEN_SIZE, 8,
C.EGL_BLUE_SIZE, 8,
C.EGL_ALPHA_SIZE, 8,
C.EGL_RENDERABLE_TYPE, C.EGL_OPENGL_BIT,
C.EGL_NONE,
}
var config C.EGLConfig
var numConfigs C.EGLint
if C.eglChooseConfig(w.eglDisplay, &configAttribs[0], &config, 1, &numConfigs) == C.EGL_FALSE {
return fmt.Errorf("failed to choose EGL config")
}
C.eglBindAPI(C.EGL_OPENGL_API)
contextAttribs := []C.EGLint{
C.EGL_CONTEXT_MAJOR_VERSION, 4,
C.EGL_CONTEXT_MINOR_VERSION, 1,
C.EGL_CONTEXT_OPENGL_PROFILE_MASK, C.EGL_CONTEXT_OPENGL_CORE_PROFILE_BIT,
C.EGL_NONE,
}
w.eglContext = C.eglCreateContext(w.eglDisplay, config, nil, &contextAttribs[0])
if w.eglContext == nil {
return fmt.Errorf("failed to create EGL context")
}
w.eglSurface = C.eglCreateWindowSurface(
w.eglDisplay,
config,
C.native_window(w.eglWindow),
nil,
)
if w.eglSurface == nil {
return fmt.Errorf("failed to create EGL surface")
}
if C.eglMakeCurrent(w.eglDisplay, w.eglSurface, w.eglSurface, w.eglContext) == C.EGL_FALSE {
return fmt.Errorf("failed to make EGL context current")
}
return nil
}
func (w *WaylandWindow) GetSize() (int, int) {
var width, height C.int32_t
C.get_dimensions(&width, &height)
if width > 0 && height > 0 {
w.width = int32(width)
w.height = int32(height)
}
return int(w.width), int(w.height)
}
func (w *WaylandWindow) ShouldClose() bool {
return false
}
func (w *WaylandWindow) SwapBuffers() {
C.eglSwapBuffers(w.eglDisplay, w.eglSurface)
}
func (w *WaylandWindow) PollEvents() {
C.wl_display_flush(w.display)
C.wl_display_dispatch_pending(w.display)
}
func (w *WaylandWindow) GetCursorPos() (float64, float64) {
var x, y C.double
C.get_mouse_pos(&x, &y)
return float64(x), float64(y)
}
func (w *WaylandWindow) GetMouseButton() bool {
state := C.get_button_state()
return state == 1
}
func (w *WaylandWindow) DisableInput() {
C.disable_all_input()
}
func (w *WaylandWindow) GetLastKey() (uint32, uint32, bool) {
key := uint32(C.get_last_key())
state := uint32(C.get_last_key_state())
return key, state, key != 0
}
func (w *WaylandWindow) ClearLastKey() {
C.clear_last_key()
}
func (w *WaylandWindow) Destroy() {
if w.eglContext != C.EGLContext(C.EGL_NO_CONTEXT) {
C.eglDestroyContext(w.eglDisplay, w.eglContext)
}
if w.eglSurface != C.EGLSurface(C.EGL_NO_SURFACE) {
C.eglDestroySurface(w.eglDisplay, w.eglSurface)
}
if w.eglWindow != nil {
C.wl_egl_window_destroy(w.eglWindow)
}
if w.eglDisplay != C.EGLDisplay(C.EGL_NO_DISPLAY) {
C.eglTerminate(w.eglDisplay)
}
if w.surface != nil {
C.wl_surface_destroy(w.surface)
}
if w.display != nil {
C.wl_display_disconnect(w.display)
}
}
================================================
FILE: pkg/wayland/wayland.h
================================================
#ifndef WAYLAND_H
#define WAYLAND_H
#include "tablet-v2.h"
#include "wlr-layer-shell-client.h"
#include
#include
#include
#include
#include
void layer_surface_configure(void *data, struct zwlr_layer_surface_v1 *surface,
uint32_t serial, uint32_t width, uint32_t height);
void layer_surface_closed(void *data, struct zwlr_layer_surface_v1 *surface);
void seat_capabilities(void *data, struct wl_seat *seat, uint32_t capabilities);
void seat_name(void *data, struct wl_seat *seat, const char *name);
void registry_global(void *data, struct wl_registry *registry, uint32_t name,
const char *interface, uint32_t version);
void registry_global_remove(void *data, struct wl_registry *registry,
uint32_t name);
struct wl_registry *get_registry(struct wl_display *display);
void add_registry_listener(struct wl_registry *registry);
struct zwlr_layer_surface_v1 *create_layer_surface(struct wl_surface *surface);
void set_input_region(int32_t width, int32_t height);
void disable_all_input();
void pointer_enter(void *data, struct wl_pointer *pointer, uint32_t serial,
struct wl_surface *surface, wl_fixed_t x, wl_fixed_t y);
void pointer_leave(void *data, struct wl_pointer *pointer, uint32_t serial,
struct wl_surface *surface);
void pointer_motion(void *data, struct wl_pointer *pointer, uint32_t time,
wl_fixed_t x, wl_fixed_t y);
void pointer_button(void *data, struct wl_pointer *pointer, uint32_t serial,
uint32_t time, uint32_t button, uint32_t state);
void pointer_axis(void *data, struct wl_pointer *pointer, uint32_t time,
uint32_t axis, wl_fixed_t value);
void pointer_frame(void *data, struct wl_pointer *pointer);
void pointer_axis_source(void *data, struct wl_pointer *pointer,
uint32_t source);
void pointer_axis_stop(void *data, struct wl_pointer *pointer, uint32_t time,
uint32_t axis);
void pointer_axis_discrete(void *data, struct wl_pointer *pointer,
uint32_t axis, int32_t discrete);
void touch_down(void *data, struct wl_touch *wl_touch, uint serial, uint time,
struct wl_surface *surface, int id, wl_fixed_t x, wl_fixed_t y);
void touch_up(void *data, struct wl_touch *wl_touch, uint serial, uint time,
int id);
void touch_motion(void *data, struct wl_touch *wl_touch, uint time, int id,
wl_fixed_t x, wl_fixed_t y);
void touch_frame(void *data, struct wl_touch *wl_touch);
void touch_cancel(void *data, struct wl_touch *wl_touch);
void touch_shape(void *data, struct wl_touch *wl_touch, int32_t id,
wl_fixed_t major, wl_fixed_t minor);
void touch_orientation(void *data, struct wl_touch *wl_touch, int32_t id,
wl_fixed_t orientation);
void tablet_added(void *data, struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2,
struct zwp_tablet_v2 *zwp_tablet_v2);
void tool_added(void *data, struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2,
struct zwp_tablet_tool_v2 *zwp_tablet_tool_v2);
void pad_added(void *data, struct zwp_tablet_seat_v2 *zwp_tablet_seat_v2,
struct zwp_tablet_pad_v2 *zwp_tablet_pad_v2);
void tablet_tool_removed(void *data, struct zwp_tablet_tool_v2 *id);
void tablet_tool_down(void *data, struct zwp_tablet_tool_v2 *id,
unsigned int serial);
void tablet_tool_up(void *data, struct zwp_tablet_tool_v2 *id);
void tablet_tool_motion(void *data, struct zwp_tablet_tool_v2 *id, wl_fixed_t x,
wl_fixed_t y);
void tablet_tool_type(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t tool_type);
void tablet_tool_serial(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t high, uint32_t low);
void tablet_tool_id_wacom(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t high, uint32_t low);
void tablet_tool_capability(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t capability);
void tablet_tool_proximity_in(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t serial, struct zwp_tablet_v2 *tablet_id,
struct wl_surface *surface);
void tablet_tool_proximity_out(void *data, struct zwp_tablet_tool_v2 *id);
void tablet_tool_pressure(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t pressure);
void tablet_tool_distance(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t distance);
void tablet_tool_tilt(void *data, struct zwp_tablet_tool_v2 *id, wl_fixed_t x,
wl_fixed_t y);
void tablet_tool_rotation(void *data, struct zwp_tablet_tool_v2 *id,
wl_fixed_t rotation);
void tablet_tool_slider(void *data, struct zwp_tablet_tool_v2 *id, int slider);
void tablet_tool_wheel(void *data, struct zwp_tablet_tool_v2 *id,
wl_fixed_t degree, int clicks);
void tablet_tool_button(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t serial, uint32_t button, uint32_t state);
void tablet_tool_frame(void *data, struct zwp_tablet_tool_v2 *id,
uint32_t time);
void tablet_tool_done(void *data, struct zwp_tablet_tool_v2 *id);
void keyboard_keymap(void *data, struct wl_keyboard *keyboard, uint32_t format,
int32_t fd, uint32_t size);
void keyboard_enter(void *data, struct wl_keyboard *keyboard, uint32_t serial,
struct wl_surface *surface, struct wl_array *keys);
void keyboard_leave(void *data, struct wl_keyboard *keyboard, uint32_t serial,
struct wl_surface *surface);
void keyboard_key(void *data, struct wl_keyboard *keyboard, uint32_t serial,
uint32_t time, uint32_t key, uint32_t state);
void keyboard_modifiers(void *data, struct wl_keyboard *keyboard,
uint32_t serial, uint32_t mods_depressed,
uint32_t mods_latched, uint32_t mods_locked,
uint32_t group);
void keyboard_repeat_info(void *data, struct wl_keyboard *keyboard,
int32_t rate, int32_t delay);
int get_button_state();
void get_mouse_pos(double *x, double *y);
void get_dimensions(int32_t *w, int32_t *h);
uint32_t get_last_key();
uint32_t get_last_key_state();
void clear_last_key();
EGLNativeWindowType native_window(struct wl_egl_window *egl_window);
extern struct wl_compositor *compositor;
extern struct zwlr_layer_shell_v1 *layer_shell;
extern struct wl_seat *seat;
extern struct wl_pointer *pointer;
extern struct wl_touch *touch;
extern struct zwp_tablet_manager_v2_interface *tablet_manager_interface;
extern struct zwp_tablet_manager_v2 *tablet_manager;
extern struct zwp_tablet_seat_v2 *tablet_seat;
extern struct zwp_tablet_tool_v2 *tool;
extern struct wl_keyboard *keyboard;
extern struct zwp_keyboard_shortcuts_inhibit_manager_v1
*shortcuts_inhibit_manager;
extern struct zwp_keyboard_shortcuts_inhibitor_v1 *shortcuts_inhibitor;
extern struct zwlr_layer_surface_v1 *layer_surface_global;
extern struct xkb_context *xkb_context;
extern struct xkb_keymap *xkb_keymap;
extern struct xkb_state *xkb_state;
#endif // WAYLAND_H
================================================
FILE: pkg/wayland/wlr-layer-shell-client.h
================================================
/* Generated by wayland-scanner 1.24.0 */
#ifndef WLR_LAYER_SHELL_UNSTABLE_V1_CLIENT_PROTOCOL_H
#define WLR_LAYER_SHELL_UNSTABLE_V1_CLIENT_PROTOCOL_H
#include "wayland-client.h"
#include
#include
#ifdef __cplusplus
extern "C" {
#endif
/**
* @page page_wlr_layer_shell_unstable_v1 The wlr_layer_shell_unstable_v1
* protocol
* @section page_ifaces_wlr_layer_shell_unstable_v1 Interfaces
* - @subpage page_iface_zwlr_layer_shell_v1 - create surfaces that are layers
* of the desktop
* - @subpage page_iface_zwlr_layer_surface_v1 - layer metadata interface
* @section page_copyright_wlr_layer_shell_unstable_v1 Copyright
*
*
* Copyright © 2017 Drew DeVault
*
* Permission to use, copy, modify, distribute, and sell this
* software and its documentation for any purpose is hereby granted
* without fee, provided that the above copyright notice appear in
* all copies and that both that copyright notice and this permission
* notice appear in supporting documentation, and that the name of
* the copyright holders not be used in advertising or publicity
* pertaining to distribution of the software without specific,
* written prior permission. The copyright holders make no
* representations about the suitability of this software for any
* purpose. It is provided "as is" without express or implied
* warranty.
*
* THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
* SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
* FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
* SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
* AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
* ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
* THIS SOFTWARE.
*
*/
struct wl_output;
struct wl_surface;
struct xdg_popup;
struct zwlr_layer_shell_v1;
struct zwlr_layer_surface_v1;
#ifndef ZWLR_LAYER_SHELL_V1_INTERFACE
#define ZWLR_LAYER_SHELL_V1_INTERFACE
/**
* @page page_iface_zwlr_layer_shell_v1 zwlr_layer_shell_v1
* @section page_iface_zwlr_layer_shell_v1_desc Description
*
* Clients can use this interface to assign the surface_layer role to
* wl_surfaces. Such surfaces are assigned to a "layer" of the output and
* rendered with a defined z-depth respective to each other. They may also be
* anchored to the edges and corners of a screen and specify input handling
* semantics. This interface should be suitable for the implementation of
* many desktop shell components, and a broad number of other applications
* that interact with the desktop.
* @section page_iface_zwlr_layer_shell_v1_api API
* See @ref iface_zwlr_layer_shell_v1.
*/
/**
* @defgroup iface_zwlr_layer_shell_v1 The zwlr_layer_shell_v1 interface
*
* Clients can use this interface to assign the surface_layer role to
* wl_surfaces. Such surfaces are assigned to a "layer" of the output and
* rendered with a defined z-depth respective to each other. They may also be
* anchored to the edges and corners of a screen and specify input handling
* semantics. This interface should be suitable for the implementation of
* many desktop shell components, and a broad number of other applications
* that interact with the desktop.
*/
extern const struct wl_interface zwlr_layer_shell_v1_interface;
#endif
#ifndef ZWLR_LAYER_SURFACE_V1_INTERFACE
#define ZWLR_LAYER_SURFACE_V1_INTERFACE
/**
* @page page_iface_zwlr_layer_surface_v1 zwlr_layer_surface_v1
* @section page_iface_zwlr_layer_surface_v1_desc Description
*
* An interface that may be implemented by a wl_surface, for surfaces that
* are designed to be rendered as a layer of a stacked desktop-like
* environment.
*
* Layer surface state (layer, size, anchor, exclusive zone,
* margin, interactivity) is double-buffered, and will be applied at the
* time wl_surface.commit of the corresponding wl_surface is called.
*
* Attaching a null buffer to a layer surface unmaps it.
*
* Unmapping a layer_surface means that the surface cannot be shown by the
* compositor until it is explicitly mapped again. The layer_surface
* returns to the state it had right after layer_shell.get_layer_surface.
* The client can re-map the surface by performing a commit without any
* buffer attached, waiting for a configure event and handling it as usual.
* @section page_iface_zwlr_layer_surface_v1_api API
* See @ref iface_zwlr_layer_surface_v1.
*/
/**
* @defgroup iface_zwlr_layer_surface_v1 The zwlr_layer_surface_v1 interface
*
* An interface that may be implemented by a wl_surface, for surfaces that
* are designed to be rendered as a layer of a stacked desktop-like
* environment.
*
* Layer surface state (layer, size, anchor, exclusive zone,
* margin, interactivity) is double-buffered, and will be applied at the
* time wl_surface.commit of the corresponding wl_surface is called.
*
* Attaching a null buffer to a layer surface unmaps it.
*
* Unmapping a layer_surface means that the surface cannot be shown by the
* compositor until it is explicitly mapped again. The layer_surface
* returns to the state it had right after layer_shell.get_layer_surface.
* The client can re-map the surface by performing a commit without any
* buffer attached, waiting for a configure event and handling it as usual.
*/
extern const struct wl_interface zwlr_layer_surface_v1_interface;
#endif
#ifndef ZWLR_LAYER_SHELL_V1_ERROR_ENUM
#define ZWLR_LAYER_SHELL_V1_ERROR_ENUM
enum zwlr_layer_shell_v1_error {
/**
* wl_surface has another role
*/
ZWLR_LAYER_SHELL_V1_ERROR_ROLE = 0,
/**
* layer value is invalid
*/
ZWLR_LAYER_SHELL_V1_ERROR_INVALID_LAYER = 1,
/**
* wl_surface has a buffer attached or committed
*/
ZWLR_LAYER_SHELL_V1_ERROR_ALREADY_CONSTRUCTED = 2,
};
#endif /* ZWLR_LAYER_SHELL_V1_ERROR_ENUM */
#ifndef ZWLR_LAYER_SHELL_V1_LAYER_ENUM
#define ZWLR_LAYER_SHELL_V1_LAYER_ENUM
/**
* @ingroup iface_zwlr_layer_shell_v1
* available layers for surfaces
*
* These values indicate which layers a surface can be rendered in. They
* are ordered by z depth, bottom-most first. Traditional shell surfaces
* will typically be rendered between the bottom and top layers.
* Fullscreen shell surfaces are typically rendered at the top layer.
* Multiple surfaces can share a single layer, and ordering within a
* single layer is undefined.
*/
enum zwlr_layer_shell_v1_layer {
ZWLR_LAYER_SHELL_V1_LAYER_BACKGROUND = 0,
ZWLR_LAYER_SHELL_V1_LAYER_BOTTOM = 1,
ZWLR_LAYER_SHELL_V1_LAYER_TOP = 2,
ZWLR_LAYER_SHELL_V1_LAYER_OVERLAY = 3,
};
#endif /* ZWLR_LAYER_SHELL_V1_LAYER_ENUM */
#define ZWLR_LAYER_SHELL_V1_GET_LAYER_SURFACE 0
#define ZWLR_LAYER_SHELL_V1_DESTROY 1
/**
* @ingroup iface_zwlr_layer_shell_v1
*/
#define ZWLR_LAYER_SHELL_V1_GET_LAYER_SURFACE_SINCE_VERSION 1
/**
* @ingroup iface_zwlr_layer_shell_v1
*/
#define ZWLR_LAYER_SHELL_V1_DESTROY_SINCE_VERSION 3
/** @ingroup iface_zwlr_layer_shell_v1 */
static inline void zwlr_layer_shell_v1_set_user_data(
struct zwlr_layer_shell_v1 *zwlr_layer_shell_v1, void *user_data) {
wl_proxy_set_user_data((struct wl_proxy *)zwlr_layer_shell_v1, user_data);
}
/** @ingroup iface_zwlr_layer_shell_v1 */
static inline void *zwlr_layer_shell_v1_get_user_data(
struct zwlr_layer_shell_v1 *zwlr_layer_shell_v1) {
return wl_proxy_get_user_data((struct wl_proxy *)zwlr_layer_shell_v1);
}
static inline uint32_t zwlr_layer_shell_v1_get_version(
struct zwlr_layer_shell_v1 *zwlr_layer_shell_v1) {
return wl_proxy_get_version((struct wl_proxy *)zwlr_layer_shell_v1);
}
/**
* @ingroup iface_zwlr_layer_shell_v1
*
* Create a layer surface for an existing surface. This assigns the role of
* layer_surface, or raises a protocol error if another role is already
* assigned.
*
* Creating a layer surface from a wl_surface which has a buffer attached
* or committed is a client error, and any attempts by a client to attach
* or manipulate a buffer prior to the first layer_surface.configure call
* must also be treated as errors.
*
* After creating a layer_surface object and setting it up, the client
* must perform an initial commit without any buffer attached.
* The compositor will reply with a layer_surface.configure event.
* The client must acknowledge it and is then allowed to attach a buffer
* to map the surface.
*
* You may pass NULL for output to allow the compositor to decide which
* output to use. Generally this will be the one that the user most
* recently interacted with.
*
* Clients can specify a namespace that defines the purpose of the layer
* surface.
*/
static inline struct zwlr_layer_surface_v1 *
zwlr_layer_shell_v1_get_layer_surface(
struct zwlr_layer_shell_v1 *zwlr_layer_shell_v1, struct wl_surface *surface,
struct wl_output *output, uint32_t layer, const char *namespace) {
struct wl_proxy *id;
id = wl_proxy_marshal_flags(
(struct wl_proxy *)zwlr_layer_shell_v1,
ZWLR_LAYER_SHELL_V1_GET_LAYER_SURFACE, &zwlr_layer_surface_v1_interface,
wl_proxy_get_version((struct wl_proxy *)zwlr_layer_shell_v1), 0, NULL,
surface, output, layer, namespace);
return (struct zwlr_layer_surface_v1 *)id;
}
/**
* @ingroup iface_zwlr_layer_shell_v1
*
* This request indicates that the client will not use the layer_shell
* object any more. Objects that have been created through this instance
* are not affected.
*/
static inline void
zwlr_layer_shell_v1_destroy(struct zwlr_layer_shell_v1 *zwlr_layer_shell_v1) {
wl_proxy_marshal_flags(
(struct wl_proxy *)zwlr_layer_shell_v1, ZWLR_LAYER_SHELL_V1_DESTROY, NULL,
wl_proxy_get_version((struct wl_proxy *)zwlr_layer_shell_v1),
WL_MARSHAL_FLAG_DESTROY);
}
#ifndef ZWLR_LAYER_SURFACE_V1_KEYBOARD_INTERACTIVITY_ENUM
#define ZWLR_LAYER_SURFACE_V1_KEYBOARD_INTERACTIVITY_ENUM
/**
* @ingroup iface_zwlr_layer_surface_v1
* types of keyboard interaction possible for a layer shell surface
*
* Types of keyboard interaction possible for layer shell surfaces. The
* rationale for this is twofold: (1) some applications are not interested
* in keyboard events and not allowing them to be focused can improve the
* desktop experience; (2) some applications will want to take exclusive
* keyboard focus.
*/
enum zwlr_layer_surface_v1_keyboard_interactivity {
/**
* no keyboard focus is possible
*
* This value indicates that this surface is not interested in
* keyboard events and the compositor should never assign it the
* keyboard focus.
*
* This is the default value, set for newly created layer shell
* surfaces.
*
* This is useful for e.g. desktop widgets that display information
* or only have interaction with non-keyboard input devices.
*/
ZWLR_LAYER_SURFACE_V1_KEYBOARD_INTERACTIVITY_NONE = 0,
/**
* request exclusive keyboard focus
*
* Request exclusive keyboard focus if this surface is above the
* shell surface layer.
*
* For the top and overlay layers, the seat will always give
* exclusive keyboard focus to the top-most layer which has
* keyboard interactivity set to exclusive. If this layer contains
* multiple surfaces with keyboard interactivity set to exclusive,
* the compositor determines the one receiving keyboard events in
* an implementation- defined manner. In this case, no guarantee is
* made when this surface will receive keyboard focus (if ever).
*
* For the bottom and background layers, the compositor is allowed
* to use normal focus semantics.
*
* This setting is mainly intended for applications that need to
* ensure they receive all keyboard events, such as a lock screen
* or a password prompt.
*/
ZWLR_LAYER_SURFACE_V1_KEYBOARD_INTERACTIVITY_EXCLUSIVE = 1,
/**
* request regular keyboard focus semantics
*
* This requests the compositor to allow this surface to be
* focused and unfocused by the user in an implementation-defined
* manner. The user should be able to unfocus this surface even
* regardless of the layer it is on.
*
* Typically, the compositor will want to use its normal mechanism
* to manage keyboard focus between layer shell surfaces with this
* setting and regular toplevels on the desktop layer (e.g. click
* to focus). Nevertheless, it is possible for a compositor to
* require a special interaction to focus or unfocus layer shell
* surfaces (e.g. requiring a click even if focus follows the mouse
* normally, or providing a keybinding to switch focus between
* layers).
*
* This setting is mainly intended for desktop shell components
* (e.g. panels) that allow keyboard interaction. Using this option
* can allow implementing a desktop shell that can be fully usable
* without the mouse.
* @since 4
*/
ZWLR_LAYER_SURFACE_V1_KEYBOARD_INTERACTIVITY_ON_DEMAND = 2,
};
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
#define ZWLR_LAYER_SURFACE_V1_KEYBOARD_INTERACTIVITY_ON_DEMAND_SINCE_VERSION 4
#endif /* ZWLR_LAYER_SURFACE_V1_KEYBOARD_INTERACTIVITY_ENUM */
#ifndef ZWLR_LAYER_SURFACE_V1_ERROR_ENUM
#define ZWLR_LAYER_SURFACE_V1_ERROR_ENUM
enum zwlr_layer_surface_v1_error {
/**
* provided surface state is invalid
*/
ZWLR_LAYER_SURFACE_V1_ERROR_INVALID_SURFACE_STATE = 0,
/**
* size is invalid
*/
ZWLR_LAYER_SURFACE_V1_ERROR_INVALID_SIZE = 1,
/**
* anchor bitfield is invalid
*/
ZWLR_LAYER_SURFACE_V1_ERROR_INVALID_ANCHOR = 2,
/**
* keyboard interactivity is invalid
*/
ZWLR_LAYER_SURFACE_V1_ERROR_INVALID_KEYBOARD_INTERACTIVITY = 3,
};
#endif /* ZWLR_LAYER_SURFACE_V1_ERROR_ENUM */
#ifndef ZWLR_LAYER_SURFACE_V1_ANCHOR_ENUM
#define ZWLR_LAYER_SURFACE_V1_ANCHOR_ENUM
enum zwlr_layer_surface_v1_anchor {
/**
* the top edge of the anchor rectangle
*/
ZWLR_LAYER_SURFACE_V1_ANCHOR_TOP = 1,
/**
* the bottom edge of the anchor rectangle
*/
ZWLR_LAYER_SURFACE_V1_ANCHOR_BOTTOM = 2,
/**
* the left edge of the anchor rectangle
*/
ZWLR_LAYER_SURFACE_V1_ANCHOR_LEFT = 4,
/**
* the right edge of the anchor rectangle
*/
ZWLR_LAYER_SURFACE_V1_ANCHOR_RIGHT = 8,
};
#endif /* ZWLR_LAYER_SURFACE_V1_ANCHOR_ENUM */
/**
* @ingroup iface_zwlr_layer_surface_v1
* @struct zwlr_layer_surface_v1_listener
*/
struct zwlr_layer_surface_v1_listener {
/**
* suggest a surface change
*
* The configure event asks the client to resize its surface.
*
* Clients should arrange their surface for the new states, and
* then send an ack_configure request with the serial sent in this
* configure event at some point before committing the new surface.
*
* The client is free to dismiss all but the last configure event
* it received.
*
* The width and height arguments specify the size of the window in
* surface-local coordinates.
*
* The size is a hint, in the sense that the client is free to
* ignore it if it doesn't resize, pick a smaller size (to satisfy
* aspect ratio or resize in steps of NxM pixels). If the client
* picks a smaller size and is anchored to two opposite anchors
* (e.g. 'top' and 'bottom'), the surface will be centered on this
* axis.
*
* If the width or height arguments are zero, it means the client
* should decide its own window dimension.
*/
void (*configure)(void *data,
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1,
uint32_t serial, uint32_t width, uint32_t height);
/**
* surface should be closed
*
* The closed event is sent by the compositor when the surface
* will no longer be shown. The output may have been destroyed or
* the user may have asked for it to be removed. Further changes to
* the surface will be ignored. The client should destroy the
* resource after receiving this event, and create a new surface if
* they so choose.
*/
void (*closed)(void *data,
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1);
};
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
static inline int zwlr_layer_surface_v1_add_listener(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1,
const struct zwlr_layer_surface_v1_listener *listener, void *data) {
return wl_proxy_add_listener((struct wl_proxy *)zwlr_layer_surface_v1,
(void (**)(void))listener, data);
}
#define ZWLR_LAYER_SURFACE_V1_SET_SIZE 0
#define ZWLR_LAYER_SURFACE_V1_SET_ANCHOR 1
#define ZWLR_LAYER_SURFACE_V1_SET_EXCLUSIVE_ZONE 2
#define ZWLR_LAYER_SURFACE_V1_SET_MARGIN 3
#define ZWLR_LAYER_SURFACE_V1_SET_KEYBOARD_INTERACTIVITY 4
#define ZWLR_LAYER_SURFACE_V1_GET_POPUP 5
#define ZWLR_LAYER_SURFACE_V1_ACK_CONFIGURE 6
#define ZWLR_LAYER_SURFACE_V1_DESTROY 7
#define ZWLR_LAYER_SURFACE_V1_SET_LAYER 8
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
#define ZWLR_LAYER_SURFACE_V1_CONFIGURE_SINCE_VERSION 1
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
#define ZWLR_LAYER_SURFACE_V1_CLOSED_SINCE_VERSION 1
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
#define ZWLR_LAYER_SURFACE_V1_SET_SIZE_SINCE_VERSION 1
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
#define ZWLR_LAYER_SURFACE_V1_SET_ANCHOR_SINCE_VERSION 1
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
#define ZWLR_LAYER_SURFACE_V1_SET_EXCLUSIVE_ZONE_SINCE_VERSION 1
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
#define ZWLR_LAYER_SURFACE_V1_SET_MARGIN_SINCE_VERSION 1
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
#define ZWLR_LAYER_SURFACE_V1_SET_KEYBOARD_INTERACTIVITY_SINCE_VERSION 1
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
#define ZWLR_LAYER_SURFACE_V1_GET_POPUP_SINCE_VERSION 1
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
#define ZWLR_LAYER_SURFACE_V1_ACK_CONFIGURE_SINCE_VERSION 1
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
#define ZWLR_LAYER_SURFACE_V1_DESTROY_SINCE_VERSION 1
/**
* @ingroup iface_zwlr_layer_surface_v1
*/
#define ZWLR_LAYER_SURFACE_V1_SET_LAYER_SINCE_VERSION 2
/** @ingroup iface_zwlr_layer_surface_v1 */
static inline void zwlr_layer_surface_v1_set_user_data(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1, void *user_data) {
wl_proxy_set_user_data((struct wl_proxy *)zwlr_layer_surface_v1, user_data);
}
/** @ingroup iface_zwlr_layer_surface_v1 */
static inline void *zwlr_layer_surface_v1_get_user_data(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1) {
return wl_proxy_get_user_data((struct wl_proxy *)zwlr_layer_surface_v1);
}
static inline uint32_t zwlr_layer_surface_v1_get_version(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1) {
return wl_proxy_get_version((struct wl_proxy *)zwlr_layer_surface_v1);
}
/**
* @ingroup iface_zwlr_layer_surface_v1
*
* Sets the size of the surface in surface-local coordinates. The
* compositor will display the surface centered with respect to its
* anchors.
*
* If you pass 0 for either value, the compositor will assign it and
* inform you of the assignment in the configure event. You must set your
* anchor to opposite edges in the dimensions you omit; not doing so is a
* protocol error. Both values are 0 by default.
*
* Size is double-buffered, see wl_surface.commit.
*/
static inline void zwlr_layer_surface_v1_set_size(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1, uint32_t width,
uint32_t height) {
wl_proxy_marshal_flags(
(struct wl_proxy *)zwlr_layer_surface_v1, ZWLR_LAYER_SURFACE_V1_SET_SIZE,
NULL, wl_proxy_get_version((struct wl_proxy *)zwlr_layer_surface_v1), 0,
width, height);
}
/**
* @ingroup iface_zwlr_layer_surface_v1
*
* Requests that the compositor anchor the surface to the specified edges
* and corners. If two orthogonal edges are specified (e.g. 'top' and
* 'left'), then the anchor point will be the intersection of the edges
* (e.g. the top left corner of the output); otherwise the anchor point
* will be centered on that edge, or in the center if none is specified.
*
* Anchor is double-buffered, see wl_surface.commit.
*/
static inline void zwlr_layer_surface_v1_set_anchor(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1, uint32_t anchor) {
wl_proxy_marshal_flags(
(struct wl_proxy *)zwlr_layer_surface_v1,
ZWLR_LAYER_SURFACE_V1_SET_ANCHOR, NULL,
wl_proxy_get_version((struct wl_proxy *)zwlr_layer_surface_v1), 0,
anchor);
}
/**
* @ingroup iface_zwlr_layer_surface_v1
*
* Requests that the compositor avoids occluding an area with other
* surfaces. The compositor's use of this information is
* implementation-dependent - do not assume that this region will not
* actually be occluded.
*
* A positive value is only meaningful if the surface is anchored to one
* edge or an edge and both perpendicular edges. If the surface is not
* anchored, anchored to only two perpendicular edges (a corner), anchored
* to only two parallel edges or anchored to all edges, a positive value
* will be treated the same as zero.
*
* A positive zone is the distance from the edge in surface-local
* coordinates to consider exclusive.
*
* Surfaces that do not wish to have an exclusive zone may instead specify
* how they should interact with surfaces that do. If set to zero, the
* surface indicates that it would like to be moved to avoid occluding
* surfaces with a positive exclusive zone. If set to -1, the surface
* indicates that it would not like to be moved to accommodate for other
* surfaces, and the compositor should extend it all the way to the edges
* it is anchored to.
*
* For example, a panel might set its exclusive zone to 10, so that
* maximized shell surfaces are not shown on top of it. A notification
* might set its exclusive zone to 0, so that it is moved to avoid
* occluding the panel, but shell surfaces are shown underneath it. A
* wallpaper or lock screen might set their exclusive zone to -1, so that
* they stretch below or over the panel.
*
* The default value is 0.
*
* Exclusive zone is double-buffered, see wl_surface.commit.
*/
static inline void zwlr_layer_surface_v1_set_exclusive_zone(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1, int32_t zone) {
wl_proxy_marshal_flags(
(struct wl_proxy *)zwlr_layer_surface_v1,
ZWLR_LAYER_SURFACE_V1_SET_EXCLUSIVE_ZONE, NULL,
wl_proxy_get_version((struct wl_proxy *)zwlr_layer_surface_v1), 0, zone);
}
/**
* @ingroup iface_zwlr_layer_surface_v1
*
* Requests that the surface be placed some distance away from the anchor
* point on the output, in surface-local coordinates. Setting this value
* for edges you are not anchored to has no effect.
*
* The exclusive zone includes the margin.
*
* Margin is double-buffered, see wl_surface.commit.
*/
static inline void zwlr_layer_surface_v1_set_margin(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1, int32_t top,
int32_t right, int32_t bottom, int32_t left) {
wl_proxy_marshal_flags(
(struct wl_proxy *)zwlr_layer_surface_v1,
ZWLR_LAYER_SURFACE_V1_SET_MARGIN, NULL,
wl_proxy_get_version((struct wl_proxy *)zwlr_layer_surface_v1), 0, top,
right, bottom, left);
}
/**
* @ingroup iface_zwlr_layer_surface_v1
*
* Set how keyboard events are delivered to this surface. By default,
* layer shell surfaces do not receive keyboard events; this request can
* be used to change this.
*
* This setting is inherited by child surfaces set by the get_popup
* request.
*
* Layer surfaces receive pointer, touch, and tablet events normally. If
* you do not want to receive them, set the input region on your surface
* to an empty region.
*
* Keyboard interactivity is double-buffered, see wl_surface.commit.
*/
static inline void zwlr_layer_surface_v1_set_keyboard_interactivity(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1,
uint32_t keyboard_interactivity) {
wl_proxy_marshal_flags(
(struct wl_proxy *)zwlr_layer_surface_v1,
ZWLR_LAYER_SURFACE_V1_SET_KEYBOARD_INTERACTIVITY, NULL,
wl_proxy_get_version((struct wl_proxy *)zwlr_layer_surface_v1), 0,
keyboard_interactivity);
}
/**
* @ingroup iface_zwlr_layer_surface_v1
*
* This assigns an xdg_popup's parent to this layer_surface. This popup
* should have been created via xdg_surface::get_popup with the parent set
* to NULL, and this request must be invoked before committing the popup's
* initial state.
*
* See the documentation of xdg_popup for more details about what an
* xdg_popup is and how it is used.
*/
static inline void zwlr_layer_surface_v1_get_popup(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1,
struct xdg_popup *popup) {
wl_proxy_marshal_flags(
(struct wl_proxy *)zwlr_layer_surface_v1, ZWLR_LAYER_SURFACE_V1_GET_POPUP,
NULL, wl_proxy_get_version((struct wl_proxy *)zwlr_layer_surface_v1), 0,
popup);
}
/**
* @ingroup iface_zwlr_layer_surface_v1
*
* When a configure event is received, if a client commits the
* surface in response to the configure event, then the client
* must make an ack_configure request sometime before the commit
* request, passing along the serial of the configure event.
*
* If the client receives multiple configure events before it
* can respond to one, it only has to ack the last configure event.
*
* A client is not required to commit immediately after sending
* an ack_configure request - it may even ack_configure several times
* before its next surface commit.
*
* A client may send multiple ack_configure requests before committing, but
* only the last request sent before a commit indicates which configure
* event the client really is responding to.
*/
static inline void zwlr_layer_surface_v1_ack_configure(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1, uint32_t serial) {
wl_proxy_marshal_flags(
(struct wl_proxy *)zwlr_layer_surface_v1,
ZWLR_LAYER_SURFACE_V1_ACK_CONFIGURE, NULL,
wl_proxy_get_version((struct wl_proxy *)zwlr_layer_surface_v1), 0,
serial);
}
/**
* @ingroup iface_zwlr_layer_surface_v1
*
* This request destroys the layer surface.
*/
static inline void zwlr_layer_surface_v1_destroy(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1) {
wl_proxy_marshal_flags(
(struct wl_proxy *)zwlr_layer_surface_v1, ZWLR_LAYER_SURFACE_V1_DESTROY,
NULL, wl_proxy_get_version((struct wl_proxy *)zwlr_layer_surface_v1),
WL_MARSHAL_FLAG_DESTROY);
}
/**
* @ingroup iface_zwlr_layer_surface_v1
*
* Change the layer that the surface is rendered on.
*
* Layer is double-buffered, see wl_surface.commit.
*/
static inline void zwlr_layer_surface_v1_set_layer(
struct zwlr_layer_surface_v1 *zwlr_layer_surface_v1, uint32_t layer) {
wl_proxy_marshal_flags(
(struct wl_proxy *)zwlr_layer_surface_v1, ZWLR_LAYER_SURFACE_V1_SET_LAYER,
NULL, wl_proxy_get_version((struct wl_proxy *)zwlr_layer_surface_v1), 0,
layer);
}
#ifdef __cplusplus
}
#endif
#endif