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.