ncl_curved - Man Page

Draws a curve through a sequence of points.

Synopsis

CALL CURVED (X,Y,N)

C-Binding Synopsis

#include <ncarg/ncargC.h>

void c_curved (float *x, float *y, int n)

Description

X

(an input array of type REAL) defines the X user coordinates of the curve.  Array X is of length N.

Y

(an input array of type REAL) defines the Y user coordinates of the curve.  Array Y is of length N.

N

(an input expression of type INTEGER) specifies the number of points in the curve.

C-Binding Description

The C-binding argument descriptions are the same as the FORTRAN  argument description.

Usage

The statement

CALL CURVED (X,Y,N)

is equivalent to the statements

CALL FRSTD (X(1),Y(1))
CALL VECTD (X(2),Y(2))
CALL VECTD (X(3),Y(3))
...(et cetera)...
CALL VECTD (X(N),Y(N))
CALL LASTD

The basic difference is that CURVED requires you to have all of the coordinates defining the curve available at once; sometimes this is convenient and sometimes it is not.

If three or more distinct points are given, and if one of the smoothing versions of Dashline is being used, and if the internal parameter that suppresses smoothing is not set, then splines under tension are used to generate a smooth curve; the number of points actually used to draw the curve will depend on its length.  In all other cases, the "curve" will be approximated by just connecting the given points in the specified order.

Examples

Use the ncargex command to see the following relevant examples:  carline, colcon, cmpfil, cmpgrp, cmpitm, cmplab, cmpmsk, cmptit, cpex01, cpex02, cpex03, cpex04, cpex06, vvex01, tdashc, tdashl, tdashp, tdashs, carline, fcover, ffex03, ffex05, fdlcurvd, fdldashd, fdlsmth, fpcloqu.

Access

To use CURVED or c_curved, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.  

See the man page for dashline to see how to access the quick, normal, smooth, and super line draw options.

See Also

Online: dashline, dashline_params, dashdb, dashdc, frstd, lastd, lined, reset, vectd, ncarg_cbind

Hardcopy:   NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

Info

March 1993 UNIX NCAR GRAPHICS