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

NAME

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

SYNOPSIS

12       CALL MAPUSR (IPRT)
13

DESCRIPTION

15       IPRT        (input expression, of type INTEGER), if positive, says that
16                   a particular part of the map is about to be drawn, as
17                   follows:
18
19                       IPRT  Part of map about to be drawn
20
21                       1     Perimeter.
22
23                       2     Grid.
24
25                       3     Labels.
26
27                       4     Limb lines.
28
29                       5     Continental outlines.
30
31                       6     U.S. state outlines.
32
33                       7     International outlines.
34
35                   If IPRT is negative, then the drawing of the last part is
36                   complete. The absolute value of IPRT will be one of the
37                   above values. Changed quantities should be restored.
38

USAGE

40       EZMAP executes the statement
41
42           CALL MAPUSR (IPRT)
43
44       just before and just after each portion of a map is drawn. The default
45       version of MAPUSR does nothing.
46
47       A user-supplied version of MAPUSR may set/reset the dotting parameter
48       'DL', the DASHCHAR dash pattern, the color index, etc., so as to
49       achieve a desired effect.
50

EXAMPLES

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

ACCESS

55       To use MAPUSR, load the NCAR Graphics libraries ncarg, ncarg_gks, and
56       ncarg_c, preferably in that order.
57

SEE ALSO

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

70       Copyright (C) 1987-2007
71       University Corporation for Atmospheric Research
72
73       This documentation is free software; you can redistribute it and/or
74       modify it under the terms of the GNU General Public License as
75       published by the Free Software Foundation; either version 2 of the
76       License, or (at your option) any later version.
77
78       This software is distributed in the hope that it will be useful, but
79       WITHOUT ANY WARRANTY; without even the implied warranty of
80       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
81       General Public License for more details.
82
83       You should have received a copy of the GNU General Public License along
84       with this software; if not, write to the Free Software Foundation,
85       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
86
87
88
89UNIX                              March 1993                    MAPUSR(3NCARG)
Impressum