mirror of
https://gitlab.gnome.org/GNOME/gimp.git
synced 2025-07-03 17:33:25 +00:00
89c359ce47
GLib has a specific type for byte arrays: `GBytes` (and it's underlying GType `G_TYPE_BYTES`). By using this type, we can avoid having a `GimpUint8Array` which is a bit cumbersome to use for both the C API, as well as bindings. By using `GBytes`, we allow other languages to pass on byte arrays as they are used to, while the bindings will make sure to do the right thing. In the end, it makes the API a little bit simpler for everyone, and reduces confusion for people who are used to working with byte arrays in other C/GLib based code (and not having 2 different types to denote the same thing). Related: https://gitlab.gnome.org/GNOME/gimp/-/issues/5919
252 lines
6.5 KiB
C
252 lines
6.5 KiB
C
/* LIBGIMP - The GIMP Library
|
|
* Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball
|
|
*
|
|
* gimpimagecolorprofile.c
|
|
*
|
|
* 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
|
|
* Lesser 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
|
|
* <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#include "config.h"
|
|
|
|
#include "gimp.h"
|
|
|
|
|
|
/**
|
|
* gimp_image_get_color_profile:
|
|
* @image: The image.
|
|
*
|
|
* Returns the image's color profile
|
|
*
|
|
* This procedure returns the image's color profile, or NULL if the
|
|
* image has no color profile assigned.
|
|
*
|
|
* Returns: (transfer full): The image's color profile. The returned
|
|
* value must be freed with g_object_unref().
|
|
*
|
|
* Since: 2.10
|
|
**/
|
|
GimpColorProfile *
|
|
gimp_image_get_color_profile (GimpImage *image)
|
|
{
|
|
GBytes *data;
|
|
|
|
data = _gimp_image_get_color_profile (image);
|
|
if (data)
|
|
{
|
|
GimpColorProfile *profile;
|
|
|
|
profile = gimp_color_profile_new_from_icc_profile (g_bytes_get_data (data, NULL),
|
|
g_bytes_get_size (data),
|
|
NULL);
|
|
g_bytes_unref (data);
|
|
|
|
return profile;
|
|
}
|
|
|
|
return NULL;
|
|
}
|
|
|
|
/**
|
|
* gimp_image_set_color_profile:
|
|
* @image: The image.
|
|
* @profile: (nullable): A #GimpColorProfile, or %NULL.
|
|
*
|
|
* Sets the image's color profile
|
|
*
|
|
* This procedure sets the image's color profile.
|
|
*
|
|
* Returns: %TRUE on success.
|
|
*
|
|
* Since: 2.10
|
|
**/
|
|
gboolean
|
|
gimp_image_set_color_profile (GimpImage *image,
|
|
GimpColorProfile *profile)
|
|
{
|
|
const guint8 *data = NULL;
|
|
GBytes *bytes = NULL;
|
|
gboolean ret;
|
|
|
|
g_return_val_if_fail (profile == NULL || GIMP_IS_COLOR_PROFILE (profile),
|
|
FALSE);
|
|
|
|
if (profile)
|
|
{
|
|
gsize l;
|
|
|
|
data = gimp_color_profile_get_icc_profile (profile, &l);
|
|
bytes = g_bytes_new_static (data, l);
|
|
}
|
|
|
|
ret = _gimp_image_set_color_profile (image, bytes);
|
|
|
|
g_bytes_unref (bytes);
|
|
return ret;
|
|
}
|
|
|
|
/**
|
|
* gimp_image_get_simulation_profile:
|
|
* @image: The image.
|
|
*
|
|
* Returns the image's simulation color profile
|
|
*
|
|
* This procedure returns the image's simulation color profile, or NULL if
|
|
* the image has no simulation color profile assigned.
|
|
*
|
|
* Returns: (transfer full): The image's simulation color profile. The
|
|
* returned value must be freed with g_object_unref().
|
|
*
|
|
* Since: 3.0
|
|
**/
|
|
GimpColorProfile *
|
|
gimp_image_get_simulation_profile (GimpImage *image)
|
|
{
|
|
GBytes *data;
|
|
|
|
data = _gimp_image_get_simulation_profile (image);
|
|
if (data)
|
|
{
|
|
GimpColorProfile *profile;
|
|
|
|
profile = gimp_color_profile_new_from_icc_profile (g_bytes_get_data (data, NULL),
|
|
g_bytes_get_size (data),
|
|
NULL);
|
|
g_bytes_unref (data);
|
|
|
|
return profile;
|
|
}
|
|
|
|
return NULL;
|
|
}
|
|
|
|
/**
|
|
* gimp_image_set_simulation_profile:
|
|
* @image: The image.
|
|
* @profile: A #GimpColorProfile, or %NULL.
|
|
*
|
|
* Sets the image's simulation color profile
|
|
*
|
|
* This procedure sets the image's simulation color profile.
|
|
*
|
|
* Returns: %TRUE on success.
|
|
*
|
|
* Since: 3.0
|
|
**/
|
|
gboolean
|
|
gimp_image_set_simulation_profile (GimpImage *image,
|
|
GimpColorProfile *profile)
|
|
{
|
|
const guint8 *data = NULL;
|
|
GBytes *bytes = NULL;
|
|
gboolean ret;
|
|
|
|
g_return_val_if_fail (profile == NULL || GIMP_IS_COLOR_PROFILE (profile),
|
|
FALSE);
|
|
|
|
if (profile)
|
|
{
|
|
gsize l;
|
|
|
|
data = gimp_color_profile_get_icc_profile (profile, &l);
|
|
bytes = g_bytes_new_static (data, l);
|
|
}
|
|
|
|
ret = _gimp_image_set_simulation_profile (image, bytes);
|
|
g_bytes_unref (bytes);
|
|
return ret;
|
|
}
|
|
|
|
/**
|
|
* gimp_image_get_effective_color_profile:
|
|
* @image: The image.
|
|
*
|
|
* Returns the color profile that is used for the image.
|
|
*
|
|
* This procedure returns the color profile that is actually used for
|
|
* this image, which is the profile returned by
|
|
* gimp_image_get_color_profile() if the image has a profile assigned,
|
|
* or the default RGB profile from preferences if no profile is
|
|
* assigned to the image. If there is no default RGB profile configured
|
|
* in preferences either, a generated default RGB profile is returned.
|
|
*
|
|
* Returns: (transfer full): The color profile. The returned value must
|
|
* be freed with g_object_unref().
|
|
*
|
|
* Since: 2.10
|
|
**/
|
|
GimpColorProfile *
|
|
gimp_image_get_effective_color_profile (GimpImage *image)
|
|
{
|
|
GBytes *data;
|
|
|
|
data = _gimp_image_get_effective_color_profile (image);
|
|
|
|
if (data)
|
|
{
|
|
GimpColorProfile *profile;
|
|
|
|
profile = gimp_color_profile_new_from_icc_profile (g_bytes_get_data (data, NULL),
|
|
g_bytes_get_size (data),
|
|
NULL);
|
|
g_bytes_unref (data);
|
|
|
|
return profile;
|
|
}
|
|
|
|
return NULL;
|
|
}
|
|
|
|
/**
|
|
* gimp_image_convert_color_profile:
|
|
* @image: The image.
|
|
* @profile: The color profile to convert to.
|
|
* @intent: Rendering intent.
|
|
* @bpc: Black point compensation.
|
|
*
|
|
* Convert the image's layers to a color profile
|
|
*
|
|
* This procedure converts from the image's color profile (or the
|
|
* default RGB profile if none is set) to the given color profile. Only
|
|
* RGB color profiles are accepted.
|
|
*
|
|
* Returns: TRUE on success.
|
|
*
|
|
* Since: 2.10
|
|
**/
|
|
gboolean
|
|
gimp_image_convert_color_profile (GimpImage *image,
|
|
GimpColorProfile *profile,
|
|
GimpColorRenderingIntent intent,
|
|
gboolean bpc)
|
|
{
|
|
const guint8 *data = NULL;
|
|
GBytes *bytes = NULL;
|
|
gboolean ret;
|
|
|
|
g_return_val_if_fail (profile == NULL || GIMP_IS_COLOR_PROFILE (profile),
|
|
FALSE);
|
|
|
|
if (profile)
|
|
{
|
|
gsize l;
|
|
|
|
data = gimp_color_profile_get_icc_profile (profile, &l);
|
|
bytes = g_bytes_new_static (data, l);
|
|
}
|
|
|
|
ret = _gimp_image_convert_color_profile (image, bytes, intent, bpc);
|
|
g_bytes_unref (bytes);
|
|
return ret;
|
|
}
|