color: introduce weston_color_profile
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 preresented by weston_color_transform.
This patch 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.
The API has errmsg return parameter for error messages. These are not
simply weston_log()'d, because CM&HDR protocol will allow clients to
trigger errors and the protocol handles that gracefully. Therefore
instead of flooding the compositor logs, the error messages will
probably need to be relayed back to clients.
Color-lcms is expected to create a cmsHPROFILE for all kinds of color
profiles, not just for those created from ICC profile data. Hence,
color-lcms will fingerprint color profiles by the MD5 hash which Little
CMS computes for us. The fingerprint is used for de-duplication: instead
of creating copies, reference existing color profiles.
This code is very much based on Sebastian Wick's earlier work on Weston
color management, but structured and named differently.
Co-authored-by: Sebastian Wick <sebastian@sebastianwick.net>
Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
4 years ago
|
|
|
/*
|
|
|
|
* Copyright 2019 Sebastian Wick
|
|
|
|
* Copyright 2021 Collabora, Ltd.
|
|
|
|
*
|
|
|
|
* Permission is hereby granted, free of charge, to any person obtaining
|
|
|
|
* a copy of this software and associated documentation files (the
|
|
|
|
* "Software"), to deal in the Software without restriction, including
|
|
|
|
* without limitation the rights to use, copy, modify, merge, publish,
|
|
|
|
* distribute, sublicense, and/or sell copies of the Software, and to
|
|
|
|
* permit persons to whom the Software is furnished to do so, subject to
|
|
|
|
* the following conditions:
|
|
|
|
*
|
|
|
|
* The above copyright notice and this permission notice (including the
|
|
|
|
* next paragraph) shall be included in all copies or substantial
|
|
|
|
* portions of the Software.
|
|
|
|
*
|
|
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
|
|
|
|
* BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
|
|
|
|
* ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
|
|
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
|
|
* SOFTWARE.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include "config.h"
|
|
|
|
|
|
|
|
#include <assert.h>
|
|
|
|
#include <stdio.h>
|
|
|
|
#include <string.h>
|
|
|
|
#include <libweston/libweston.h>
|
|
|
|
|
|
|
|
#include "color.h"
|
|
|
|
#include "color-lcms.h"
|
|
|
|
#include "shared/helpers.h"
|
|
|
|
#include "shared/string-helpers.h"
|
|
|
|
|
|
|
|
/* FIXME: sync with spec! */
|
|
|
|
static bool
|
|
|
|
validate_icc_profile(cmsHPROFILE profile, char **errmsg)
|
|
|
|
{
|
|
|
|
cmsColorSpaceSignature cs = cmsGetColorSpace(profile);
|
|
|
|
uint32_t nr_channels = cmsChannelsOf(cs);
|
|
|
|
uint8_t version = cmsGetEncodedICCversion(profile) >> 24;
|
|
|
|
|
|
|
|
if (version != 2 && version != 4) {
|
|
|
|
str_printf(errmsg,
|
|
|
|
"ICC profile major version %d is unsupported, should be 2 or 4.",
|
|
|
|
version);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (nr_channels != 3) {
|
|
|
|
str_printf(errmsg,
|
|
|
|
"ICC profile must contain 3 channels for the color space, not %u.",
|
|
|
|
nr_channels);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (cmsGetDeviceClass(profile) != cmsSigDisplayClass) {
|
|
|
|
str_printf(errmsg, "ICC profile is required to be of Display device class, but it is not.");
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
static struct cmlcms_color_profile *
|
|
|
|
cmlcms_find_color_profile_by_md5(const struct weston_color_manager_lcms *cm,
|
|
|
|
const struct cmlcms_md5_sum *md5sum)
|
|
|
|
{
|
|
|
|
struct cmlcms_color_profile *cprof;
|
|
|
|
|
|
|
|
wl_list_for_each(cprof, &cm->color_profile_list, link) {
|
|
|
|
if (memcmp(cprof->md5sum.bytes,
|
|
|
|
md5sum->bytes, sizeof(md5sum->bytes)) == 0)
|
|
|
|
return cprof;
|
|
|
|
}
|
|
|
|
|
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
|
|
|
|
static struct cmlcms_color_profile *
|
|
|
|
cmlcms_color_profile_create(struct weston_color_manager_lcms *cm,
|
|
|
|
cmsHPROFILE profile,
|
|
|
|
char *desc,
|
|
|
|
char **errmsg)
|
|
|
|
{
|
|
|
|
struct cmlcms_color_profile *cprof;
|
|
|
|
|
|
|
|
cprof = zalloc(sizeof *cprof);
|
|
|
|
if (!cprof)
|
|
|
|
return NULL;
|
|
|
|
|
|
|
|
weston_color_profile_init(&cprof->base, &cm->base);
|
|
|
|
cprof->base.description = desc;
|
|
|
|
cprof->profile = profile;
|
|
|
|
cmsGetHeaderProfileID(profile, cprof->md5sum.bytes);
|
|
|
|
wl_list_insert(&cm->color_profile_list, &cprof->link);
|
|
|
|
|
|
|
|
return cprof;
|
|
|
|
}
|
|
|
|
|
|
|
|
void
|
color: introduce weston_color_profile
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 preresented by weston_color_transform.
This patch 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.
The API has errmsg return parameter for error messages. These are not
simply weston_log()'d, because CM&HDR protocol will allow clients to
trigger errors and the protocol handles that gracefully. Therefore
instead of flooding the compositor logs, the error messages will
probably need to be relayed back to clients.
Color-lcms is expected to create a cmsHPROFILE for all kinds of color
profiles, not just for those created from ICC profile data. Hence,
color-lcms will fingerprint color profiles by the MD5 hash which Little
CMS computes for us. The fingerprint is used for de-duplication: instead
of creating copies, reference existing color profiles.
This code is very much based on Sebastian Wick's earlier work on Weston
color management, but structured and named differently.
Co-authored-by: Sebastian Wick <sebastian@sebastianwick.net>
Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
4 years ago
|
|
|
cmlcms_color_profile_destroy(struct cmlcms_color_profile *cprof)
|
|
|
|
{
|
|
|
|
wl_list_remove(&cprof->link);
|
|
|
|
cmsFreeToneCurveTriple(cprof->vcgt);
|
|
|
|
cmsFreeToneCurveTriple(cprof->output_eotf);
|
|
|
|
cmsFreeToneCurveTriple(cprof->output_inv_eotf_vcgt);
|
color: introduce weston_color_profile
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 preresented by weston_color_transform.
This patch 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.
The API has errmsg return parameter for error messages. These are not
simply weston_log()'d, because CM&HDR protocol will allow clients to
trigger errors and the protocol handles that gracefully. Therefore
instead of flooding the compositor logs, the error messages will
probably need to be relayed back to clients.
Color-lcms is expected to create a cmsHPROFILE for all kinds of color
profiles, not just for those created from ICC profile data. Hence,
color-lcms will fingerprint color profiles by the MD5 hash which Little
CMS computes for us. The fingerprint is used for de-duplication: instead
of creating copies, reference existing color profiles.
This code is very much based on Sebastian Wick's earlier work on Weston
color management, but structured and named differently.
Co-authored-by: Sebastian Wick <sebastian@sebastianwick.net>
Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
4 years ago
|
|
|
cmsCloseProfile(cprof->profile);
|
|
|
|
free(cprof->base.description);
|
|
|
|
free(cprof);
|
|
|
|
}
|
|
|
|
|
|
|
|
struct cmlcms_color_profile *
|
|
|
|
ref_cprof(struct cmlcms_color_profile *cprof)
|
|
|
|
{
|
|
|
|
if (!cprof)
|
|
|
|
return NULL;
|
|
|
|
|
|
|
|
weston_color_profile_ref(&cprof->base);
|
|
|
|
return cprof;
|
|
|
|
}
|
|
|
|
|
|
|
|
void
|
|
|
|
unref_cprof(struct cmlcms_color_profile *cprof)
|
|
|
|
{
|
|
|
|
if (!cprof)
|
|
|
|
return;
|
|
|
|
|
|
|
|
weston_color_profile_unref(&cprof->base);
|
|
|
|
}
|
|
|
|
|
color: introduce weston_color_profile
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 preresented by weston_color_transform.
This patch 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.
The API has errmsg return parameter for error messages. These are not
simply weston_log()'d, because CM&HDR protocol will allow clients to
trigger errors and the protocol handles that gracefully. Therefore
instead of flooding the compositor logs, the error messages will
probably need to be relayed back to clients.
Color-lcms is expected to create a cmsHPROFILE for all kinds of color
profiles, not just for those created from ICC profile data. Hence,
color-lcms will fingerprint color profiles by the MD5 hash which Little
CMS computes for us. The fingerprint is used for de-duplication: instead
of creating copies, reference existing color profiles.
This code is very much based on Sebastian Wick's earlier work on Weston
color management, but structured and named differently.
Co-authored-by: Sebastian Wick <sebastian@sebastianwick.net>
Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
4 years ago
|
|
|
static char *
|
|
|
|
make_icc_file_description(cmsHPROFILE profile,
|
|
|
|
const struct cmlcms_md5_sum *md5sum,
|
|
|
|
const char *name_part)
|
|
|
|
{
|
|
|
|
char md5sum_str[sizeof(md5sum->bytes) * 2 + 1];
|
|
|
|
char *desc;
|
|
|
|
size_t i;
|
|
|
|
|
|
|
|
for (i = 0; i < sizeof(md5sum->bytes); i++) {
|
|
|
|
snprintf(md5sum_str + 2 * i, sizeof(md5sum_str) - 2 * i,
|
|
|
|
"%02x", md5sum->bytes[i]);
|
|
|
|
}
|
|
|
|
|
|
|
|
str_printf(&desc, "ICCv%f %s %s", cmsGetProfileVersion(profile),
|
|
|
|
name_part, md5sum_str);
|
|
|
|
|
|
|
|
return desc;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
*
|
|
|
|
* Build stock profile which available for clients unaware of color management
|
|
|
|
*/
|
|
|
|
bool
|
|
|
|
cmlcms_create_stock_profile(struct weston_color_manager_lcms *cm)
|
|
|
|
{
|
|
|
|
cmsHPROFILE profile;
|
|
|
|
struct cmlcms_md5_sum md5sum;
|
|
|
|
char *desc = NULL;
|
|
|
|
|
|
|
|
profile = cmsCreate_sRGBProfileTHR(cm->lcms_ctx);
|
|
|
|
if (!profile) {
|
|
|
|
weston_log("color-lcms: error: cmsCreate_sRGBProfileTHR failed\n");
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
if (!cmsMD5computeID(profile)) {
|
|
|
|
weston_log("Failed to compute MD5 for ICC profile\n");
|
|
|
|
goto err_close;
|
|
|
|
}
|
|
|
|
|
|
|
|
cmsGetHeaderProfileID(profile, md5sum.bytes);
|
|
|
|
desc = make_icc_file_description(profile, &md5sum, "sRGB stock");
|
|
|
|
if (!desc)
|
|
|
|
goto err_close;
|
|
|
|
|
|
|
|
cm->sRGB_profile = cmlcms_color_profile_create(cm, profile, desc, NULL);
|
|
|
|
if (!cm->sRGB_profile)
|
|
|
|
goto err_close;
|
|
|
|
|
|
|
|
return true;
|
|
|
|
|
|
|
|
err_close:
|
|
|
|
free(desc);
|
|
|
|
cmsCloseProfile(profile);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
color: introduce weston_color_profile
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 preresented by weston_color_transform.
This patch 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.
The API has errmsg return parameter for error messages. These are not
simply weston_log()'d, because CM&HDR protocol will allow clients to
trigger errors and the protocol handles that gracefully. Therefore
instead of flooding the compositor logs, the error messages will
probably need to be relayed back to clients.
Color-lcms is expected to create a cmsHPROFILE for all kinds of color
profiles, not just for those created from ICC profile data. Hence,
color-lcms will fingerprint color profiles by the MD5 hash which Little
CMS computes for us. The fingerprint is used for de-duplication: instead
of creating copies, reference existing color profiles.
This code is very much based on Sebastian Wick's earlier work on Weston
color management, but structured and named differently.
Co-authored-by: Sebastian Wick <sebastian@sebastianwick.net>
Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.com>
4 years ago
|
|
|
bool
|
|
|
|
cmlcms_get_color_profile_from_icc(struct weston_color_manager *cm_base,
|
|
|
|
const void *icc_data,
|
|
|
|
size_t icc_len,
|
|
|
|
const char *name_part,
|
|
|
|
struct weston_color_profile **cprof_out,
|
|
|
|
char **errmsg)
|
|
|
|
{
|
|
|
|
struct weston_color_manager_lcms *cm = get_cmlcms(cm_base);
|
|
|
|
cmsHPROFILE profile;
|
|
|
|
struct cmlcms_md5_sum md5sum;
|
|
|
|
struct cmlcms_color_profile *cprof;
|
|
|
|
char *desc = NULL;
|
|
|
|
|
|
|
|
if (!icc_data || icc_len < 1) {
|
|
|
|
str_printf(errmsg, "No ICC data.");
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
if (icc_len >= UINT32_MAX) {
|
|
|
|
str_printf(errmsg, "Too much ICC data.");
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
profile = cmsOpenProfileFromMemTHR(cm->lcms_ctx, icc_data, icc_len);
|
|
|
|
if (!profile) {
|
|
|
|
str_printf(errmsg, "ICC data not understood.");
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
if (!validate_icc_profile(profile, errmsg))
|
|
|
|
goto err_close;
|
|
|
|
|
|
|
|
if (!cmsMD5computeID(profile)) {
|
|
|
|
str_printf(errmsg, "Failed to compute MD5 for ICC profile.");
|
|
|
|
goto err_close;
|
|
|
|
}
|
|
|
|
|
|
|
|
cmsGetHeaderProfileID(profile, md5sum.bytes);
|
|
|
|
cprof = cmlcms_find_color_profile_by_md5(cm, &md5sum);
|
|
|
|
if (cprof) {
|
|
|
|
*cprof_out = weston_color_profile_ref(&cprof->base);
|
|
|
|
cmsCloseProfile(profile);
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
|
|
|
desc = make_icc_file_description(profile, &md5sum, name_part);
|
|
|
|
if (!desc)
|
|
|
|
goto err_close;
|
|
|
|
|
|
|
|
cprof = cmlcms_color_profile_create(cm, profile, desc, errmsg);
|
|
|
|
if (!cprof)
|
|
|
|
goto err_close;
|
|
|
|
|
|
|
|
*cprof_out = &cprof->base;
|
|
|
|
return true;
|
|
|
|
|
|
|
|
err_close:
|
|
|
|
free(desc);
|
|
|
|
cmsCloseProfile(profile);
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
|
|
|
void
|
|
|
|
cmlcms_destroy_color_profile(struct weston_color_profile *cprof_base)
|
|
|
|
{
|
|
|
|
struct cmlcms_color_profile *cprof = get_cprof(cprof_base);
|
|
|
|
|
|
|
|
cmlcms_color_profile_destroy(cprof);
|
|
|
|
}
|