1SUPMAP(3NCARG) NCAR GRAPHICS SUPMAP(3NCARG)
2
6 Draws a map with a single call. An implementation of the routine from
7 which EZMAP grew.
8
10 CALL SUPMAP (JPRJ, PLAT, PLON, ROTA, PLM1, PLM2, PLM3,
11 + PLM4, JLTS, JGRD, IOUT, IDOT, IERR)
12
14 #include <ncarg/ncargC.h>
15 void c_supmap (int jprj, float plat, float plon,
17 float rota, float *plm1, float *plm2, float *plm3,
18 float *plm4, int jlts, int jgrd, int iout, int idot,
19 int *ierr)
20
22 JPRJ (input expression, of type INTEGER) defines the projection
23 type and indicates whether or not continental outlines are
24 to be plotted, as follows:
25 · IABS(JPRJ) defines the projection type, as follows
27 (values less than 1 or greater than 10 are treated as 1
28 or 10, respectively):
29 IABS(JPRJ) Projection Type
31 1 Stereographic.
33 2 Orthographic.
35 3 Lambert conformal conic.
37 4 Lambert equal area.
39 5 Gnomonic.
41 6 Azimuthal equidistant.
43 7 Satellite view.
45 8 Cylindrical equidistant.
47 9 Mercator.
49 10 Mollweide-type.
51 Using the value 2 causes the EZMAP parameter 'SA' to be
53 zeroed. ('SA', if greater than 1., says that a
54 satellite-view projection, rather than an orthographic
55 projection, is to be used, and specifies the distance
56 of the satellite from the center of the earth, in units
57 of earth radii.)
58 Using the value 7 causes 'SA' to be examined. If it has
60 a non-zero value, the value is left alone. If it has a
61 zero value, its value is reset to 6.631, which is about
62 right for a satellite in a geosynchronous equatorial
63 orbit.
64 · The sign of JPRJ, when IOUT is -1, 0, or +1, indicates
66 whether the continental outlines are to be plotted or
67 not. See IOUT, below.
68 PLAT, PLON, and ROTA
70 (input expressions, of type REAL) define the origin of the
71 projection and its rotation angle and are used in the same
72 way as they would be in a call to the routine MAPROJ (which
73 see).
74 JLTS (input expression, of type INTEGER), and PLM1, PLM2, PLM3,
76 and PLM4 (input arrays, dimensioned 2, of type REAL)
77 specify the rectangular limits of the map. These arguments
78 are used in the same way as they would be in a call to
79 MAPSET (which see), except that JLTS is an integer instead
80 of a character string. IABS(JLTS) may take on the values 1
81 through 5, as follows:
82 IABS(JLTS) Equivalent character string in a call to
84 MAPSET
85 1 'MA' - maximal area desired.
87 2 'CO' - corner points given in PLM1, PLM2,
89 PLM3, and PLM4.
90 3 'LI' - U/V limits given in PLM1, PLM2,
92 PLM3, and PLM4.
93 4 'AN' - angles given in PLM1, PLM2, PLM3,
95 and PLM4.
96 5 'PO' - edge points given in PLM1, PLM2,
98 PLM3, and PLM4.
99 At one time, the sign of JLTS specified whether or not a
101 line of text was to be written at the bottom of the plot
102 produced. This line may no longer be written and the sign
103 of JLTS is therefore ignored.
104 JGRD (input expression, of type INTEGER) is used in the
106 following way: The value of "MOD(IABS(JGRD),1000)" is the
107 value, in degrees, of the interval at which lines of
108 latitude and longitude are to be plotted. If the given
109 interval is zero, grid lines and labels are not plotted. If
110 JGRD is less than zero, the perimeter is not plotted. Set
111 JGRD to -1000 to suppress both grid lines and perimeter and
112 to +1000 to suppress the grid lines, but leave the
113 perimeter. The value -0 may have a meaning on ones'
114 complement machines, but should be avoided; use -1000
115 instead.
116 IOUT (input expression, of type INTEGER) has the value 0 to
118 suppress U.S. state outlines, and the value -1 or +1 to
119 plot U.S. state outlines. In both of these cases, the sign
120 of JPRJ indicates whether continental outlines are to be
121 plotted (JPRJ positive) or not (JPRJ negative).
122 Originally, SUPMAP recognized only these values of IOUT;
123 now, if IOUT is less than 0 or greater than 1, the sign of
124 JPRJ is ignored, and IOUT selects an outline group, as
125 follows:
126 IOUT Outline group selected
128 -2 or less 'NO' (no outlines)
130 2 'CO' (continental outlines)
132 3 'US' (U.S. state outlines)
134 4 'PS' (continental outlines plus
136 international outlines plus U.S. state
137 outlines)
138 5 or greater
140 'PO' (continental outlines plus
141 international outlines)
142 At one time, the sign of IOUT specified whether or not a
144 line of text was to be written on the print output unit.
145 This may no longer be done.
146 IDOT (input expression, of type INTEGER) is a 0 to get
148 continuous outlines, a 1 to get dotted outlines.
149 IERR (output variable, of type INTEGER) is the only output
151 parameter. A non-zero value indicates that an error has
152 occurred. The section "ERROR CONDITIONS" lists the possible
153 values of IERR.
154
156 The C-binding argument descriptions are the same as the FORTRAN
157 argument descriptions.
158
160 Use the ncargex command to see the following relevant examples: caredg,
161 cmpgci, cmpsup, mpex03, mpex08, mpexfi, bnchmk, stex03, vvex02.
162
164 To use SUPMAP or c_supmap, load the NCAR Graphics libraries ncarg,
165 ncarg_gks, and ncarg_c, preferably in that order.
166
168 Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod,
169 mapfst, mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint,
170 mapiq, mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl,
171 maplmb, maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc,
172 mapsti, mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln,
173 mpfnme, mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb,
174 mpiola, mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr,
175 mplnri, mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supcon,
176 ncarg_cbind
177 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
179
181 Copyright (C) 1987-2007
182 University Corporation for Atmospheric Research
183 This documentation is free software; you can redistribute it and/or
185 modify it under the terms of the GNU General Public License as
186 published by the Free Software Foundation; either version 2 of the
187 License, or (at your option) any later version.
188 This software is distributed in the hope that it will be useful, but
190 WITHOUT ANY WARRANTY; without even the implied warranty of
191 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
192 General Public License for more details.
193 You should have received a copy of the GNU General Public License along
195 with this software; if not, write to the Free Software Foundation,
196 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
197UNIX March 1993 SUPMAP(3NCARG)