AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

Documentation updates.

Browse Source
This commit is contained in:
Matthias Clasen 2002-10-23 23:15:58 +00:00
parent 5cc215cddf
commit 1f1f2e9127
10 changed files with 436 additions and 164 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
ChangeLog
View File

@ -1,3 +1,23 @@
2002-10-24 Matthias Clasen <maclas@gmx.de>
* 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 <maclas@gmx.de>
* gdk/linux-fb/gdkselection-fb.c (gdk_utf8_to_string_target):

20
ChangeLog.pre-2-10
View File

@ -1,3 +1,23 @@
2002-10-24 Matthias Clasen <maclas@gmx.de>
* 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 <maclas@gmx.de>
* gdk/linux-fb/gdkselection-fb.c (gdk_utf8_to_string_target):

20
ChangeLog.pre-2-2
View File

@ -1,3 +1,23 @@
2002-10-24 Matthias Clasen <maclas@gmx.de>
* 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 <maclas@gmx.de>
* gdk/linux-fb/gdkselection-fb.c (gdk_utf8_to_string_target):

20
ChangeLog.pre-2-4
View File

@ -1,3 +1,23 @@
2002-10-24 Matthias Clasen <maclas@gmx.de>
* 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 <maclas@gmx.de>
* gdk/linux-fb/gdkselection-fb.c (gdk_utf8_to_string_target):

20
ChangeLog.pre-2-6
View File

@ -1,3 +1,23 @@
2002-10-24 Matthias Clasen <maclas@gmx.de>
* 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 <maclas@gmx.de>
* gdk/linux-fb/gdkselection-fb.c (gdk_utf8_to_string_target):

20
ChangeLog.pre-2-8
View File

@ -1,3 +1,23 @@
2002-10-24 Matthias Clasen <maclas@gmx.de>
* 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 <maclas@gmx.de>
* gdk/linux-fb/gdkselection-fb.c (gdk_utf8_to_string_target):

4
docs/reference/ChangeLog
View File

@ -1,3 +1,7 @@
2002-10-24 Matthias Clasen <maclas@gmx.de>
* gdk/tmpl/colors.sgml: Some docs moved inline.
2002-10-22 Matthias Clasen <maclas@gmx.de>
* gdk/tmpl/gdkdisplay.sgml: Document GdkDisplayPointerHooks.

194
docs/reference/gdk/tmpl/colors.sgml
View File

