blankie
/
wlroots
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
wlroots/include/wlr/backend/interface.h

37 lines
1.0 KiB
C
Raw Permalink Normal View History

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_BACKEND_INTERFACE_H
#define WLR_BACKEND_INTERFACE_H
Refactor backend state management
2017-05-07 14:00:23 +00:00
#include <stdbool.h>
backend: add get_present_clock
2018-10-01 20:44:33 +00:00
#include <time.h>
Refactor backend state management
2017-05-07 14:00:23 +00:00
#include <wlr/backend.h>
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.
2017-08-13 13:59:14 +00:00
bool (*start)(struct wlr_backend *backend);
Refactor out wlr_backend_state from wl/multi
2017-08-12 15:43:36 +00:00
void (*destroy)(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).
2018-09-24 21:17:08 +00:00
struct wlr_session *(*get_session)(struct wlr_backend *backend);
Rename get_present_clock to get_presentation clock, use it
2018-10-01 20:57:36 +00:00
clockid_t (*get_presentation_clock)(struct wlr_backend *backend);
backend: add get_drm_fd to interface This function allows backends to return the DRM FD they are using. This will allow the allocator and the renderer to use the right device.
2020-12-01 15:00:12 +00:00
int (*get_drm_fd)(struct wlr_backend *backend);
backend: introduce backend_get_buffer_caps
2021-04-28 14:09:33 +00:00
uint32_t (*get_buffer_caps)(struct wlr_backend *backend);
Refactor backend state management
2017-05-07 14:00:23 +00:00
};
Write some more docs
2018-03-19 19:46:28 +00:00
/**
* 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.
2017-08-13 13:59:14 +00:00
void wlr_backend_init(struct wlr_backend *backend,
Refactor out wlr_backend_state from wl/multi
2017-08-12 15:43:36 +00:00
const struct wlr_backend_impl *impl);
backend: introduce wlr_backend_finish This new functions cleans up the common backend state. While this currently only emits the destroy signal, this will also clean up the renderer and allocator in upcoming patches.
2021-04-28 22:07:31 +00:00
/**
* Emit the destroy event and clean up common backend state.
*/
void wlr_backend_finish(struct wlr_backend *backend);
Refactor backend state management
2017-05-07 14:00:23 +00:00
#endif