1AGCURV(3NCARG) NCAR GRAPHICS AGCURV(3NCARG)
2
6 AGCURV - Draws a curve in a manner specified by the current values of
7 the control parameters - the primary parameters with default values or
8 with values supplied by the user, and the secondary parameters with
9 values computed by AGSTUP.
10
12 CALL AGCURV (XVEC,IIEX,YVEC,IIEY,NEXY,KDSH)
13
15 #include <ncarg/ncargC.h>
16 void c_agcurv (float *xvec, int iiex, float *yvec,
18 int iiey, int nexy, int kdsh)
19
21 XVEC (a singly-subscripted input array of type REAL), when IIEX
22 is non-zero, contains NEXY X-coordinate data - curve point
23 1 has X coordinate XVEC(1), curve point 2 has X coordinate
24 XVEC(1+IIEX), curve point 3 has X coordinate
25 XVEC(1+IIEX*2), etc. When IIEX is zero, the array XVEC is
26 ignored - curve point 1 has X coordinate "1.", curve point
27 2 has X coordinate "2.", etc.
28 If the value of any X coordinate matches the current value
30 of 'NULL/1.' (default - "1.E36"), the corresponding point
31 is considered to be missing - curve segments on either side
32 of that point are not drawn.
33 IIEX (an input expression of type INTEGER), if non-zero, is the
35 index increment between one X coordinate in XVEC and the
36 next. If IIEX is zero, the array XVEC is ignored, as
37 described above.
38 YVEC (a singly-subscripted input array of type REAL) is just
40 like XVEC, but provides Y coordinate data.
41 IIEY (an input expression of type INTEGER) is just like IIEX,
43 but describes the use (or non-use) of YVEC.
44 NEXY (an input expression of type INTEGER) is the number of
46 curve points - the number of X/Y coordinate pairs to be
47 used.
48 Note: If 'INVERT.' is given the value "1." (in place of its
50 default value "0."), AGCURV will behave as if the arguments
51 XVEC and IIEX had been interchanged with the arguments YVEC
52 and IIEY, so that X-coordinate values refer to vertical
53 distances, and Y-coordinate values to horizontal distances,
54 on the graph. This parameter affects AGSTUP in a similar
55 manner, thus allowing one to plot "X as a function of Y".
56 KDSH (an input expression of type INTEGER) specifies the dashed-
58 line pattern to be used in drawing the curve. (Since the
59 routines DASHD, FRSTD, VECTD, and LASTD, in the package
60 Dashline, are used to draw the curve, it may have its own
61 particular dashed-line pattern.) If KDSH is zero, the user
62 is assumed to have done his own call to DASHD; AGCURV will
63 do no such call.
64 · If KDSH is zero, the user is assumed to have done his
66 own call to DASHD; AGCURV will do no such call.
67 · If KDSH is non-zero and negative, the function
69 MOD(-KDSH-1,26)+1 determines which of 26 "alphabetic"
70 patterns is to be used; each of these generates a solid
71 line interrupted by one of the letters of the alphabet.
72 The value 1 implies that an "A" will be used, the value
73 2 that a "B" will be used, . . . the value 27 that an
74 "A" will be used again, etc.
75 · If KDSH is non-zero and positive, the function
77 MOD(KDSH-1,n)+1 determines which of n "user" patterns
78 is to be used; these n patterns are defined by the
79 parameters in the group named 'DASH.' - the default
80 values specify one solid-line pattern.
81 Note: The routines EZY and EZXY, which draw one curve per
83 call, always call AGCURV with KDSH = 1. The routines EZMY
84 and EZMXY, which draw one or more curves per call, call
85 AGCURV with KDSH = ISIGN(p,q), where p is the number of the
86 curve being drawn (p is between 1 and MANY, inclusive) and
87 q is the current integral value of 'DASH/SELECTOR.'.
88
90 The C-binding argument descriptions are the same as the FORTRAN
91 argument descriptions.
92
94 Use the ncargex command to see the following relevant example: agex13.
95
97 To use AGCURV or c_agcurv, load the NCAR Graphics libraries ncarg,
98 ncarg_gks, and ncarg_c, preferably in that order. To get smoother
99 curves, drawn using spline interpolation, also load libdashsmth.o. Or,
100 you can use the ncargf77 command to compile your program and load the
101 above libraries, then, to get smoother curves, use the -dashsmth
102 option.
103
105 See the autograph man page for a description of all Autograph error
106 messages and/or informational messages.
107
109 Online: autograph, agback, agbnch, agchax, agchcu, agchil, agchnl,
110 agdshn, aggetc, aggetf, aggeti, aggetp, aggetr, agpwrt, agrstr, agsave,
111 agsetc, agsetf, agseti, agsetp, agsetr, agstup, agutol, anotat, displa,
112 ezmxy, ezmy, ezxy, ezy
113 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
115
117 Copyright (C) 1987-2007
118 University Corporation for Atmospheric Research
119 This documentation is free software; you can redistribute it and/or
121 modify it under the terms of the GNU General Public License as
122 published by the Free Software Foundation; either version 2 of the
123 License, or (at your option) any later version.
124 This software is distributed in the hope that it will be useful, but
126 WITHOUT ANY WARRANTY; without even the implied warranty of
127 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
128 General Public License for more details.
129 You should have received a copy of the GNU General Public License along
131 with this software; if not, write to the Free Software Foundation,
132 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
133UNIX March 1993 AGCURV(3NCARG)