From: John Lindgren <john@jlindgren.net>
Date: Thu, 29 May 2025 16:31:41 +0000 (-0400)
Subject: common/graphic-helpers: add a few cairo pattern helpers
X-Git-Url: https://git.mdlowis.com/?a=commitdiff_plain;h=3ca7adace0b770c03cb5103eebf0458bb0b0dc05;p=proto%2Flabwc.git

common/graphic-helpers: add a few cairo pattern helpers
---

diff --git a/include/common/graphic-helpers.h b/include/common/graphic-helpers.h
index 1b751b25..3fdde6ad 100644
--- a/include/common/graphic-helpers.h
+++ b/include/common/graphic-helpers.h
@@ -12,6 +12,19 @@ struct wlr_fbox;
  */
 void set_cairo_color(cairo_t *cairo, const float *color);
 
+/* Creates a solid color cairo pattern from premultipled RGBA */
+cairo_pattern_t *color_to_pattern(const float *color);
+
+bool is_pattern_opaque(cairo_pattern_t *pattern);
+
+/* Like zfree() but for a cairo_pattern_t */
+#define zfree_pattern(ptr) do { \
+	if (ptr) { \
+		cairo_pattern_destroy(ptr); \
+		(ptr) = NULL; \
+	} \
+} while (0)
+
 /* Draws a border with a specified line width */
 void draw_cairo_border(cairo_t *cairo, struct wlr_fbox fbox, double line_width);
 
diff --git a/src/common/graphic-helpers.c b/src/common/graphic-helpers.c
index 08817cb5..7a8af89a 100644
--- a/src/common/graphic-helpers.c
+++ b/src/common/graphic-helpers.c
@@ -44,6 +44,54 @@ set_cairo_color(cairo_t *cairo, const float *c)
 		c[2] / alpha, alpha);
 }
 
+cairo_pattern_t *
+color_to_pattern(const float *c)
+{
+	float alpha = c[3];
+
+	if (alpha == 0.0f) {
+		return cairo_pattern_create_rgba(0, 0, 0, 0);
+	}
+
+	return cairo_pattern_create_rgba(
+		c[0] / alpha, c[1] / alpha, c[2] / alpha, alpha);
+}
+
+/*
+ * This is used as an optimization in font rendering and errs on the
+ * side of returning false (not opaque) for unknown pattern types.
+ *
+ * The 0.999 alpha threshold was chosen to be greater than 254/255
+ * (about 0.996) while leaving some margin for rounding errors.
+ */
+bool
+is_pattern_opaque(cairo_pattern_t *pattern)
+{
+	double alpha = 0;
+	int stops = 0;
+
+	/* solid color? */
+	if (cairo_pattern_get_rgba(pattern, NULL, NULL, NULL, &alpha)
+			== CAIRO_STATUS_SUCCESS) {
+		return (alpha >= 0.999);
+	}
+
+	/* gradient? */
+	if (cairo_pattern_get_color_stop_count(pattern, &stops)
+			== CAIRO_STATUS_SUCCESS) {
+		for (int s = 0; s < stops; s++) {
+			cairo_pattern_get_color_stop_rgba(pattern, s,
+				NULL, NULL, NULL, NULL, &alpha);
+			if (alpha < 0.999) {
+				return false;
+			}
+		}
+		return true;
+	}
+
+	return false; /* unknown pattern type */
+}
+
 static int
 compare_xcolor_entry(const void *a, const void *b)
 {