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-2007
68       University Corporation for Atmospheric Research
69
70       This documentation is free software; you can redistribute it and/or
71       modify it under the terms of the GNU General Public License as
72       published by the Free Software Foundation; either version 2 of the
73       License, or (at your option) any later version.
74
75       This software is distributed in the hope that it will be useful, but
76       WITHOUT ANY WARRANTY; without even the implied warranty of
77       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
78       General Public License for more details.
79
80       You should have received a copy of the GNU General Public License along
81       with this software; if not, write to the Free Software Foundation,
82       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
83
84
85
86
87UNIX                              March 1993                     FRSTD(3NCARG)
Impressum