mirror of
https://gitlab.freedesktop.org/emersion/libliftoff.git
synced 2024-12-25 21:59:11 +01:00
e9433997d9
This lets the library user define a layer where composition will happen. At the moment there can be at most one composition layer per output, on the primary plane. It should be possible to remove these restrictions in the future if desirable. The composition layer will be put on a plane if and only if composition is needed. The compositor needs to know where composited layers will be blended to resolve zpos conflicts. Closes: https://github.com/emersion/libliftoff/issues/9
73 lines
2.3 KiB
C
73 lines
2.3 KiB
C
#ifndef LIFTOFF_H
|
|
#define LIFTOFF_H
|
|
|
|
#include <stdarg.h>
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
#include <xf86drmMode.h>
|
|
|
|
struct liftoff_display;
|
|
struct liftoff_output;
|
|
struct liftoff_layer;
|
|
|
|
/**
|
|
* Initialize libliftoff for a DRM node. The node is expected to have
|
|
* DRM_CLIENT_CAP_UNIVERSAL_PLANES and DRM_CLIENT_CAP_ATOMIC enabled.
|
|
*/
|
|
struct liftoff_display *liftoff_display_create(int drm_fd);
|
|
void liftoff_display_destroy(struct liftoff_display *display);
|
|
/**
|
|
* Build a layer to plane mapping and append the plane configuration to `req`.
|
|
* Callers are expected to commit `req` afterwards and can read the layer to
|
|
* plane mapping with `liftoff_layer_get_plane_id`.
|
|
*/
|
|
bool liftoff_display_apply(struct liftoff_display *display,
|
|
drmModeAtomicReq *req);
|
|
|
|
/**
|
|
* Make the display manage a CRTC's planes. The returned output allows callers
|
|
* to attach layers.
|
|
*/
|
|
struct liftoff_output *liftoff_output_create(struct liftoff_display *display,
|
|
uint32_t crtc_id);
|
|
void liftoff_output_destroy(struct liftoff_output *output);
|
|
/**
|
|
* Indicate on which layer composition can take place. Users should be able to
|
|
* blend layers that haven't been mapped to a plane to this layer. The
|
|
* composition layer won't be used if all other layers have been mapped to a
|
|
* plane. There is at most one composition layer per output.
|
|
*/
|
|
void liftoff_output_set_composition_layer(struct liftoff_output *output,
|
|
struct liftoff_layer *layer);
|
|
|
|
/**
|
|
* Create a new layer on an output.
|
|
*/
|
|
struct liftoff_layer *liftoff_layer_create(struct liftoff_output *output);
|
|
void liftoff_layer_destroy(struct liftoff_layer *layer);
|
|
/**
|
|
* Set a property on the layer. Any plane property can be set. If none of the
|
|
* planes support the property, the layer won't be mapped to any plane.
|
|
*/
|
|
void liftoff_layer_set_property(struct liftoff_layer *layer, const char *name,
|
|
uint64_t value);
|
|
/**
|
|
* Retrieve the plane mapped to this layer. Zero is returned if no plane is
|
|
* mapped.
|
|
*/
|
|
uint32_t liftoff_layer_get_plane_id(struct liftoff_layer *layer);
|
|
|
|
enum liftoff_log_importance {
|
|
LIFTOFF_SILENT,
|
|
LIFTOFF_DEBUG,
|
|
LIFTOFF_ERROR,
|
|
};
|
|
|
|
typedef void (*liftoff_log_func)(enum liftoff_log_importance importance,
|
|
const char *fmt, va_list args);
|
|
|
|
void liftoff_log_init(enum liftoff_log_importance verbosity,
|
|
liftoff_log_func callback);
|
|
|
|
#endif
|