gimpimagecolorprofile: GIMP Library Reference Manual

gimpimagecolorprofile

gimpimagecolorprofile — Operations on an image's color profile.

Functions

GimpColorProfile *	gimp_image_get_color_profile ()
gboolean	gimp_image_set_color_profile ()
gboolean	gimp_image_set_color_profile_from_file ()
GimpColorProfile *	gimp_image_get_effective_color_profile ()
gboolean	gimp_image_convert_color_profile ()
gboolean	gimp_image_convert_color_profile_from_file ()

Description

Operations on an image's color profile.

Functions

gimp_image_get_color_profile ()

GimpColorProfile *
gimp_image_get_color_profile (gint32 image_ID);

Returns the image's color profile

This procedure returns the image's color profile, or NULL if the image has no color profile assigned.

Parameters

image_ID

The image.

Returns

The image's color profile. The returned value must be freed with g_object_unref().

Since: 2.10

gimp_image_set_color_profile ()

gboolean
gimp_image_set_color_profile (gint32 image_ID,
                              GimpColorProfile *profile);

Sets the image's color profile

This procedure sets the image's color profile.

Parameters

image_ID	The image.
profile	A GimpColorProfile, or `NULL`.

Returns

TRUE on success.

Since: 2.10

gimp_image_set_color_profile_from_file ()

gboolean
gimp_image_set_color_profile_from_file
                               (gint32 image_ID,
                                const gchar *uri);

Sets the image's color profile from an ICC file

This procedure sets the image's color profile from a file containing an ICC profile, or unsets it if NULL is passed as 'uri'. This procedure does no color conversion.

Parameters

image_ID	The image.
uri	The URI of the file containing the new color profile.

Returns

TRUE on success.

Since: 2.10

gimp_image_get_effective_color_profile ()

GimpColorProfile *
gimp_image_get_effective_color_profile
                               (gint32 image_ID);

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.

Parameters

image_ID

The image.

Returns

The color profile. The returned value must be freed with g_object_unref().

Since: 2.10

gimp_image_convert_color_profile ()

gboolean
gimp_image_convert_color_profile (gint32 image_ID,
                                  GimpColorProfile *profile,
                                  GimpColorRenderingIntent intent,
                                  gboolean bpc);

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.

Parameters

image_ID	The image.
profile	The color profile to convert to.
intent	Rendering intent.
bpc	Black point compensation.

Returns

TRUE on success.

Since: 2.10

gimp_image_convert_color_profile_from_file ()

gboolean
gimp_image_convert_color_profile_from_file
                               (gint32 image_ID,
                                const gchar *uri,
                                GimpColorRenderingIntent intent,
                                gboolean bpc);

Convert the image's layers to a color profile

This procedure converts from the image's color profile (or the default RGB or grayscale profile if none is set) to an ICC profile specified by 'uri'. Only RGB and grayscale color profiles are accepted, according to the image's type.

Parameters

image_ID	The image.
uri	The URI of the file containing the new color profile.
intent	Rendering intent.
bpc	Black point compensation.

Returns

TRUE on success.

Since: 2.10