1FRSTD(3NCARG)                    NCAR GRAPHICS                   FRSTD(3NCARG)
2
3
4

NAME

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

SYNOPSIS

10       CALL FRSTD (X,Y)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_frstd (float x, float y)
16

DESCRIPTION

18       X           (an input expression of type REAL) defines the X user
19                   coordinate of the starting point of the curve.
20
21       Y           (an input expression of type REAL) defines the Y user
22                   coordinate of the starting point of the curve.
23

C-BINDING DESCRIPTION

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

USAGE

29       One way to draw a curve with Dashline is to call FRSTD once to define
30       the first point of the curve and then to call VECTD repeatedly to
31       define the second and all following points of the curve.
32
33       If three or more distinct points are given, and if one of the smoothing
34       versions of Dashline is being used, and if the internal parameter that
35       suppresses smoothing is not set, then splines under tension are used to
36       generate a smooth curve; the number of points actually used to draw the
37       curve will depend on its length.  In all other cases, the "curve" will
38       be approximated by just connecting the user-given points in the
39       specified order.
40
41       After the call to VECTD defining the last point of the curve, you may
42       call LASTD, which flushes any portions of smoothed curves that are
43       defined by coordinates saved in internal buffers of FRSTD and VECTD and
44       that have not yet been drawn.  Calls to LASTD are not always required -
45       for example, when a non-smoothing version of Dashline is used (no
46       buffering) or when the next call to an NCAR Graphics routine will be to
47       FRSTD (which flushes the buffers) - but unnecessary calls do no harm.
48       If you judge that one of the smoothing versions of Dashline may be
49       used, it is best to put in the calls to LASTD.
50

EXAMPLES

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

ACCESS

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

SEE ALSO

60       Online: dashline, dashline_params, curved, dashdb, dashdc, lastd,
61       lined, reset, vectd, ncarg_cbind
62
63       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
64       Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics
65

67       Copyright (C) 1987-2009
68       University Corporation for Atmospheric Research
69
70       The use of this Software is governed by a License Agreement.
71
72
73
74UNIX                              March 1993                     FRSTD(3NCARG)
Impressum