gdk_colormap_new ()

GdkColormap *
gdk_colormap_new (GdkVisual *visual,
                  gboolean allocate);

Creates a new colormap for the given visual.

gdk_colormap_ref ()

GdkColormap *
gdk_colormap_ref (GdkColormap *cmap);

Deprecated function; use g_object_ref() instead.

gdk_colormap_unref ()

void
gdk_colormap_unref (GdkColormap *cmap);

Deprecated function; use g_object_unref() instead.

gdk_colormap_get_system ()

GdkColormap *
gdk_colormap_get_system (void);

Gets the system's default colormap for the default screen. (See gdk_colormap_get_system_for_screen())

gdk_colormap_get_system_size ()

gint
gdk_colormap_get_system_size (void);

Returns the size of the system's default colormap. (See the description of struct GdkColormap for an explanation of the size of a colormap.)

gdk_colormap_change ()

void
gdk_colormap_change (GdkColormap *colormap,
                     gint ncolors);

Changes the value of the first ncolors in a private colormap to match the values in the colors array in the colormap. This function is obsolete and should not be used. See gdk_color_change().

gdk_colormap_alloc_colors ()

gint
gdk_colormap_alloc_colors (GdkColormap *colormap,
                           GdkColor *colors,
                           gint n_colors,
                           gboolean writeable,
                           gboolean best_match,
                           gboolean *success);

Allocates colors from a colormap.

gdk_colormap_alloc_color ()

gboolean
gdk_colormap_alloc_color (GdkColormap *colormap,
                          GdkColor *color,
                          gboolean writeable,
                          gboolean best_match);

Allocates a single color from a colormap.

gdk_colormap_free_colors ()

void
gdk_colormap_free_colors (GdkColormap *colormap,
                          const GdkColor *colors,
                          gint n_colors);

Frees previously allocated colors.

gdk_colormap_query_color ()

void
gdk_colormap_query_color (GdkColormap *colormap,
                          gulong pixel,
                          GdkColor *result);

Locates the RGB color in colormap corresponding to the given hardware pixel pixel . pixel must be a valid pixel in the colormap; it's a programmer error to call this function with a pixel which is not in the colormap. Hardware pixels are normally obtained from gdk_colormap_alloc_colors(), or from a GdkImage. (A GdkImage contains image data in hardware format, a GdkPixbuf contains image data in a canonical 24-bit RGB format.)

This function is rarely useful; it's used for example to implement the eyedropper feature in GtkColorSelection.

gdk_colormap_get_visual ()

GdkVisual *
gdk_colormap_get_visual (GdkColormap *colormap);

Returns the visual for which a given colormap was created.

gdk_colormap_get_screen ()

GdkScreen *
gdk_colormap_get_screen (GdkColormap *cmap);

Gets the screen for which this colormap was created.

Since 2.2

gdk_colors_store ()

void
gdk_colors_store (GdkColormap *colormap,
                  GdkColor *colors,
                  gint ncolors);

Changes the value of the first ncolors colors in a private colormap. This function is obsolete and should not be used. See gdk_color_change().

gdk_color_copy ()

GdkColor *
gdk_color_copy (const GdkColor *color);

Makes a copy of a color structure. The result must be freed using gdk_color_free().

gdk_color_free ()

void
gdk_color_free (GdkColor *color);

Frees a color structure created with gdk_color_copy().

gdk_colors_alloc ()

gint
gdk_colors_alloc (GdkColormap *colormap,
                  gboolean contiguous,
                  gulong *planes,
                  gint nplanes,
                  gulong *pixels,
                  gint npixels);

Allocates colors from a colormap. This function is obsolete. See gdk_colormap_alloc_colors(). For full documentation of the fields, see the Xlib documentation for XAllocColorCells().

gdk_colors_free ()

void
gdk_colors_free (GdkColormap *colormap,
                 gulong *pixels,
                 gint npixels,
                 gulong planes);

Frees colors allocated with gdk_colors_alloc(). This function is obsolete. See gdk_colormap_free_colors().

gdk_color_white ()

gint
gdk_color_white (GdkColormap *colormap,
                 GdkColor *color);

Returns the white color for a given colormap. The resulting value has already allocated been allocated.

gdk_color_black ()

gint
gdk_color_black (GdkColormap *colormap,
                 GdkColor *color);

Returns the black color for a given colormap. The resulting value has already been allocated.

gdk_color_parse ()

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

Parses a textual specification of a color and fill in the

and blue fields of a GdkColor structure. The color is not allocated, you must call gdk_colormap_alloc_color() yourself. 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')

gdk_color_alloc ()

gint
gdk_color_alloc (GdkColormap *colormap,
                 GdkColor *color);

Allocates a single color from a colormap.

gdk_color_change ()

gint
gdk_color_change (GdkColormap *colormap,
                  GdkColor *color);

Changes the value of a color that has already been allocated. If colormap is not a private colormap, then the color must have been allocated using gdk_colormap_alloc_colors() with the writeable set to TRUE.

gdk_color_equal ()

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

Compares two colors.

gdk_color_hash ()

guint
gdk_color_hash (const GdkColor *colora);

A hash function suitable for using for a hash table that stores GdkColor's.

gdk_color_to_string ()

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.

Since 2.12

GdkColor

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

The GdkColor structure is used to describe an allocated or unallocated color.

GdkColormap

typedef struct {
  gint      GSEAL (size);
  GdkColor *GSEAL (colors);
} GdkColormap;

The colormap structure contains the following public fields.