1MPLNAM(3NCARG) NCAR GRAPHICS MPLNAM(3NCARG)
2
6 MPLNAM - Reads a specified EZMAP database and sends boundary lines from
7 it to a specified area map.
8
10 CALL MPLNAM (FLNM,ILVL,IAMA)
11
13 #include <ncarg/ncargC.h>
14 void c_mplnam (char *flnm, int ilvl, int *iama)
16
18 FLNM (an input expression of type CHARACTER) specifies the name
19 of the database to be used. MPLNAM will first look for the
20 files of the specified database in the current working
21 directory; if the files are not found there, MPLNAM will
22 look for them in the NCAR Graphics database directory. The
23 database created in 1998 and provided as part of Version
24 4.1 of NCAR Graphics is named "Earth..1".
25 ILVL (an input expression of type INTEGER) specifies the level
27 at which the database is to be used. The value 1 says to
28 use only land/water boundaries, the value 2 says to add
29 continental boundaries (like the boundary which separates
30 Africa from Eurasia), the value 3 says to add the
31 boundaries of countries, and the value 4 says to add
32 states. (The value 5 will eventually be used to add
33 counties.)
34 IAMA (an input/output array of type INTEGER) is the area map
36 array to which boundary lines are to be added.
37
39 The C-binding argument description is the same as the FORTRAN argument
40 description.
41
43 Calling MPLNAM adds boundary lines to the area map in the array IAMA.
44 The area map must previously have been initialized by calling the
45 routine ARINAM, in the package AREAS, using a statement like "CALL
46 ARINAM (IAMA,LAMA)", where LAMA is the length of the array IAMA. The
47 area map may subsequently be used in various ways; for example, one may
48 call the AREAS routine ARSCAM to draw a solid-filled map.
49 One or two groups of boundary lines are added to the area map by a call
51 to MPLNAM. The first, having group identifier 'G1' (default value 1),
52 consists of a perimeter (either rectangular or elliptical, depending on
53 the value of the internal parameter 'EL') and the set of projected
54 boundary lines implied by the user's selection of a map database and
55 level. For certain projections, a limb line may also be included.
56 If the parameter 'VS' has a value greater than zero, the group 'G2' is
58 added to the area map; it consists of a copy of the perimeter and the
59 limb line (if any) plus a set of vertical lines splitting the area
60 inside the perimeter into 'VS' vertical strips. (By default, the value
61 of 'VS' is 1.) The object of the group 'G2' is to split areas up,
62 reducing the number of points required to define a typical area below
63 the level at which some target hardware device begins to fail. (This
64 is more important when using MPLNAM than it was when using MAPBLA
65 because the new database is at a higher resolution.)
66 The perimeter and the limb in the groups 'G1' and 'G2' have the
68 following left and right area identifiers:
69 0 Identifies the area inside the perimeter or limb.
71 -1 Identifies the area outside the perimeter or limb.
73 The vertical lines in the group 'G2' have left and right area
75 identifiers of 0.
76 To set the values of 'G1', 'G2', and 'VS', call the EZMAP routine
78 MAPSTI. To get the current values of 'G1', 'G2', and 'VS', call the
79 EZMAP routine MAPGTI. See the man pages for MAPSTI and MAPGTI.
80
82 Use the ncargex command to see the following relevant examples: mpex11,
83 tezmpb.
84
86 To use MPLNAM or c_mplnam, load the NCAR Graphics libraries ncarg,
87 ncarg_gks, and ncarg_c, preferably in that order.
88
90 Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod,
91 mapfst, mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint,
92 mapiq, mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl,
93 maplmb, maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc,
94 mapsti, mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln,
95 mpfnme, mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb,
96 mpiola, mpiosa, mpipai, mpipan, mpipar, mpisci, mplndm, mplndr, mplnri,
97 mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon,
98 ncarg_cbind
99
101 Copyright (C) 1987-2007
102 University Corporation for Atmospheric Research
103 This documentation is free software; you can redistribute it and/or
105 modify it under the terms of the GNU General Public License as
106 published by the Free Software Foundation; either version 2 of the
107 License, or (at your option) any later version.
108 This software is distributed in the hope that it will be useful, but
110 WITHOUT ANY WARRANTY; without even the implied warranty of
111 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
112 General Public License for more details.
113 You should have received a copy of the GNU General Public License along
115 with this software; if not, write to the Free Software Foundation,
116 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
117UNIX April 1998 MPLNAM(3NCARG)