## GnomeCanvasLine GnomeCanvasLine — Line canvas item |

## Synopsis

    #include <libgnomecanvas/libgnomecanvas.h>

    struct              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"               gchar*                : 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

### struct GnomeCanvasLine

    struct 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"               gchar*                : 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