mirror of
https://gitlab.freedesktop.org/emersion/libliftoff.git
synced 2024-12-25 21:59:11 +01:00
780c5b457c
Logigng the list of planes being disabled at the beginning of an apply does not really give useful information. Planes are disabled (and by that become in theory ready for layer-assignment) if they do not have a layer associated at the moment or if they are compatible with the output. That is uninteresting since in this list the subset of planes that are compatible with the output stay constant. And while the subset of planes being reset not compatible with the output might vary from apply to apply it is also of less interest since by definition they are not compatible with what the apply is about. |
||
|---|---|---|
| example | ||
| include | ||
| test | ||
| .build.yml | ||
| .editorconfig | ||
| .gitignore | ||
| alloc.c | ||
| device.c | ||
| layer.c | ||
| LICENSE | ||
| list.c | ||
| log.c | ||
| meson.build | ||
| output.c | ||
| plane.c | ||
| README.md | ||
libliftoff
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_device *device;
struct liftoff_output *output;
struct liftoff_layer *layer;
drmModeAtomicReq *req;
int ret;
device = liftoff_device_create(drm_fd);
output = liftoff_output_create(device, 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_output_apply(output, req)) {
perror("liftoff_output_apply");
exit(1);
}
ret = drmModeAtomicCommit(drm_fd, req, DRM_MODE_ATOMIC_NONBLOCK, NULL);
if (ret < 0) {
perror("drmModeAtomicCommit");
exit(1);
}
drmModeAtomicFree(req);
Contributing
Report bugs and send pull requests on GitHub.
We use the Wayland/Weston style and contribution guidelines, see Weston's contributing document.
License
MIT