NAME

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

SYNOPSIS

       CALL DPSMTH (XCPF,YCPF,IFVL)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_dpsmth (float xcpf, float ycpf, int ifvl);

DESCRIPTION

       XCPF        (an  input  expression  of type REAL) specifies the X coordinate of a point in the fractional
                   coordinate system.  Ignored when IFVL = 2.

       YCPF        (an input expression of type REAL) specifies the Y coordinate of a point  in  the  fractional
                   coordinate system.  Ignored when IFVL = 2.

       IFVL        (an  input expression of type INTEGER) indicates what type of call is being done: "0" implies
                   a "first-point" call, "1" implies a "vector" call, and "2" implies a "last-point" or "buffer-
                   flush" call.

C-BINDING DESCRIPTION

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

USAGE

       Use "CALL DPSMTH(XCPF,YCPF,0)" to do a "pen-up" move to the first point in a sequence of points  defining
       a curve.

       Use "CALL DPSMTH(XCPF,YCPF,1)" to do "pen-down" moves to the second and following points in a sequence of
       points defining a curve.

       Use  "CALL DPSMTH(0.,0.,2) to terminate a sequence of calls, finish drawing the curve, and flush internal
       buffers.

       DPSMTH accumulates points until it has an internal buffer-load or until the last one has  been  received.
       It  then  creates  a  smooth  curve passing through all the points, interpolates points along that smooth
       curve, and passes those points along to the routine DPDRAW.  If the internal parameter 'TCS' has a  value
       less  than  or  equal  to  zero,  the  smoothing is done using simple cubic splines; if 'TCS' has a value
       greater than zero, the smoothing is done using cubic  splines  under  tension  and  'TCS'  specifies  the
       desired tension.

EXAMPLES

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

ACCESS

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

SEE ALSO

       Online: dashpack, dashpack_params, dpcurv,  dpdraw,  dpfrst,  dpgetc,  dpgeti,  dpgetr,  dplast,  dpline,
       dpsetc, dpseti, dpsetr, dpvect, ncarg_cbind.

       Hardcopy: None.

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               March 1995                                     DPSMTH(3NCARG)