Skip to content
Lightweight hardware composer library for libdrm
C Meson
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
example
include
test
.build.yml
.editorconfig
.gitignore
LICENSE
README.md
alloc.c
display.c
layer.c
list.c
log.c
meson.build
output.c
plane.c

README.md

libliftoff

builds.sr.ht status

Lightweight hardware composer library for libdrm.

libliftoff eases the use of KMS planes from userspace without standing in your way. Users create "virtual planes" called layers, set KMS properties on them, and libliftoff will allocate planes for these layers if possible.

See the blog post introducing the project for more context.

Building

Depends on libdrm. Requires universal planes and atomic.

meson build/
ninja -C build/

Usage

See liftoff.h. Here's the general idea:

struct liftoff_display *display;
struct liftoff_output *output;
struct liftoff_layer *layer;
drmModeAtomicReq *req;
int ret;

display = liftoff_display_create(drm_fd);
output = liftoff_output_create(display, crtc_id);

layer = liftoff_layer_create(output);
liftoff_layer_set_property(layer, "FB_ID", fb_id);
/* Probably setup more properties and more layers */

req = drmModeAtomicAlloc();
if (!liftoff_display_apply(display, req)) {
	perror("liftoff_display_apply");
	exit(1);
}

ret = drmModeAtomicCommit(drm_fd, req, DRM_MODE_ATOMIC_NONBLOCK, NULL);
if (ret < 0) {
	perror("drmModeAtomicCommit");
	exit(1);
}
drmModeAtomicFree(req);

License

MIT

You can’t perform that action at this time.