mirror of
https://gitlab.freedesktop.org/emersion/libliftoff.git
synced 2024-11-16 19:47:55 +01:00
8d45eeae7f
If we've found a good previous allocation, it's possible that there is no point trying to continue exploring the graph. In particular, if we won't get a higher score even if we manage to make use of all available planes, we can stop right away. For instance, let's say that we've previously found a way to make use of 3 out of 5 planes. We're exploring a different path where we've populated 1 plane, we've skipped 1 plane because we couldn't find a suitable layer for it, and out of the 3 remaining planes only 2 are compatible with the CRTC we're interested in. Even if we manage to make use of these 2 extra planes we would end up with 3 effectively used planes thus no benefit over the previous solution. |
||
|---|---|---|
| .builds | ||
| doc | ||
| example | ||
| include | ||
| test | ||
| .editorconfig | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| alloc.c | ||
| device.c | ||
| gcovr.cfg | ||
| layer.c | ||
| LICENSE | ||
| list.c | ||
| log.c | ||
| meson.build | ||
| output.c | ||
| plane.c | ||
| README.md | ||
libliftoff
Lightweight KMS plane library.
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 pick hardware planes for these layers if possible.
Resources:
libliftoff is used in production by gamescope on Steam Deck devices, and work is underway to integrate it with wlroots.
Building
Depends on libdrm. Requires universal planes and atomic.
meson setup build/
ninja -C build/
Usage
See liftoff.h and the example/ directory. See
doc/compositor.md for compositor guidelines.
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);
liftoff_device_register_all_planes(device);
layer = liftoff_layer_create(output);
liftoff_layer_set_property(layer, "FB_ID", fb_id);
/* Probably setup more properties and more layers */
req = drmModeAtomicAlloc();
ret = liftoff_output_apply(output, req);
if (ret < 0) {
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 GitLab.
We use the Wayland/Weston style and contribution guidelines, see Weston's contributing document.
License
MIT