CURVED(3NCARG)

NAME
CURVED - 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

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