wlroots/include/wlr/backend/libinput.h

/*
 * This an unstable interface of wlroots. No guarantees are made regarding the
 * future consistency of this API.
 */
#ifndef WLR_USE_UNSTABLE
#error "Add -DWLR_USE_UNSTABLE to enable unstable wlroots features"
#endif

#ifndef WLR_BACKEND_LIBINPUT_H
#define WLR_BACKEND_LIBINPUT_H

#include <libinput.h>
#include <wayland-server-core.h>
#include <wlr/backend.h>
#include <wlr/backend/session.h>

struct wlr_input_device;

struct wlr_backend *wlr_libinput_backend_create(struct wl_display *display,
		struct wlr_session *session);
/**
 * Gets the underlying struct libinput_device handle for the given input device.
 */
struct libinput_device *wlr_libinput_get_device_handle(
		struct wlr_input_device *dev);

bool wlr_backend_is_libinput(struct wlr_backend *backend);
bool wlr_input_device_is_libinput(struct wlr_input_device *device);

#endif
Initial pass on API stability guarantees This introduces -DWLR_USE_UNSTABLE and adds information regarding the stability status to all headers. I started with a conservative set of headers to mark as stable: - types/wlr_matrix.h - util/edges.h - util/log.h - util/region.h - xcursor.h 2018-07-13 08:40:56 -04:00			`/*`
			`* This an unstable interface of wlroots. No guarantees are made regarding the`
			`* future consistency of this API.`
			`*/`
			`#ifndef WLR_USE_UNSTABLE`
			`#error "Add -DWLR_USE_UNSTABLE to enable unstable wlroots features"`
			`#endif`

Add error handling and init in backend_autocreate 2017-06-09 11:38:38 -04:00			`#ifndef WLR_BACKEND_LIBINPUT_H`
			`#define WLR_BACKEND_LIBINPUT_H`

Reassign ownership of libinput handle 2017-06-10 12:21:54 -04:00			`#include <libinput.h>`
Remove all wayland-server.h includes The documentation for wayland-server.h says: > Use of this header file is discouraged. Prefer including > wayland-server-core.h instead, which does not include the server protocol > header and as such only defines the library PI, excluding the deprecated API > below. Replacing wayland-server.h with wayland-server-core.h allows us to drop the WL_HIDE_DEPRECATED declaration. 2019-07-27 11:53:54 +03:00			`#include <wayland-server-core.h>`
Add error handling and init in backend_autocreate 2017-06-09 11:38:38 -04:00			`#include <wlr/backend.h>`
Reformat all #include directives 2018-02-12 21:29:23 +01:00			`#include <wlr/backend/session.h>`
types/wlr_input_device: move init and finish function to private API 2022-03-03 09:43:38 -05:00
			`struct wlr_input_device;`
Add error handling and init in backend_autocreate 2017-06-09 11:38:38 -04:00
			`struct wlr_backend wlr_libinput_backend_create(struct wl_display display,`
Merge wlr_udev into wlr_session 2017-08-26 14:02:04 +12:00			`struct wlr_session *session);`
Reformat doc comments Unify the way we document our APIs. See CONTRIBUTING.md for the rules. 2022-05-24 18:46:59 +02:00			`/**`
			`* Gets the underlying struct libinput_device handle for the given input device.`
			`*/`
Write some more docs 2018-03-19 15:46:28 -04:00			`struct libinput_device *wlr_libinput_get_device_handle(`
			`struct wlr_input_device *dev);`
Add error handling and init in backend_autocreate 2017-06-09 11:38:38 -04:00
Add backend detection functions Resolves #80 2017-08-13 23:05:57 +02:00			`bool wlr_backend_is_libinput(struct wlr_backend *backend);`
libinput backend: add wlr_input_device_is_libinput 2017-12-19 19:46:30 +01:00			`bool wlr_input_device_is_libinput(struct wlr_input_device *device);`
Add backend detection functions Resolves #80 2017-08-13 23:05:57 +02:00
Add error handling and init in backend_autocreate 2017-06-09 11:38:38 -04:00			`#endif`