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

NAME

6       MAPEOD - Called by the EZMAP routines MAPLOT and MAPBLA.  The default
7       version does nothing.  A user-written version may be supplied to
8       examine each outline-dataset segment and, perhaps, to delete selected
9       ones.  Note that this routine is not called by any of the EZMAPB
10       routines; for the same purpose, they call the routine MPCHLN.
11

SYNOPSIS

13       CALL MAPEOD (NOUT,NSEG,IDLS,IDRS,NPTS,PNTS)
14

DESCRIPTION

16       NOUT        (an input expression of type INTEGER) is the number of the
17                   outline dataset from which the segment comes, as follows:
18
19                   NOUT    Dataset from which the segment came
20
21                   1       CO - Continental outlines only.
22
23                   2       US - U.S. state outlines only.
24
25                   3       PS - Continental, U.S. state, and international
26                           outlines.
27
28                   4       PO - Continental and international outlines.
29
30       NSEG        (an input expression of type INTEGER) is the number of the
31                   segment within the outline dataset. The maps in the example
32                   named "mpex09" show segment numbers for the outline dataset
33                   'CO'; the program may be modified to produce maps showing
34                   segment numbers for any outline dataset.
35
36       IDLS and IDRS
37                   (input expressions of type INTEGER) are identifiers for the
38                   areas to the left and right, respectively, of the segment.
39                   (Left and right are defined from the standpoint of a viewer
40                   standing at point 1 of the segment and looking toward point
41                   2.)
42
43       NPTS        (an input/output variable of type INTEGER), on entry, is
44                   the number of points defining the outline segment. NPTS may
45                   be zeroed by MAPEOD to suppress plotting of the segment on
46                   the map.
47
48       PNTS        (an input/output array, dimensioned 2*NPTS, of type REAL)
49                   is an array of coordinates. PNTS(1) and PNTS(2) are the
50                   latitude and longitude of the first point, PNTS(3) and
51                   PNTS(4) the latitude and longitude of the second point, ...
52                   PNTS(2*NPTS-1) and PNTS(2*NPTS) the latitude and longitude
53                   of the last point. All values are in degrees. Longitudes
54                   are all between -180 and +180; no segment crosses the
55                   meridian at -180 (+180) degrees.
56

USAGE

58       MAPEOD is called by MAPLOT to examine each segment in an outline
59       dataset just before it is plotted and by MAPBLA to examine each segment
60       in an outline dataset just before it is added to an area map. The
61       default version of MAPEOD does nothing. A user-supplied version may
62       cause selected segments to be deleted (to reduce the clutter in
63       northern Canada, for example).
64

EXAMPLES

66       Use the ncargex command to see the following relevant examples: mpex03,
67       mpex05, mpex09.
68

ACCESS

70       To use MAPEOD, load the NCAR Graphics libraries ncarg, ncarg_gks, and
71       ncarg_c, preferably in that order.
72

SEE ALSO

74       Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapfst,
75       mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint, mapiq,
76       mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl, maplmb,
77       maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc, mapsti,
78       mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln, mpfnme,
79       mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb, mpiola,
80       mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri,
81       mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon,
82       ncarg_cbind
83
84       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
85

87       Copyright (C) 1987-2007
88       University Corporation for Atmospheric Research
89
90       This documentation is free software; you can redistribute it and/or
91       modify it under the terms of the GNU General Public License as
92       published by the Free Software Foundation; either version 2 of the
93       License, or (at your option) any later version.
94
95       This software is distributed in the hope that it will be useful, but
96       WITHOUT ANY WARRANTY; without even the implied warranty of
97       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
98       General Public License for more details.
99
100       You should have received a copy of the GNU General Public License along
101       with this software; if not, write to the Free Software Foundation,
102       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
103
104
105
106UNIX                              March 1993                    MAPEOD(3NCARG)
Impressum