NAME

       FRSTD - Defines the first of a sequence of points through which a curve is to be drawn.

SYNOPSIS

       CALL FRSTD (X,Y)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_frstd (float x, float y)

DESCRIPTION

       X           (an input expression of type REAL) defines the X user coordinate of the
                   starting point of the curve.

       Y           (an input expression of type REAL) defines the Y user coordinate of the
                   starting point of the curve.

C-BINDING DESCRIPTION

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

USAGE

       One way to draw a curve with Dashline is to call FRSTD once to define the first point of
       the curve and then to call VECTD repeatedly to define the second and all following points
       of the curve.

       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 user-given points in the specified
       order.

       After the call to VECTD defining the last point of the curve, you may call LASTD, which
       flushes any portions of smoothed curves that are defined by coordinates saved in internal
       buffers of FRSTD and VECTD and that have not yet been drawn.  Calls to LASTD are not
       always required - for example, when a non-smoothing version of Dashline is used (no
       buffering) or when the next call to an NCAR Graphics routine will be to FRSTD (which
       flushes the buffers) - but unnecessary calls do no harm.  If you judge that one of the
       smoothing versions of Dashline may be used, it is best to put in the calls to LASTD.

EXAMPLES

       Use the ncargex command to see the following relevant examples: tdashc, tdashl, tdashp,
       tdashs, fdldashc, fdldashd.

ACCESS

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

SEE ALSO

       Online: dashline, dashline_params, curved, dashdb, dashdc, 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.