1MAPSET(3NCARG) NCAR GRAPHICS MAPSET(3NCARG)
2
6 MAPSET - Specifies the rectangular portion of the u/v plane to be
7 drawn.
8
10 CALL MAPSET (JLTS, PLM1, PLM2, PLM3, PLM4)
11
13 #include <ncarg/ncargC.h>
14 void c_mapset (char *jlts, float *plm1, float *plm2,
16 float *plm3, float *plm4)
17
19 JLTS (an input expression, of type CHARACTER) is a character
20 string specifying how the limits of the map are to be
21 chosen. There are six possibilities, as follows:
22 · JLTS='MA' (MAXIMUM). The maximum useful area
25 produced by the projection is plotted. PLM1, PLM2,
26 PLM3, and PLM4 are not used.
27 · JLTS='CO' (CORNERS). The points (PLM1,PLM2) and
29 (PLM3,PLM4) are to be at opposite corners of the
30 map. PLM1 and PLM3 are latitudes, in degrees. PLM2
31 and PLM4 are longitudes, in degrees. If a
32 cylindrical projection is being used, the first
33 point should be on the left edge of the map and the
34 second point on the right edge; otherwise, the order
35 makes no difference.
36 · JLTS='PO' (POINTS). PLM1, PLM2, PLM3, and PLM4 are
38 two-element arrays giving the latitudes and
39 longitudes, in degrees, of four points which are to
40 be on the edges of the rectangular map. If a
41 cylindrical projection is being used, the first
42 point should be on the left edge and the second
43 point on the right edge; otherwise, the order makes
44 no difference.
45 · JLTS='AN' (ANGLES). PLM1, PLM2, PLM3, and PLM4 are
47 positive angles, in degrees, representing angular
48 distances from a point on the map to the left,
49 right, bottom, and top edges of the map,
50 respectively. For most projections, these angles are
51 measured with the center of the earth at the vertex
52 and represent angular distances from the point which
53 projects to the origin of the u/v plane; on a
54 satellite-view projection, they are measured with
55 the satellite at the vertex and represent angular
56 deviations from the line of sight. Angular limits
57 are particularly useful for polar projections and
58 for the satellite-view projection; they are not
59 appropriate for the Lambert conformal conic and an
60 error will result if one attempts to use JLTS='AN'
61 with JPRJ='LC'.
62 · JLTS='LI' (LIMITS). PLM1, PLM2, PLM3, and PLM4
64 specify the minimum value of u, the maximum value of
65 u, the minimum value of v, and the maximum value of
66 v, respectively. Knowledge of the projection
67 equations is necessary in order to use this option
68 correctly.
69 · JLTS='GR' (GRID). PLM1, PLM2, PLM3, and PLM4 specify
71 the minimum value of latitude, the minimum value of
72 longitude, the maximum value of latitude, and the
73 maximum value of longitude, in degrees, on a lat/lon
74 grid. The limits will be determined in such a way
75 as to ensure that the entire grid will be visible on
76 the map.
77 PLM1, PLM2, PLM3, and PLM4
79 (input arrays, dimensioned 2, of type REAL) are as
80 described above, depending on the value of JLTS. Note that
81 each is a two-element array. Strictly speaking, the FORTRAN
82 standard requires that they be declared as such, even when
83 only the first element of each array is used.
84
86 The C-binding argument descriptions are the same as the FORTRAN
87 argument descriptions.
88
90 This routine allows you to set the current values of the EZMAP
91 parameters 'AR', 'P1', 'P2', ... 'P7', and 'P8'. For a complete list
92 of parameters available in this utility, see the ezmap_params man page.
93
95 Use the ncargex command to see the following relevant examples:
96 ccpcica, ccpmap, ccpmovi, ccppole, ccpvp, colcon, cezmap1, cezmap2,
97 cezmap3, cmpclr, cmpdd, cmpdrw, cmpfil, cmpgrd, cmpgrp, cmpita, cmpitm,
98 cmplab, cmplbl, cmplot, cmpmsk, cmpou, cmptra, cpex01, cpex03, cpex08,
99 cpex09, mpex01, mpex02, mpex04, mpex07, mpex09, mpex10, eezmpa, tezmap,
100 tezmpa, fcover, ffex00, ffex02, ffex03, ffex05, fgkgpl, fgkgtx,
101 fngngdts.
102
104 To use MAPSET or c_mapset, load the NCAR Graphics libraries ncarg,
105 ncarg_gks, and ncarg_c, preferably in that order.
106
108 See the ezmap man page for a description of all EZMAP error messages
109 and/or informational messages.
110
112 Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod,
113 mapfst, mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint,
114 mapiq, mapiqa, mapiqd, mapiqd, mapiqm, mapit, mapita, mapitd, mapitd,
115 mapitm, maplbl, maplmb, maplot, mappos, maproj, maprs, maprst, mapsav,
116 mapstc, mapsti, mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec,
117 mpchln, mpfnme, mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb,
118 mpilnb, mpiola, mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm,
119 mplndr, mplnri, mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap,
120 supcon, ncarg_cbind
121 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
123
125 Copyright (C) 1987-2007
126 University Corporation for Atmospheric Research
127 This documentation is free software; you can redistribute it and/or
129 modify it under the terms of the GNU General Public License as
130 published by the Free Software Foundation; either version 2 of the
131 License, or (at your option) any later version.
132 This software is distributed in the hope that it will be useful, but
134 WITHOUT ANY WARRANTY; without even the implied warranty of
135 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
136 General Public License for more details.
137 You should have received a copy of the GNU General Public License along
139 with this software; if not, write to the Free Software Foundation,
140 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
141UNIX March 1993 MAPSET(3NCARG)