## table of contents

GPL(3NCARG) | NCAR GRAPHICS | GPL(3NCARG) |

# NAME¶

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

# SYNOPSIS¶

CALL GPL (N, X, Y)

# C-BINDING SYNOPSIS¶

#include <ncarg/gks.h>

void gpolyline(const Gpoint_list *point_list);

# DESCRIPTION¶

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

- N
- (Integer, Input) - The number of points in the line to be drawn. N must be larger than one.
- X (N)
- (Real Array, Input) - The X coordinates (specified in world coordinates) of the N points to be connected by line segments.
- Y (N)
- (Real Array, Input) - The Y coordinates (specified in world coordinates) of the N 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 SET call and the SPPS functions for drawing lines are not applicable here.

# ACCESS¶

To use GKS routines, load the NCAR GKS-0A library ncarg_gks.

# SEE ALSO¶

Online: gsln, gslwsc, gscr, gsplci, gqln, gqlwsc, gqplci, dashline, set, gpolyline

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.

March 1993 | UNIX |