GimpColorProfile

GimpColorProfile — Definitions and Functions relating to LCMS.

Functions

Types and Values

Description

Definitions and Functions relating to LCMS.

Functions

gimp_color_profile_get_description ()

const gchar *
gimp_color_profile_get_description (GimpColorProfile *profile);

Parameters

profile

a GimpColorProfile

 

Returns

a string containing profile 's description. The returned value belongs to profile and must not be modified or freed.

Since: 2.10


gimp_color_profile_get_manufacturer ()

const gchar *
gimp_color_profile_get_manufacturer (GimpColorProfile *profile);

Parameters

profile

a GimpColorProfile

 

Returns

a string containing profile 's manufacturer. The returned value belongs to profile and must not be modified or freed.

Since: 2.10


gimp_color_profile_get_model ()

const gchar *
gimp_color_profile_get_model (GimpColorProfile *profile);

Parameters

profile

a GimpColorProfile

 

Returns

a string containing profile 's model. The returned value belongs to profile and must not be modified or freed.

Since: 2.10


gimp_color_profile_get_copyright ()

const gchar *
gimp_color_profile_get_copyright (GimpColorProfile *profile);

Parameters

profile

a GimpColorProfile

 

Returns

a string containing profile 's copyright. The returned value belongs to profile and must not be modified or freed.

Since: 2.10


gimp_color_profile_get_label ()

const gchar *
gimp_color_profile_get_label (GimpColorProfile *profile);

This function returns a string containing profile 's "title", a string that can be used to label the profile in a user interface.

Unlike gimp_color_profile_get_description(), this function always returns a string (as a fallback, it returns "(unnamed profile)".

Parameters

profile

a GimpColorProfile

 

Returns

the profile 's label. The returned value belongs to profile and must not be modified or freed.

Since: 2.10


gimp_color_profile_get_summary ()

const gchar *
gimp_color_profile_get_summary (GimpColorProfile *profile);

This function return a string containing a multi-line summary of profile 's description, model, manufacturer and copyright, to be used as detailled information about the profile in a user interface.

Parameters

profile

a GimpColorProfile

 

Returns

the profile 's summary. The returned value belongs to profile and must not be modified or freed.

Since: 2.10


gimp_color_profile_is_equal ()

gboolean
gimp_color_profile_is_equal (GimpColorProfile *profile1,
                             GimpColorProfile *profile2);

Compares two profiles.

Parameters

profile1

a GimpColorProfile

 

profile2

a GimpColorProfile

 

Returns

TRUE if the profiles are equal, FALSE otherwise.

Since: 2.10


gimp_color_profile_is_rgb ()

gboolean
gimp_color_profile_is_rgb (GimpColorProfile *profile);

Parameters

profile

a GimpColorProfile

 

Returns

TRUE if the profile's color space is RGB, FALSE otherwise.

Since: 2.10


gimp_color_profile_is_cmyk ()

gboolean
gimp_color_profile_is_cmyk (GimpColorProfile *profile);

Parameters

profile

a GimpColorProfile

 

Returns

TRUE if the profile's color space is CMYK, FALSE otherwise.

Since: 2.10


gimp_color_profile_new_srgb ()

GimpColorProfile *
gimp_color_profile_new_srgb (void);

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.

Returns

the sRGB GimpColorProfile.

Since: 2.10


gimp_color_profile_new_linear_rgb ()

GimpColorProfile *
gimp_color_profile_new_linear_rgb (void);

This function creates a profile for babl_model("RGB"). Please somebody write someting smarter here.

Returns

the linear RGB GimpColorProfile.

Since: 2.10


gimp_color_profile_get_format ()

const Babl *
gimp_color_profile_get_format (const Babl *format,
                               guint32 *lcms_format);

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 .

Note that this function currently only supports RGB, RGBA, R'G'B', R'G'B'A and the cairo-RGB24 and cairo-ARGB32 formats.

Parameters

format

a Babl format

 

lcms_format

return location for an lcms format

 

Returns

the Babl format to be used instead of format , or NULL is the passed format is not supported at all.

Since: 2.10

Types and Values

GimpColorProfile

typedef struct {
  GObject                  parent_instance;

  GimpColorProfilePrivate *priv;
} 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.


GimpColorTransform

typedef gpointer GimpColorTransform;