dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
gimp/libgimpcolor/gimpcolorprofile.c

1828 lines
55 KiB
C
Raw Normal View History

Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
/* LIBGIMP - The GIMP Library
* Copyright (C) 1995-1997 Spencer Kimball and Peter Mattis
*
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
* gimpcolorprofile.c
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
* Copyright (C) 2014 Michael Natterer <mitch@gimp.org>
* Elle Stone <ellestone@ninedegreesbelow.com>
libgimpcolor: add a function to check if a profile is linear RGB
2015-11-23 07:01:37 +08:00
* Øyvind Kolås <pippin@gimp.org>
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
*
* This library is free software: you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 3 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see
Change the license URL from http://www.gnu.org/licenses/ to https://
2018-07-12 05:27:07 +08:00
* <https://www.gnu.org/licenses/>.
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
*/
#include "config.h"
libgimpcolor: add gimp_lcms_profile_is_equal() and remove all of our own MD5 digest code and API. is_equal() uses lcms' own MD5 API which I missed before. Thanks Elle for pointing that out :)
2014-03-29 17:40:47 +08:00
#include <string.h>
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
#include <lcms2.h>
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
#include <gio/gio.h>
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
#include <gegl.h>
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
#include "libgimpbase/gimpbase.h"
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
#include "gimpcolortypes.h"
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
#include "gimpcolorprofile.h"
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
#include "libgimp/libgimp-intl.h"
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
libgimpcolor: add support for GRAY profiles in gimp_color_profile_get_format() surprisinly seems to work just fine. Thanks to Roman Lebedev for hinting that this is possible, and for constructing the #defines.
2015-12-15 06:16:38 +08:00
#ifndef TYPE_RGBA_DBL
#define TYPE_RGBA_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_RGB)|EXTRA_SH(1)|CHANNELS_SH(3)|BYTES_SH(0))
#endif
#ifndef TYPE_GRAYA_HALF_FLT
#define TYPE_GRAYA_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(2))
#endif
#ifndef TYPE_GRAYA_FLT
#define TYPE_GRAYA_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(4))
#endif
#ifndef TYPE_GRAYA_DBL
#define TYPE_GRAYA_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_GRAY)|EXTRA_SH(1)|CHANNELS_SH(1)|BYTES_SH(0))
#endif
libgimpcolor: add CMYK formats to gimp_color_profile_get_format() Makes the CMYK color selector not crash.
2016-05-27 06:33:56 +08:00
#ifndef TYPE_CMYKA_DBL
#define TYPE_CMYKA_DBL (FLOAT_SH(1)|COLORSPACE_SH(PT_CMYK)|EXTRA_SH(1)|CHANNELS_SH(4)|BYTES_SH(0))
#endif
#ifndef TYPE_CMYKA_HALF_FLT
#define TYPE_CMYKA_HALF_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_CMYK)|EXTRA_SH(1)|CHANNELS_SH(4)|BYTES_SH(2))
#endif
#ifndef TYPE_CMYKA_FLT
#define TYPE_CMYKA_FLT (FLOAT_SH(1)|COLORSPACE_SH(PT_CMYK)|EXTRA_SH(1)|CHANNELS_SH(4)|BYTES_SH(4))
#endif
#ifndef TYPE_CMYKA_16
#define TYPE_CMYKA_16 (COLORSPACE_SH(PT_CMYK)|EXTRA_SH(1)|CHANNELS_SH(4)|BYTES_SH(2))
#endif
libgimpcolor: add support for GRAY profiles in gimp_color_profile_get_format() surprisinly seems to work just fine. Thanks to Roman Lebedev for hinting that this is possible, and for constructing the #defines.
2015-12-15 06:16:38 +08:00
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
/**
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
* SECTION: gimpcolorprofile
* @title: GimpColorProfile
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
* @short_description: Definitions and Functions relating to LCMS.
*
* Definitions and Functions relating to LCMS.
**/
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
* GimpColorProfile:
*
* Simply a typedef to #gpointer, but actually is a cmsHPROFILE. It's
* used in public GIMP APIs in order to avoid having to include LCMS
* headers.
**/
libgimpcolor: move GIMP_LCMS_MD5_DIGEST_LENGTH to the .c file
2014-04-11 02:41:32 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
struct _GimpColorProfile
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
{
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
GObject parent_instance;
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
cmsHPROFILE lcms_profile;
guint8 *data;
gsize length;
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
gchar *description;
gchar *manufacturer;
gchar *model;
gchar *copyright;
gchar *label;
gchar *summary;
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
};
static void gimp_color_profile_finalize (GObject *object);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
G_DEFINE_TYPE (GimpColorProfile, gimp_color_profile, G_TYPE_OBJECT)
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
#define parent_class gimp_color_profile_parent_class
libgimpcolor: add a new gimp_color_profile_get_format() which takes a GimpColorProfile and a Babl format, and returns a new format which uses the profile's RGB primaries and TRC, and the original format's pixel layout; or NULL if babl couldn't create a space from the profile's ICC data.
2017-09-03 02:29:29 +08:00
#define GIMP_COLOR_PROFILE_ERROR gimp_color_profile_error_quark ()
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
static GQuark
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
gimp_color_profile_error_quark (void)
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
{
static GQuark quark = 0;
if (G_UNLIKELY (quark == 0))
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
quark = g_quark_from_static_string ("gimp-color-profile-error-quark");
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
return quark;
}
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
static void
gimp_color_profile_class_init (GimpColorProfileClass *klass)
{
GObjectClass *object_class = G_OBJECT_CLASS (klass);
object_class->finalize = gimp_color_profile_finalize;
}
static void
gimp_color_profile_init (GimpColorProfile *profile)
{
}
static void
gimp_color_profile_finalize (GObject *object)
{
GimpColorProfile *profile = GIMP_COLOR_PROFILE (object);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
g_clear_pointer (&profile->lcms_profile, cmsCloseProfile);
libgimp*: use some g_clear_object() and g_clear_pointer()
2017-09-03 21:14:51 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
g_clear_pointer (&profile->data, g_free);
profile->length = 0;
libgimp*: use some g_clear_object() and g_clear_pointer()
2017-09-03 21:14:51 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
g_clear_pointer (&profile->description, g_free);
g_clear_pointer (&profile->manufacturer, g_free);
g_clear_pointer (&profile->model, g_free);
g_clear_pointer (&profile->copyright, g_free);
g_clear_pointer (&profile->label, g_free);
g_clear_pointer (&profile->summary, g_free);
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
G_OBJECT_CLASS (parent_class)->finalize (object);
}
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
* gimp_color_profile_new_from_file:
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* @file: a #GFile
* @error: return location for #GError
*
* This function opens an ICC color profile from @file.
*
Add (nullable) if applicable Basically this commit makes sure that all return values that are marked as "Returns:" also have a `(nullable)` annotation if it is mentioned on the same line that NULL can also be returned. This will prevent a few problems in GObject-introspection.
2019-08-03 06:36:59 +08:00
* Returns: (nullable): the #GimpColorProfile, or %NULL. On error, %NULL is
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* returned and @error is set.
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
**/
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
GimpColorProfile *
gimp_color_profile_new_from_file (GFile *file,
GError **error)
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
{
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
GimpColorProfile *profile = NULL;
cmsHPROFILE lcms_profile = NULL;
guint8 *data = NULL;
gsize length = 0;
libgimpcolor: change gimp_lcms_profile_open_from_file() from filename to GFile and change most of the lcms plug-in to using GFile too.
2014-07-05 05:57:27 +08:00
gchar *path;
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
libgimpcolor: change gimp_lcms_profile_open_from_file() from filename to GFile and change most of the lcms plug-in to using GFile too.
2014-07-05 05:57:27 +08:00
g_return_val_if_fail (G_IS_FILE (file), NULL);
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
g_return_val_if_fail (error == NULL || *error == NULL, NULL);
libgimpcolor: change gimp_lcms_profile_open_from_file() from filename to GFile and change most of the lcms plug-in to using GFile too.
2014-07-05 05:57:27 +08:00
path = g_file_get_path (file);
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
libgimpcolor: change gimp_lcms_profile_open_from_file() from filename to GFile and change most of the lcms plug-in to using GFile too.
2014-07-05 05:57:27 +08:00
if (path)
{
libgimpcolor: don't leak the path in gimp_color_profile_new_from_file()
2016-05-05 00:58:37 +08:00
GMappedFile *mapped;
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
libgimpcolor: change gimp_lcms_profile_open_from_file() from filename to GFile and change most of the lcms plug-in to using GFile too.
2014-07-05 05:57:27 +08:00
mapped = g_mapped_file_new (path, FALSE, error);
libgimpcolor: don't leak the path in gimp_color_profile_new_from_file()
2016-05-05 00:58:37 +08:00
g_free (path);
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
libgimpcolor: change gimp_lcms_profile_open_from_file() from filename to GFile and change most of the lcms plug-in to using GFile too.
2014-07-05 05:57:27 +08:00
if (! mapped)
return NULL;
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
libgimpcolor: change gimp_lcms_profile_open_from_file() from filename to GFile and change most of the lcms plug-in to using GFile too.
2014-07-05 05:57:27 +08:00
length = g_mapped_file_get_length (mapped);
app, libgimp*, pdb, plug-ins: use g_memdup2() instead of g_memdup() Since it appeared with GLib 2.68.0, we could not change this until we bumped the dependency which has only become possible a few days ago (since Debian testing is our baseline for dependency bumps). Cf. previous commit. As this is a drop-in replacement (just a guint parameter changed to gsize to avoid integer overflow), search-and-replace with: > sed -i 's/g_memdup\>/g_memdup2/g' `grep -rIl 'g_memdup\>' *` … followed by a few manual alignment tweaks when necessary. This gets rid of the many deprecation warnings which we had lately when building with a recent GLib version.
2021-08-26 23:18:32 +08:00
data = g_memdup2 (g_mapped_file_get_contents (mapped), length);
libgimpcolor: change gimp_lcms_profile_open_from_file() from filename to GFile and change most of the lcms plug-in to using GFile too.
2014-07-05 05:57:27 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
lcms_profile = cmsOpenProfileFromMem (data, length);
libgimpcolor: change gimp_lcms_profile_open_from_file() from filename to GFile and change most of the lcms plug-in to using GFile too.
2014-07-05 05:57:27 +08:00
g_mapped_file_unref (mapped);
}
else
{
GFileInfo *info;
info = g_file_query_info (file,
G_FILE_ATTRIBUTE_STANDARD_SIZE,
G_FILE_QUERY_INFO_NONE,
NULL, error);
if (info)
{
GInputStream *input;
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
Issue #9994: do not call g_file_info_get_is_hidden() (and others) directly. This is not the main reason for the specific output in #9994. These ones are more probably because of similar usage in GTK (which updated its own calls to g_file_info_get_is_hidden|backup() in version 3.24.38). But we should likely also update the various calls we have to use the generic g_file_info_get_attribute_*() variants. To be fair, it is unclear to me when we can be sure that an attribute is set. For instance, when we call g_file_enumerate_children() or g_file_query_info() with specific attributes, docs say that it is still possible for these attributes to not be set. So I assume it means we should never use direct accessor functions. The only exception is that I didn't remove usage of g_file_info_get_name(), since its docs says: > * Gets a display name for a file. This is guaranteed to always be set. Even though it also says just after: > * It is an error to call this if the #GFileInfo does not contain > * %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME. Which is very contradictory. But assuming that this error warning was over-zealous documentation, I kept the direct accessors since they are supposed to be slightly more optimized (still according to in-code documentation) so let's priorize them when we know they are set for sure.
2023-09-19 20:38:42 +08:00
length = g_file_info_get_attribute_uint64 (info, G_FILE_ATTRIBUTE_STANDARD_SIZE);
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
data = g_malloc (length);
libgimpcolor: change gimp_lcms_profile_open_from_file() from filename to GFile and change most of the lcms plug-in to using GFile too.
2014-07-05 05:57:27 +08:00
g_object_unref (info);
input = G_INPUT_STREAM (g_file_read (file, NULL, error));
if (input)
{
gsize bytes_read;
if (g_input_stream_read_all (input, data, length,
&bytes_read, NULL, error) &&
bytes_read == length)
{
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
lcms_profile = cmsOpenProfileFromMem (data, length);
libgimpcolor: change gimp_lcms_profile_open_from_file() from filename to GFile and change most of the lcms plug-in to using GFile too.
2014-07-05 05:57:27 +08:00
}
g_object_unref (input);
}
}
}
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
if (lcms_profile)
{
profile = g_object_new (GIMP_TYPE_COLOR_PROFILE, NULL);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
profile->lcms_profile = lcms_profile;
profile->data = data;
profile->length = length;
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
}
else
{
if (data)
g_free (data);
if (error && *error == NULL)
{
libgimpcolor: add a new gimp_color_profile_get_format() which takes a GimpColorProfile and a Babl format, and returns a new format which uses the profile's RGB primaries and TRC, and the original format's pixel layout; or NULL if babl couldn't create a space from the profile's ICC data.
2017-09-03 02:29:29 +08:00
g_set_error (error, GIMP_COLOR_PROFILE_ERROR, 0,
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
_("'%s' does not appear to be an ICC color profile"),
gimp_file_get_utf8_name (file));
}
}
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
return profile;
}
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
* gimp_color_profile_new_from_icc_profile:
gir: Add missing annotations Otherwise we won't be able to generate proper API for our bindings
2020-05-04 08:10:55 +08:00
* @data: (array length=length): The memory containing an ICC profile
Bug 795161 - Misc. typo fixes in source comments and doxygen Found via `codespell` Follow-up to commit 7fdb963e018c5413036bc1dd547c7a812e20302d
2018-04-19 02:57:03 +08:00
* @length: length of the profile in memory, in bytes
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* @error: return location for #GError
*
* This function opens an ICC color profile from memory. On error,
* %NULL is returned and @error is set.
*
Add (nullable) if applicable Basically this commit makes sure that all return values that are marked as "Returns:" also have a `(nullable)` annotation if it is mentioned on the same line that NULL can also be returned. This will prevent a few problems in GObject-introspection.
2019-08-03 06:36:59 +08:00
* Returns: (nullable): the #GimpColorProfile, or %NULL.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
**/
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
GimpColorProfile *
gimp_color_profile_new_from_icc_profile (const guint8 *data,
gsize length,
GError **error)
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
{
libgimpcolor, app: gracefully reject empty ICC profiles In gimp_color_profile_new_from_icc_profile() and gimp_image_validate_icc_profile(), don't raise a critical when encountering an empty profile, but rather reject it gracefully with an error.
2018-07-06 08:34:15 +08:00
cmsHPROFILE lcms_profile = 0;
GimpColorProfile *profile = NULL;
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
libgimpcolor, app: gracefully reject empty ICC profiles In gimp_color_profile_new_from_icc_profile() and gimp_image_validate_icc_profile(), don't raise a critical when encountering an empty profile, but rather reject it gracefully with an error.
2018-07-06 08:34:15 +08:00
g_return_val_if_fail (data != NULL || length == 0, NULL);
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
g_return_val_if_fail (error == NULL || *error == NULL, NULL);
libgimpcolor, app: gracefully reject empty ICC profiles In gimp_color_profile_new_from_icc_profile() and gimp_image_validate_icc_profile(), don't raise a critical when encountering an empty profile, but rather reject it gracefully with an error.
2018-07-06 08:34:15 +08:00
if (length > 0)
lcms_profile = cmsOpenProfileFromMem (data, length);
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
if (lcms_profile)
{
profile = g_object_new (GIMP_TYPE_COLOR_PROFILE, NULL);
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
profile->lcms_profile = lcms_profile;
profile->data = g_memdup2 (data, length);
profile->length = length;
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
}
else
{
libgimpcolor: add a new gimp_color_profile_get_format() which takes a GimpColorProfile and a Babl format, and returns a new format which uses the profile's RGB primaries and TRC, and the original format's pixel layout; or NULL if babl couldn't create a space from the profile's ICC data.
2017-09-03 02:29:29 +08:00
g_set_error_literal (error, GIMP_COLOR_PROFILE_ERROR, 0,
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
_("Data does not appear to be an ICC color profile"));
}
libgimpcolor: add gimp_lcms_profile_open_from_file() and _from_data() which work just like their lcms counterparts but return an optional md5 digest of the ICC data and a GError in case opening fails.
2014-03-16 07:06:31 +08:00
return profile;
}
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
* gimp_color_profile_new_from_lcms_profile:
* @lcms_profile: an LCMS cmsHPROFILE pointer
* @error: return location for #GError
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
* This function creates a GimpColorProfile from a cmsHPROFILE. On
* error, %NULL is returned and @error is set. The passed
* @lcms_profile pointer is not retained by the created
* #GimpColorProfile.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
Add (nullable) if applicable Basically this commit makes sure that all return values that are marked as "Returns:" also have a `(nullable)` annotation if it is mentioned on the same line that NULL can also be returned. This will prevent a few problems in GObject-introspection.
2019-08-03 06:36:59 +08:00
* Returns: (nullable): the #GimpColorProfile, or %NULL.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
**/
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
GimpColorProfile *
gimp_color_profile_new_from_lcms_profile (gpointer lcms_profile,
GError **error)
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
{
cmsUInt32Number size;
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
g_return_val_if_fail (lcms_profile != NULL, NULL);
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
g_return_val_if_fail (error == NULL || *error == NULL, NULL);
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
if (cmsSaveProfileToMem (lcms_profile, NULL, &size))
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
{
guint8 *data = g_malloc (size);
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
if (cmsSaveProfileToMem (lcms_profile, data, &size))
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
{
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gsize length = size;
lcms_profile = cmsOpenProfileFromMem (data, length);
if (lcms_profile)
{
GimpColorProfile *profile;
profile = g_object_new (GIMP_TYPE_COLOR_PROFILE, NULL);
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
profile->lcms_profile = lcms_profile;
profile->data = data;
profile->length = length;
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
return profile;
}
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
}
g_free (data);
}
libgimpcolor: add a new gimp_color_profile_get_format() which takes a GimpColorProfile and a Babl format, and returns a new format which uses the profile's RGB primaries and TRC, and the original format's pixel layout; or NULL if babl couldn't create a space from the profile's ICC data.
2017-09-03 02:29:29 +08:00
g_set_error_literal (error, GIMP_COLOR_PROFILE_ERROR, 0,
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
_("Could not save color profile to memory"));
return NULL;
}
libgimpcolor: add gimp_color_profile_save_to_file()
2016-05-05 02:40:04 +08:00
/**
* gimp_color_profile_save_to_file:
libgimpcolor: some doc fixes and updates
2017-06-04 03:03:25 +08:00
* @profile: a #GimpColorProfile
* @file: a #GFile
* @error: return location for #GError
libgimpcolor: add gimp_color_profile_save_to_file()
2016-05-05 02:40:04 +08:00
*
* This function saves @profile to @file as ICC profile.
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: %TRUE on success, %FALSE if an error occurred.
libgimpcolor: add gimp_color_profile_save_to_file()
2016-05-05 02:40:04 +08:00
*
* Since: 2.10
**/
gboolean
gimp_color_profile_save_to_file (GimpColorProfile *profile,
GFile *file,
GError **error)
{
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), FALSE);
g_return_val_if_fail (G_IS_FILE (file), FALSE);
g_return_val_if_fail (error == NULL || *error == NULL, FALSE);
return g_file_replace_contents (file,
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
(const gchar *) profile->data,
profile->length,
libgimpcolor: add gimp_color_profile_save_to_file()
2016-05-05 02:40:04 +08:00
NULL, FALSE,
G_FILE_CREATE_NONE,
NULL,
NULL,
error);
}
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
* gimp_color_profile_get_icc_profile:
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* @profile: a #GimpColorProfile
gir: Add missing annotations Otherwise we won't be able to generate proper API for our bindings
2020-05-04 08:10:55 +08:00
* @length: (out): return location for the number of bytes
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
* This function returns @profile as ICC profile data. The returned
* memory belongs to @profile and must not be modified or freed.
*
gir: Add missing annotations Otherwise we won't be able to generate proper API for our bindings
2020-05-04 08:10:55 +08:00
* Returns: (array length=length): a pointer to the IIC profile data.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
**/
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
const guint8 *
gimp_color_profile_get_icc_profile (GimpColorProfile *profile,
gsize *length)
libgimpcolor: add gimp_lcms_profile_close() So code that only needs a profile's metadata doesn't need to depend on lcms2 any longer.
2015-05-06 22:28:45 +08:00
{
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
g_return_val_if_fail (length != NULL, NULL);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
*length = profile->length;
libgimpcolor: add gimp_lcms_profile_close() So code that only needs a profile's metadata doesn't need to depend on lcms2 any longer.
2015-05-06 22:28:45 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
return profile->data;
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
}
/**
* gimp_color_profile_get_lcms_profile:
* @profile: a #GimpColorProfile
*
* This function returns @profile's cmsHPROFILE. The returned
* value belongs to @profile and must not be modified or freed.
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: a pointer to the cmsHPROFILE.
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
*
* Since: 2.10
**/
gpointer
gimp_color_profile_get_lcms_profile (GimpColorProfile *profile)
{
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
return profile->lcms_profile;
libgimpcolor: add gimp_lcms_profile_close() So code that only needs a profile's metadata doesn't need to depend on lcms2 any longer.
2015-05-06 22:28:45 +08:00
}
libgimpcolor: add gimp_lcms_profile_get_summary() Which returns an "executive summary" of the profile, much like lcms1's "profile info" API. Refactor common code out of the other string getters.
2014-03-15 01:37:07 +08:00
static gchar *
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_get_info (GimpColorProfile *profile,
cmsInfoType info)
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
{
cmsUInt32Number size;
libgimpcolor: add gimp_lcms_profile_get_summary() Which returns an "executive summary" of the profile, much like lcms1's "profile info" API. Refactor common code out of the other string getters.
2014-03-15 01:37:07 +08:00
gchar *text = NULL;
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
size = cmsGetProfileInfoASCII (profile->lcms_profile, info,
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
"en", "US", NULL, 0);
if (size > 0)
{
gchar *data = g_new (gchar, size + 1);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
size = cmsGetProfileInfoASCII (profile->lcms_profile, info,
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
"en", "US", data, size);
if (size > 0)
libgimpcolor: add gimp_lcms_profile_get_summary() Which returns an "executive summary" of the profile, much like lcms1's "profile info" API. Refactor common code out of the other string getters.
2014-03-15 01:37:07 +08:00
text = gimp_any_to_utf8 (data, -1, NULL);
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
g_free (data);
}
libgimpcolor: add gimp_lcms_profile_get_summary() Which returns an "executive summary" of the profile, much like lcms1's "profile info" API. Refactor common code out of the other string getters.
2014-03-15 01:37:07 +08:00
return text;
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
}
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
* gimp_color_profile_get_description:
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* @profile: a #GimpColorProfile
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: a string containing @profile's description. The
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
* returned value belongs to @profile and must not be
* modified or freed.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
**/
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
const gchar *
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_get_description (GimpColorProfile *profile)
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
{
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
if (! profile->description)
profile->description =
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
gimp_color_profile_get_info (profile, cmsInfoDescription);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
return profile->description;
libgimpcolor: add gimp_lcms_profile_get_summary() Which returns an "executive summary" of the profile, much like lcms1's "profile info" API. Refactor common code out of the other string getters.
2014-03-15 01:37:07 +08:00
}
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
* gimp_color_profile_get_manufacturer:
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* @profile: a #GimpColorProfile
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: a string containing @profile's manufacturer. The
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
* returned value belongs to @profile and must not be
* modified or freed.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
**/
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
const gchar *
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_get_manufacturer (GimpColorProfile *profile)
libgimpcolor: add gimp_lcms_profile_get_summary() Which returns an "executive summary" of the profile, much like lcms1's "profile info" API. Refactor common code out of the other string getters.
2014-03-15 01:37:07 +08:00
{
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
if (! profile->manufacturer)
profile->manufacturer =
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
gimp_color_profile_get_info (profile, cmsInfoManufacturer);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
return profile->manufacturer;
libgimpcolor: add gimp_lcms_profile_get_summary() Which returns an "executive summary" of the profile, much like lcms1's "profile info" API. Refactor common code out of the other string getters.
2014-03-15 01:37:07 +08:00
}
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
* gimp_color_profile_get_model:
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* @profile: a #GimpColorProfile
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: a string containing @profile's model. The returned
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
* value belongs to @profile and must not be modified or
* freed.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
**/
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
const gchar *
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_get_model (GimpColorProfile *profile)
libgimpcolor: add gimp_lcms_profile_get_summary() Which returns an "executive summary" of the profile, much like lcms1's "profile info" API. Refactor common code out of the other string getters.
2014-03-15 01:37:07 +08:00
{
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
if (! profile->model)
profile->model =
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
gimp_color_profile_get_info (profile, cmsInfoModel);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
return profile->model;
libgimpcolor: add gimp_lcms_profile_get_summary() Which returns an "executive summary" of the profile, much like lcms1's "profile info" API. Refactor common code out of the other string getters.
2014-03-15 01:37:07 +08:00
}
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
* gimp_color_profile_get_copyright:
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* @profile: a #GimpColorProfile
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: a string containing @profile's copyright. The
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
* returned value belongs to @profile and must not be
* modified or freed.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
**/
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
const gchar *
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_get_copyright (GimpColorProfile *profile)
libgimpcolor: add gimp_lcms_profile_get_summary() Which returns an "executive summary" of the profile, much like lcms1's "profile info" API. Refactor common code out of the other string getters.
2014-03-15 01:37:07 +08:00
{
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
if (! profile->copyright)
profile->copyright =
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
gimp_color_profile_get_info (profile, cmsInfoCopyright);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
return profile->copyright;
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
}
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
* gimp_color_profile_get_label:
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* @profile: a #GimpColorProfile
*
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
* This function returns a string containing @profile's "title", a
* string that can be used to label the profile in a user interface.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
libgimpcolor: don't return a profile's model as fallback for it's description in gimp_color_profile_get_label(). Also, make gimp_color_profile_get_summary() more verbose.
2015-08-23 03:59:30 +08:00
* Unlike gimp_color_profile_get_description(), this function always
libgimpcolor: don't leak the path in gimp_color_profile_new_from_file()
2016-05-05 00:58:37 +08:00
* returns a string (as a fallback, it returns "(unnamed profile)").
libgimpcolor: don't return a profile's model as fallback for it's description in gimp_color_profile_get_label(). Also, make gimp_color_profile_get_summary() more verbose.
2015-08-23 03:59:30 +08:00
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: the @profile's label. The returned value belongs to
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
* @profile and must not be modified or freed.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
**/
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
const gchar *
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_get_label (GimpColorProfile *profile)
libgimpcolor: add gimp_lcms_profile_get_label() which returns a string meant to label the profile in the GUI, it's either the profile's description, its model, or "(unnamed profile)" as a fallback. Use the function instead of duplicating that logic inconsistently and imcompletely all over the place.
2014-03-30 09:12:42 +08:00
{
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
libgimpcolor: add gimp_lcms_profile_get_label() which returns a string meant to label the profile in the GUI, it's either the profile's description, its model, or "(unnamed profile)" as a fallback. Use the function instead of duplicating that logic inconsistently and imcompletely all over the place.
2014-03-30 09:12:42 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
if (! profile->label)
libgimpcolor: add gimp_lcms_profile_get_label() which returns a string meant to label the profile in the GUI, it's either the profile's description, its model, or "(unnamed profile)" as a fallback. Use the function instead of duplicating that logic inconsistently and imcompletely all over the place.
2014-03-30 09:12:42 +08:00
{
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
const gchar *label = gimp_color_profile_get_description (profile);
libgimpcolor: add gimp_lcms_profile_get_label() which returns a string meant to label the profile in the GUI, it's either the profile's description, its model, or "(unnamed profile)" as a fallback. Use the function instead of duplicating that logic inconsistently and imcompletely all over the place.
2014-03-30 09:12:42 +08:00
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
if (! label || ! strlen (label))
label = _("(unnamed profile)");
libgimpcolor: add gimp_lcms_profile_get_label() which returns a string meant to label the profile in the GUI, it's either the profile's description, its model, or "(unnamed profile)" as a fallback. Use the function instead of duplicating that logic inconsistently and imcompletely all over the place.
2014-03-30 09:12:42 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
profile->label = g_strdup (label);
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
}
libgimpcolor: add gimp_lcms_profile_get_label() which returns a string meant to label the profile in the GUI, it's either the profile's description, its model, or "(unnamed profile)" as a fallback. Use the function instead of duplicating that logic inconsistently and imcompletely all over the place.
2014-03-30 09:12:42 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
return profile->label;
libgimpcolor: add gimp_lcms_profile_get_label() which returns a string meant to label the profile in the GUI, it's either the profile's description, its model, or "(unnamed profile)" as a fallback. Use the function instead of duplicating that logic inconsistently and imcompletely all over the place.
2014-03-30 09:12:42 +08:00
}
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
* gimp_color_profile_get_summary:
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* @profile: a #GimpColorProfile
*
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
* This function return a string containing a multi-line summary of
* @profile's description, model, manufacturer and copyright, to be
Bug 795161 - Misc. typo fixes in source comments and doxygen Found via `codespell` Follow-up to commit 7fdb963e018c5413036bc1dd547c7a812e20302d
2018-04-19 02:57:03 +08:00
* used as detailed information about the profile in a user
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
* interface.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: the @profile's summary. The returned value belongs to
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
* @profile and must not be modified or freed.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
**/
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
const gchar *
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_get_summary (GimpColorProfile *profile)
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
{
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
if (! profile->summary)
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
{
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
GString *string = g_string_new (NULL);
const gchar *text;
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
text = gimp_color_profile_get_description (profile);
if (text)
g_string_append (string, text);
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
text = gimp_color_profile_get_model (profile);
if (text)
{
if (string->len > 0)
g_string_append (string, "\n");
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
libgimpcolor: don't return a profile's model as fallback for it's description in gimp_color_profile_get_label(). Also, make gimp_color_profile_get_summary() more verbose.
2015-08-23 03:59:30 +08:00
g_string_append_printf (string, _("Model: %s"), text);
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
}
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
text = gimp_color_profile_get_manufacturer (profile);
if (text)
{
if (string->len > 0)
g_string_append (string, "\n");
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
libgimpcolor: don't return a profile's model as fallback for it's description in gimp_color_profile_get_label(). Also, make gimp_color_profile_get_summary() more verbose.
2015-08-23 03:59:30 +08:00
g_string_append_printf (string, _("Manufacturer: %s"), text);
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
}
text = gimp_color_profile_get_copyright (profile);
if (text)
{
if (string->len > 0)
g_string_append (string, "\n");
libgimpcolor: don't return a profile's model as fallback for it's description in gimp_color_profile_get_label(). Also, make gimp_color_profile_get_summary() more verbose.
2015-08-23 03:59:30 +08:00
g_string_append_printf (string, _("Copyright: %s"), text);
libgimpcolor, *: change all GimpColorConfig getters to return const gchar* instead of a gchar* which has to be freed. Cache all the strings in the GimpColorConfig instance.
2015-07-12 20:08:42 +08:00
}
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
profile->summary = g_string_free (string, FALSE);
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
}
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
return profile->summary;
libgimpcolor: start adding profile utility functions to gimplcms.[ch] Add functions to get a profile's description, manufacturer, model and copyright, and use them instead of implementing the same 10 times. Also add a GimpColorProfile typedef which avoids both having to include lcms globally or using a gpointer instead (which looks bad and non-descriptive in an API).
2014-03-14 08:44:27 +08:00
}
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
* gimp_color_profile_is_equal:
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* @profile1: a #GimpColorProfile
* @profile2: a #GimpColorProfile
*
* Compares two profiles.
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: %TRUE if the profiles are equal, %FALSE otherwise.
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
**/
libgimpcolor: add gimp_lcms_profile_is_equal() and remove all of our own MD5 digest code and API. is_equal() uses lcms' own MD5 API which I missed before. Thanks Elle for pointing that out :)
2014-03-29 17:40:47 +08:00
gboolean
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_is_equal (GimpColorProfile *profile1,
GimpColorProfile *profile2)
libgimpcolor: add gimp_lcms_profile_is_equal() and remove all of our own MD5 digest code and API. is_equal() uses lcms' own MD5 API which I missed before. Thanks Elle for pointing that out :)
2014-03-29 17:40:47 +08:00
{
Bug 751553: Linear precision doesn't display the image correctly gimp_color_profile_is_equal(): byte-by-byte compare the entire profile *except* the header, instead of only the header, which was wrong.
2015-07-11 05:06:53 +08:00
const gsize header_len = sizeof (cmsICCHeader);
libgimpcolor: add gimp_lcms_profile_is_equal() and remove all of our own MD5 digest code and API. is_equal() uses lcms' own MD5 API which I missed before. Thanks Elle for pointing that out :)
2014-03-29 17:40:47 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile1), FALSE);
libgimpcolor: add shortcut in gimp_color_profile_is_equal() When the two pointers are equal, return TRUE immediately, instead of comparing the profile to itself.
2017-11-03 15:11:47 +08:00
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile2), FALSE);
libgimpcolor: add gimp_lcms_profile_is_equal() and remove all of our own MD5 digest code and API. is_equal() uses lcms' own MD5 API which I missed before. Thanks Elle for pointing that out :)
2014-03-29 17:40:47 +08:00
libgimpcolor: add shortcut in gimp_color_profile_is_equal() When the two pointers are equal, return TRUE immediately, instead of comparing the profile to itself.
2017-11-03 15:11:47 +08:00
return profile1 == profile2 ||
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
(profile1->length == profile2->length &&
memcmp (profile1->data + header_len,
profile2->data + header_len,
profile1->length - header_len) == 0);
libgimpcolor: add gimp_lcms_profile_is_equal() and remove all of our own MD5 digest code and API. is_equal() uses lcms' own MD5 API which I missed before. Thanks Elle for pointing that out :)
2014-03-29 17:40:47 +08:00
}
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
/**
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
* gimp_color_profile_is_rgb:
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* @profile: a #GimpColorProfile
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: %TRUE if the profile's color space is RGB, %FALSE
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
* otherwise.
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add API docs to gimplcms.c
2015-05-07 08:00:33 +08:00
**/
libgimpcolor: add gimp_lcms_profile_is_rgb() and _is_cmyk() And change all lcms code to use it.
2014-03-16 04:46:02 +08:00
gboolean
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_is_rgb (GimpColorProfile *profile)
libgimpcolor: add gimp_lcms_profile_is_rgb() and _is_cmyk() And change all lcms code to use it.
2014-03-16 04:46:02 +08:00
{
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), FALSE);
libgimpcolor: add gimp_lcms_profile_is_rgb() and _is_cmyk() And change all lcms code to use it.
2014-03-16 04:46:02 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
return (cmsGetColorSpace (profile->lcms_profile) == cmsSigRgbData);
libgimpcolor: add gimp_lcms_profile_is_rgb() and _is_cmyk() And change all lcms code to use it.
2014-03-16 04:46:02 +08:00
}
libgimpcolor: add gimp_color_profile_is_gray() and improve gimp_color_profile_is_linear() to return TRUE for linear gray matrix profiles.
2015-12-13 21:33:51 +08:00
/**
* gimp_color_profile_is_gray:
* @profile: a #GimpColorProfile
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: %TRUE if the profile's color space is grayscale, %FALSE
libgimpcolor: add gimp_color_profile_is_gray() and improve gimp_color_profile_is_linear() to return TRUE for linear gray matrix profiles.
2015-12-13 21:33:51 +08:00
* otherwise.
*
* Since: 2.10
**/
gboolean
gimp_color_profile_is_gray (GimpColorProfile *profile)
{
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), FALSE);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
return (cmsGetColorSpace (profile->lcms_profile) == cmsSigGrayData);
libgimpcolor: add gimp_color_profile_is_gray() and improve gimp_color_profile_is_linear() to return TRUE for linear gray matrix profiles.
2015-12-13 21:33:51 +08:00
}
/**
* gimp_color_profile_is_cmyk:
* @profile: a #GimpColorProfile
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: %TRUE if the profile's color space is CMYK, %FALSE
libgimpcolor: add gimp_color_profile_is_gray() and improve gimp_color_profile_is_linear() to return TRUE for linear gray matrix profiles.
2015-12-13 21:33:51 +08:00
* otherwise.
*
* Since: 2.10
**/
gboolean
gimp_color_profile_is_cmyk (GimpColorProfile *profile)
{
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), FALSE);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
return (cmsGetColorSpace (profile->lcms_profile) == cmsSigCmykData);
libgimpcolor: add gimp_color_profile_is_gray() and improve gimp_color_profile_is_linear() to return TRUE for linear gray matrix profiles.
2015-12-13 21:33:51 +08:00
}
libgimpcolor: clean up gimp_color_profile_is_linear(), add it to gimpcolor.def
2015-11-23 08:29:17 +08:00
/**
* gimp_color_profile_is_linear:
* @profile: a #GimpColorProfile
*
* This function determines is the ICC profile represented by a GimpColorProfile
* is a linear RGB profile or not, some profiles that are LUTs though linear
* will also return FALSE;
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: %TRUE if the profile is a matrix shaping profile with linear
libgimpcolor: clean up gimp_color_profile_is_linear(), add it to gimpcolor.def
2015-11-23 08:29:17 +08:00
* TRCs, %FALSE otherwise.
*
* Since: 2.10
**/
gboolean
gimp_color_profile_is_linear (GimpColorProfile *profile)
{
libgimpcolor: add gimp_color_profile_is_gray() and improve gimp_color_profile_is_linear() to return TRUE for linear gray matrix profiles.
2015-12-13 21:33:51 +08:00
cmsHPROFILE prof;
libgimpcolor: clean up gimp_color_profile_is_linear(), add it to gimpcolor.def
2015-11-23 08:29:17 +08:00
cmsToneCurve *curve;
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), FALSE);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
prof = profile->lcms_profile;
libgimpcolor: clean up gimp_color_profile_is_linear(), add it to gimpcolor.def
2015-11-23 08:29:17 +08:00
if (! cmsIsMatrixShaper (prof))
return FALSE;
if (cmsIsCLUT (prof, INTENT_PERCEPTUAL, LCMS_USED_AS_INPUT))
return FALSE;
if (cmsIsCLUT (prof, INTENT_PERCEPTUAL, LCMS_USED_AS_OUTPUT))
return FALSE;
libgimpcolor: add gimp_color_profile_is_gray() and improve gimp_color_profile_is_linear() to return TRUE for linear gray matrix profiles.
2015-12-13 21:33:51 +08:00
if (gimp_color_profile_is_rgb (profile))
{
curve = cmsReadTag(prof, cmsSigRedTRCTag);
if (curve == NULL || ! cmsIsToneCurveLinear (curve))
return FALSE;
libgimpcolor: clean up gimp_color_profile_is_linear(), add it to gimpcolor.def
2015-11-23 08:29:17 +08:00
libgimpcolor: add gimp_color_profile_is_gray() and improve gimp_color_profile_is_linear() to return TRUE for linear gray matrix profiles.
2015-12-13 21:33:51 +08:00
curve = cmsReadTag (prof, cmsSigGreenTRCTag);
if (curve == NULL || ! cmsIsToneCurveLinear (curve))
return FALSE;
libgimpcolor: clean up gimp_color_profile_is_linear(), add it to gimpcolor.def
2015-11-23 08:29:17 +08:00
libgimpcolor: add gimp_color_profile_is_gray() and improve gimp_color_profile_is_linear() to return TRUE for linear gray matrix profiles.
2015-12-13 21:33:51 +08:00
curve = cmsReadTag (prof, cmsSigBlueTRCTag);
if (curve == NULL || ! cmsIsToneCurveLinear (curve))
return FALSE;
}
else if (gimp_color_profile_is_gray (profile))
{
curve = cmsReadTag(prof, cmsSigGrayTRCTag);
if (curve == NULL || ! cmsIsToneCurveLinear (curve))
return FALSE;
}
else
{
return FALSE;
}
libgimpcolor: clean up gimp_color_profile_is_linear(), add it to gimpcolor.def
2015-11-23 08:29:17 +08:00
return TRUE;
}
libgimpcolor: add a bunch or information strings to the sRGB profile so it can be treated like any other profile and needs no special casing.
2014-03-15 07:06:47 +08:00
static void
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
gimp_color_profile_set_tag (cmsHPROFILE profile,
cmsTagSignature sig,
const gchar *tag)
libgimpcolor: add a bunch or information strings to the sRGB profile so it can be treated like any other profile and needs no special casing.
2014-03-15 07:06:47 +08:00
{
cmsMLU *mlu;
mlu = cmsMLUalloc (NULL, 1);
cmsMLUsetASCII (mlu, "en", "US", tag);
cmsWriteTag (profile, sig, mlu);
cmsMLUfree (mlu);
}
Bug 728610 - Code for retrieving the XYZ values of a matrix RGB profile Add two private functions which are currently unused but will become public once it's clear where exactly we need them: gimp_color_profile_get_rgb_matrix_colorants(): returns a GimpMatrix2 with the RGB colorants. gimp_color_profile_new_foobar(): takes an existing profile and creates a new one with the same RGB colorants but a linear gamma TRC. To be renamed and made more general.
2015-08-22 05:29:39 +08:00
static gboolean
gimp_color_profile_get_rgb_matrix_colorants (GimpColorProfile *profile,
GimpMatrix3 *matrix)
{
cmsHPROFILE lcms_profile;
cmsCIEXYZ *red;
cmsCIEXYZ *green;
cmsCIEXYZ *blue;
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), FALSE);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
lcms_profile = profile->lcms_profile;
Bug 728610 - Code for retrieving the XYZ values of a matrix RGB profile Add two private functions which are currently unused but will become public once it's clear where exactly we need them: gimp_color_profile_get_rgb_matrix_colorants(): returns a GimpMatrix2 with the RGB colorants. gimp_color_profile_new_foobar(): takes an existing profile and creates a new one with the same RGB colorants but a linear gamma TRC. To be renamed and made more general.
2015-08-22 05:29:39 +08:00
red = cmsReadTag (lcms_profile, cmsSigRedColorantTag);
green = cmsReadTag (lcms_profile, cmsSigGreenColorantTag);
blue = cmsReadTag (lcms_profile, cmsSigBlueColorantTag);
if (red && green && blue)
{
if (matrix)
{
matrix->coeff[0][0] = red->X;
matrix->coeff[0][1] = red->Y;
matrix->coeff[0][2] = red->Z;
matrix->coeff[1][0] = green->X;
matrix->coeff[1][1] = green->Y;
matrix->coeff[1][2] = green->Z;
matrix->coeff[2][0] = blue->X;
Bug 751553 - Linear precision doesn't display the image correctly Fix copy/paste bug in gimp_color_profile_get_rgb_matrix_colorants() which returned a broken XYZ triple for the blue component. Spotted by Massimo.
2015-10-22 02:25:06 +08:00
matrix->coeff[2][1] = blue->Y;
matrix->coeff[2][2] = blue->Z;
Bug 728610 - Code for retrieving the XYZ values of a matrix RGB profile Add two private functions which are currently unused but will become public once it's clear where exactly we need them: gimp_color_profile_get_rgb_matrix_colorants(): returns a GimpMatrix2 with the RGB colorants. gimp_color_profile_new_foobar(): takes an existing profile and creates a new one with the same RGB colorants but a linear gamma TRC. To be renamed and made more general.
2015-08-22 05:29:39 +08:00
}
return TRUE;
}
return FALSE;
}
Issue #3057 - Retain last user-chosen ICC profile information... ...when generating "TRC variants" When creating a new profile with different TRC from an existing profile, keep all the original profile's description, model, manufacturer and copyright strings around, but prefix them with "GIMP from " or similar to indicate that they are different. Also make sure we don't prefix strings with GIMP stuff multiple times when profiles are generated repeatedly.
2019-05-31 21:44:07 +08:00
static void
gimp_color_profile_make_tag (cmsHPROFILE profile,
cmsTagSignature sig,
const gchar *gimp_tag,
const gchar *gimp_prefix,
const gchar *gimp_prefix_alt,
const gchar *original_tag)
{
if (! original_tag || ! strlen (original_tag) ||
! strcmp (original_tag, gimp_tag))
{
/* if there is no original tag (or it is the same as the new
* tag), just use the new tag
*/
gimp_color_profile_set_tag (profile, sig, gimp_tag);
}
else
{
/* otherwise prefix the existing tag with a gimp prefix
* indicating that the profile has been generated
*/
if (g_str_has_prefix (original_tag, gimp_prefix))
{
/* don't add multiple GIMP prefixes */
gimp_color_profile_set_tag (profile, sig, original_tag);
}
else if (gimp_prefix_alt &&
g_str_has_prefix (original_tag, gimp_prefix_alt))
{
/* replace GIMP prefix_alt by prefix */
gchar *new_tag = g_strconcat (gimp_prefix,
original_tag + strlen (gimp_prefix_alt),
NULL);
gimp_color_profile_set_tag (profile, sig, new_tag);
g_free (new_tag);
}
else
{
gchar *new_tag = g_strconcat (gimp_prefix,
original_tag,
NULL);
gimp_color_profile_set_tag (profile, sig, new_tag);
g_free (new_tag);
}
}
}
Bug 728610 - Code for retrieving the XYZ values of a matrix RGB profile Add two private functions which are currently unused but will become public once it's clear where exactly we need them: gimp_color_profile_get_rgb_matrix_colorants(): returns a GimpMatrix2 with the RGB colorants. gimp_color_profile_new_foobar(): takes an existing profile and creates a new one with the same RGB colorants but a linear gamma TRC. To be renamed and made more general.
2015-08-22 05:29:39 +08:00
static GimpColorProfile *
libgimpcolor: add API to create profile variants with linear/sRGB gamma and the original profile's RGB chromacities and whitepoint.
2015-10-21 02:12:18 +08:00
gimp_color_profile_new_from_color_profile (GimpColorProfile *profile,
gboolean linear)
Bug 728610 - Code for retrieving the XYZ values of a matrix RGB profile Add two private functions which are currently unused but will become public once it's clear where exactly we need them: gimp_color_profile_get_rgb_matrix_colorants(): returns a GimpMatrix2 with the RGB colorants. gimp_color_profile_new_foobar(): takes an existing profile and creates a new one with the same RGB colorants but a linear gamma TRC. To be renamed and made more general.
2015-08-22 05:29:39 +08:00
{
GimpColorProfile *new_profile;
cmsHPROFILE target_profile;
Bug 761170: Warnings building with clang Fix some of the warnings.
2017-07-14 19:10:46 +08:00
GimpMatrix3 matrix = { { { 0, } } };
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
cmsCIEXYZ *whitepoint;
cmsToneCurve *curve;
Bug 728610 - Code for retrieving the XYZ values of a matrix RGB profile Add two private functions which are currently unused but will become public once it's clear where exactly we need them: gimp_color_profile_get_rgb_matrix_colorants(): returns a GimpMatrix2 with the RGB colorants. gimp_color_profile_new_foobar(): takes an existing profile and creates a new one with the same RGB colorants but a linear gamma TRC. To be renamed and made more general.
2015-08-22 05:29:39 +08:00
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
Bug 756389 - Color-managing grayscale images Support creating linear/sRGB-gamma variants of gray profiles and rename gimp_color_profile_new_linear_rgb_from_color_profile() to gimp_color_profile_new_linear_gamma_from_color_profile() because it's not RGB-specific any longer.
2015-12-14 06:36:31 +08:00
if (gimp_color_profile_is_rgb (profile))
{
if (! gimp_color_profile_get_rgb_matrix_colorants (profile, &matrix))
return NULL;
}
else if (! gimp_color_profile_is_gray (profile))
{
return NULL;
}
Bug 728610 - Code for retrieving the XYZ values of a matrix RGB profile Add two private functions which are currently unused but will become public once it's clear where exactly we need them: gimp_color_profile_get_rgb_matrix_colorants(): returns a GimpMatrix2 with the RGB colorants. gimp_color_profile_new_foobar(): takes an existing profile and creates a new one with the same RGB colorants but a linear gamma TRC. To be renamed and made more general.
2015-08-22 05:29:39 +08:00
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
whitepoint = cmsReadTag (profile->lcms_profile,
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
cmsSigMediaWhitePointTag);
Bug 728610 - Code for retrieving the XYZ values of a matrix RGB profile Add two private functions which are currently unused but will become public once it's clear where exactly we need them: gimp_color_profile_get_rgb_matrix_colorants(): returns a GimpMatrix2 with the RGB colorants. gimp_color_profile_new_foobar(): takes an existing profile and creates a new one with the same RGB colorants but a linear gamma TRC. To be renamed and made more general.
2015-08-22 05:29:39 +08:00
target_profile = cmsCreateProfilePlaceholder (0);
cmsSetProfileVersion (target_profile, 4.3);
cmsSetDeviceClass (target_profile, cmsSigDisplayClass);
cmsSetPCS (target_profile, cmsSigXYZData);
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
cmsWriteTag (target_profile, cmsSigMediaWhitePointTag, whitepoint);
if (linear)
{
/* linear light */
curve = cmsBuildGamma (NULL, 1.00);
Bug 728610 - Code for retrieving the XYZ values of a matrix RGB profile Add two private functions which are currently unused but will become public once it's clear where exactly we need them: gimp_color_profile_get_rgb_matrix_colorants(): returns a GimpMatrix2 with the RGB colorants. gimp_color_profile_new_foobar(): takes an existing profile and creates a new one with the same RGB colorants but a linear gamma TRC. To be renamed and made more general.
2015-08-22 05:29:39 +08:00
Issue #3057 - Retain last user-chosen ICC profile information... ...when generating "TRC variants" When creating a new profile with different TRC from an existing profile, keep all the original profile's description, model, manufacturer and copyright strings around, but prefix them with "GIMP from " or similar to indicate that they are different. Also make sure we don't prefix strings with GIMP stuff multiple times when profiles are generated repeatedly.
2019-05-31 21:44:07 +08:00
gimp_color_profile_make_tag (target_profile, cmsSigProfileDescriptionTag,
"linear TRC from unnamed profile",
"linear TRC from ",
"sRGB TRC from ",
gimp_color_profile_get_description (profile));
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
}
else
{
cmsFloat64Number srgb_parameters[5] =
{ 2.4, 1.0 / 1.055, 0.055 / 1.055, 1.0 / 12.92, 0.04045 };
/* sRGB curve */
curve = cmsBuildParametricToneCurve (NULL, 4, srgb_parameters);
Issue #3057 - Retain last user-chosen ICC profile information... ...when generating "TRC variants" When creating a new profile with different TRC from an existing profile, keep all the original profile's description, model, manufacturer and copyright strings around, but prefix them with "GIMP from " or similar to indicate that they are different. Also make sure we don't prefix strings with GIMP stuff multiple times when profiles are generated repeatedly.
2019-05-31 21:44:07 +08:00
gimp_color_profile_make_tag (target_profile, cmsSigProfileDescriptionTag,
"sRGB TRC from unnamed profile",
"sRGB TRC from ",
"linear TRC from ",
gimp_color_profile_get_description (profile));
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
}
Bug 756389 - Color-managing grayscale images Support creating linear/sRGB-gamma variants of gray profiles and rename gimp_color_profile_new_linear_rgb_from_color_profile() to gimp_color_profile_new_linear_gamma_from_color_profile() because it's not RGB-specific any longer.
2015-12-14 06:36:31 +08:00
if (gimp_color_profile_is_rgb (profile))
{
cmsCIEXYZ red;
cmsCIEXYZ green;
cmsCIEXYZ blue;
cmsSetColorSpace (target_profile, cmsSigRgbData);
red.X = matrix.coeff[0][0];
red.Y = matrix.coeff[0][1];
red.Z = matrix.coeff[0][2];
green.X = matrix.coeff[1][0];
green.Y = matrix.coeff[1][1];
green.Z = matrix.coeff[1][2];
blue.X = matrix.coeff[2][0];
blue.Y = matrix.coeff[2][1];
blue.Z = matrix.coeff[2][2];
cmsWriteTag (target_profile, cmsSigRedColorantTag, &red);
cmsWriteTag (target_profile, cmsSigGreenColorantTag, &green);
cmsWriteTag (target_profile, cmsSigBlueColorantTag, &blue);
cmsWriteTag (target_profile, cmsSigRedTRCTag, curve);
cmsWriteTag (target_profile, cmsSigGreenTRCTag, curve);
cmsWriteTag (target_profile, cmsSigBlueTRCTag, curve);
}
else
{
cmsSetColorSpace (target_profile, cmsSigGrayData);
cmsWriteTag (target_profile, cmsSigGrayTRCTag, curve);
}
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
cmsFreeToneCurve (curve);
Bug 728610 - Code for retrieving the XYZ values of a matrix RGB profile Add two private functions which are currently unused but will become public once it's clear where exactly we need them: gimp_color_profile_get_rgb_matrix_colorants(): returns a GimpMatrix2 with the RGB colorants. gimp_color_profile_new_foobar(): takes an existing profile and creates a new one with the same RGB colorants but a linear gamma TRC. To be renamed and made more general.
2015-08-22 05:29:39 +08:00
Issue #3057 - Retain last user-chosen ICC profile information... ...when generating "TRC variants" When creating a new profile with different TRC from an existing profile, keep all the original profile's description, model, manufacturer and copyright strings around, but prefix them with "GIMP from " or similar to indicate that they are different. Also make sure we don't prefix strings with GIMP stuff multiple times when profiles are generated repeatedly.
2019-05-31 21:44:07 +08:00
gimp_color_profile_make_tag (target_profile, cmsSigDeviceMfgDescTag,
"GIMP",
"GIMP from ", NULL,
gimp_color_profile_get_manufacturer (profile));
gimp_color_profile_make_tag (target_profile, cmsSigDeviceModelDescTag,
"Generated by GIMP",
"GIMP from ", NULL,
gimp_color_profile_get_model (profile));
gimp_color_profile_make_tag (target_profile, cmsSigCopyrightTag,
"Public Domain",
"GIMP from ", NULL,
gimp_color_profile_get_copyright (profile));
libgimpcolor: add API to create profile variants with linear/sRGB gamma and the original profile's RGB chromacities and whitepoint.
2015-10-21 02:12:18 +08:00
Bug 728610 - Code for retrieving the XYZ values of a matrix RGB profile Add two private functions which are currently unused but will become public once it's clear where exactly we need them: gimp_color_profile_get_rgb_matrix_colorants(): returns a GimpMatrix2 with the RGB colorants. gimp_color_profile_new_foobar(): takes an existing profile and creates a new one with the same RGB colorants but a linear gamma TRC. To be renamed and made more general.
2015-08-22 05:29:39 +08:00
new_profile = gimp_color_profile_new_from_lcms_profile (target_profile, NULL);
cmsCloseProfile (target_profile);
return new_profile;
}
libgimpcolor: add API to create profile variants with linear/sRGB gamma and the original profile's RGB chromacities and whitepoint.
2015-10-21 02:12:18 +08:00
/**
Bug 756389 - Color-managing grayscale images Rename profile constructors to say "d65_gray" instead of just "gray", "srgb_trc" instead of "srgb_gamma", and drop the "srgb" from "srgb_linear" because we now say "d65". This should be a naming scheme that doesn't conflict with whatever future functions we might add.
2016-04-10 00:47:51 +08:00
* gimp_color_profile_new_srgb_trc_from_color_profile:
libgimpcolor: add API to create profile variants with linear/sRGB gamma and the original profile's RGB chromacities and whitepoint.
2015-10-21 02:12:18 +08:00
* @profile: a #GimpColorProfile
*
* This function creates a new RGB #GimpColorProfile with a sRGB gamma
* TRC and @profile's RGB chromacities and whitepoint.
*
Add (nullable) if applicable Basically this commit makes sure that all return values that are marked as "Returns:" also have a `(nullable)` annotation if it is mentioned on the same line that NULL can also be returned. This will prevent a few problems in GObject-introspection.
2019-08-03 06:36:59 +08:00
* Returns: (nullable) (transfer full): the new #GimpColorProfile, or %NULL if
libgimp*: fix various missing (transfer) annotations.
2019-08-01 07:52:07 +08:00
* @profile is not an RGB profile or not matrix-based.
libgimpcolor: add API to create profile variants with linear/sRGB gamma and the original profile's RGB chromacities and whitepoint.
2015-10-21 02:12:18 +08:00
*
* Since: 2.10
**/
GimpColorProfile *
Bug 756389 - Color-managing grayscale images Rename profile constructors to say "d65_gray" instead of just "gray", "srgb_trc" instead of "srgb_gamma", and drop the "srgb" from "srgb_linear" because we now say "d65". This should be a naming scheme that doesn't conflict with whatever future functions we might add.
2016-04-10 00:47:51 +08:00
gimp_color_profile_new_srgb_trc_from_color_profile (GimpColorProfile *profile)
libgimpcolor: add API to create profile variants with linear/sRGB gamma and the original profile's RGB chromacities and whitepoint.
2015-10-21 02:12:18 +08:00
{
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
return gimp_color_profile_new_from_color_profile (profile, FALSE);
}
/**
Bug 756389 - Color-managing grayscale images Rename profile constructors to say "d65_gray" instead of just "gray", "srgb_trc" instead of "srgb_gamma", and drop the "srgb" from "srgb_linear" because we now say "d65". This should be a naming scheme that doesn't conflict with whatever future functions we might add.
2016-04-10 00:47:51 +08:00
* gimp_color_profile_new_linear_from_color_profile:
libgimpcolor: add API to create profile variants with linear/sRGB gamma and the original profile's RGB chromacities and whitepoint.
2015-10-21 02:12:18 +08:00
* @profile: a #GimpColorProfile
*
* This function creates a new RGB #GimpColorProfile with a linear TRC
* and @profile's RGB chromacities and whitepoint.
*
Add (nullable) if applicable Basically this commit makes sure that all return values that are marked as "Returns:" also have a `(nullable)` annotation if it is mentioned on the same line that NULL can also be returned. This will prevent a few problems in GObject-introspection.
2019-08-03 06:36:59 +08:00
* Returns: (nullable) (transfer full): the new #GimpColorProfile, or %NULL if
libgimp*: fix various missing (transfer) annotations.
2019-08-01 07:52:07 +08:00
* @profile is not an RGB profile or not matrix-based.
libgimpcolor: add API to create profile variants with linear/sRGB gamma and the original profile's RGB chromacities and whitepoint.
2015-10-21 02:12:18 +08:00
*
* Since: 2.10
**/
GimpColorProfile *
Bug 756389 - Color-managing grayscale images Rename profile constructors to say "d65_gray" instead of just "gray", "srgb_trc" instead of "srgb_gamma", and drop the "srgb" from "srgb_linear" because we now say "d65". This should be a naming scheme that doesn't conflict with whatever future functions we might add.
2016-04-10 00:47:51 +08:00
gimp_color_profile_new_linear_from_color_profile (GimpColorProfile *profile)
libgimpcolor: add API to create profile variants with linear/sRGB gamma and the original profile's RGB chromacities and whitepoint.
2015-10-21 02:12:18 +08:00
{
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
return gimp_color_profile_new_from_color_profile (profile, TRUE);
}
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
static cmsHPROFILE *
libgimpcolor: rename RGB and GRAY gimp_color_profile_new_*() functions to be more consistent, as discussed in bug #756389.
2015-12-16 03:42:21 +08:00
gimp_color_profile_new_rgb_srgb_internal (void)
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
{
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
cmsHPROFILE profile;
libgimpcolor: comment out line that makes V2 profile and add more docs
2014-02-10 22:42:39 +08:00
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
/* white point is D65 from the sRGB specs */
cmsCIExyY whitepoint = { 0.3127, 0.3290, 1.0 };
/* primaries are ITU‐R BT.709‐5 (xYY), which are also the primaries
* from the sRGB specs, modified to properly account for hexadecimal
* quantization during the profile making process.
*/
cmsCIExyYTRIPLE primaries =
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
{
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
/* R { 0.6400, 0.3300, 1.0 }, */
/* G { 0.3000, 0.6000, 1.0 }, */
/* B { 0.1500, 0.0600, 1.0 } */
/* R */ { 0.639998686, 0.330010138, 1.0 },
/* G */ { 0.300003784, 0.600003357, 1.0 },
/* B */ { 0.150002046, 0.059997204, 1.0 }
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
};
cmsFloat64Number srgb_parameters[5] =
{ 2.4, 1.0 / 1.055, 0.055 / 1.055, 1.0 / 12.92, 0.04045 };
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
cmsToneCurve *curve[3];
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
/* sRGB curve */
curve[0] = curve[1] = curve[2] = cmsBuildParametricToneCurve (NULL, 4,
srgb_parameters);
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
profile = cmsCreateRGBProfile (&whitepoint, &primaries, curve);
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
cmsFreeToneCurve (curve[0]);
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_set_tag (profile, cmsSigProfileDescriptionTag,
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
"GIMP built-in sRGB");
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_set_tag (profile, cmsSigDeviceMfgDescTag,
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
"GIMP");
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_set_tag (profile, cmsSigDeviceModelDescTag,
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
"sRGB");
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
gimp_color_profile_set_tag (profile, cmsSigCopyrightTag,
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
"Public Domain");
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
libgimpcolor: add some missing API docs
2015-05-31 08:47:24 +08:00
/* The following line produces a V2 profile with a point curve TRC.
libgimpcolor: comment out line that makes V2 profile and add more docs
2014-02-10 22:42:39 +08:00
* Profiles with point curve TRCs can't be used in LCMS2 unbounded
* mode ICC profile conversions. A V2 profile might be appropriate
* for embedding in sRGB images saved to disk, if the image is to be
* opened by an image editing application that doesn't understand V4
* profiles.
*
* cmsSetProfileVersion (srgb_profile, 2.1);
libgimpcolor: add some missing API docs
2015-05-31 08:47:24 +08:00
*/
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
return profile;
Bug 723787 - Neutral sRGB profile matching Argyllcms sRGB.icm Add gimp_lcms_create_srgb_profile() to libgimpcolor and use it where we used to call cmsCreate_sRGBProfile().
2014-02-06 22:53:37 +08:00
}
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
/**
libgimpcolor: rename RGB and GRAY gimp_color_profile_new_*() functions to be more consistent, as discussed in bug #756389.
2015-12-16 03:42:21 +08:00
* gimp_color_profile_new_rgb_srgb:
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
*
* This function is a replacement for cmsCreate_sRGBProfile() and
* returns an sRGB profile that is functionally the same as the
* ArgyllCMS sRGB.icm profile. "Functionally the same" means it has
* the same red, green, and blue colorants and the V4 "chad"
* equivalent of the ArgyllCMS V2 white point. The profile TRC is also
* functionally equivalent to the ArgyllCMS sRGB.icm TRC and is the
* same as the LCMS sRGB built-in profile TRC.
*
* The actual primaries in the sRGB specification are
* red xy: {0.6400, 0.3300, 1.0}
* green xy: {0.3000, 0.6000, 1.0}
* blue xy: {0.1500, 0.0600, 1.0}
*
* The sRGB primaries given below are "pre-quantized" to compensate
* for hexadecimal quantization during the profile-making process.
* Unless the profile-making code compensates for this quantization,
* the resulting profile's red, green, and blue colorants will deviate
* slightly from the correct XYZ values.
*
* LCMS2 doesn't compensate for hexadecimal quantization. The
* "pre-quantized" primaries below were back-calculated from the
* ArgyllCMS sRGB.icm profile. The resulting sRGB profile's colorants
* exactly matches the ArgyllCMS sRGB.icm profile colorants.
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: the sRGB #GimpColorProfile.
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
**/
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
GimpColorProfile *
libgimpcolor: rename RGB and GRAY gimp_color_profile_new_*() functions to be more consistent, as discussed in bug #756389.
2015-12-16 03:42:21 +08:00
gimp_color_profile_new_rgb_srgb (void)
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
{
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
static GimpColorProfile *profile = NULL;
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
const guint8 *data;
libgimpcolor: Remove warnings about uninitialized variables While `length` is always assigned a value by gimp_color_profile_get_icc_profile (), some compilers don't recognize this and warn about it being uninitialized. This assigns six instance of `length` to 0 when declared to remove the warnings.
2023-08-18 18:54:06 +08:00
gsize length = 0;
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
if (G_UNLIKELY (profile == NULL))
{
libgimpcolor: rename RGB and GRAY gimp_color_profile_new_*() functions to be more consistent, as discussed in bug #756389.
2015-12-16 03:42:21 +08:00
cmsHPROFILE lcms_profile = gimp_color_profile_new_rgb_srgb_internal ();
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
profile = gimp_color_profile_new_from_lcms_profile (lcms_profile, NULL);
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
cmsCloseProfile (lcms_profile);
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
}
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
data = gimp_color_profile_get_icc_profile (profile, &length);
return gimp_color_profile_new_from_icc_profile (data, length, NULL);
Bug 727185 - Converting to GIMP built-in sRGB produces the wrong RGB values Profiles from disk have a lower precision than those created from scratch via lcms API. Ensure identical profiles by returning a "loaded" profile from gimp_lcms_create_srgb_profile() (simply do a save/load roundtrip in memory).
2014-04-10 22:30:04 +08:00
}
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
static cmsHPROFILE
libgimpcolor: rename RGB and GRAY gimp_color_profile_new_*() functions to be more consistent, as discussed in bug #756389.
2015-12-16 03:42:21 +08:00
gimp_color_profile_new_rgb_srgb_linear_internal (void)
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
{
cmsHPROFILE profile;
/* white point is D65 from the sRGB specs */
cmsCIExyY whitepoint = { 0.3127, 0.3290, 1.0 };
/* primaries are ITU‐R BT.709‐5 (xYY), which are also the primaries
* from the sRGB specs, modified to properly account for hexadecimal
* quantization during the profile making process.
*/
cmsCIExyYTRIPLE primaries =
{
/* R { 0.6400, 0.3300, 1.0 }, */
/* G { 0.3000, 0.6000, 1.0 }, */
/* B { 0.1500, 0.0600, 1.0 } */
/* R */ { 0.639998686, 0.330010138, 1.0 },
/* G */ { 0.300003784, 0.600003357, 1.0 },
/* B */ { 0.150002046, 0.059997204, 1.0 }
};
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
cmsToneCurve *curve[3];
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
/* linear light */
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
curve[0] = curve[1] = curve[2] = cmsBuildGamma (NULL, 1.0);
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
profile = cmsCreateRGBProfile (&whitepoint, &primaries, curve);
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
cmsFreeToneCurve (curve[0]);
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
gimp_color_profile_set_tag (profile, cmsSigProfileDescriptionTag,
Bug 764772 - Change GIMP-generated profile names to be more accurate
2016-04-08 18:01:35 +08:00
"GIMP built-in Linear sRGB");
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
gimp_color_profile_set_tag (profile, cmsSigDeviceMfgDescTag,
"GIMP");
gimp_color_profile_set_tag (profile, cmsSigDeviceModelDescTag,
Bug 764772 - Change GIMP-generated profile names to be more accurate
2016-04-08 18:01:35 +08:00
"Linear sRGB");
libgimpcolor: rename the gimp_lcms_*() functions to gimp_color_profile_*() because it doesn't make sense to call the typedef GimpColorProfile but the function namespace gimp_lcms_*().
2015-06-03 15:41:23 +08:00
gimp_color_profile_set_tag (profile, cmsSigCopyrightTag,
"Public Domain");
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
return profile;
}
/**
libgimpcolor: rename RGB and GRAY gimp_color_profile_new_*() functions to be more consistent, as discussed in bug #756389.
2015-12-16 03:42:21 +08:00
* gimp_color_profile_new_rgb_srgb_linear:
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
*
* This function creates a profile for babl_model("RGB"). Please
Bug 795161 - Misc. typo fixes in source comments and doxygen Found via `codespell` Follow-up to commit 7fdb963e018c5413036bc1dd547c7a812e20302d
2018-04-19 02:57:03 +08:00
* somebody write something smarter here.
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: the linear RGB #GimpColorProfile.
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
**/
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
GimpColorProfile *
libgimpcolor: rename RGB and GRAY gimp_color_profile_new_*() functions to be more consistent, as discussed in bug #756389.
2015-12-16 03:42:21 +08:00
gimp_color_profile_new_rgb_srgb_linear (void)
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
{
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
static GimpColorProfile *profile = NULL;
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
const guint8 *data;
libgimpcolor: Remove warnings about uninitialized variables While `length` is always assigned a value by gimp_color_profile_get_icc_profile (), some compilers don't recognize this and warn about it being uninitialized. This assigns six instance of `length` to 0 when declared to remove the warnings.
2023-08-18 18:54:06 +08:00
gsize length = 0;
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
if (G_UNLIKELY (profile == NULL))
{
libgimpcolor: rename RGB and GRAY gimp_color_profile_new_*() functions to be more consistent, as discussed in bug #756389.
2015-12-16 03:42:21 +08:00
cmsHPROFILE lcms_profile = gimp_color_profile_new_rgb_srgb_linear_internal ();
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
profile = gimp_color_profile_new_from_lcms_profile (lcms_profile, NULL);
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
cmsCloseProfile (lcms_profile);
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
}
libgimpcolor, *: change GimpColorProfile to be a GObject it used to be a typedef to gpointer and actually was a cmsHPROFILE. Change its API to be more "standard", remove the public close() function. The object caches both the cmsHPROFILE and the data/length ICC blob, so conversions between the two become obsolete (simply call get_lcms_profile() or get_icc_profile()). Adapt everything to the new API, but port it in a naive way for now, the code doesn't take advantage of the new possibilities yet (like refcounting).
2015-07-11 04:43:53 +08:00
data = gimp_color_profile_get_icc_profile (profile, &length);
return gimp_color_profile_new_from_icc_profile (data, length, NULL);
libgimpcolor: add gimp_lcms_add_linear_rgb_profile() taken from gegl:lcms-from-profile.
2015-05-13 04:47:12 +08:00
}
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
static cmsHPROFILE *
libgimpcolor: rename RGB and GRAY gimp_color_profile_new_*() functions to be more consistent, as discussed in bug #756389.
2015-12-16 03:42:21 +08:00
gimp_color_profile_new_rgb_adobe_internal (void)
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
{
cmsHPROFILE profile;
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
/* white point is D65 from the sRGB specs */
cmsCIExyY whitepoint = { 0.3127, 0.3290, 1.0 };
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
/* AdobeRGB1998 and sRGB have the same white point.
*
* The primaries below are technically correct, but because of
* hexadecimal rounding these primaries don't make a profile that
* matches the original.
*
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
* cmsCIExyYTRIPLE primaries = {
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
* { 0.6400, 0.3300, 1.0 },
* { 0.2100, 0.7100, 1.0 },
* { 0.1500, 0.0600, 1.0 }
* };
*/
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
cmsCIExyYTRIPLE primaries =
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
{
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
{ 0.639996511, 0.329996864, 1.0 },
{ 0.210005295, 0.710004866, 1.0 },
{ 0.149997606, 0.060003644, 1.0 }
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
};
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
cmsToneCurve *curve[3];
/* gamma 2.2 */
curve[0] = curve[1] = curve[2] = cmsBuildGamma (NULL, 2.19921875);
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
profile = cmsCreateRGBProfile (&whitepoint, &primaries, curve);
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
libgimpcolor: clean up profile creation in GimpColorProfile Use shorter and consistent local variable names, improve the unused function that creates a linear/sRGB-gamma profile from another RGB profile.
2015-10-19 07:14:35 +08:00
cmsFreeToneCurve (curve[0]);
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
gimp_color_profile_set_tag (profile, cmsSigProfileDescriptionTag,
"Compatible with Adobe RGB (1998)");
gimp_color_profile_set_tag (profile, cmsSigDeviceMfgDescTag,
"GIMP");
gimp_color_profile_set_tag (profile, cmsSigDeviceModelDescTag,
"Compatible with Adobe RGB (1998)");
gimp_color_profile_set_tag (profile, cmsSigCopyrightTag,
"Public Domain");
return profile;
}
/**
libgimpcolor: rename RGB and GRAY gimp_color_profile_new_*() functions to be more consistent, as discussed in bug #756389.
2015-12-16 03:42:21 +08:00
* gimp_color_profile_new_rgb_adobe:
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
*
* This function creates a profile compatible with AbobeRGB (1998).
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: the AdobeRGB-compatible #GimpColorProfile.
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
*
* Since: 2.10
**/
GimpColorProfile *
libgimpcolor: rename RGB and GRAY gimp_color_profile_new_*() functions to be more consistent, as discussed in bug #756389.
2015-12-16 03:42:21 +08:00
gimp_color_profile_new_rgb_adobe (void)
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
{
static GimpColorProfile *profile = NULL;
const guint8 *data;
libgimpcolor: Remove warnings about uninitialized variables While `length` is always assigned a value by gimp_color_profile_get_icc_profile (), some compilers don't recognize this and warn about it being uninitialized. This assigns six instance of `length` to 0 when declared to remove the warnings.
2023-08-18 18:54:06 +08:00
gsize length = 0;
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
if (G_UNLIKELY (profile == NULL))
{
libgimpcolor: rename RGB and GRAY gimp_color_profile_new_*() functions to be more consistent, as discussed in bug #756389.
2015-12-16 03:42:21 +08:00
cmsHPROFILE lcms_profile = gimp_color_profile_new_rgb_adobe_internal ();
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
profile = gimp_color_profile_new_from_lcms_profile (lcms_profile, NULL);
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
cmsCloseProfile (lcms_profile);
}
data = gimp_color_profile_get_icc_profile (profile, &length);
return gimp_color_profile_new_from_icc_profile (data, length, NULL);
}
static cmsHPROFILE *
Bug 756389 - Color-managing grayscale images Rename profile constructors to say "d65_gray" instead of just "gray", "srgb_trc" instead of "srgb_gamma", and drop the "srgb" from "srgb_linear" because we now say "d65". This should be a naming scheme that doesn't conflict with whatever future functions we might add.
2016-04-10 00:47:51 +08:00
gimp_color_profile_new_d65_gray_srgb_trc_internal (void)
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
{
cmsHPROFILE profile;
Revert "libgimpcolor: use D50 for the gray profiles" This reverts commit 169f436e7567cd025dbdb29614b5c7e6f2cff85d. Turns out we should use the same whitepoint for RGB and GRAY.
2015-12-15 01:43:26 +08:00
/* white point is D65 from the sRGB specs */
cmsCIExyY whitepoint = { 0.3127, 0.3290, 1.0 };
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
cmsFloat64Number srgb_parameters[5] =
{ 2.4, 1.0 / 1.055, 0.055 / 1.055, 1.0 / 12.92, 0.04045 };
cmsToneCurve *curve = cmsBuildParametricToneCurve (NULL, 4,
srgb_parameters);
profile = cmsCreateGrayProfile (&whitepoint, curve);
cmsFreeToneCurve (curve);
gimp_color_profile_set_tag (profile, cmsSigProfileDescriptionTag,
Bug 756389 - Color-managing grayscale images Change grayscale profiles to show white point
2016-04-08 19:15:58 +08:00
"GIMP built-in D65 Grayscale with sRGB TRC");
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
gimp_color_profile_set_tag (profile, cmsSigDeviceMfgDescTag,
"GIMP");
gimp_color_profile_set_tag (profile, cmsSigDeviceModelDescTag,
Bug 756389 - Color-managing grayscale images Change grayscale profiles to show white point
2016-04-08 19:15:58 +08:00
"D65 Grayscale with sRGB TRC");
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
gimp_color_profile_set_tag (profile, cmsSigCopyrightTag,
"Public Domain");
return profile;
}
/**
Bug 756389 - Color-managing grayscale images Rename profile constructors to say "d65_gray" instead of just "gray", "srgb_trc" instead of "srgb_gamma", and drop the "srgb" from "srgb_linear" because we now say "d65". This should be a naming scheme that doesn't conflict with whatever future functions we might add.
2016-04-10 00:47:51 +08:00
* gimp_color_profile_new_d65_gray_srgb_trc
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
*
* This function creates a grayscale #GimpColorProfile with an
libgimpcolor: some doc fixes and updates
2017-06-04 03:03:25 +08:00
* sRGB TRC. See gimp_color_profile_new_rgb_srgb().
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: the sRGB-gamma grayscale #GimpColorProfile.
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
*
* Since: 2.10
**/
GimpColorProfile *
Bug 756389 - Color-managing grayscale images Rename profile constructors to say "d65_gray" instead of just "gray", "srgb_trc" instead of "srgb_gamma", and drop the "srgb" from "srgb_linear" because we now say "d65". This should be a naming scheme that doesn't conflict with whatever future functions we might add.
2016-04-10 00:47:51 +08:00
gimp_color_profile_new_d65_gray_srgb_trc (void)
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
{
static GimpColorProfile *profile = NULL;
const guint8 *data;
libgimpcolor: Remove warnings about uninitialized variables While `length` is always assigned a value by gimp_color_profile_get_icc_profile (), some compilers don't recognize this and warn about it being uninitialized. This assigns six instance of `length` to 0 when declared to remove the warnings.
2023-08-18 18:54:06 +08:00
gsize length = 0;
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
if (G_UNLIKELY (profile == NULL))
{
Bug 756389 - Color-managing grayscale images Rename profile constructors to say "d65_gray" instead of just "gray", "srgb_trc" instead of "srgb_gamma", and drop the "srgb" from "srgb_linear" because we now say "d65". This should be a naming scheme that doesn't conflict with whatever future functions we might add.
2016-04-10 00:47:51 +08:00
cmsHPROFILE lcms_profile = gimp_color_profile_new_d65_gray_srgb_trc_internal ();
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
profile = gimp_color_profile_new_from_lcms_profile (lcms_profile, NULL);
cmsCloseProfile (lcms_profile);
}
data = gimp_color_profile_get_icc_profile (profile, &length);
return gimp_color_profile_new_from_icc_profile (data, length, NULL);
}
static cmsHPROFILE
Bug 756389 - Color-managing grayscale images Rename profile constructors to say "d65_gray" instead of just "gray", "srgb_trc" instead of "srgb_gamma", and drop the "srgb" from "srgb_linear" because we now say "d65". This should be a naming scheme that doesn't conflict with whatever future functions we might add.
2016-04-10 00:47:51 +08:00
gimp_color_profile_new_d65_gray_linear_internal (void)
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
{
cmsHPROFILE profile;
Revert "libgimpcolor: use D50 for the gray profiles" This reverts commit 169f436e7567cd025dbdb29614b5c7e6f2cff85d. Turns out we should use the same whitepoint for RGB and GRAY.
2015-12-15 01:43:26 +08:00
/* white point is D65 from the sRGB specs */
cmsCIExyY whitepoint = { 0.3127, 0.3290, 1.0 };
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
cmsToneCurve *curve = cmsBuildGamma (NULL, 1.0);
profile = cmsCreateGrayProfile (&whitepoint, curve);
cmsFreeToneCurve (curve);
gimp_color_profile_set_tag (profile, cmsSigProfileDescriptionTag,
Bug 756389 - Color-managing grayscale images Change grayscale profiles to show white point
2016-04-08 19:15:58 +08:00
"GIMP built-in D65 Linear Grayscale");
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
gimp_color_profile_set_tag (profile, cmsSigDeviceMfgDescTag,
"GIMP");
gimp_color_profile_set_tag (profile, cmsSigDeviceModelDescTag,
Bug 756389 - Color-managing grayscale images Change grayscale profiles to show white point
2016-04-08 19:15:58 +08:00
"D65 Linear Grayscale");
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
gimp_color_profile_set_tag (profile, cmsSigCopyrightTag,
"Public Domain");
return profile;
}
/**
Bug 756389 - Color-managing grayscale images Rename profile constructors to say "d65_gray" instead of just "gray", "srgb_trc" instead of "srgb_gamma", and drop the "srgb" from "srgb_linear" because we now say "d65". This should be a naming scheme that doesn't conflict with whatever future functions we might add.
2016-04-10 00:47:51 +08:00
* gimp_color_profile_new_d65_gray_srgb_gray:
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
*
* This function creates a profile for babl_model("Y"). Please
Bug 795161 - Misc. typo fixes in source comments and doxygen Found via `codespell` Follow-up to commit 7fdb963e018c5413036bc1dd547c7a812e20302d
2018-04-19 02:57:03 +08:00
* somebody write something smarter here.
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: the linear grayscale #GimpColorProfile.
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
*
* Since: 2.10
**/
GimpColorProfile *
Bug 756389 - Color-managing grayscale images Rename profile constructors to say "d65_gray" instead of just "gray", "srgb_trc" instead of "srgb_gamma", and drop the "srgb" from "srgb_linear" because we now say "d65". This should be a naming scheme that doesn't conflict with whatever future functions we might add.
2016-04-10 00:47:51 +08:00
gimp_color_profile_new_d65_gray_linear (void)
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
{
static GimpColorProfile *profile = NULL;
const guint8 *data;
libgimpcolor: Remove warnings about uninitialized variables While `length` is always assigned a value by gimp_color_profile_get_icc_profile (), some compilers don't recognize this and warn about it being uninitialized. This assigns six instance of `length` to 0 when declared to remove the warnings.
2023-08-18 18:54:06 +08:00
gsize length = 0;
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
if (G_UNLIKELY (profile == NULL))
{
Bug 756389 - Color-managing grayscale images Rename profile constructors to say "d65_gray" instead of just "gray", "srgb_trc" instead of "srgb_gamma", and drop the "srgb" from "srgb_linear" because we now say "d65". This should be a naming scheme that doesn't conflict with whatever future functions we might add.
2016-04-10 00:47:51 +08:00
cmsHPROFILE lcms_profile = gimp_color_profile_new_d65_gray_linear_internal ();
Bug 756389 - Color-managing grayscale images Add gimp_color_profile_new_srgb_gray() and gimp_color_profile_new_linear_gray(). I know "srgb_gray" sounds odd but it's better than "gray_with_srgb_trc"... Please review, I have no clue if that code is right.
2015-12-14 02:43:02 +08:00
profile = gimp_color_profile_new_from_lcms_profile (lcms_profile, NULL);
Bug 492048 - Detect color space in Exif 2.21/DCF 2.0 option files Add gimp_color_profile_new_adobe_rgb(), will need this later to fix this bug.
2015-08-20 05:10:56 +08:00
cmsCloseProfile (lcms_profile);
}
data = gimp_color_profile_get_icc_profile (profile, &length);
return gimp_color_profile_new_from_icc_profile (data, length, NULL);
}
Make grayscale profile with LAB companding curve TRC
2016-04-21 05:01:17 +08:00
static cmsHPROFILE *
gimp_color_profile_new_d50_gray_lab_trc_internal (void)
{
cmsHPROFILE profile;
/* white point is D50 from the ICC profile illuminant specs */
cmsCIExyY whitepoint = {0.345702915, 0.358538597, 1.0};
cmsFloat64Number lab_parameters[5] =
{ 3.0, 1.0 / 1.16, 0.16 / 1.16, 2700.0 / 24389.0, 0.08000 };
cmsToneCurve *curve = cmsBuildParametricToneCurve (NULL, 4,
lab_parameters);
profile = cmsCreateGrayProfile (&whitepoint, curve);
cmsFreeToneCurve (curve);
gimp_color_profile_set_tag (profile, cmsSigProfileDescriptionTag,
"GIMP built-in D50 Grayscale with LAB L TRC");
gimp_color_profile_set_tag (profile, cmsSigDeviceMfgDescTag,
"GIMP");
gimp_color_profile_set_tag (profile, cmsSigDeviceModelDescTag,
"D50 Grayscale with LAB L TRC");
gimp_color_profile_set_tag (profile, cmsSigCopyrightTag,
"Public Domain");
return profile;
}
/**
* gimp_color_profile_new_d50_gray_lab_trc
*
* This function creates a grayscale #GimpColorProfile with the
* D50 ICC profile illuminant as the profile white point and the
* LAB companding curve as the TRC.
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: a gray profile with the D50 ICC profile illuminant
Make grayscale profile with LAB companding curve TRC
2016-04-21 05:01:17 +08:00
* as the profile white point and the LAB companding curve as the TRC.
* as the TRC.
*
* Since: 2.10
**/
GimpColorProfile *
gimp_color_profile_new_d50_gray_lab_trc (void)
{
static GimpColorProfile *profile = NULL;
const guint8 *data;
libgimpcolor: Remove warnings about uninitialized variables While `length` is always assigned a value by gimp_color_profile_get_icc_profile (), some compilers don't recognize this and warn about it being uninitialized. This assigns six instance of `length` to 0 when declared to remove the warnings.
2023-08-18 18:54:06 +08:00
gsize length = 0;
Make grayscale profile with LAB companding curve TRC
2016-04-21 05:01:17 +08:00
if (G_UNLIKELY (profile == NULL))
{
cmsHPROFILE lcms_profile = gimp_color_profile_new_d50_gray_lab_trc_internal ();
profile = gimp_color_profile_new_from_lcms_profile (lcms_profile, NULL);
cmsCloseProfile (lcms_profile);
}
data = gimp_color_profile_get_icc_profile (profile, &length);
return gimp_color_profile_new_from_icc_profile (data, length, NULL);
}
libgimpcolor: add gimp_color_profile_get_space() which returns the Babl space matching the profile.
2018-07-16 20:06:32 +08:00
/**
* gimp_color_profile_get_space:
* @profile: a #GimpColorProfile
* @intent: a #GimpColorRenderingIntent
* @error: return location for #GError
*
* This function returns the #Babl space of @profile, for the
* specified @intent.
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: the new #Babl space.
libgimpcolor: add gimp_color_profile_get_space() which returns the Babl space matching the profile.
2018-07-16 20:06:32 +08:00
*
* Since: 2.10.6
**/
const Babl *
gimp_color_profile_get_space (GimpColorProfile *profile,
GimpColorRenderingIntent intent,
GError **error)
{
const Babl *space;
const gchar *babl_error = NULL;
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
g_return_val_if_fail (error == NULL || *error == NULL, NULL);
libgimpcolor: Make GimpColorProfile a final type
2024-07-28 13:28:31 +08:00
space = babl_space_from_icc ((const gchar *) profile->data,
profile->length,
libgimpcolor: add gimp_color_profile_get_space() which returns the Babl space matching the profile.
2018-07-16 20:06:32 +08:00
(BablIccIntent) intent,
&babl_error);
if (! space)
g_set_error (error, GIMP_COLOR_PROFILE_ERROR, 0,
"%s: %s",
gimp_color_profile_get_label (profile), babl_error);
return space;
}
libgimpcolor: add a new gimp_color_profile_get_format() which takes a GimpColorProfile and a Babl format, and returns a new format which uses the profile's RGB primaries and TRC, and the original format's pixel layout; or NULL if babl couldn't create a space from the profile's ICC data.
2017-09-03 02:29:29 +08:00
/**
* gimp_color_profile_get_format:
* @profile: a #GimpColorProfile
* @format: a #Babl format
libgimpcolor: add gimp_color_profile_get_space() which returns the Babl space matching the profile.
2018-07-16 20:06:32 +08:00
* @intent: a #GimpColorRenderingIntent
libgimpcolor: add a new gimp_color_profile_get_format() which takes a GimpColorProfile and a Babl format, and returns a new format which uses the profile's RGB primaries and TRC, and the original format's pixel layout; or NULL if babl couldn't create a space from the profile's ICC data.
2017-09-03 02:29:29 +08:00
* @error: return location for #GError
*
* This function takes a #GimpColorProfile and a #Babl format and
* returns a new #Babl format with @profile's RGB primaries and TRC,
* and @format's pixel layout.
*
Use "Returns:" to annotate return values To be able to annotate return values through GObject-introspection, you need to make sure it is tagged with `Returns:` and not something else.
2019-08-03 06:10:14 +08:00
* Returns: the new #Babl format.
libgimpcolor: add a new gimp_color_profile_get_format() which takes a GimpColorProfile and a Babl format, and returns a new format which uses the profile's RGB primaries and TRC, and the original format's pixel layout; or NULL if babl couldn't create a space from the profile's ICC data.
2017-09-03 02:29:29 +08:00
*
* Since: 2.10
**/
const Babl *
libgimpcolor: pass intent to babl_space from icc creation
2017-09-14 06:12:08 +08:00
gimp_color_profile_get_format (GimpColorProfile *profile,
const Babl *format,
GimpColorRenderingIntent intent,
GError **error)
libgimpcolor: add a new gimp_color_profile_get_format() which takes a GimpColorProfile and a Babl format, and returns a new format which uses the profile's RGB primaries and TRC, and the original format's pixel layout; or NULL if babl couldn't create a space from the profile's ICC data.
2017-09-03 02:29:29 +08:00
{
libgimpcolor: add gimp_color_profile_get_space() which returns the Babl space matching the profile.
2018-07-16 20:06:32 +08:00
const Babl *space;
libgimpcolor: add a new gimp_color_profile_get_format() which takes a GimpColorProfile and a Babl format, and returns a new format which uses the profile's RGB primaries and TRC, and the original format's pixel layout; or NULL if babl couldn't create a space from the profile's ICC data.
2017-09-03 02:29:29 +08:00
g_return_val_if_fail (GIMP_IS_COLOR_PROFILE (profile), NULL);
g_return_val_if_fail (format != NULL, NULL);
g_return_val_if_fail (error == NULL || *error == NULL, NULL);
libgimpcolor: add gimp_color_profile_get_space() which returns the Babl space matching the profile.
2018-07-16 20:06:32 +08:00
space = gimp_color_profile_get_space (profile, intent, error);
libgimpcolor: add a new gimp_color_profile_get_format() which takes a GimpColorProfile and a Babl format, and returns a new format which uses the profile's RGB primaries and TRC, and the original format's pixel layout; or NULL if babl couldn't create a space from the profile's ICC data.
2017-09-03 02:29:29 +08:00
if (! space)
libgimpcolor: add gimp_color_profile_get_space() which returns the Babl space matching the profile.
2018-07-16 20:06:32 +08:00
return NULL;
libgimpcolor: add a new gimp_color_profile_get_format() which takes a GimpColorProfile and a Babl format, and returns a new format which uses the profile's RGB primaries and TRC, and the original format's pixel layout; or NULL if babl couldn't create a space from the profile's ICC data.
2017-09-03 02:29:29 +08:00
app, libgimpcolor: handle palette formats across babl_format_with_space() Don't just pass the input format's encoding because that loses the palette. Instead, pass the input format directly so babl_format_with_space() can do its job of preserving the palette.
2019-01-01 23:34:57 +08:00
return babl_format_with_space ((const gchar *) format, space);
libgimpcolor: add a new gimp_color_profile_get_format() which takes a GimpColorProfile and a Babl format, and returns a new format which uses the profile's RGB primaries and TRC, and the original format's pixel layout; or NULL if babl couldn't create a space from the profile's ICC data.
2017-09-03 02:29:29 +08:00
}
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
/**
libgimpcolor: rename gimp_color_profile_get_format() to _get_lcms_format()
2017-09-03 00:47:04 +08:00
* gimp_color_profile_get_lcms_format:
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
* @format: a #Babl format
libgimpcolor: Add missing (out) in gimpcolorprofile
2024-05-11 20:46:10 +08:00
* @lcms_format: (out): return location for an lcms format
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
*
* This function takes a #Babl format and returns the lcms format to
* be used with that @format. It also returns a #Babl format to be
* used instead of the passed @format, which usually is the same as
* @format, unless lcms doesn't support @format.
*
Bug 478528 - Layer and Image previews are not color managed Fix gimp_color_profile_get_format() to return the right format for "cairo-RGB24": simply check for the more special cairo formats first, then check for the general RGB models. Found by Massimo.
2015-09-06 20:12:58 +08:00
* Note that this function currently only supports RGB, RGBA, R'G'B',
libgimpcolor: update docs of gimp_color_profile_get_format()
2016-04-08 04:11:45 +08:00
* R'G'B'A, Y, YA, Y', Y'A and the cairo-RGB24 and cairo-ARGB32 formats.
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
*
Add (nullable) if applicable Basically this commit makes sure that all return values that are marked as "Returns:" also have a `(nullable)` annotation if it is mentioned on the same line that NULL can also be returned. This will prevent a few problems in GObject-introspection.
2019-08-03 06:36:59 +08:00
* Returns: (nullable): the #Babl format to be used instead of @format, or %NULL
libgimpcolor: support "CIE Lab (alpha)" in gimp_color_profile_get_format() Return "RGB(A) float", babl will do the needed conversions.
2017-02-24 19:50:57 +08:00
* if the passed @format is not supported at all.
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
*
Remove the "GIMP" from all "Since: GIMP 2.x" API doc comments because it confuses gtk-doc and breaks some links. Also change the "Index of new symbols in GIMP 2.x" sections to be what seems to be the modern standard (looked at the GLib and GTK+ docs), and update some other stuff.
2015-06-01 03:18:09 +08:00
* Since: 2.10
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
**/
const Babl *
libgimpcolor: rename gimp_color_profile_get_format() to _get_lcms_format()
2017-09-03 00:47:04 +08:00
gimp_color_profile_get_lcms_format (const Babl *format,
guint32 *lcms_format)
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
{
const Babl *output_format = NULL;
const Babl *type;
const Babl *model;
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
const Babl *space;
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
gboolean has_alpha;
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
gboolean rgb = FALSE;
gboolean gray = FALSE;
gboolean cmyk = FALSE;
gboolean linear = FALSE;
gboolean srgb_trc = FALSE;
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
g_return_val_if_fail (format != NULL, NULL);
g_return_val_if_fail (lcms_format != NULL, NULL);
has_alpha = babl_format_has_alpha (format);
type = babl_format_get_type (format, 0);
model = babl_format_get_model (format);
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
space = babl_format_get_space (format);
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
Bug 478528 - Layer and Image previews are not color managed Fix gimp_color_profile_get_format() to return the right format for "cairo-RGB24": simply check for the more special cairo formats first, then check for the general RGB models. Found by Massimo.
2015-09-06 20:12:58 +08:00
if (format == babl_format ("cairo-RGB24"))
libgimpwidgets: support cairo formats in gimp_color_profile_get_format() so color profile transforms can write directly to cairo-RGB24 and cairo-ARGB32 surfaces.
2015-09-03 02:31:31 +08:00
{
libgimpcolor: optimize gimp_color_profile_get_format() for cairo-RGB24 Trick lcms into converting cairo-RGB24 pixels directly, by using TYPE_BGRA_8 on little endian and TYPE_ARGB_8 on big endian. They have the same byte order, and the alpha channel (ignored by lcms anyway) takes the place of the unused byte of cairo-RGB24. This saves two babl conversions around cmsDoTransform().
2016-05-25 18:24:06 +08:00
#if G_BYTE_ORDER == G_LITTLE_ENDIAN
*lcms_format = TYPE_BGRA_8;
#else
*lcms_format = TYPE_ARGB_8;
#endif
libgimpwidgets: support cairo formats in gimp_color_profile_get_format() so color profile transforms can write directly to cairo-RGB24 and cairo-ARGB32 surfaces.
2015-09-03 02:31:31 +08:00
libgimpcolor: optimize gimp_color_profile_get_format() for cairo-RGB24 Trick lcms into converting cairo-RGB24 pixels directly, by using TYPE_BGRA_8 on little endian and TYPE_ARGB_8 on big endian. They have the same byte order, and the alpha channel (ignored by lcms anyway) takes the place of the unused byte of cairo-RGB24. This saves two babl conversions around cmsDoTransform().
2016-05-25 18:24:06 +08:00
return format;
libgimpwidgets: support cairo formats in gimp_color_profile_get_format() so color profile transforms can write directly to cairo-RGB24 and cairo-ARGB32 surfaces.
2015-09-03 02:31:31 +08:00
}
else if (format == babl_format ("cairo-ARGB32"))
{
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
rgb = TRUE;
libgimpwidgets: support cairo formats in gimp_color_profile_get_format() so color profile transforms can write directly to cairo-RGB24 and cairo-ARGB32 surfaces.
2015-09-03 02:31:31 +08:00
}
libgimpcolor: gimp_color_profile_get_format: support premultiplied formats
2016-06-08 06:00:36 +08:00
else if (model == babl_model ("RGB") ||
model == babl_model ("RGBA") ||
model == babl_model ("RaGaBaA"))
Bug 478528 - Layer and Image previews are not color managed Fix gimp_color_profile_get_format() to return the right format for "cairo-RGB24": simply check for the more special cairo formats first, then check for the general RGB models. Found by Massimo.
2015-09-06 20:12:58 +08:00
{
libgimpcolor: add CMYK formats to gimp_color_profile_get_format() Makes the CMYK color selector not crash.
2016-05-27 06:33:56 +08:00
rgb = TRUE;
Bug 478528 - Layer and Image previews are not color managed Fix gimp_color_profile_get_format() to return the right format for "cairo-RGB24": simply check for the more special cairo formats first, then check for the general RGB models. Found by Massimo.
2015-09-06 20:12:58 +08:00
linear = TRUE;
}
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
else if (model == babl_model ("R~G~B~") ||
model == babl_model ("R~G~B~A") ||
model == babl_model ("R~aG~aB~aA"))
{
rgb = TRUE;
srgb_trc = TRUE;
}
libgimpcolor: gimp_color_profile_get_format: support premultiplied formats
2016-06-08 06:00:36 +08:00
else if (model == babl_model ("R'G'B'") ||
model == babl_model ("R'G'B'A") ||
model == babl_model ("R'aG'aB'aA"))
Bug 478528 - Layer and Image previews are not color managed Fix gimp_color_profile_get_format() to return the right format for "cairo-RGB24": simply check for the more special cairo formats first, then check for the general RGB models. Found by Massimo.
2015-09-06 20:12:58 +08:00
{
libgimpcolor: add CMYK formats to gimp_color_profile_get_format() Makes the CMYK color selector not crash.
2016-05-27 06:33:56 +08:00
rgb = TRUE;
libgimpcolor: add support for GRAY profiles in gimp_color_profile_get_format() surprisinly seems to work just fine. Thanks to Roman Lebedev for hinting that this is possible, and for constructing the #defines.
2015-12-15 06:16:38 +08:00
}
libgimpcolor: gimp_color_profile_get_format: support premultiplied formats
2016-06-08 06:00:36 +08:00
else if (model == babl_model ("Y") ||
model == babl_model ("YA") ||
model == babl_model ("YaA"))
libgimpcolor: add support for GRAY profiles in gimp_color_profile_get_format() surprisinly seems to work just fine. Thanks to Roman Lebedev for hinting that this is possible, and for constructing the #defines.
2015-12-15 06:16:38 +08:00
{
gray = TRUE;
linear = TRUE;
}
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
else if (model == babl_model ("Y~") ||
model == babl_model ("Y~A") ||
model == babl_model ("Y~aA"))
{
gray = TRUE;
srgb_trc = TRUE;
}
libgimpcolor: gimp_color_profile_get_format: support premultiplied formats
2016-06-08 06:00:36 +08:00
else if (model == babl_model ("Y'") ||
model == babl_model ("Y'A") ||
model == babl_model ("Y'aA"))
libgimpcolor: add support for GRAY profiles in gimp_color_profile_get_format() surprisinly seems to work just fine. Thanks to Roman Lebedev for hinting that this is possible, and for constructing the #defines.
2015-12-15 06:16:38 +08:00
{
libgimpcolor: add CMYK formats to gimp_color_profile_get_format() Makes the CMYK color selector not crash.
2016-05-27 06:33:56 +08:00
gray = TRUE;
}
libgimpcolor: gimp_color_profile_get_format: support premultiplied formats
2016-06-08 06:00:36 +08:00
else if (model == babl_model ("CMYK"))
#if 0
/* FIXME missing from babl */
|| model == babl_model ("CMYKA"))
#endif
libgimpcolor: add CMYK formats to gimp_color_profile_get_format() Makes the CMYK color selector not crash.
2016-05-27 06:33:56 +08:00
{
cmyk = TRUE;
Bug 478528 - Layer and Image previews are not color managed Fix gimp_color_profile_get_format() to return the right format for "cairo-RGB24": simply check for the more special cairo formats first, then check for the general RGB models. Found by Massimo.
2015-09-06 20:12:58 +08:00
}
Bug 794366 - Crash when using Hue-Chroma on a ProPhotoRGB image Handle "CIE LCH(ab)" in gimp_color_profile_get_lcms_format() as suggested by Massimo.
2018-03-19 01:46:25 +08:00
else if (model == babl_model ("CIE Lab") ||
model == babl_model ("CIE Lab alpha") ||
model == babl_model ("CIE LCH(ab)") ||
model == babl_model ("CIE LCH(ab) alpha"))
libgimpcolor: support "CIE Lab (alpha)" in gimp_color_profile_get_format() Return "RGB(A) float", babl will do the needed conversions.
2017-02-24 19:50:57 +08:00
{
if (has_alpha)
{
*lcms_format = TYPE_RGBA_FLT;
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
return babl_format_with_space ("RGBA float", space);
libgimpcolor: support "CIE Lab (alpha)" in gimp_color_profile_get_format() Return "RGB(A) float", babl will do the needed conversions.
2017-02-24 19:50:57 +08:00
}
else
{
*lcms_format = TYPE_RGB_FLT;
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
return babl_format_with_space ("RGB float", space);
libgimpcolor: support "CIE Lab (alpha)" in gimp_color_profile_get_format() Return "RGB(A) float", babl will do the needed conversions.
2017-02-24 19:50:57 +08:00
}
}
libgimpcolor: handle palette formats in gimp_color_profile_get_format() Return "R'G'B'[A] u8" and "TYPE_RGB[A]_8" and babl and lcms formats. I'm not sure which code triggered the warning about an unhandled format, but now it handles indexed images too.
2016-04-27 06:48:23 +08:00
else if (babl_format_is_palette (format))
{
if (has_alpha)
{
*lcms_format = TYPE_RGBA_8;
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
return babl_format_with_space ("R'G'B'A u8", space);
libgimpcolor: handle palette formats in gimp_color_profile_get_format() Return "R'G'B'[A] u8" and "TYPE_RGB[A]_8" and babl and lcms formats. I'm not sure which code triggered the warning about an unhandled format, but now it handles indexed images too.
2016-04-27 06:48:23 +08:00
}
else
{
*lcms_format = TYPE_RGB_8;
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
return babl_format_with_space ("R'G'B' u8", space);
libgimpcolor: handle palette formats in gimp_color_profile_get_format() Return "R'G'B'[A] u8" and "TYPE_RGB[A]_8" and babl and lcms formats. I'm not sure which code triggered the warning about an unhandled format, but now it handles indexed images too.
2016-04-27 06:48:23 +08:00
}
}
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
else
{
libgimpcolor: better error messages in GimpColorProfile and GimpColorTransform
2019-05-28 23:37:08 +08:00
g_printerr ("format not supported: %s\n"
libgimpwidgets: support cairo formats in gimp_color_profile_get_format() so color profile transforms can write directly to cairo-RGB24 and cairo-ARGB32 surfaces.
2015-09-03 02:31:31 +08:00
"has_alpha = %s\n"
"type = %s\n"
"model = %s\n",
babl_get_name (format),
has_alpha ? "TRUE" : "FALSE",
babl_get_name (type),
babl_get_name (model));
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
g_return_val_if_reached (NULL);
}
*lcms_format = 0;
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
#define FIND_FORMAT_FOR_TYPE(babl_t, lcms_t) \
do \
{ \
if (has_alpha) \
{ \
if (rgb) \
{ \
*lcms_format = TYPE_RGBA_##lcms_t; \
\
if (linear) \
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
output_format = babl_format_with_space ("RGBA " babl_t, \
space); \
else if (srgb_trc) \
output_format = babl_format_with_space ("R~G~B~A " babl_t, \
space); \
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
else \
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
output_format = babl_format_with_space ("R'G'B'A " babl_t, \
space); \
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
} \
else if (gray) \
{ \
*lcms_format = TYPE_GRAYA_##lcms_t; \
\
if (linear) \
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
output_format = babl_format_with_space ("YA " babl_t, \
space); \
else if (srgb_trc) \
output_format = babl_format_with_space ("Y~A " babl_t, \
space); \
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
else \
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
output_format = babl_format_with_space ("Y'A " babl_t, \
space); \
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
} \
else if (cmyk) \
{ \
*lcms_format = TYPE_CMYKA_##lcms_t; \
\
output_format = format; \
} \
} \
else \
{ \
if (rgb) \
{ \
*lcms_format = TYPE_RGB_##lcms_t; \
\
if (linear) \
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
output_format = babl_format_with_space ("RGB " babl_t, \
space); \
else if (srgb_trc) \
output_format = babl_format_with_space ("R~G~B~ " babl_t, \
space); \
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
else \
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
output_format = babl_format_with_space ("R'G'B' " babl_t, \
space); \
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
} \
else if (gray) \
{ \
*lcms_format = TYPE_GRAY_##lcms_t; \
\
if (linear) \
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
output_format = babl_format_with_space ("Y " babl_t, \
space); \
else if (srgb_trc) \
output_format = babl_format_with_space ("Y~ " babl_t, \
space); \
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
else \
libgimpcolor: space invade gimp_color_profile_get_lcms_format() The function was still returning formats without space, and was lacking support for perceptual '~' models.
2019-05-28 06:33:20 +08:00
output_format = babl_format_with_space ("Y' " babl_t, \
space); \
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
} \
else if (cmyk) \
{ \
*lcms_format = TYPE_CMYK_##lcms_t; \
\
output_format = format; \
} \
} \
} \
while (FALSE)
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
if (type == babl_type ("u8"))
FIND_FORMAT_FOR_TYPE ("u8", 8);
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
else if (type == babl_type ("u16"))
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
FIND_FORMAT_FOR_TYPE ("u16", 16);
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
else if (type == babl_type ("half")) /* 16-bit floating point (half) */
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
FIND_FORMAT_FOR_TYPE ("half", HALF_FLT);
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
else if (type == babl_type ("float"))
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
FIND_FORMAT_FOR_TYPE ("float", FLT);
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
else if (type == babl_type ("double"))
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
FIND_FORMAT_FOR_TYPE ("double", DBL);
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
if (*lcms_format == 0)
{
libgimpcolor: gimp_color_profile_get_format: support premultiplied formats
2016-06-08 06:00:36 +08:00
g_printerr ("%s: format %s not supported, "
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
"falling back to float\n",
libgimpcolor: fix error message in gimp_color_profile_get_format()
2015-06-13 02:43:17 +08:00
G_STRFUNC, babl_get_name (format));
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
rgb = ! gray;
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
FIND_FORMAT_FOR_TYPE ("float", FLT);
libgimpcolor: add support for GRAY profiles in gimp_color_profile_get_format() surprisinly seems to work just fine. Thanks to Roman Lebedev for hinting that this is possible, and for constructing the #defines.
2015-12-15 06:16:38 +08:00
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
g_return_val_if_fail (output_format != NULL, NULL);
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
}
libgimpcolor: fix gimp_color_profile_get_lcms_format() for premul formats It doesn't look like LCMS supports premultiplied alpha formats, so we must convert them to the corresponding non-premultiplied formats ourselves.
2018-03-17 00:31:55 +08:00
#undef FIND_FORMAT_FOR_TYPE
libgimpcolor: add gimp_lcms_get_format() Which returns an lcms format given a Babl format. It also returns a Babl format to be used instead of the passed format, but only if lcms doesn't support the passed format.
2015-05-08 18:44:44 +08:00
return output_format;
}