wlseeds/include/wlr/backend/headless.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_HEADLESS_H
#define WLR_BACKEND_HEADLESS_H

#include <wlr/backend.h>
#include <wlr/types/wlr_output.h>

/**
 * Creates a headless backend. A headless backend has no outputs or inputs by
 * default.
 */
struct wlr_backend *wlr_headless_backend_create(struct wl_display *display);
/**
 * Create a new headless output backed by an in-memory EGL framebuffer. You can
 * read pixels from this framebuffer via wlr_renderer_read_pixels but it is
 * otherwise not displayed.
 */
struct wlr_output *wlr_headless_add_output(struct wlr_backend *backend,
	unsigned int width, unsigned int height);

bool wlr_backend_is_headless(struct wlr_backend *backend);
bool wlr_output_is_headless(struct wlr_output *output);

#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`

Initialize headless backend 7 years ago			`#ifndef WLR_BACKEND_HEADLESS_H`
			`#define WLR_BACKEND_HEADLESS_H`

			`#include <wlr/backend.h>`
headless backend: add wlr_output_is_headless 7 years ago			`#include <wlr/types/wlr_output.h>`
Initialize headless backend 7 years ago
Write some more docs 7 years ago			`/**`
			`* Creates a headless backend. A headless backend has no outputs or inputs by`
			`* default.`
			`*/`
Remove wlr_create_renderer_func_t This callback allowed compositors to customize the EGL config used by the renderer. However with renderer v6 EGL configs aren't used anymore. Instead, buffers are allocated via GBM and GL FBOs are rendered to. So customizing the EGL config is a no-op. 4 years ago			`struct wlr_backend wlr_headless_backend_create(struct wl_display display);`
Write some more docs 7 years ago			`/**`
			`* Create a new headless output backed by an in-memory EGL framebuffer. You can`
			`* read pixels from this framebuffer via wlr_renderer_read_pixels but it is`
			`* otherwise not displayed.`
			`*/`
Initialize headless backend 7 years ago			`struct wlr_output wlr_headless_add_output(struct wlr_backend backend,`
			`unsigned int width, unsigned int height);`
backend/headless: remove unused wlr_headless_input_device 3 years ago
Add full refresh rate support to custom modes 7 years ago			`bool wlr_backend_is_headless(struct wlr_backend *backend);`
headless backend: add wlr_output_is_headless 7 years ago			`bool wlr_output_is_headless(struct wlr_output *output);`
Initialize headless backend 7 years ago
			`#endif`