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

NAME

6       DPSMTH - Used to draw a curve when fractional coordinates are available
7       and smoothing is to be done.
8

SYNOPSIS

10       CALL DPSMTH (XCPF,YCPF,IFVL)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_dpsmth (float xcpf, float ycpf, int ifvl);
16

DESCRIPTION

18       XCPF        (an input expression of type REAL) specifies the X
19                   coordinate of a point in the fractional coordinate system.
20                   Ignored when IFVL = 2.
21
22       YCPF        (an input expression of type REAL) specifies the Y
23                   coordinate of a point in the fractional coordinate system.
24                   Ignored when IFVL = 2.
25
26       IFVL        (an input expression of type INTEGER) indicates what type
27                   of call is being done: "0" implies a "first-point" call,
28                   "1" implies a "vector" call, and "2" implies a "last-point"
29                   or "buffer-flush" call.
30

C-BINDING DESCRIPTION

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

USAGE

36       Use "CALL DPSMTH(XCPF,YCPF,0)" to do a "pen-up" move to the first point
37       in a sequence of points defining a curve.
38
39       Use "CALL DPSMTH(XCPF,YCPF,1)" to do "pen-down" moves to the second and
40       following points in a sequence of points defining a curve.
41
42       Use "CALL DPSMTH(0.,0.,2) to terminate a sequence of calls, finish
43       drawing the curve, and flush internal buffers.
44
45       DPSMTH accumulates points until it has an internal buffer-load or until
46       the last one has been received.  It then creates a smooth curve passing
47       through all the points, interpolates points along that smooth curve,
48       and passes those points along to the routine DPDRAW.  If the internal
49       parameter 'TCS' has a value less than or equal to zero, the smoothing
50       is done using simple cubic splines; if 'TCS' has a value greater than
51       zero, the smoothing is done using cubic splines under tension and 'TCS'
52       specifies the desired tension.
53

EXAMPLES

55       Use the ncargex command to see the following relevant examples: tdshpk.
56

ACCESS

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

SEE ALSO

62       Online: dashpack, dashpack_params, dpcurv, dpdraw, dpfrst, dpgetc,
63       dpgeti, dpgetr, dplast, dpline, dpsetc, dpseti, dpsetr, dpvect,
64       ncarg_cbind.
65
66       Hardcopy: None.
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 1995                    DPSMTH(3NCARG)
Impressum