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

NAME

6       VECTD - Defines the second and following of a sequence of points
7       through which a curve is to be drawn.
8

SYNOPSIS

10       CALL VECTD (X,Y)
11

C-BINDING SYNOPSIS

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

DESCRIPTION

18       X           (an input expression of type REAL) defines the X user
19                   coordinate of the next point in a sequence of points
20                   defining a curve.
21
22       Y           (an input expression of type REAL) defines the Y user
23                   coordinate of the next point in a sequence of points
24                   defining a curve.
25

C-BINDING DESCRIPTION

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

USAGE

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

EXAMPLES

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

ACCESS

58       To use VECTD or c_vectd load the NCAR Graphics libraries ncarg,
59       ncarg_gks, and ncarg_c, preferably in that order.
60

SEE ALSO

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

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