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-2009
70       University Corporation for Atmospheric Research
71       The use of this Software is governed by a License Agreement.
72
73
74
75UNIX                              March 1995                    DPSMTH(3NCARG)
Impressum