diff --git a/ChangeLog b/ChangeLog index dda8af366f..e06bfa6e4a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,23 @@ +2002-10-24 Matthias Clasen + + * gdk/gdkcolor.c (gdk_colormap_alloc_color): + (gdk_colormap_get_visual): + (gdk_colors_store): + (gdk_color_copy): + (gdk_color_free): + (gdk_color_white): + (gdk_color_black): + (gdk_color_parse): + (gdk_color_alloc): + + * gdk/x11/gdkcolor-x11.c (gdk_colormap_new): + (gdk_colormap_get_system_size): + (gdk_colormap_change): + (gdk_colormap_alloc_colors): + (gdk_colors_alloc): + (gdk_colors_free): + (gdk_color_change): + 2002-10-23 Matthias Clasen * gdk/linux-fb/gdkselection-fb.c (gdk_utf8_to_string_target): diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index dda8af366f..e06bfa6e4a 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,3 +1,23 @@ +2002-10-24 Matthias Clasen + + * gdk/gdkcolor.c (gdk_colormap_alloc_color): + (gdk_colormap_get_visual): + (gdk_colors_store): + (gdk_color_copy): + (gdk_color_free): + (gdk_color_white): + (gdk_color_black): + (gdk_color_parse): + (gdk_color_alloc): + + * gdk/x11/gdkcolor-x11.c (gdk_colormap_new): + (gdk_colormap_get_system_size): + (gdk_colormap_change): + (gdk_colormap_alloc_colors): + (gdk_colors_alloc): + (gdk_colors_free): + (gdk_color_change): + 2002-10-23 Matthias Clasen * gdk/linux-fb/gdkselection-fb.c (gdk_utf8_to_string_target): diff --git a/ChangeLog.pre-2-2 b/ChangeLog.pre-2-2 index dda8af366f..e06bfa6e4a 100644 --- a/ChangeLog.pre-2-2 +++ b/ChangeLog.pre-2-2 @@ -1,3 +1,23 @@ +2002-10-24 Matthias Clasen + + * gdk/gdkcolor.c (gdk_colormap_alloc_color): + (gdk_colormap_get_visual): + (gdk_colors_store): + (gdk_color_copy): + (gdk_color_free): + (gdk_color_white): + (gdk_color_black): + (gdk_color_parse): + (gdk_color_alloc): + + * gdk/x11/gdkcolor-x11.c (gdk_colormap_new): + (gdk_colormap_get_system_size): + (gdk_colormap_change): + (gdk_colormap_alloc_colors): + (gdk_colors_alloc): + (gdk_colors_free): + (gdk_color_change): + 2002-10-23 Matthias Clasen * gdk/linux-fb/gdkselection-fb.c (gdk_utf8_to_string_target): diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4 index dda8af366f..e06bfa6e4a 100644 --- a/ChangeLog.pre-2-4 +++ b/ChangeLog.pre-2-4 @@ -1,3 +1,23 @@ +2002-10-24 Matthias Clasen + + * gdk/gdkcolor.c (gdk_colormap_alloc_color): + (gdk_colormap_get_visual): + (gdk_colors_store): + (gdk_color_copy): + (gdk_color_free): + (gdk_color_white): + (gdk_color_black): + (gdk_color_parse): + (gdk_color_alloc): + + * gdk/x11/gdkcolor-x11.c (gdk_colormap_new): + (gdk_colormap_get_system_size): + (gdk_colormap_change): + (gdk_colormap_alloc_colors): + (gdk_colors_alloc): + (gdk_colors_free): + (gdk_color_change): + 2002-10-23 Matthias Clasen * gdk/linux-fb/gdkselection-fb.c (gdk_utf8_to_string_target): diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index dda8af366f..e06bfa6e4a 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,3 +1,23 @@ +2002-10-24 Matthias Clasen + + * gdk/gdkcolor.c (gdk_colormap_alloc_color): + (gdk_colormap_get_visual): + (gdk_colors_store): + (gdk_color_copy): + (gdk_color_free): + (gdk_color_white): + (gdk_color_black): + (gdk_color_parse): + (gdk_color_alloc): + + * gdk/x11/gdkcolor-x11.c (gdk_colormap_new): + (gdk_colormap_get_system_size): + (gdk_colormap_change): + (gdk_colormap_alloc_colors): + (gdk_colors_alloc): + (gdk_colors_free): + (gdk_color_change): + 2002-10-23 Matthias Clasen * gdk/linux-fb/gdkselection-fb.c (gdk_utf8_to_string_target): diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index dda8af366f..e06bfa6e4a 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,3 +1,23 @@ +2002-10-24 Matthias Clasen + + * gdk/gdkcolor.c (gdk_colormap_alloc_color): + (gdk_colormap_get_visual): + (gdk_colors_store): + (gdk_color_copy): + (gdk_color_free): + (gdk_color_white): + (gdk_color_black): + (gdk_color_parse): + (gdk_color_alloc): + + * gdk/x11/gdkcolor-x11.c (gdk_colormap_new): + (gdk_colormap_get_system_size): + (gdk_colormap_change): + (gdk_colormap_alloc_colors): + (gdk_colors_alloc): + (gdk_colors_free): + (gdk_color_change): + 2002-10-23 Matthias Clasen * gdk/linux-fb/gdkselection-fb.c (gdk_utf8_to_string_target): diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 9650bc83e7..3ab6229ec2 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,7 @@ +2002-10-24 Matthias Clasen + + * gdk/tmpl/colors.sgml: Some docs moved inline. + 2002-10-22 Matthias Clasen * gdk/tmpl/gdkdisplay.sgml: Document GdkDisplayPointerHooks. diff --git a/docs/reference/gdk/tmpl/colors.sgml b/docs/reference/gdk/tmpl/colors.sgml index 381452b71c..bbaad54566 100644 --- a/docs/reference/gdk/tmpl/colors.sgml +++ b/docs/reference/gdk/tmpl/colors.sgml @@ -72,14 +72,11 @@ The colormap structure contains the following public fields. -Creates a new colormap for the given visual. -@visual: a #GdkVisual. -@allocate: if %TRUE, the newly created colormap will be - a private colormap, and all colors in it will be - allocated for the applications use. -@Returns: the new #GdkColormap. +@visual: +@allocate: +@Returns: @@ -108,74 +105,50 @@ Creates a new colormap for the given visual. -Returns the size of the system's default colormap. -(See the description of struct #GdkColormap for an -explanation of the size of a colormap.) -@Returns: the size of the system's default colormap. +@Returns: -Changes the value of the first @ncolors in a private colormap -to match the values in the colors -array in the color map. This function is obsolete and -should not be used. See gdk_color_change(). -@colormap: a #GdkColormap. -@ncolors: the number of colors to change. +@colormap: +@ncolors: -Allocates colors from a colormap. -@colormap: a #GdkColormap. -@colors: The color values to allocate. On return, the pixel - values for allocated colors will be filled in. -@ncolors: The number of colors in @colors. -@writeable: If %TRUE, the colors are allocated writeable - (their values can later be changed using gdk_color_change()). - Writeable colors cannot be shared between applications. -@best_match: If %TRUE, GDK will attempt to do matching against - existing colors if the colors cannot be allocated as - requested. -@success: An array of length @ncolors. On return, this - indicates whether the corresponding color in @colors was - sucessfully allocated or not. -@Returns: The number of colors that were not sucessfully - allocated. +@colormap: +@colors: +@ncolors: +@writeable: +@best_match: +@success: +@Returns: -Allocates a single color from a colormap. -@colormap: a #GdkColormap. -@color: the color to allocate. On return the -pixel field will be -filled in if allocation succeeds. -@writeable: If %TRUE, the color is allocated writeable - (their values can later be changed using gdk_color_change()). - Writeable colors cannot be shared between applications. -@best_match: If %TRUE, GDK will attempt to do matching against - existing colors if the color cannot be allocated as - requested. -@Returns: %TRUE if the allocation succeeded. +@colormap: +@color: +@writeable: +@best_match: +@Returns: -Frees previously allocated colors. -@colormap: a #GdkColormap. -@colors: the colors to free. -@ncolors: the number of colors in @colors. +@colormap: +@colors: +@ncolors: @@ -190,11 +163,10 @@ Frees previously allocated colors. -Returns the visual for which a given colormap was created. -@colormap: a #GdkColormap. -@Returns: the visual of the colormap. +@colormap: +@Returns: @@ -208,157 +180,115 @@ Returns the visual for which a given colormap was created. -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(). -@colormap: a #GdkColormap. -@colors: the new color values. -@ncolors: the number of colors to change. +@colormap: +@colors: +@ncolors: -Makes a copy of a color structure. The result -must be freed using gdk_color_free(). -@color: a #GdkColor. -@Returns: a copy of @color. +@color: +@Returns: -Frees a color structure created with -gdk_color_copy(). -@color: a #GdkColor. +@color: -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(). -@colormap: a #GdkColormap. -@contiguous: if %TRUE, the colors should be allocated - in contiguous color cells. -@planes: an array in which to store the plane masks. -@nplanes: the number of planes to allocate. (Or zero, - to indicate that the color allocation should not be - planar.) -@pixels: an array into which to store allocated pixel - values. -@npixels: the number of pixels in each plane to allocate. +@colormap: +@contiguous: +@planes: +@nplanes: +@pixels: +@npixels: @Returns: -Frees colors allocated with gdk_colors_alloc(). This -function is obsolete. See gdk_colormap_free_colors(). -@colormap: a #GdkColormap. -@pixels: the pixel values of the colors to free. -@npixels: the number of values in @pixels. -@planes: the plane masks for all planes to free, OR'd - together. +@colormap: +@pixels: +@npixels: +@planes: -Returns the white color for a given colormap. The resulting -value has already allocated been allocated. -@colormap: a #GdkColormap. -@color: the location to store the color. -@Returns: %TRUE if the allocation succeeded. +@colormap: +@color: +@Returns: -Returns the black color for a given colormap. The resulting -value has already benn allocated. -@colormap: a #GdkColormap. -@color: the location to store the color. -@Returns: %TRUE if the allocation succeeded. +@colormap: +@color: +@Returns: -Parses a textual specification of a color and fill in -the red, -green, and -blue fields of a -#GdkColor structure. The color is not -allocated, you must call gdk_colormap_alloc_color() yourself. -The text string can be in any of the forms accepted -by XParseColor; these include -name for a color from rgb.txt, such as -DarkSlateGray, or a hex specification -such as 305050. -@spec: the string specifying the color. -@color: the #GdkColor to fill in +@spec: +@color: @Returns: -Allocates a single color from a colormap. -This function is obsolete. See gdk_colormap_alloc_color(). -@colormap: a #GdkColormap. -@color: The color to allocate. On return, the -pixel field will be -filled in. -@Returns: %TRUE if the allocation succeeded. +@colormap: +@color: +@Returns: -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. -@colormap: a #GdkColormap. -@color: a #GdkColor, with the color to change -in the pixel field, -and the new value in the remaining fields. +@colormap: +@color: @Returns: -Compares two colors. -@colora: a #GdkColor. -@colorb: another #GdkColor. -@Returns: %TRUE if the two colors compare equal +@colora: +@colorb: +@Returns: -A hash function suitable for using for a hash -table that stores #GdkColor's. -@colora: a #GdkColor. -@Returns: The hash function appled to @colora +@colora: +@Returns: + + + + + diff --git a/gdk/gdkcolor.c b/gdk/gdkcolor.c index 79bdd93d11..4ef0ddc561 100644 --- a/gdk/gdkcolor.c +++ b/gdk/gdkcolor.c @@ -56,6 +56,15 @@ gdk_colormap_unref (GdkColormap *cmap) g_object_unref (cmap); } + +/** + * gdk_colormap_get_visual: + * @colormap: a #GdkColormap. + * + * Returns the visual for which a given colormap was created. + * + * Return value: the visual of the colormap. + **/ GdkVisual * gdk_colormap_get_visual (GdkColormap *colormap) { @@ -63,7 +72,19 @@ gdk_colormap_get_visual (GdkColormap *colormap) return colormap->visual; } - + +/** + * gdk_colors_store: + * @colormap: a #GdkColormap. + * @colors: the new color values. + * @ncolors: the number of colors to change. + * + * 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(). + * + * Return value: + **/ void gdk_colors_store (GdkColormap *colormap, GdkColor *colors, @@ -82,23 +103,17 @@ gdk_colors_store (GdkColormap *colormap, gdk_colormap_change (colormap, ncolors); } -/* - *-------------------------------------------------------------- - * gdk_color_copy - * - * Copy a color structure into new storage. - * - * Arguments: - * "color" is the color struct to copy. - * - * Results: - * A new color structure. Free it with gdk_color_free. - * - *-------------------------------------------------------------- - */ - static GMemChunk *color_chunk; +/** + * gdk_color_copy: + * @color: a #GdkColor. + * + * Makes a copy of a color structure. The result + * must be freed using gdk_color_free(). + * + * Return value: a copy of @color. + **/ GdkColor* gdk_color_copy (const GdkColor *color) { @@ -117,18 +132,13 @@ gdk_color_copy (const GdkColor *color) return new_color; } -/* - *-------------------------------------------------------------- - * gdk_color_free - * - * Free a color structure obtained from gdk_color_copy. Do not use - * with other color structures. - * - * Arguments: - * "color" is the color struct to free. - * - *-------------------------------------------------------------- */ - +/** + * gdk_color_free: + * @color: a #GdkColor. + * + * Frees a color structure created with + * gdk_color_copy(). + **/ void gdk_color_free (GdkColor *color) { @@ -138,6 +148,16 @@ gdk_color_free (GdkColor *color) g_mem_chunk_free (color_chunk, color); } +/** + * gdk_color_white: + * @colormap: a #GdkColormap. + * @color: the location to store the color. + * + * Returns the white color for a given colormap. The resulting + * value has already allocated been allocated. + * + * Return value: %TRUE if the allocation succeeded. + **/ gboolean gdk_color_white (GdkColormap *colormap, GdkColor *color) @@ -160,6 +180,16 @@ gdk_color_white (GdkColormap *colormap, return return_val; } +/** + * gdk_color_black: + * @colormap: a #GdkColormap. + * @color: the location to store the color. + * + * Returns the black color for a given colormap. The resulting + * value has already benn allocated. + * + * Return value: %TRUE if the allocation succeeded. + **/ gboolean gdk_color_black (GdkColormap *colormap, GdkColor *color) @@ -186,6 +216,22 @@ gdk_color_black (GdkColormap *colormap, * Color allocation * ********************/ +/** + * gdk_colormap_alloc_color: + * @colormap: a #GdkColormap. + * @color: the color to allocate. On return the + * pixel field will be + * filled in if allocation succeeds. + * @writeable: If %TRUE, the color is allocated writeable + * (their values can later be changed using gdk_color_change()). + * Writeable colors cannot be shared between applications. + * @best_match: If %TRUE, GDK will attempt to do matching against + * existing colors if the color cannot be allocated as requested. + * + * Allocates a single color from a colormap. + * + * Return value: %TRUE if the allocation succeeded. + **/ gboolean gdk_colormap_alloc_color (GdkColormap *colormap, GdkColor *color, @@ -200,6 +246,17 @@ gdk_colormap_alloc_color (GdkColormap *colormap, return success; } +/** + * gdk_color_alloc: + * @colormap: a #GdkColormap. + * @color: The color to allocate. On return, the + * pixel field will be filled in. + * + * Allocates a single color from a colormap. + * This function is obsolete. See gdk_colormap_alloc_color(). + * + * Return value: %TRUE if the allocation succeeded. + **/ gboolean gdk_color_alloc (GdkColormap *colormap, GdkColor *color) @@ -211,6 +268,15 @@ gdk_color_alloc (GdkColormap *colormap, return success; } +/** + * gdk_color_hash: + * @colora: a #GdkColor. + * + * A hash function suitable for using for a hash + * table that stores #GdkColor's. + * + * Return value: The hash function appled to @colora + **/ guint gdk_color_hash (const GdkColor *colora) { @@ -220,6 +286,15 @@ gdk_color_hash (const GdkColor *colora) (colora->blue >> 6)); } +/** + * gdk_color_equal: + * @colora: a #GdkColor. + * @colorb: another #GdkColor. + * + * Compares two colors. + * + * Return value: %TRUE if the two colors compare equal + **/ gboolean gdk_color_equal (const GdkColor *colora, const GdkColor *colorb) @@ -244,6 +319,25 @@ gdk_color_get_type (void) return our_type; } +/** + * gdk_color_parse: + * @spec: the string specifying the color. + * @color: the #GdkColor to fill in + * + * Parses a textual specification of a color and fill in + * the red, + * green, and + * blue fields of a + * #GdkColor structure. The color is not + * allocated, you must call gdk_colormap_alloc_color() yourself. + * The text string can be in any of the forms accepted + * by XParseColor; these include + * name for a color from rgb.txt, such as + * DarkSlateGray, or a hex specification + * such as 305050. + * + * Return value: %TRUE if the parsing succeeded. + **/ gboolean gdk_color_parse (const gchar *spec, GdkColor *color) diff --git a/gdk/x11/gdkcolor-x11.c b/gdk/x11/gdkcolor-x11.c index fe543021b0..97589793e1 100644 --- a/gdk/x11/gdkcolor-x11.c +++ b/gdk/x11/gdkcolor-x11.c @@ -147,9 +147,20 @@ gdk_colormap_finalize (GObject *object) G_OBJECT_CLASS (parent_class)->finalize (object); } +/** + * gdk_colormap_new: + * @visual: a #GdkVisual. + * @allocate: if %TRUE, the newly created colormap will be + * a private colormap, and all colors in it will be + * allocated for the applications use. + * + * Creates a new colormap for the given visual. + * + * Return value: the new #GdkColormap. + **/ GdkColormap* gdk_colormap_new (GdkVisual *visual, - gboolean private_cmap) + gboolean allocate) { GdkColormap *colormap; GdkColormapPrivateX11 *private; @@ -187,11 +198,11 @@ gdk_colormap_new (GdkVisual *visual, private->hash = g_hash_table_new ((GHashFunc) gdk_color_hash, (GEqualFunc) gdk_color_equal); - private->private_val = private_cmap; + private->private_val = allocate; private->xcolormap = XCreateColormap (xdisplay, xrootwin, - xvisual, (private_cmap) ? (AllocAll) : (AllocNone)); + xvisual, (allocate) ? (AllocAll) : (AllocNone)); - if (private_cmap) + if (allocate) { XColor *default_colors; @@ -418,6 +429,15 @@ gdk_screen_get_system_colormap (GdkScreen *screen) return colormap; } +/** + * gdk_colormap_get_system_size: + * + * Returns the size of the system's default colormap. + * (See the description of struct #GdkColormap for an + * explanation of the size of a colormap.) + * + * Return value: the size of the system's default colormap. + **/ gint gdk_colormap_get_system_size (void) { @@ -425,6 +445,16 @@ gdk_colormap_get_system_size (void) GDK_SCREEN_X11 (gdk_screen_get_default())->screen_num); } +/** + * gdk_colormap_change: + * @colormap: a #GdkColormap. + * @ncolors: the number of colors to change. + * + * 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(). + **/ void gdk_colormap_change (GdkColormap *colormap, gint ncolors) @@ -514,6 +544,24 @@ gdk_colormap_change (GdkColormap *colormap, g_free (palette); } +/** + * gdk_colors_alloc: + * @colormap: a #GdkColormap. + * @contiguous: if %TRUE, the colors should be allocated + * in contiguous color cells. + * @planes: an array in which to store the plane masks. + * @nplanes: the number of planes to allocate. (Or zero, + * to indicate that the color allocation should not be planar.) + * @pixels: an array into which to store allocated pixel values. + * @npixels: the number of pixels in each plane to allocate. + * + * 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(). + * + * Return value: + **/ gboolean gdk_colors_alloc (GdkColormap *colormap, gboolean contiguous, @@ -551,6 +599,18 @@ gdk_colors_alloc (GdkColormap *colormap, /* This is almost identical to gdk_colormap_free_colors. * Keep them in sync! */ + + +/** + * gdk_colors_free: + * @colormap: a #GdkColormap. + * @in_pixels: the pixel values of the colors to free. + * @in_npixels: the number of values in @pixels. + * @planes: the plane masks for all planes to free, OR'd together. + * + * Frees colors allocated with gdk_colors_alloc(). This + * function is obsolete. See gdk_colormap_free_colors(). + **/ void gdk_colors_free (GdkColormap *colormap, gulong *in_pixels, @@ -600,6 +660,15 @@ gdk_colors_free (GdkColormap *colormap, /* This is almost identical to gdk_colors_free. * Keep them in sync! */ + +/** + * gdk_colormap_free_colors: + * @colormap: a #GdkColormap. + * @colors: the colors to free. + * @ncolors: the number of colors in @colors. + * + * Frees previously allocated colors. + **/ void gdk_colormap_free_colors (GdkColormap *colormap, GdkColor *colors, @@ -979,10 +1048,50 @@ gdk_colormap_alloc_colors_pseudocolor (GdkColormap *colormap, return 0; } +/** + * gdk_colormap_alloc_colors: + * @colormap: a #GdkColormap. + * @colors: The color values to allocate. On return, the pixel + * values for allocated colors will be filled in. + * @ncolors: The number of colors in @colors. + * @writeable: If %TRUE, the colors are allocated writeable + * (their values can later be changed using gdk_color_change()). + * Writeable colors cannot be shared between applications. + * @best_match: If %TRUE, GDK will attempt to do matching against + * existing colors if the colors cannot be allocated as requested. + * @success: An array of length @ncolors. On return, this + * indicates whether the corresponding color in @colors was + * sucessfully allocated or not. + * + * Allocates colors from a colormap. + * + * Return value: The number of colors that were not sucessfully + * allocated. + **/ gint gdk_colormap_alloc_colors (GdkColormap *colormap, GdkColor *colors, gint ncolors, +/** + * gdk_colormap_alloc_colors: + * @colormap: a #GdkColormap. + * @colors: The color values to allocate. On return, the pixel + * values for allocated colors will be filled in. + * @ncolors: The number of colors in @colors. + * @writeable: If %TRUE, the colors are allocated writeable + * (their values can later be changed using gdk_color_change()). + * Writeable colors cannot be shared between applications. + * @best_match: If %TRUE, GDK will attempt to do matching against + * existing colors if the colors cannot be allocated as requested. + * @success: An array of length @ncolors. On return, this + * indicates whether the corresponding color in @colors was + * sucessfully allocated or not. + * + * Allocates colors from a colormap. + * + * Return value: The number of colors that were not sucessfully + * allocated. + **/ gboolean writeable, gboolean best_match, gboolean *success) @@ -1121,6 +1230,21 @@ gdk_colormap_query_color (GdkColormap *colormap, } } +/** + * gdk_color_change: + * @colormap: a #GdkColormap. + * @color: a #GdkColor, with the color to change + * in the pixel field, + * and the new value in the remaining fields. + * + * 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. + * + * Return value: %TRUE if the color was successfully changed. + **/ gboolean gdk_color_change (GdkColormap *colormap, GdkColor *color)