Graphics Contexts

Graphics Contexts — A shared pool of GdkGC objects

Synopsis

#include <gtk/gtk.h>

GdkGC *             gtk_gc_get                          (gint depth,
                                                         GdkColormap *colormap,
                                                         GdkGCValues *values,
                                                         GdkGCValuesMask values_mask);
void                gtk_gc_release                      (GdkGC *gc);

Description

These functions provide access to a shared pool of GdkGC objects. When a new GdkGC is needed, gtk_gc_get() is called with the required depth, colormap and GdkGCValues. If a GdkGC with the required properties already exists then that is returned. If not, a new GdkGC is created. When the GdkGC is no longer needed, gtk_gc_release() should be called.

Details

gtk_gc_get ()

GdkGC *             gtk_gc_get                          (gint depth,
                                                         GdkColormap *colormap,
                                                         GdkGCValues *values,
                                                         GdkGCValuesMask values_mask);

Gets a GdkGC with the given depth, colormap and GdkGCValues. If a GdkGC with the given properties already exists then it is returned, otherwise a new GdkGC is created. The returned GdkGC should be released with gtk_gc_release() when it is no longer needed.

depth :

the depth of the GdkGC to create.

colormap :

the GdkColormap (FIXME: I don't know why this is needed).

values :

a GdkGCValues struct containing settings for the GdkGC.

values_mask :

a set of flags indicating which of the fields in values has been set.

Returns :

a GdkGC.

gtk_gc_release ()

void                gtk_gc_release                      (GdkGC *gc);

Releases a GdkGC allocated using gtk_gc_get().

gc :

a GdkGC.