NAME¶

gpolyline - Draw line segments connecting a sequence of user-specified coordinate pairs

SYNOPSIS¶

#include <ncarg/gks.h>

void gpolyline(const Gpoint_list *point_list);

DESCRIPTION¶

gpolyline (Polyline) - This output primitive draws line segments connecting a sequence of user-specified coordinate pairs.

point_list.num_points

(Gint, Input) - The number of points in the line to be drawn. Must be larger than one.

point_list.points

(Gint *, Input) - The X and Y coordinates (specified in world coordinates) of the point_list.num_points points to be connected by line segments.

USAGE¶

Note that the coordinate pairs must be in world coordinates and not user coordinates. Among other things, this means that the log scaling and mirror-imaging features available via the c_set call and the SPPS functions for drawing lines are not applicable here.

ACCESS¶

To use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries.

SEE ALSO¶

Online: gset_linetype(3NCARG), gset_linewidth(3NCARG), gset_colr_rep(3NCARG), gset_line_colr_ind(3NCARG), ginq_linetype(3NCARG), ginq_linewidth(3NCARG), ginq_line_colr_ind(3NCARG), dashline(3NCARG), set(3NCARG), gks(3NCARG), ncarg_gks_cbind(3NCARG)

Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version "The Use of X/Y Coordinates in NCAR Graphics" SCD User Document"

COPYRIGHT¶

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.