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);
};

/**
 * 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);`
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`