gdk-Colormaps-and-Colors: Colormaps and Colors
Description
Manipulation of colors and colormapsMethods and Functions
gdkColormapNew(visual, allocate)
gdkColormapGetSystem()
gdkColormapGetSystemSize()
gdkColormapAllocColors(colormap, colors, writeable, best.match)
gdkColormapAllocColor(object, color, writeable, best.match)
gdkColormapFreeColors(object, colors)
gdkColormapQueryColor(object, pixel)
gdkColormapGetVisual(object)
gdkColormapGetScreen(object)
gdkColorsStore(object, colors)
gdkColorWhite(object)
gdkColorBlack(object)
gdkColorParse(spec)
gdkColorAlloc(object, color)
gdkColorChange(object, color)
gdkColormap(visual, allocate)
Detailed Description
These functions are used to modify colormaps.
A colormap is an object that contains the mapping
between the color values stored in memory and
the RGB values that are used to display color
values. In general, colormaps only contain
significant information for pseudo-color visuals,
but even for other visual types, a colormap object
is required in some circumstances.
There are a couple of special colormaps that can
be retrieved. The system colormap (retrieved
with gdkColormapGetSystem
) is the default
colormap of the system. If you are using GdkRGB,
there is another colormap that is important - the
colormap in which GdkRGB works, retrieved with
gdkRgbGetCmap
. However, when using GdkRGB,
it is not generally necessary to allocate colors
directly.
In previous revisions of this interface, a number
of functions that take a GdkColormap
parameter
were replaced with functions whose names began
with "gdk_colormap_". This process will probably
be extended somewhat in the future -
gdkColorWhite
, gdkColorBlack
, and
gdkColorChange
will probably become aliases.Convenient Construction
gdkColormap
is the equivalent of gdkColormapNew
.References
http://developer.gnome.org/doc/API/2.0/gdk/gdk-Colormaps-and-Colors.html