## GimpColorProfile

GimpColorProfile — Definitions and Functions relating to LCMS.

## Functions

const gchar * | gimp_color_profile_get_description ()
const gchar * | gimp_color_profile_get_manufacturer ()
const gchar * | gimp_color_profile_get_model ()
const gchar * | gimp_color_profile_get_copyright ()
const gchar * | gimp_color_profile_get_label ()
const gchar * | gimp_color_profile_get_summary ()
gboolean | gimp_color_profile_is_equal ()
gboolean | gimp_color_profile_is_rgb ()
gboolean | gimp_color_profile_is_cmyk ()
const Babl * | gimp_color_profile_get_format ()

## Types and Values

| GimpColorProfile
| GimpColorTransform

## 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_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, Y, YA, Y', Y'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 struct {
      GObject                    parent_instance;

      GimpColorTransformPrivate *priv;
    } GimpColorTransform;

Simply a typedef to gpointer, but actually is a cmsHTRANSFORM. It's used in public GIMP APIs in order to avoid having to include LCMS headers.