GdkGC

A structure that contains graphics information.

Object Hierarchy

GdkGC

Description

A GdkGC is made up of a series of properties, each of which may or may not be set, that describe everything from color to font to line-width. It forms several of the underlying elements of the style property in widgets, and is used in GDK where GtkStyle would be used at GTK level. The GC part of GdkGC stands for graphics context, and every GDK drawing function requires one in much the same way that every GTK drawing function requires a style.

The functions that allow the getting and setting of GdkGC properties are internalised in PHP-GTK. For the most part, we have writeable properties instead of these methods. Please note that there is no guarantee that all these properties will be supported by your operating system; win32's 'little black boxes' text issue is there because win32 does not support stippling, for example.

There is no direct constructor for a GdkGC. To create one, you will need to use the GdkWindow method new_gc() and set the properties that you are interested in directly.

Properties

foreground:

  The foreground color.

background:

  The background color.

font:

  The loaded font.

function:

  Bitwise description of the drawing function.

fill:

  The style of the fill.

tile:

  The pixmap used for tiling.

stipple:

  The pixmap used for stippling.

clip_mask:

  The clip mask bitmap.

subwindow_mode:

  The way subwindows are treated.

ts_x_origin:

  Tile or stipple's x origin.

ts_y_origin:

  Tile or stipple's y origin.

clip_x_origin:

  Clip mask's x origin.

clip_y_origin:

  Clip mask's y origin.

graphics_exposures:

  Whether expose events are generated during pixmap copies.

line_width:

  The pixel width of a drawn line.

line_style:

  The way a dashed line is drawn.

cap_style:

  The way the end of a line is drawn.

join_style:

  The way line joins are drawn.