@ -72,14 +72,11 @@ The colormap structure contains the following public fields.
<!-- ##### FUNCTION gdk_colormap_new ##### -->
<para>
Creates a new colormap for the given visual.
</para>
@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:
<!-- ##### FUNCTION gdk_colormap_ref ##### -->
@ -108,74 +105,50 @@ Creates a new colormap for the given visual.
<!-- ##### FUNCTION gdk_colormap_get_system_size ##### -->
<para>
Returns the size of the system's default colormap.
(See the description of struct #GdkColormap for an
explanation of the size of a colormap.)
</para>
@Returns: the size of the system's default colormap.
@Returns:
<!-- ##### FUNCTION gdk_colormap_change ##### -->
<para>
Changes the value of the first @ncolors in a private colormap
to match the values in the <structfield>colors</structfield>
array in the color map. This function is obsolete and
should not be used. See gdk_color_change().
</para>
@colormap: a #GdkColormap.
@ncolors: the number of colors to change.
@colormap:
@ncolors:
<!-- ##### FUNCTION gdk_colormap_alloc_colors ##### -->
<para>
Allocates colors from a colormap.
</para>
@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:
<!-- ##### FUNCTION gdk_colormap_alloc_color ##### -->
<para>
Allocates a single color from a colormap.
</para>
@colormap: a #GdkColormap.
@color: the color to allocate. On return the
<structfield>pixel</structfield> 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:
<!-- ##### FUNCTION gdk_colormap_free_colors ##### -->
<para>
Frees previously allocated colors.
</para>
@colormap: a #GdkColormap.
@colors: the colors to free.
@ncolors: the number of colors in @colors.
@colormap:
@colors:
@ncolors:
<!-- ##### FUNCTION gdk_colormap_query_color ##### -->
@ -190,11 +163,10 @@ Frees previously allocated colors.
<!-- ##### FUNCTION gdk_colormap_get_visual ##### -->
<para>
Returns the visual for which a given colormap was created.
</para>
@colormap: a #GdkColormap.
@Returns: the visual of the colormap.
@colormap:
@Returns:
<!-- ##### FUNCTION gdk_colormap_get_screen ##### -->
@ -208,157 +180,115 @@ Returns the visual for which a given colormap was created.
<!-- ##### FUNCTION gdk_colors_store ##### -->
<para>
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().
</para>
@colormap: a #GdkColormap.
@colors: the new color values.
@ncolors: the number of colors to change.
@colormap:
@colors:
@ncolors:
<!-- ##### FUNCTION gdk_color_copy ##### -->
<para>
Makes a copy of a color structure. The result
must be freed using gdk_color_free().
</para>
@color: a #GdkColor.
@Returns: a copy of @color.
@color:
@Returns:
<!-- ##### FUNCTION gdk_color_free ##### -->
<para>
Frees a color structure created with
gdk_color_copy().
</para>
@color: a #GdkColor.
@color:
<!-- ##### FUNCTION gdk_colors_alloc ##### -->
<para>
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 <function>XAllocColorCells()</function>.
</para>
@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:
<!-- ##### FUNCTION gdk_colors_free ##### -->
<para>
Frees colors allocated with gdk_colors_alloc(). This
function is obsolete. See gdk_colormap_free_colors().
</para>
@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:
<!-- ##### FUNCTION gdk_color_white ##### -->
<para>
Returns the white color for a given colormap. The resulting
value has already allocated been allocated.
</para>
@colormap: a #GdkColormap.
@color: the location to store the color.
@Returns: %TRUE if the allocation succeeded.
@colormap:
@color:
@Returns:
<!-- ##### FUNCTION gdk_color_black ##### -->
<para>
Returns the black color for a given colormap. The resulting
value has already benn allocated.
</para>
@colormap: a #GdkColormap.
@color: the location to store the color.
@Returns: %TRUE if the allocation succeeded.
@colormap:
@color:
@Returns:
<!-- ##### FUNCTION gdk_color_parse ##### -->
<para>
Parses a textual specification of a color and fill in
the <structfield>red</structfield>,
<structfield>green</structfield>, and
<structfield>blue</structfield> fields of a
#GdkColor structure. The color is <emphasis>not</emphasis>
allocated, you must call gdk_colormap_alloc_color() yourself.
The text string can be in any of the forms accepted
by <function>XParseColor</function>; these include
name for a color from <filename>rgb.txt</filename>, such as
<literal>DarkSlateGray</literal>, or a hex specification
such as <literal>305050</literal>.
</para>
@spec: the string specifying the color.
@color: the #GdkColor to fill in
@spec:
@color:
@Returns:
<!-- ##### FUNCTION gdk_color_alloc ##### -->
<para>
Allocates a single color from a colormap.
This function is obsolete. See gdk_colormap_alloc_color().
</para>
@colormap: a #GdkColormap.
@color: The color to allocate. On return, the
<structfield>pixel</structfield> field will be
filled in.
@Returns: %TRUE if the allocation succeeded.
@colormap:
@color:
@Returns:
<!-- ##### FUNCTION gdk_color_change ##### -->
<para>
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.
</para>
@colormap: a #GdkColormap.
@color: a #GdkColor, with the color to change
in the <structfield>pixel</structfield> field,
and the new value in the remaining fields.
@colormap:
@color:
@Returns:
<!-- ##### FUNCTION gdk_color_equal ##### -->
<para>
Compares two colors.
</para>
@colora: a #GdkColor.
@colorb: another #GdkColor.
@Returns: %TRUE if the two colors compare equal
@colora:
@colorb:
@Returns:
<!-- ##### FUNCTION gdk_color_hash ##### -->
<para>
A hash function suitable for using for a hash
table that stores #GdkColor's.
</para>
@colora: a #GdkColor.
@Returns: The hash function appled to @colora
@colora:
@Returns:

150
gdk/gdkcolor.c
View File

@ -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
* <structfield>pixel</structfield> 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
* <structfield>pixel</structfield> 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 <structfield>red</structfield>,
* <structfield>green</structfield>, and
* <structfield>blue</structfield> fields of a
* #GdkColor structure. The color is <emphasis>not</emphasis>
* allocated, you must call gdk_colormap_alloc_color() yourself.
* The text string can be in any of the forms accepted
* by <function>XParseColor</function>; these include
* name for a color from <filename>rgb.txt</filename>, such as
* <literal>DarkSlateGray</literal>, or a hex specification
* such as <literal>305050</literal>.
*
* Return value: %TRUE if the parsing succeeded.
**/
gboolean
gdk_color_parse (const gchar *spec,
GdkColor *color)

132
gdk/x11/gdkcolor-x11.c
View File

@ -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 <structfield>colors</structfield>
* 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 <function>XAllocColorCells()</function>.
*
* 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 <structfield>pixel</structfield> 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)