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.