NAME

       AGCURV - Draws a curve in a manner specified by the current values of the control parameters - the
       primary parameters with default values or with values supplied by the user, and the secondary parameters
       with values computed by AGSTUP.

SYNOPSIS

       CALL AGCURV (XVEC,IIEX,YVEC,IIEY,NEXY,KDSH)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_agcurv (float *xvec, int iiex, float *yvec,
       int iiey, int nexy, int kdsh)

DESCRIPTION

       XVEC        (a  singly-subscripted  input  array  of  type REAL), when IIEX is non-zero, contains NEXY X-
                   coordinate data - curve point 1 has X coordinate XVEC(1), curve  point  2  has  X  coordinate
                   XVEC(1+IIEX),  curve  point  3  has  X coordinate XVEC(1+IIEX*2), etc. When IIEX is zero, the
                   array XVEC is ignored - curve point 1 has X coordinate "1.", curve point 2 has  X  coordinate
                   "2.", etc.

                   If  the value of any X coordinate matches the current value of 'NULL/1.' (default - "1.E36"),
                   the corresponding point is considered to be missing - curve segments on either side  of  that
                   point are not drawn.

       IIEX        (an  input  expression  of  type  INTEGER), if non-zero, is the index increment between one X
                   coordinate in XVEC and the next. If IIEX is zero, the array XVEC  is  ignored,  as  described
                   above.

       YVEC        (a  singly-subscripted input array of type REAL) is just like XVEC, but provides Y coordinate
                   data.

       IIEY        (an input expression of type INTEGER) is just like IIEX, but describes the use  (or  non-use)
                   of YVEC.

       NEXY        (an  input  expression  of  type  INTEGER)  is the number of curve points - the number of X/Y
                   coordinate pairs to be used.

                   Note: If 'INVERT.' is given the value "1." (in place of its default value "0."), AGCURV  will
                   behave  as  if  the arguments XVEC and IIEX had been interchanged with the arguments YVEC and
                   IIEY, so that X-coordinate values refer to vertical distances,  and  Y-coordinate  values  to
                   horizontal  distances,  on the graph. This parameter affects AGSTUP in a similar manner, thus
                   allowing one to plot "X as a function of Y".

       KDSH        (an input expression of type INTEGER) specifies the dashed-line pattern to be used in drawing
                   the curve. (Since the routines DASHD, FRSTD, VECTD, and LASTD, in the package  Dashline,  are
                   used  to  draw  the  curve,  it may have its own particular dashed-line pattern.)  If KDSH is
                   zero, the user is assumed to have done his own call to DASHD; AGCURV will do no such call.

                   •   If KDSH is zero, the user is assumed to have done his own call to DASHD; AGCURV  will  do
                       no such call.

                   •   If  KDSH  is non-zero and negative, the function MOD(-KDSH-1,26)+1 determines which of 26
                       "alphabetic" patterns is to be used; each of these generates a solid line interrupted  by
                       one  of  the  letters  of the alphabet. The value 1 implies that an "A" will be used, the
                       value 2 that a "B" will be used, . . . the value 27 that an "A" will be used again, etc.

                   •   If KDSH is non-zero and positive, the function  MOD(KDSH-1,n)+1  determines  which  of  n
                       "user"  patterns  is  to  be  used; these n patterns are defined by the parameters in the
                       group named 'DASH.' - the default values specify one solid-line pattern.

                   Note: The routines EZY and EZXY, which draw one curve per call, always call AGCURV with  KDSH
                   =  1.  The  routines EZMY and EZMXY, which draw one or more curves per call, call AGCURV with
                   KDSH = ISIGN(p,q), where p is the number of the curve being drawn (p is between 1  and  MANY,
                   inclusive) and q is the current integral value of 'DASH/SELECTOR.'.

C-BINDING DESCRIPTION

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

EXAMPLES

       Use the ncargex command to see the following relevant example: agex13.

ACCESS

       To  use AGCURV or c_agcurv, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in
       that order.  To get smoother curves, drawn using spline interpolation, also load libdashsmth.o.  Or,  you
       can  use the ncargf77 command to compile your program and load the above libraries, then, to get smoother
       curves, use the -dashsmth option.

MESSAGES

       See the autograph man page for a  description  of  all  Autograph  error  messages  and/or  informational
       messages.

SEE ALSO

       Online:  autograph,  agback,  agbnch,  agchax,  agchcu,  agchil,  agchnl, agdshn, aggetc, aggetf, aggeti,
       aggetp, aggetr, agpwrt, agrstr, agsave, agsetc, agsetf, agseti, agsetp, agsetr, agstup,  agutol,  anotat,
       displa, ezmxy, ezmy, ezxy, ezy

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

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

UNIX                                               March 1993                                     AGCURV(3NCARG)