## GnomeCanvasLine

GnomeCanvasLine — Line canvas item

## Synopsis

    #include <libgnomecanvas/libgnomecanvas.h>

                        GnomeCanvasLine;

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GnomeCanvasItem
                         +----GnomeCanvasLine

## Properties

      "arrow-shape-a"            gdouble               : Read / Write
      "arrow-shape-b"            gdouble               : Read / Write
      "arrow-shape-c"            gdouble               : Read / Write
      "cap-style"                GdkCapStyle           : Read / Write
      "fill-color"               gchararray            : Read / Write
      "fill-color-gdk"           GdkColor              : Read / Write
      "fill-color-rgba"          guint                 : Read / Write
      "fill-stipple"             GdkDrawable           : Read / Write
      "first-arrowhead"          gboolean              : Read / Write
      "join-style"               GdkJoinStyle          : Read / Write
      "last-arrowhead"           gboolean              : Read / Write
      "line-style"               GdkLineStyle          : Read / Write
      "points"                   GnomeCanvasPoints     : Read / Write
      "smooth"                   gboolean              : Read / Write
      "spline-steps"             guint                 : Read / Write
      "width-pixels"             guint                 : Read / Write
      "width-units"              gdouble               : Read / Write

## Description

A canvas item for drawing lines. This canvas item uses a GnomeCanvasPoints structure so one or multiple joined lined segments can be drawn with a single GnomeCanvasLine item.

## Details

### GnomeCanvasLine

    typedef struct _GnomeCanvasLine GnomeCanvasLine;

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

## Property Details

### The "`arrow-shape-a`" property

      "arrow-shape-a"            gdouble               : Read / Write

Distance from tip of arrowhead to center.

Default value: 0

### The "`arrow-shape-b`" property

      "arrow-shape-b"            gdouble               : Read / Write

Distance from tip of arrowhead to trailing point, measured along shaft.

Default value: 0

### The "`arrow-shape-c`" property

      "arrow-shape-c"            gdouble               : Read / Write

Distance of arrowhead trailing points from outside edge of shaft.

Default value: 0

### The "`cap-style`" property

      "cap-style"                GdkCapStyle           : Read / Write

Determines how the ends of lines are drawn (the line cap style).

Default value: GDK_CAP_BUTT

### The "`fill-color`" property

      "fill-color"               gchararray            : Read / Write

X color specification for line.

Default value: NULL

### The "`fill-color-gdk`" property

      "fill-color-gdk"           GdkColor              : Read / Write

Pointer to an allocated GdkColor to draw the line with.

### The "`fill-color-rgba`" property

      "fill-color-rgba"          guint                 : Read / Write

Line color with an alpha component (in the format 0xRRGGBBAA).

Default value: 0

### The "`fill-stipple`" property

      "fill-stipple"             GdkDrawable           : Read / Write

Stipple pattern for the line.

### The "`first-arrowhead`" property

      "first-arrowhead"          gboolean              : Read / Write

Specifies whether to draw an arrowhead on the first point of the line.

Default value: FALSE

### The "`join-style`" property

      "join-style"               GdkJoinStyle          : Read / Write

Vertex join style for line segments (GDK_JOIN_MITER to join by extending each line to meet at an angle, GDK_JOIN_ROUND to join by a circular arc, and GDK_JOIN_BEVEL to join by a straight line which makes an equal angle with each line).

Default value: GDK_JOIN_MITER

### The "`last-arrowhead`" property

      "last-arrowhead"           gboolean              : Read / Write

Specifies whether to draw an arrowhead on the last point of the line.

Default value: FALSE

### The "`line-style`" property

      "line-style"               GdkLineStyle          : Read / Write

Line dash style.

Default value: GDK_LINE_SOLID

### The "`points`" property

      "points"                   GnomeCanvasPoints     : Read / Write

Pointer to a GnomeCanvasPoints structure. This can be created by a call to `gnome_canvas_points_new()`.

### The "`smooth`" property

      "smooth"                   gboolean              : Read / Write

Specifies whether to smooth the line using parabolic splines.

Default value: FALSE

### The "`spline-steps`" property

      "spline-steps"             guint                 : Read / Write

Specifies the number of steps to use when rendering curves.

Default value: 12

### The "`width-pixels`" property

      "width-pixels"             guint                 : Read / Write

Width of the line in pixels. The line width will not be scaled when the canvas zoom factor changes.

Default value: 0

### The "`width-units`" property

      "width-units"              gdouble               : Read / Write

Width of the line in canvas units. The line width will be scaled when the canvas zoom factor changes.

Allowed values: >= 0

Default value: 0