wlseeds/include/wlr/backend/interface.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_INTERFACE_H
#define WLR_BACKEND_INTERFACE_H

#include <stdbool.h>
#include <wlr/backend.h>
#include <wlr/render/egl.h>

struct wlr_backend_impl {
	bool (*start)(struct wlr_backend *backend);
	void (*destroy)(struct wlr_backend *backend);
	struct wlr_renderer *(*get_renderer)(struct wlr_backend *backend);
	struct wlr_session *(*get_session)(struct wlr_backend *backend);
};

/**
 * Initializes common state on a wlr_backend and sets the implementation to the
 * provided wlr_backend_impl reference.
 */
void wlr_backend_init(struct wlr_backend *backend,
		const struct wlr_backend_impl *impl);

#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 6 years ago			`/*`
			`* 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 7 years ago			`#ifndef WLR_BACKEND_INTERFACE_H`
			`#define WLR_BACKEND_INTERFACE_H`
Refactor backend state management 8 years ago
			`#include <stdbool.h>`
			`#include <wlr/backend.h>`
Move egl.h to render/egl.h 7 years ago			`#include <wlr/render/egl.h>`
Refactor backend state management 8 years ago
			`struct wlr_backend_impl {`
wlr_backend_init -> wlr_backend_start Also renames create to init. We'll use create for anything that allocates and init for anything that takes a pointer and initializes it. 7 years ago			`bool (start)(struct wlr_backend backend);`
Refactor out wlr_backend_state from wl/multi 7 years ago			`void (destroy)(struct wlr_backend backend);`
Backport screenshooter fixes from the renderer redesign v1 This backports some changes to #319 to fix the screenshooter data format. This also adds wlr_backend_get_renderer which will be useful to support multiple renderers. 7 years ago			`struct wlr_renderer (get_renderer)(struct wlr_backend *backend);`
Rework session handling Sessions can now be retrieved from a backend in a more general manner. Multi-backend gets back its `session` field that contains the session if one was created, removing the interfacing from multi backend with the drm backend directly. This adds the possibility to use sessions even without the drm backend. It additionally fixes the bug that 2 session objects got created when WLR_BACKENDS were set to "libinput,drm". To allow vt switching without drm backend (and drm fd) on logind, start listening to PropertiesChanged signals from dbus and parse the session "Active" property when no master fd was created (this does not change current drm backend behaviour in any way). 6 years ago			`struct wlr_session (get_session)(struct wlr_backend *backend);`
Refactor backend state management 8 years ago			`};`

Write some more docs 7 years ago			`/**`
			`* Initializes common state on a wlr_backend and sets the implementation to the`
			`* provided wlr_backend_impl reference.`
			`*/`
wlr_backend_init -> wlr_backend_start Also renames create to init. We'll use create for anything that allocates and init for anything that takes a pointer and initializes it. 7 years ago			`void wlr_backend_init(struct wlr_backend *backend,`
Refactor out wlr_backend_state from wl/multi 7 years ago			`const struct wlr_backend_impl *impl);`
Refactor backend state management 8 years ago
			`#endif`