Colors: GDK 3 Reference Manual

## Colors Colors — Manipulation of colors |

## Functions

GdkColor * | gdk_color_copy ()
void | gdk_color_free ()
gboolean | gdk_color_parse ()
gboolean | gdk_color_equal ()
guint | gdk_color_hash ()
gchar * | gdk_color_to_string ()

## Types and Values

| GdkColor

## Includes

    #include <gdk/gdk.h>

## Description

A GdkColor represents a color.

When working with cairo, it is often more convenient to use a GdkRGBA instead, and GdkColor has been deprecated in favor of GdkRGBA.

## Functions

### gdk_color_copy ()

    GdkColor *
    gdk_color_copy (const GdkColor *color);

`gdk_color_copy` has been deprecated since version 3.14 and should not be used in newly-written code.

Use GdkRGBA

Makes a copy of a GdkColor.

The result must be freed using `gdk_color_free()`.

#### Parameters

color | a GdkColor |

#### Returns

a copy of `color`

### gdk_color_free ()

    void
    gdk_color_free (GdkColor *color);

`gdk_color_free` has been deprecated since version 3.14 and should not be used in newly-written code.

Use GdkRGBA

Frees a GdkColor created with `gdk_color_copy()`.

#### Parameters

color | a GdkColor |

### gdk_color_parse ()

    gboolean
    gdk_color_parse (const gchar *spec,
                     GdkColor *color);

`gdk_color_parse` has been deprecated since version 3.14 and should not be used in newly-written code.

Use GdkRGBA

Parses a textual specification of a color and fill in the `red` , `green` , and `blue` fields of a GdkColor.

The string can either one of a large set of standard names (taken from the X11 `rgb.txt` file), or it can be a hexadecimal value in the form “#rgb” “#rrggbb”, “#rrrgggbbb” or “#rrrrggggbbbb” where “r”, “g” and “b” are hex digits of the red, green, and blue components of the color, respectively. (White in the four forms is “#fff”, “#ffffff”, “#fffffffff” and “#ffffffffffff”).

#### Parameters

spec | the string specifying the color |
color | the GdkColor to fill in. | [out]

#### Returns

`TRUE` if the parsing succeeded

### gdk_color_equal ()

    gboolean
    gdk_color_equal (const GdkColor *colora,
                     const GdkColor *colorb);

`gdk_color_equal` has been deprecated since version 3.14 and should not be used in newly-written code.

Use GdkRGBA

Compares two colors.

#### Parameters

colora | a GdkColor |
colorb | another GdkColor |

#### Returns

`TRUE` if the two colors compare equal

### gdk_color_hash ()

    guint
    gdk_color_hash (const GdkColor *color);

`gdk_color_hash` has been deprecated since version 3.14 and should not be used in newly-written code.

Use GdkRGBA

A hash function suitable for using for a hash table that stores GdkColors.

#### Parameters

color | a GdkColor |

#### Returns

The hash function applied to `color`

### gdk_color_to_string ()

    gchar *
    gdk_color_to_string (const GdkColor *color);

`gdk_color_to_string` has been deprecated since version 3.14 and should not be used in newly-written code.

Use GdkRGBA

Returns a textual specification of `color` in the hexadecimal form “#rrrrggggbbbb” where “r”, “g” and “b” are hex digits representing the red, green and blue components respectively.

The returned string can be parsed by `gdk_color_parse()`.

#### Parameters

color | a GdkColor |

#### Returns

a newly-allocated text string

Since: 2.12

## Types and Values

### GdkColor

    typedef struct {
      guint32 pixel;
      guint16 red;
      guint16 green;
      guint16 blue;
    } GdkColor;

`GdkColor` has been deprecated since version 3.14 and should not be used in newly-written code.

Use GdkRGBA

A GdkColor is used to describe a color, similar to the XColor struct used in the X11 drawing API.

#### Members

guint32 `pixel`; | For allocated colors, the pixel value used to draw this color on the screen. Not used anymore. |
guint16 `red`; | The red component of the color. This is a value between 0 and 65535, with 65535 indicating full intensity |
guint16 `green`; | The green component of the color |
guint16 `blue`; | The blue component of the color |