|  |  |  | GDK 3 Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
#include <gdk/gdk.h>
                    GdkColor;
GdkColor *          gdk_color_copy                      (const GdkColor *color);
void                gdk_color_free                      (GdkColor *color);
gboolean            gdk_color_parse                     (const gchar *spec,
                                                         GdkColor *color);
gboolean            gdk_color_equal                     (const GdkColor *colora,
                                                         const GdkColor *colorb);
guint               gdk_color_hash                      (const GdkColor *color);
gchar *             gdk_color_to_string                 (const GdkColor *color);
A GdkColor represents a color.
When working with cairo, it is often more convenient to use a GdkRGBA instead.
typedef struct {
  guint32 pixel;
  guint16 red;
  guint16 green;
  guint16 blue;
} GdkColor;
The GdkColor structure is used to describe a color, similar to the XColor struct used in the X11 drawing API.
| guint32  | For allocated colors, the pixel value used to draw this color on the screen. Not used anymore. | 
| guint16  | The red component of the color. This is a value between 0 and 65535, with 65535 indicating full intensitiy | 
| guint16  | The green component of the color | 
| guint16  | The blue component of the color | 
GdkColor *          gdk_color_copy                      (const GdkColor *color);
Makes a copy of a color structure.
The result must be freed using gdk_color_free().
| 
 | a GdkColor | 
| Returns : | a copy of color | 
void                gdk_color_free                      (GdkColor *color);
Frees a color structure created with gdk_color_copy().
| 
 | a GdkColor | 
gboolean gdk_color_parse (const gchar *spec,GdkColor *color);
Parses a textual specification of a color and fill in the
red, green,
and blue fields of a GdkColor
structure.
The string can either one of a large set of standard names
(taken from the X11 rgb.txt file), or
it can be a hex 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').
gboolean gdk_color_equal (const GdkColor *colora,const GdkColor *colorb);
Compares two colors.
guint               gdk_color_hash                      (const GdkColor *color);
A hash function suitable for using for a hash table that stores GdkColors.
| 
 | a GdkColor | 
| Returns : | The hash function applied to color | 
gchar *             gdk_color_to_string                 (const GdkColor *color);
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().
| 
 | a GdkColor | 
| Returns : | a newly-allocated text string | 
Since 2.12