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

NAME

6       MPLNAM - Reads a specified EZMAP database and sends boundary lines from
7       it to a specified area map.
8

SYNOPSIS

10       CALL MPLNAM (FLNM,ILVL,IAMA)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_mplnam (char *flnm, int ilvl, int *iama)
16

DESCRIPTION

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
26       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
35       IAMA        (an input/output array of type INTEGER) is the area map
36                   array to which boundary lines are to be added.
37

C-BINDING DESCRIPTION

39       The C-binding argument description is the same as the FORTRAN argument
40       description.
41

USAGE

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
50       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
57       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
67       The perimeter and the limb in the groups 'G1' and 'G2' have the
68       following left and right area identifiers:
69
70           0   Identifies the area inside the perimeter or limb.
71
72           -1  Identifies the area outside the perimeter or limb.
73
74       The vertical lines in the group 'G2' have left and right area
75       identifiers of 0.
76
77       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

EXAMPLES

82       Use the ncargex command to see the following relevant examples: mpex11,
83       tezmpb.
84

ACCESS

86       To use MPLNAM or c_mplnam, load the NCAR Graphics libraries ncarg,
87       ncarg_gks, and ncarg_c, preferably in that order.
88

SEE ALSO

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-2009
102       University Corporation for Atmospheric Research
103       The use of this Software is governed by a License Agreement.
104
105
106
107UNIX                              April 1998                    MPLNAM(3NCARG)
Impressum