mirror of
https://gitlab.freedesktop.org/emersion/libliftoff.git
synced 2024-12-27 21:59:24 +01:00
ceb4a1ff9e
Compositors need to drive multiple connectors, each with its own vblank timings. For each device, there's one separate rendering loop per output. It's not possible to call liftoff_device_apply each time we want to submit a new frame to one output, because this could touch another's output state, submitting a new frame there in the process. When the other output will submit a new frame, it'll get EBUSY (can't submit two frames without waiting for vblank). Closes: https://github.com/emersion/libliftoff/issues/21
72 lines
2.3 KiB
C
72 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_device;
|
|
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_device *liftoff_device_create(int drm_fd);
|
|
void liftoff_device_destroy(struct liftoff_device *device);
|
|
/**
|
|
* 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_output_apply(struct liftoff_output *output, drmModeAtomicReq *req);
|
|
|
|
/**
|
|
* Make the device manage a CRTC's planes. The returned output allows callers
|
|
* to attach layers.
|
|
*/
|
|
struct liftoff_output *liftoff_output_create(struct liftoff_device *device,
|
|
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
|