1SUPMAP(3NCARG)                   NCAR GRAPHICS                  SUPMAP(3NCARG)
2
3
4

NAME

6       Draws a map with a single call. An implementation of the routine from
7       which EZMAP grew.
8

SYNOPSIS

10        CALL SUPMAP (JPRJ, PLAT, PLON, ROTA, PLM1, PLM2, PLM3,
11       + PLM4, JLTS, JGRD, IOUT, IDOT, IERR)
12

C-BINDING SYNOPSIS

14       #include <ncarg/ncargC.h>
15
16       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

DESCRIPTION

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
26                   ·   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
30                           IABS(JPRJ)  Projection Type
31
32                           1           Stereographic.
33
34                           2           Orthographic.
35
36                           3           Lambert conformal conic.
37
38                           4           Lambert equal area.
39
40                           5           Gnomonic.
41
42                           6           Azimuthal equidistant.
43
44                           7           Satellite view.
45
46                           8           Cylindrical equidistant.
47
48                           9           Mercator.
49
50                           10          Mollweide-type.
51
52                       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
59                       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
65                   ·   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
69       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
75       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
83                       IABS(JLTS)  Equivalent character string in a call to
84                                   MAPSET
85
86                       1           'MA' - maximal area desired.
87
88                       2           'CO' - corner points given in PLM1, PLM2,
89                                   PLM3, and PLM4.
90
91                       3           'LI' - U/V limits given in PLM1, PLM2,
92                                   PLM3, and PLM4.
93
94                       4           'AN' - angles given in PLM1, PLM2, PLM3,
95                                   and PLM4.
96
97                       5           'PO' - edge points given in PLM1, PLM2,
98                                   PLM3, and PLM4.
99
100                   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
105       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
117       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
127                       IOUT        Outline group selected
128
129                       -2 or less  'NO' (no outlines)
130
131                       2           'CO' (continental outlines)
132
133                       3           'US' (U.S. state outlines)
134
135                       4           'PS' (continental outlines plus
136                                   international outlines plus U.S. state
137                                   outlines)
138
139                       5 or greater
140                                   'PO' (continental outlines plus
141                                   international outlines)
142
143                   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
147       IDOT        (input expression, of type INTEGER) is a 0 to get
148                   continuous outlines, a 1 to get dotted outlines.
149
150       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

C-BINDING DESCRIPTION

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

EXAMPLES

160       Use the ncargex command to see the following relevant examples: caredg,
161       cmpgci, cmpsup, mpex03, mpex08, mpexfi, bnchmk, stex03, vvex02.
162

ACCESS

164       To use SUPMAP or c_supmap, load the NCAR Graphics libraries ncarg,
165       ncarg_gks, and ncarg_c, preferably in that order.
166

SEE ALSO

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
178       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
179
181       Copyright (C) 1987-2009
182       University Corporation for Atmospheric Research
183       The use of this Software is governed by a License Agreement.
184
185
186
187UNIX                              March 1993                    SUPMAP(3NCARG)
Impressum