1EZVEC(3NCARG) NCAR GRAPHICS EZVEC(3NCARG)
2
6 EZVEC - A front-end to VELVCT with a simpler interface. Like VELVCT, it
7 plots a a vector field in a single call.
8
10 CALL EZVEC (U,V,M,N)
11
13 EZVEC is obsolete, and is supported only to provide compatibility with
14 old NCAR Graphics codes. However, the compatibility mode parameter,
15 CPM, offers a number of options to help ease the the transition to the
16 new version of the utility. When writing new code you are encouraged
17 not to use this entry point, since it provides less capability than the
18 standard Vectors interface, and may eventually be phased out.
19
21 #include <ncarg/ncargC.h>
22 void c_ezvec (float *u, float *v, int m, int n)
24
26 U (REAL 2-dimensional array, dimensioned M x n: n >= N,
27 input) By default, assumed to contain the first dimensional
28 Cartesian components of the vector field. However, if PLR
29 is non-zero, it is treated as containing the vector
30 magnitudes.
31 V (REAL 2-dimensional array, dimensioned M x n: n >= N,
33 input) By default, assumed to contain the second
34 dimensional Cartesian components of the vector field.
35 However, if PLR is non-zero, it is treated as containing
36 the vector angles.
37 M (INTEGER, input) Actual size of the first dimension of
39 arrays U and V
40 N (INTEGER, input) Assumed size of the second dimension of
42 arrays U and V.
43
45 The C-binding argument descriptions are the same as the FORTRAN
46 argument descriptions with the following exceptions:
47 m The actual size of the second dimension of arrays u and v.
49 n The assumed size of first dimension of arrays u and v.
51
53 U and V are 2-dimensional vector component arrays, whose actual first
54 dimensions must be equal to the value of M, and whose second dimensions
55 must equal or exceed the value of N.
56 Assuming the default value of the compatibility mode parameter, CPM,
58 Vectors always performs a SET call and draws a perimeter around the
59 plot when accessed through the EZVEC interface. Before the return from
60 EZVEC, another call to SET restores the previous coordinate system
61 mapping.
62 By modifying the value of CPM, you may take more control over the
64 utility than originally possible using this entry point. For instance,
65 you can override the default value of the SET parameter, or use the
66 Version 3.2 coordinate system mapping routines instead of the old FX,
67 FY, MXF, and MYF functions. Nevertheless, when creating new code, use
68 the VVINIT/VVECTR interface, since its capabilities are greater and
69 more likely to improve with time.
70
72 Use the ncargex command to see the following relevant example: tvelvc.
73
75 To use EZVEC, load the NCAR Graphics libraries ncarg, ncarg_gks, and
76 ncarg_c, preferably in that order.
77
79 Online: vectors, vectors_params, fx, velvct, vvectr, vvgetc, vvgeti,
80 vvgetr, vvinit, vvrset, vvsetc, vvseti, vvsetr, vvudmv, vvumxy,
81 ncarg_cbind.
82
84 Copyright (C) 1987-2007
85 University Corporation for Atmospheric Research
86 This documentation is free software; you can redistribute it and/or
88 modify it under the terms of the GNU General Public License as
89 published by the Free Software Foundation; either version 2 of the
90 License, or (at your option) any later version.
91 This software is distributed in the hope that it will be useful, but
93 WITHOUT ANY WARRANTY; without even the implied warranty of
94 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
95 General Public License for more details.
96 You should have received a copy of the GNU General Public License along
98 with this software; if not, write to the Free Software Foundation,
99 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
100UNIX April 1993 EZVEC(3NCARG)