Color management architecture: color profiles

This MR depends on !596 (merged).

Roughly speaking, a color profile describes the color space of content or an output. Under the hood, the description includes one or more ways to map colors between the profile space and some standard profile connecting space (PCS).

This object is not called a color space. A color space has a unique definition, while a color profile may contain multiple different mappings depending on render intent. Some of these mappings may be subjective, with an artistic touch.

When a source color profile and a destination color profile are combined under a specific render intent, they produce a color transformation. Color transformations are already presented by weston_color_transform.

This MR adds the basic API for color profile objects. Everything worthwhile of these objects is implemented in the color managers: color-noop never creates these, and in color-lcms they are basically a container for cmsHPROFILE, the Little CMS object for color profiles. Color profile objects will not be interpreted outside of the color managers, unlike color transformations.

For a start, the color manager API has one function to create color profiles: from ICC profile data. More creation functions for other sources will be added later. ICC profiles have various types which raises enum weston_color_profile_kind. Output profiles have different requirements from content profiles.

To exercise the the API, if color management is enabled, Weston will now recognize icc_profile key in an [output] section in weston.ini for DRM, headless, wayland, and x11 backends.

This code is very much based on @swick's earlier work on Weston color management, but structured and named differently.

---

This MR is a draft until it has been tested with color-lcms actually using an output color profile. The color-lcms implementation may be added to this MR or it may come as another MR on top of this.

Without the color-lcms implementation, Weston will refuse to start if you specify an output color profile and have turned the experimental color management option on.

Cc @vitalyp

compositor/main.c

@@ -122,6 +122,7 @@ struct wet_compositor {
 	int (*simple_output_configure)(struct weston_output *output);
 	bool init_failed;
 	struct wl_list layoutput_list;	/**< wet_layoutput::compositor_link */
+	bool use_color_manager;
 };
 
 static FILE *weston_logfile = NULL;
@@ -1083,6 +1084,7 @@ static int
 weston_compositor_init_config(struct weston_compositor *ec,
 			      struct weston_config *config)
 {
+	struct wet_compositor *compositor = to_wet_compositor(ec);
 	struct xkb_rule_names xkb_names;
 	struct weston_config_section *s;
 	int repaint_msec;
@@ -1131,6 +1133,8 @@ weston_compositor_init_config(struct weston_compositor *ec,
 	if (color_management) {
 		if (weston_compositor_load_color_manager(ec) < 0)
 			return -1;
+		else
+			compositor->use_color_manager = true;
 	}
 
 	/* weston.ini [libinput] */
@@ -1290,6 +1294,49 @@ wet_output_set_transform(struct weston_output *output,
 	return 0;
 }
 
+static int
+wet_output_set_color_profile(struct weston_output *output,
+			     struct weston_config_section *section,
+			     struct weston_color_profile *parent_winsys_profile)
+{
+	struct wet_compositor *compositor = to_wet_compositor(output->compositor);
+	struct weston_color_profile *cprof;
+	char *icc_file = NULL;
+	bool ok;
+
+	if (!compositor->use_color_manager)
+		return 0;
+
+	if (section) {
+		weston_config_section_get_string(section, "icc_profile",
+						 &icc_file, NULL);
+	}
+
+	if (icc_file) {
+		cprof = weston_compositor_load_icc_file(output->compositor,
+							icc_file,
+							WESTON_COLOR_PROFILE_KIND_OUTPUT);
+		free(icc_file);
+	} else if (parent_winsys_profile) {
+		cprof = weston_color_profile_ref(parent_winsys_profile);
+	} else {
+		return 0;
+	}
+
+	if (!cprof)
+		return -1;
+
+	ok = weston_output_set_color_profile(output, cprof);
+	if (!ok) {
+		weston_log("Error: failed to set color profile '%s' for output %s\n",
+			   weston_color_profile_get_description(cprof),
+			   output->name);
+	}
+
+	weston_color_profile_unref(cprof);
+	return ok ? 0 : -1;
+}
+
 static void
 allow_content_protection(struct weston_output *output,
 			struct weston_config_section *section)
@@ -1354,6 +1401,9 @@ wet_configure_windowed_output_from_config(struct weston_output *output,
 		return -1;
 	}
 
+	if (wet_output_set_color_profile(output, section, NULL) < 0)
+		return -1;
+
 	if (api->output_set_size(output, width, height) < 0) {
 		weston_log("Cannot configure output \"%s\" using weston_windowed_output_api.\n",
 			   output->name);
@@ -1794,6 +1844,9 @@ drm_backend_output_configure(struct weston_output *output,
 		return -1;
 	}
 
+	if (wet_output_set_color_profile(output, section, NULL) < 0)
+		return -1;
+
 	weston_config_section_get_string(section,
 					 "gbm-format", &gbm_format, NULL);
 
@@ -2293,6 +2346,9 @@ drm_backend_remoted_output_configure(struct weston_output *output,
 		return -1;
 	};
 
+	if (wet_output_set_color_profile(output, section, NULL) < 0)
+		return -1;
+
 	weston_config_section_get_string(section, "gbm-format", &gbm_format,
 					 NULL);
 	api->set_gbm_format(output, gbm_format);
@@ -2444,6 +2500,9 @@ drm_backend_pipewire_output_configure(struct weston_output *output,
 		return -1;
 	}
 
+	if (wet_output_set_color_profile(output, section, NULL) < 0)
+		return -1;
+
 	weston_config_section_get_string(section, "seat", &seat, "");
 
 	api->set_seat(output, seat);