NAME

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

SYNOPSIS

       CALL MPLNAM (FLNM,ILVL,IAMA)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_mplnam (char *flnm, int ilvl, int *iama)

DESCRIPTION

       FLNM        (an input expression of type CHARACTER) specifies the name of the database to be used.
                   MPLNAM will first look for the files of the specified database in the current working
                   directory; if the files are not found there, MPLNAM will look for them in the NCAR Graphics
                   database directory.  The database created in 1998 and provided as part of Version 4.1 of NCAR
                   Graphics is named "Earth..1".

       ILVL        (an input expression of type INTEGER) specifies the level at which the database is to be
                   used.  The value 1 says to use only land/water boundaries, the value 2 says to add
                   continental boundaries (like the boundary which separates Africa from Eurasia), the value 3
                   says to add the boundaries of countries, and the value 4 says to add states.  (The value 5
                   will eventually be used to add counties.)

       IAMA        (an input/output array of type INTEGER) is the area map array to which boundary lines are to
                   be added.

C-BINDING DESCRIPTION

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

USAGE

       Calling MPLNAM adds boundary lines to the area map in the array IAMA. The area map must previously have
       been initialized by calling the routine ARINAM, in the package AREAS, using a statement like "CALL ARINAM
       (IAMA,LAMA)", where LAMA is the length of the array IAMA. The area map may subsequently be used in
       various ways; for example, one may call the AREAS routine ARSCAM to draw a solid-filled map.

       One or two groups of boundary lines are added to the area map by a call to MPLNAM. The first, having
       group identifier 'G1' (default value 1), consists of a perimeter (either rectangular or elliptical,
       depending on the value of the internal parameter 'EL') and the set of projected boundary lines implied by
       the user's selection of a map database and level.  For certain projections, a limb line may also be
       included.

       If the parameter 'VS' has a value greater than zero, the group 'G2' is added to the area map; it consists
       of a copy of the perimeter and the limb line (if any) plus a set of vertical lines splitting the area
       inside the perimeter into 'VS' vertical strips. (By default, the value of 'VS' is 1.) The object of the
       group 'G2' is to split areas up, reducing the number of points required to define a typical area below
       the level at which some target hardware device begins to fail.  (This is more important when using MPLNAM
       than it was when using MAPBLA because the new database is at a higher resolution.)

       The perimeter and the limb in the groups 'G1' and 'G2' have the following left and right area
       identifiers:

           0   Identifies the area inside the perimeter or limb.

           -1  Identifies the area outside the perimeter or limb.

       The vertical lines in the group 'G2' have left and right area identifiers of 0.

       To set the values of 'G1', 'G2', and 'VS', call the EZMAP routine MAPSTI.  To get the current values of
       'G1', 'G2', and 'VS', call the EZMAP routine MAPGTI.  See the man pages for MAPSTI and MAPGTI.

EXAMPLES

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

ACCESS

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

SEE ALSO

       Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod, mapfst, mapgci, mapgrd, mapgrm,
       mapgtc, mapgti, mapgtl, mapgtr, mapint, mapiq, mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm,
       maplbl, maplmb, maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc, mapsti, mapstl, mapstr,
       maptra, maptri, maptrn, mapusr, mapvec, mpchln, mpfnme, mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty,
       mpifnb, mpilnb, mpiola, mpiosa, mpipai, mpipan, mpipar, mpisci, mplndm, mplndr, mplnri, mpname, mprset,
       mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon, ncarg_cbind

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.