ext-image-capture-source-v1: add base interface

include/wlr/interfaces/wlr_ext_image_capture_source_v1.h

@@ -0,0 +1,30 @@
+/*
+ * This an unstable interface of wlroots. No guarantees are made regarding the
+ * future consistency of this API.
+ */
+#ifndef WLR_USE_UNSTABLE
+#error "Add -DWLR_USE_UNSTABLE to enable unstable wlroots features"
+#endif
+
+#ifndef WLR_INTERFACES_WLR_EXT_IMAGE_CAPTURE_SOURCE_V1_H
+#define WLR_INTERFACES_WLR_EXT_IMAGE_CAPTURE_SOURCE_V1_H
+
+#include <wayland-server-core.h>
+#include <wlr/types/wlr_ext_image_capture_source_v1.h>
+
+struct wlr_ext_image_copy_capture_frame_v1;
+
+struct wlr_ext_image_capture_source_v1_interface {
+	void (*schedule_frame)(struct wlr_ext_image_capture_source_v1 *source);
+	void (*copy_frame)(struct wlr_ext_image_capture_source_v1 *source,
+		struct wlr_ext_image_copy_capture_frame_v1 *dst_frame,
+		struct wlr_ext_image_capture_source_v1_frame_event *frame_event);
+};
+
+void wlr_ext_image_capture_source_v1_init(struct wlr_ext_image_capture_source_v1 *source,
+		const struct wlr_ext_image_capture_source_v1_interface *impl);
+void wlr_ext_image_capture_source_v1_finish(struct wlr_ext_image_capture_source_v1 *source);
+bool wlr_ext_image_capture_source_v1_create_resource(struct wlr_ext_image_capture_source_v1 *source,
+	struct wl_client *client, uint32_t new_id);
+
+#endif

include/wlr/types/wlr_ext_image_capture_source_v1.h

@@ -0,0 +1,60 @@
+/*
+ * This an unstable interface of wlroots. No guarantees are made regarding the
+ * future consistency of this API.
+ */
+#ifndef WLR_USE_UNSTABLE
+#error "Add -DWLR_USE_UNSTABLE to enable unstable wlroots features"
+#endif
+
+#ifndef WLR_TYPES_WLR_EXT_IMAGE_CAPTURE_SOURCE_V1_H
+#define WLR_TYPES_WLR_EXT_IMAGE_CAPTURE_SOURCE_V1_H
+
+#include <pixman.h>
+#include <wayland-server-core.h>
+#include <wlr/render/drm_format_set.h>
+
+/**
+ * A screen capture source.
+ *
+ * When the size, device or formats change, the constraints_update event is
+ * emitted.
+ *
+ * The device and formats advertised are suitable for copying into a
+ * struct wlr_buffer.
+ */
+struct wlr_ext_image_capture_source_v1 {
+	const struct wlr_ext_image_capture_source_v1_interface *impl;
+	struct wl_list resources; // wl_resource_get_link()
+
+	uint32_t width, height;
+
+	uint32_t *shm_formats;
+	size_t shm_formats_len;
+
+	dev_t dmabuf_device;
+	struct wlr_drm_format_set dmabuf_formats;
+
+	struct {
+		struct wl_signal constraints_update;
+		struct wl_signal frame; // struct wlr_ext_image_capture_source_v1_frame_event
+		struct wl_signal destroy;
+	} events;
+};
+
+/**
+ * Event indicating that the source has produced a new frame.
+ */
+struct wlr_ext_image_capture_source_v1_frame_event {
+	const pixman_region32_t *damage;
+};
+
+/**
+ * Obtain a struct wlr_ext_image_capture_source_v1 from an ext_image_capture_source_v1
+ * resource.
+ *
+ * Asserts that the resource has the correct type. Returns NULL if the resource
+ * is inert.
+ */
+struct wlr_ext_image_capture_source_v1 *wlr_ext_image_capture_source_v1_from_resource(struct wl_resource *resource);
+
+#endif