wlroots/include/wlr/interfaces/wlr_touch.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_INTERFACES_WLR_TOUCH_H
#define WLR_INTERFACES_WLR_TOUCH_H

#include <wlr/types/wlr_touch.h>

struct wlr_touch_impl {
	const char *name;
};

void wlr_touch_init(struct wlr_touch *touch,
	const struct wlr_touch_impl *impl, const char *name);
void wlr_touch_finish(struct wlr_touch *touch);

#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 12:40:56 +00: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`

Use more consistent include guard names 2017-09-23 08:26:01 +00:00			`#ifndef WLR_INTERFACES_WLR_TOUCH_H`
			`#define WLR_INTERFACES_WLR_TOUCH_H`

Split out types.h and wlr/types.h TODO: Update the code accordingly and move other types into the same paradigm 2017-06-19 22:41:02 +00:00			`#include <wlr/types/wlr_touch.h>`

			`struct wlr_touch_impl {`
interface/wlr_touch: rework destroy sequence The destroy callback in wlr_touch_impl has been removed. The function `wlr_touch_finish` has been introduced to clean up the resources owned by a wlr_touch. `wlr_input_device_destroy` no longer destroys the wlr_touch, attempting to destroy a wlr_touch will result in a no-op. The field `name` has been added to the wlr_touch_impl to be able to identify a given wlr_touch device. 2022-03-02 21:07:40 +00:00			`const char *name;`
Split out types.h and wlr/types.h TODO: Update the code accordingly and move other types into the same paradigm 2017-06-19 22:41:02 +00:00			`};`

Refactor out wlr_touch_state 2017-08-14 14:07:00 +00:00			`void wlr_touch_init(struct wlr_touch *touch,`
types/wlr_touch: add base wlr_input_device wlr_touch now owns its wlr_input_device. It will be initialized when the tablet tool is initialized, and finished when the touch is destroyed. 2022-02-01 16:51:50 +00:00			`const struct wlr_touch_impl impl, const char name);`
interface/wlr_touch: rework destroy sequence The destroy callback in wlr_touch_impl has been removed. The function `wlr_touch_finish` has been introduced to clean up the resources owned by a wlr_touch. `wlr_input_device_destroy` no longer destroys the wlr_touch, attempting to destroy a wlr_touch will result in a no-op. The field `name` has been added to the wlr_touch_impl to be able to identify a given wlr_touch device. 2022-03-02 21:07:40 +00:00			`void wlr_touch_finish(struct wlr_touch *touch);`
Split out types.h and wlr/types.h TODO: Update the code accordingly and move other types into the same paradigm 2017-06-19 22:41:02 +00:00
			`#endif`