MAPUSR(3NCARG)

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.