Graphics Contexts
<!-- ##### SECTION Short_Description ##### -->
-objects to encapsulate drawing properties.
+Objects to encapsulate drawing properties
<!-- ##### SECTION Long_Description ##### -->
<para>
</para>
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
<!-- ##### STRUCT GdkGC ##### -->
<para>
The #GdkGC structure represents a graphics context.
elements.
</para>
-@dummy_var:
<!-- ##### STRUCT GdkGCValues ##### -->
<para>
The #GdkGCValues structure holds a set of values used
to create or modify a graphics context.
+</para>
-<informaltable pgwide=1 frame="none" role="struct">
-<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
-<tbody>
-
-<row>
-<entry>#GdkColor foreground;</entry>
-<entry>the foreground color.</entry>
-</row>
-
-<row>
-<entry>#GdkColor background;</entry>
-<entry>the background color.</entry>
-</row>
-
-<row>
-<entry>#GdkFont *font;</entry>
-<entry>the default font..</entry>
-</row>
-
-<row>
-<entry>#GdkFunction function;</entry>
-<entry>the bitwise operation used when drawing.</entry>
-</row>
-
-<row>
-<entry>#GdkFill fill;</entry>
-<entry>the fill style.</entry>
-</row>
-
-<row>
-<entry>#GdkPixmap *tile;</entry>
-<entry>the tile pixmap.</entry>
-</row>
-
-<row>
-<entry>#GdkPixmap *stipple;</entry>
-<entry>the stipple bitmap.</entry>
-</row>
-
-<row>
-<entry>#GdkPixmap *clip_mask;</entry>
-<entry>the clip mask bitmap.</entry>
-</row>
-
-<row>
-<entry>#GdkSubwindowMode subwindow_mode;</entry>
-<entry>the subwindow mode.</entry>
-</row>
-
-<row>
-<entry>#gint ts_x_origin;</entry>
-<entry>the x origin of the tile or stipple.</entry>
-</row>
-
-<row>
-<entry>#gint ts_y_origin;</entry>
-<entry>the y origin of the tile or stipple.</entry>
-</row>
-
-<row>
-<entry>#gint clip_x_origin;</entry>
-<entry>the x origin of the clip mask.</entry>
-</row>
-
-<row>
-<entry>#gint clip_y_origin;</entry>
-<entry>the y origin of the clip mask.</entry>
-</row>
-
-<row>
-<entry>#gint graphics_exposures;</entry>
-<entry>whether graphics exposures are enabled.</entry>
-</row>
-
-<row>
-<entry>#gint line_width;</entry>
-<entry>the line width</entry>
-</row>
-
-<row>
-<entry>#GdkLineStyle line_style;</entry>
-<entry>the way dashed lines are drawn</entry>
-</row>
-
-<row>
-<entry>#GdkCapStyle cap_style;</entry>
-<entry>the way the ends of lines are drawn</entry>
-</row>
-
-<row>
-<entry>#GdkJoinStyle join_style;</entry>
-<entry>the way joins between lines are drawn</entry>
-</row>
-
-</tbody></tgroup></informaltable>
-</para>
-
-@foreground:
-@background:
-@font:
-@function:
-@fill:
-@tile:
-@stipple:
-@clip_mask:
-@subwindow_mode:
-@ts_x_origin:
-@ts_y_origin:
-@clip_x_origin:
-@clip_y_origin:
-@graphics_exposures:
-@line_width:
-@line_style:
-@cap_style:
-@join_style:
+@foreground: the foreground color. Note that gdk_gc_get_values()
+ only sets the pixel value.
+@background: the background color. Note that gdk_gc_get_values()
+ only sets the pixel value.
+@font: the default font.
+@function: the bitwise operation used when drawing.
+@fill: the fill style.
+@tile: the tile pixmap.
+@stipple: the stipple bitmap.
+@clip_mask: the clip mask bitmap.
+@subwindow_mode: the subwindow mode.
+@ts_x_origin: the x origin of the tile or stipple.
+@ts_y_origin: the y origin of the tile or stipple.
+@clip_x_origin: the x origin of the clip mask.
+@clip_y_origin: the y origin of the clip mask.
+@graphics_exposures: whether graphics exposures are enabled.
+@line_width: the line width.
+@line_style: the way dashed lines are drawn.
+@cap_style: the way the ends of lines are drawn.
+@join_style: the way joins between lines are drawn.
<!-- ##### ENUM GdkGCValuesMask ##### -->
<para>
#GdkGCValues structure are set.
</para>
-@GDK_GC_FOREGROUND:
-@GDK_GC_BACKGROUND:
-@GDK_GC_FONT:
-@GDK_GC_FUNCTION:
-@GDK_GC_FILL:
-@GDK_GC_TILE:
-@GDK_GC_STIPPLE:
-@GDK_GC_CLIP_MASK:
-@GDK_GC_SUBWINDOW:
-@GDK_GC_TS_X_ORIGIN:
-@GDK_GC_TS_Y_ORIGIN:
-@GDK_GC_CLIP_X_ORIGIN:
-@GDK_GC_CLIP_Y_ORIGIN:
-@GDK_GC_EXPOSURES:
-@GDK_GC_LINE_WIDTH:
-@GDK_GC_LINE_STYLE:
-@GDK_GC_CAP_STYLE:
-@GDK_GC_JOIN_STYLE:
-
-<!-- ##### ENUM GdkFill ##### -->
-<para>
-Determines how primitives are drawn.
-
-<informaltable pgwide=1 frame="none" role="enum">
-<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
-<tbody>
-
-<row>
-<entry>GDK_SOLID</entry>
-<entry>draw with the foreground color.</entry>
-</row>
-
-<row>
-<entry>GDK_TILED</entry>
-<entry>draw with a tiled pixmap.</entry>
-</row>
-
-<row>
-<entry>GDK_STIPPLED</entry>
-<entry>draw using the stipple bitmap. Pixels corresponding
-to bits in the stipple bitmap that are set will be drawn in the
-foreground color; pixels corresponding to bits that are
-not set will be left untouched.</entry>
-</row>
-
-<row>
-<entry>GDK_OPAQUE_STIPPLED</entry>
-<entry>draw using the stipple bitmap. Pixels corresponding
-to bits in the stipple bitmap that are set will be drawn in the
-foreground color; pixels corresponding to bits that are
-not set will be drawn with the background color.</entry>
-</row>
-
-</tbody></tgroup></informaltable>
-</para>
-
-@GDK_SOLID:
-@GDK_TILED:
-@GDK_STIPPLED:
-@GDK_OPAQUE_STIPPLED:
+@GDK_GC_FOREGROUND: the @foreground is set.
+@GDK_GC_BACKGROUND: the @background is set.
+@GDK_GC_FONT: the @font is set.
+@GDK_GC_FUNCTION: the @function is set.
+@GDK_GC_FILL: the @fill is set.
+@GDK_GC_TILE: the @tile is set.
+@GDK_GC_STIPPLE: the @stipple is set.
+@GDK_GC_CLIP_MASK: the @clip_mask is set.
+@GDK_GC_SUBWINDOW: the @subwindow_mode is set.
+@GDK_GC_TS_X_ORIGIN: the @ts_x_origin is set.
+@GDK_GC_TS_Y_ORIGIN: the @ts_y_origin is set.
+@GDK_GC_CLIP_X_ORIGIN: the @clip_x_origin is set.
+@GDK_GC_CLIP_Y_ORIGIN: the @clip_y_origin is set.
+@GDK_GC_EXPOSURES: the @graphics_exposures is set.
+@GDK_GC_LINE_WIDTH: the @line_width is set.
+@GDK_GC_LINE_STYLE: the @line_style is set.
+@GDK_GC_CAP_STYLE: the @cap_style is set.
+@GDK_GC_JOIN_STYLE: the @join_style is set.
<!-- ##### ENUM GdkFunction ##### -->
<para>
useful. For bitmaps, %GDK_AND and %GDK_OR are also useful.
</para>
-@GDK_COPY:
-@GDK_INVERT:
-@GDK_XOR:
-@GDK_CLEAR:
-@GDK_AND:
-@GDK_AND_REVERSE:
-@GDK_AND_INVERT:
-@GDK_NOOP:
-@GDK_OR:
-@GDK_EQUIV:
-@GDK_OR_REVERSE:
-@GDK_COPY_INVERT:
-@GDK_OR_INVERT:
-@GDK_NAND:
-@GDK_SET:
+@GDK_COPY: <literal>dst = src</literal>
+@GDK_INVERT: <literal>dst = NOT dst</literal>
+@GDK_XOR: <literal>dst = src XOR dst</literal>
+@GDK_CLEAR: <literal>dst = 0</literal>
+@GDK_AND: <literal>dst = dst AND src</literal>
+@GDK_AND_REVERSE: <literal>dst = src AND (NOT dst)</literal>
+@GDK_AND_INVERT: <literal>dst = (NOT src) AND dst</literal>
+@GDK_NOOP: <literal>dst = dst</literal>
+@GDK_OR: <literal>dst = src OR dst</literal>
+@GDK_EQUIV: <literal>dst = (NOT src) XOR dst</literal>
+@GDK_OR_REVERSE: <literal>dst = src OR (NOT dst)</literal>
+@GDK_COPY_INVERT: <literal>dst = NOT src</literal>
+@GDK_OR_INVERT: <literal>dst = (NOT src) OR dst</literal>
+@GDK_NAND: <literal>dst = (NOT src) OR (NOT dst)</literal>
+@GDK_NOR: <literal>dst = (NOT src) AND (NOT dst)</literal>
+@GDK_SET: <literal>dst = 1</literal>
-<!-- ##### ENUM GdkLineStyle ##### -->
+<!-- ##### FUNCTION gdk_gc_new ##### -->
<para>
-Determines how lines are drawn.
-
-<informaltable pgwide=1 frame="none" role="enum">
-<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
-<tbody>
+</para>
-<row>
-<entry>GDK_LINE_SOLID</entry>
-<entry>lines are drawn solid.</entry>
-</row>
+@drawable:
+@Returns:
-<row>
-<entry>GDK_LINE_ON_OFF_DASH</entry>
-<entry>even segments are drawn; odd segments are not drawn.</entry>
-</row>
-<row>
-<entry>GDK_LINE_DOUBLE_DASH</entry>
-<entry>even segments are normally. Odd segments are drawn
-in the background color if the fill style is %GDK_SOLID,
-or in the background color masked by the stipple if the
-fill style is %GDK_STIPPLED.</entry>
-</row>
+<!-- ##### FUNCTION gdk_gc_new_with_values ##### -->
+<para>
-</tbody></tgroup></informaltable>
</para>
-@GDK_LINE_SOLID:
-@GDK_LINE_ON_OFF_DASH:
-@GDK_LINE_DOUBLE_DASH:
+@drawable:
+@values:
+@values_mask:
+@Returns:
-<!-- ##### ENUM GdkCapStyle ##### -->
+
+<!-- ##### FUNCTION gdk_gc_get_screen ##### -->
<para>
-Determines how the end of lines are drawn.
-<informaltable pgwide=1 frame="none" role="struct">
-<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
-<tbody>
-
-<row>
-<entry>GDK_CAP_NOT_LAST</entry>
-<entry>the same as %GDK_CAP_BUTT for lines of non-zero width.
- for zero width lines, the final point on the line
- will not be drawn.</entry>
-</row>
-
-<row>
-<entry>GDK_CAP_BUTT</entry>
-<entry>the ends of the lines are drawn squared off and extending
- to the coordinates of the end point.</entry>
-</row>
-
-<row>
-<entry>GDK_CAP_ROUND</entry>
-<entry>the ends of the lines are drawn as semicircles with the
- diameter equal to the line width and centered at the
- end point.</entry>
-</row>
-
-<row>
-<entry>GDK_CAP_PROJECTING</entry>
-<entry>the ends of the lines are drawn squared off and extending
- half the width of the line beyond the end point.</entry>
-</row>
-</tbody></tgroup></informaltable>
-</para>
-
-@GDK_CAP_NOT_LAST:
-@GDK_CAP_BUTT:
-@GDK_CAP_ROUND:
-@GDK_CAP_PROJECTING:
+</para>
-<!-- ##### ENUM GdkJoinStyle ##### -->
+@gc:
+@Returns:
+
+
+<!-- ##### FUNCTION gdk_gc_set_values ##### -->
<para>
-Determines how the joins between segments of a polygon are drawn.
-<informaltable pgwide=1 frame="none" role="struct">
-<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
-<tbody>
+</para>
-<row>
-<entry>GDK_JOIN_MITER</entry>
-<entry>the sides of each line are extended to meet at an angle.</entry>
-</row>
+@gc:
+@values:
+@values_mask:
-<row>
-<entry>GDK_JOIN_ROUND</entry>
-<entry>the sides of the two lines are joined by a circular arc.</entry>
-</row>
-<row>
-<entry>GDK_JOIN_BEVEL</entry>
-<entry>the sides of the two lines are joined by a straight line which
- makes an equal angle with each line.</entry>
-</row>
+<!-- ##### FUNCTION gdk_gc_get_values ##### -->
+<para>
-</tbody></tgroup></informaltable>
</para>
-@GDK_JOIN_MITER:
-@GDK_JOIN_ROUND:
-@GDK_JOIN_BEVEL:
+@gc:
+@values:
-<!-- ##### FUNCTION gdk_gc_new ##### -->
+
+<!-- ##### FUNCTION gdk_gc_set_foreground ##### -->
<para>
-Create a new graphics context with default values.
+
</para>
-@window: a #GdkDrawable. The created GC must always be used
- with drawables of the same depth as this one.
-@Returns: the new graphics context.
+@gc:
+@color:
-<!-- ##### FUNCTION gdk_gc_new_with_values ##### -->
+<!-- ##### FUNCTION gdk_gc_set_background ##### -->
<para>
-Create a new GC with the given initial values.
+
</para>
-@window: a #GdkDrawable. The created GC must always be used
- with drawables of the same depth as this one.
-@values: a structure containing initial values for the GC.
-@values_mask: a bit mask indicating which fields in @values
- are set.
-@Returns: the new graphics context.
+@gc:
+@color:
-<!-- ##### FUNCTION gdk_gc_ref ##### -->
+<!-- ##### FUNCTION gdk_gc_set_rgb_fg_color ##### -->
<para>
-Increase the reference count on a graphics context.
+
</para>
-@gc: a #GdkGC.
-@Returns: @gc.
+@gc:
+@color:
-<!-- ##### FUNCTION gdk_gc_unref ##### -->
+<!-- ##### FUNCTION gdk_gc_set_rgb_bg_color ##### -->
<para>
-Decrease the reference count on a graphics context. If
-the resulting reference count is zero, the graphics
-context will be destroyed.
+
</para>
-@gc: a #GdkGC.
+@gc:
+@color:
-<!-- ##### FUNCTION gdk_gc_destroy ##### -->
+<!-- ##### FUNCTION gdk_gc_set_function ##### -->
<para>
-Identical to gdk_gc_unref(). This function is obsolete
-and should not be used.
+
</para>
-@gc: a #GdkGC.
+@gc:
+@function:
-<!-- ##### FUNCTION gdk_gc_get_values ##### -->
+<!-- ##### FUNCTION gdk_gc_set_fill ##### -->
<para>
-Retrieves the current values from a graphics context.
+
</para>
-@gc: a #GdkGC.
-@values: the #GdkGCValues structure in which to store the results.
+@gc:
+@fill:
-<!-- ##### FUNCTION gdk_gc_set_foreground ##### -->
+<!-- ##### ENUM GdkFill ##### -->
<para>
-Sets the foreground color for a graphics context.
+Determines how primitives are drawn.
</para>
-@gc: a #GdkGC.
-@color: the new foreground color.
+@GDK_SOLID: draw with the foreground color.
+@GDK_TILED: draw with a tiled pixmap.
+@GDK_STIPPLED: draw using the stipple bitmap. Pixels corresponding
+ to bits in the stipple bitmap that are set will be drawn in the
+ foreground color; pixels corresponding to bits that are
+ not set will be left untouched.
+@GDK_OPAQUE_STIPPLED: draw using the stipple bitmap. Pixels corresponding
+ to bits in the stipple bitmap that are set will be drawn in the
+ foreground color; pixels corresponding to bits that are
+ not set will be drawn with the background color.
-
-<!-- ##### FUNCTION gdk_gc_set_background ##### -->
+<!-- ##### FUNCTION gdk_gc_set_tile ##### -->
<para>
-Sets the background color for a graphics context.
+
</para>
-@gc: a #GdkGC.
-@color: the new background color.
+@gc:
+@tile:
-<!-- ##### FUNCTION gdk_gc_set_font ##### -->
+<!-- ##### FUNCTION gdk_gc_set_stipple ##### -->
<para>
-Sets the font for a graphics context. (Note that
-all text-drawing functions in GDK take a @font
-argument; the value set here is used when that
-argument is %NULL.)
+
</para>
-@gc: a #GdkGC.
-@font: the new font.
+@gc:
+@stipple:
-<!-- ##### FUNCTION gdk_gc_set_function ##### -->
+<!-- ##### FUNCTION gdk_gc_set_ts_origin ##### -->
<para>
-Determines how the current pixel values and the
-pixel values being drawn are combined to produce
-the final pixel values.
+
</para>
-@gc: a #GdkGC.
-@function:
+@gc:
+@x:
+@y:
-<!-- ##### FUNCTION gdk_gc_set_fill ##### -->
+<!-- ##### FUNCTION gdk_gc_set_clip_origin ##### -->
<para>
-Set the fill mode for a graphics context.
+
</para>
-@gc: a #GdkGC.
-@fill: the new fill mode.
+@gc:
+@x:
+@y:
-<!-- ##### FUNCTION gdk_gc_set_tile ##### -->
+<!-- ##### FUNCTION gdk_gc_set_clip_mask ##### -->
<para>
-Set a tile pixmap for a graphics context.
-This will only be used if the fill mode
-is %GDK_TILED.
+
</para>
-@gc: a #GdkGC.
-@tile: the new tile pixmap.
+@gc:
+@mask:
-<!-- ##### FUNCTION gdk_gc_set_stipple ##### -->
+<!-- ##### FUNCTION gdk_gc_set_clip_rectangle ##### -->
<para>
-Set the stipple bitmap for a graphics context. The
-stipple will only be used if the fill mode is
-%GDK_STIPPLED or %GDK_OPAQUE_STIPPLED.
</para>
-@gc: a #GdkGC.
-@stipple: the new stipple bitmap.
+@gc:
+@rectangle:
-<!-- ##### FUNCTION gdk_gc_set_ts_origin ##### -->
+<!-- ##### FUNCTION gdk_gc_set_clip_region ##### -->
<para>
-Set the origin when using tiles or stipples with
-the GC. The tile or stipple will be aligned such
-that the upper left corner of the tile or stipple
-will coincide with this point.
+
</para>
-@gc: a #GdkGC.
-@x: the x-coordinate of the origin.
-@y: the y-coordinate of the origin.
+@gc:
+@region:
-<!-- ##### FUNCTION gdk_gc_set_clip_origin ##### -->
+<!-- ##### FUNCTION gdk_gc_set_subwindow ##### -->
<para>
-Sets the origin of the clip mask. The coordinates are
-interpreted relative to the upper-left corner of
-the destination drawable of the current operation.
+
</para>
-@gc: a #GdkGC.
-@x: the x-coordinate of the origin.
-@y: the y-coordinate of the origin.
+@gc:
+@mode:
-<!-- ##### FUNCTION gdk_gc_set_clip_mask ##### -->
+<!-- ##### ENUM GdkSubwindowMode ##### -->
<para>
-Sets the clip mask for a graphics context from a bitmap.
-The clip mask is interpreted relative to the clip
-origin. (See gdk_gc_set_clip_origin()).
+Determines how drawing onto a window will affect child
+windows of that window.
</para>
-@gc: the #GdkGC.
-@mask: a bitmap.
-
+@GDK_CLIP_BY_CHILDREN: only draw onto the window itself.
+@GDK_INCLUDE_INFERIORS: draw onto the window and child windows.
-<!-- ##### FUNCTION gdk_gc_set_clip_rectangle ##### -->
+<!-- ##### FUNCTION gdk_gc_set_exposures ##### -->
<para>
-Sets the clip mask for a graphics context from a
-rectangle. The clip mask is interpreted relative to the clip
-origin. (See gdk_gc_set_clip_origin()).
</para>
-@gc: a #GdkGC.
-@rectangle: the rectangle to clip to.
+@gc:
+@exposures:
-<!-- ##### FUNCTION gdk_gc_set_clip_region ##### -->
+<!-- ##### FUNCTION gdk_gc_set_line_attributes ##### -->
<para>
-Sets the clip mask for a graphics context from a region structure.
-The clip mask is interpreted relative to the clip origin. (See
-gdk_gc_set_clip_origin()).
+
</para>
-@gc: a #GdkGC.
-@region: the #GdkRegion.
+@gc:
+@line_width:
+@line_style:
+@cap_style:
+@join_style:
-<!-- ##### FUNCTION gdk_gc_set_subwindow ##### -->
+<!-- ##### ENUM GdkLineStyle ##### -->
<para>
-Sets how drawing with this GC on a window will affect child
-windows of that window.
+Determines how lines are drawn.
</para>
-@gc: a #GdkGC.
-@mode: the subwindow mode.
-
+@GDK_LINE_SOLID: lines are drawn solid.
+@GDK_LINE_ON_OFF_DASH: even segments are drawn; odd segments are not drawn.
+@GDK_LINE_DOUBLE_DASH: even segments are normally. Odd segments are drawn
+ in the background color if the fill style is %GDK_SOLID, or in the background
+ color masked by the stipple if the fill style is %GDK_STIPPLED.
-<!-- ##### ENUM GdkSubwindowMode ##### -->
+<!-- ##### ENUM GdkCapStyle ##### -->
<para>
+Determines how the end of lines are drawn.
+</para>
-Determines how drawing onto a window will affect child
-windows of that window.
+@GDK_CAP_NOT_LAST: the same as %GDK_CAP_BUTT for lines of non-zero width.
+ for zero width lines, the final point on the line will not be drawn.
+@GDK_CAP_BUTT: the ends of the lines are drawn squared off and extending
+ to the coordinates of the end point.
+@GDK_CAP_ROUND: the ends of the lines are drawn as semicircles with the
+ diameter equal to the line width and centered at the end point.
+@GDK_CAP_PROJECTING: the ends of the lines are drawn squared off and extending
+ half the width of the line beyond the end point.
-<informaltable pgwide=1 frame="none" role="enum">
-<tgroup cols="2"><colspec colwidth="3*"><colspec colwidth="7*">
-<tbody>
+<!-- ##### ENUM GdkJoinStyle ##### -->
+<para>
+Determines how the joins between segments of a polygon are drawn.
+</para>
-<row>
-<entry>GDK_CLIP_BY_CHILDREN</entry>
-<entry>only draw onto the window itself.</entry>
-</row>
+@GDK_JOIN_MITER: the sides of each line are extended to meet at an angle.
+@GDK_JOIN_ROUND: the sides of the two lines are joined by a circular arc.
+@GDK_JOIN_BEVEL: the sides of the two lines are joined by a straight line which
+ makes an equal angle with each line.
-<row>
-<entry>GDK_INCLUDE_INFERIORS</entry>
-<entry>Draw onto the window and child windows.</entry>
-</row>
+<!-- ##### FUNCTION gdk_gc_set_dashes ##### -->
+<para>
-</tbody></tgroup></informaltable>
</para>
-@GDK_CLIP_BY_CHILDREN:
-@GDK_INCLUDE_INFERIORS:
+@gc:
+@dash_offset:
+@dash_list:
+@n:
-<!-- ##### FUNCTION gdk_gc_set_exposures ##### -->
+
+<!-- ##### FUNCTION gdk_gc_copy ##### -->
<para>
-Sets whether copying non-visible portions of a drawable
-using this graphics context generate exposure events
-for the corresponding regions of the destination
-drawable. (See gdk_draw_pixmap()).
+
</para>
-@gc: a #GdkGC.
-@exposures: if %TRUE, exposure events will be generated.
+@dst_gc:
+@src_gc:
-<!-- ##### FUNCTION gdk_gc_set_line_attributes ##### -->
+<!-- ##### FUNCTION gdk_gc_set_colormap ##### -->
<para>
-Sets various attributes of how lines are drawn. See
-the corresponding members of GdkGCValues for full
-explanations of the arguments.
+
</para>
-@gc: a #GdkGC.
-@line_width: the width of lines.
-@line_style: the dash-style for lines.
-@cap_style: the manner in which the ends of lines are drawn.
-@join_style: the in which lines are joined together.
+@gc:
+@colormap:
-<!-- ##### FUNCTION gdk_gc_set_dashes ##### -->
+<!-- ##### FUNCTION gdk_gc_get_colormap ##### -->
<para>
-Sets the way dashed-lines are drawn. Lines will be
-drawn with alternating on and off segments of the
-lengths specified in @dash_list. The manner in
-which the on and off segments are drawn is determined
-by the @line_style value of the GC. (This can
-be changed with gdk_gc_set_line_attributes)
+
</para>
-@gc: a #GdkGC.
-@dash_offset: the
-@dash_list: an array of dash lengths.
-@n: the number of elements in @dash_list.
+@gc:
+@Returns:
-<!-- ##### FUNCTION gdk_gc_copy ##### -->
+<!-- ##### FUNCTION gdk_gc_offset ##### -->
<para>
-Copy the set of values from one graphics context
-onto another graphics context.
+
</para>
-@dst_gc: the destination graphics context.
-@src_gc: the source graphics context.
+@gc:
+@x_offset:
+@y_offset:
+
+