## GnomeCanvasShape

GnomeCanvasShape — Base class for canvas item shapes

##

# Synopsis

    #include <libgnomecanvas/libgnomecanvas.h>

    struct      GnomeCanvasShape;
    void        gnome_canvas_shape_set_path_def (GnomeCanvasShape *shape,
                                                 GnomeCanvasPathDef *def);
    GnomeCanvasPathDef* gnome_canvas_shape_get_path_def
                                                (GnomeCanvasShape *shape);

## Object Hierarchy

      GObject
       +----GtkObject
             +----GnomeCanvasItem
                   +----GnomeCanvasShape
                         +----GnomeCanvasBpath
                         +----GnomeCanvasRE
                         +----GnomeCanvasPolygon

## Properties

      "cap-style"            GdkCapStyle          : Read / Write
      "dash"                 gpointer             : Read / Write
      "fill-color"           gchararray           : Write
      "fill-color-gdk"       GdkColor             : Read / Write
      "fill-color-rgba"      guint                : Read / Write
      "fill-stipple"         GdkDrawable          : Read / Write
      "join-style"           GdkJoinStyle         : Read / Write
      "miterlimit"           gdouble              : Read / Write
      "outline-color"        gchararray           : Write
      "outline-color-gdk"    GdkColor             : Read / Write
      "outline-color-rgba"   guint                : Read / Write
      "outline-stipple"      GdkDrawable          : Read / Write
      "width-pixels"         guint                : Read / Write
      "width-units"          gdouble              : Write
      "wind"                 guint                : Read / Write

## Description

Provides a base class for canvas item shapes, including: GnomeCanvasBpath, GnomeCanvasEllipse, GnomeCanvasRect, and GnomeCanvasPolygon.

## Details

### struct GnomeCanvasShape

    struct GnomeCanvasShape;

This structure should not be accessed directly. Use the object's properties and functions for querying or changing its parameters.

### gnome_canvas_shape_set_path_def ()

    void        gnome_canvas_shape_set_path_def (GnomeCanvasShape *shape,
                                                 GnomeCanvasPathDef *def);

This function sets the the GnomeCanvasPathDef used by the GnomeCanvasShape. Notice, that it does not request updates, as it is meant to be used from item implementations, from inside update queue.

`shape` : | a GnomeCanvasShape
`def` : | a GnomeCanvasPathDef

### gnome_canvas_shape_get_path_def ()

    GnomeCanvasPathDef* gnome_canvas_shape_get_path_def
                                                (GnomeCanvasShape *shape);

This function returns the GnomeCanvasPathDef that the shape currently uses. It adds a reference to the GnomeCanvasPathDef and returns it, if there is not a GnomeCanvasPathDef set for the shape it returns NULL.

`shape` : | a GnomeCanvasShape
Returns : | a GnomeCanvasPathDef or NULL if none is set for the shape.

## Properties

"`cap-style`" (GdkCapStyle : Read / Write) | Cap (end point) style for the bpath.
"`dash`" (gpointer : Read / Write) | Dashing pattern.
"`fill-color`" (gchararray : Write) | X color specification for fill color, or NULL pointer for no color (transparent).
"`fill-color-gdk`" (GdkColor : Read / Write) | Allocated GdkColor for fill.
"`fill-color-rgba`" (guint : Read / Write) | Fill color with an alpha component (in the format 0xRRGGBBAA).
"`fill-stipple`" (GdkDrawable : Read / Write) | Stipple pattern for fill.
"`join-style`" (GdkJoinStyle : Read / Write) | Vertex join style for the bpath.
"`miterlimit`" (gdouble : Read / Write) | Minimum angle between segments, where miter join rule is applied.
"`outline-color`" (gchararray : Write) | X color specification for outline color, or NULL pointer for no color (transparent).
"`outline-color-gdk`" (GdkColor : Read / Write) | Allocated GdkColor for outline.
"`outline-color-rgba`" (guint : Read / Write) | Outline color with an alpha component (in the format 0xRRGGBBAA).
"`outline-stipple`" (GdkDrawable : Read / Write) | Stipple pattern for outline.
"`width-pixels`" (guint : Read / Write) | Width of the outline in pixels. The outline will not be scaled when the canvas zoom factor is changed.
"`width-units`" (gdouble : Write) | Width of the outline in canvas units. The outline will be scaled when the canvas zoom factor is changed.
"`wind`" (guint : Read / Write) | Winding rule for the bpath (ArtWindRule).