NAME

       MAPUSR - Called by EZMAP routines that draw the various parts of the map.  The default
       version does nothing.  A user-written version may be supplied to change the appearance of
       the map. Note that this routine is not called by any of the EZMAPB routines; they call
       MPCHLN instead.

SYNOPSIS

       CALL MAPUSR (IPRT)

DESCRIPTION

       IPRT        (input expression, of type INTEGER), if positive, says that a particular part
                   of the map is about to be drawn, as follows:

                       IPRT  Part of map about to be drawn

                       1     Perimeter.

                       2     Grid.

                       3     Labels.

                       4     Limb lines.

                       5     Continental outlines.

                       6     U.S. state outlines.

                       7     International outlines.

                   If IPRT is negative, then the drawing of the last part is complete. The
                   absolute value of IPRT will be one of the above values. Changed quantities
                   should be restored.

USAGE

       EZMAP executes the statement

           CALL MAPUSR (IPRT)

       just before and just after each portion of a map is drawn. The default version of MAPUSR
       does nothing.

       A user-supplied version of MAPUSR may set/reset the dotting parameter 'DL', the DASHCHAR
       dash pattern, the color index, etc., so as to achieve a desired effect.

EXAMPLES

       Use the ncargex command to see the following relevant example: mpex08.

ACCESS

       To use MAPUSR, 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, mapvec, mpchln,
       mpfnme, mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb, mpiola, mpiosa,
       mpipai, mpipan, mpipar, mpisci, mplnam, 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.