output: add wlr_output_is_direct_scanout_allowed()

This lets compositors check whether direct scan-out is possible.
Compositors will soon be responsible for manually calling this
function.

1 files changed, 7 insertions, 0 deletions

diff --git a/include/wlr/types/wlr_output.h b/include/wlr/types/wlr_output.h
index bd379444..767418bd 100644
--- a/include/wlr/types/wlr_output.h
+++ b/include/wlr/types/wlr_output.h
@@ -525,6 +525,13 @@ void wlr_output_render_software_cursors(struct wlr_output *output,
  */
 const struct wlr_drm_format_set *wlr_output_get_primary_formats(
 	struct wlr_output *output, uint32_t buffer_caps);
+/**
+ * Check whether direct scan-out is allowed on the output.
+ *
+ * Direct scan-out is typically disallowed when there are software cursors or
+ * during screen capture.
+ */
+bool wlr_output_is_direct_scanout_allowed(struct wlr_output *output);
 
 
 struct wlr_output_cursor *wlr_output_cursor_create(struct wlr_output *output);