libliftoff/include/libliftoff.h

#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