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

NAME

6       MAPBLM - Draws geographical outlines masked against an existing area
7       map.  Note that this routine uses whichever old outline dataset is
8       selected by the value of the internal parameter 'OU'; to access the new
9       map database "Earth..1", which was created in 1998, one must call
10       instead the EZMAPB routine MPLNDM.
11

SYNOPSIS

13       CALL MAPBLM (IAMA,XCRA,YCRA,MCRA,IAAI,IAGI,MNOG,ULPR)
14

C-BINDING SYNOPSIS

16       #include <ncarg/ncargC.h>
17
18       void c_mapblm (int *iama, float *xcra, float *ycra,
19       int mcra, int *iaai, int *iagi, int mnog,
20       int (*ulpr)(float *xcra, float *ycra, int *ncs,
21       int *iaai, int *iagi, int *nai))
22

DESCRIPTION

24       IAMA        (an input/output array, dimensioned as specified in a call
25                   to the AREAS routine ARINAM, of type INTEGER) is the array
26                   containing the area map against which boundary lines are to
27                   be masked. The area map must have been initialized by a
28                   call to ARINAM; it should contain the edges required to
29                   create a desired effect.  For example, an area map might be
30                   created that defines a region of interest, within which
31                   user data is available and within which boundary lines are
32                   to be drawn. For more details, see the reference document
33                   for the package named AREAS.
34
35       XCRA and YCRA
36                   (scratch arrays, dimensioned at least MCRA, of type REAL)
37                   are to be used by MAPBLM in calls to the AREAS routine
38                   ARDRLN; they will eventually be used in calls to the user-
39                   provided line-processing routine ULPR.
40
41       MCRA        (an input expression of type INTEGER) is the dimension of
42                   the arrays XCRA and YCRA.
43
44       IAAI and IAGI
45                   (scratch arrays, dimensioned at least NOGI, of type
46                   INTEGER) are to be used by MAPBLM in calls to the AREAS
47                   routine ARDRLN; they will eventually be used in calls to
48                   the user-provided line-processing routine ULPR. The
49                   mnemonics stand for "Integer Array of Area Identifiers" and
50                   "Integer Array of Group Identifiers", respectively.
51
52       NOGI        (an input expression of type INTEGER) is the dimension of
53                   the arrays IAAI and IAGI. The mnemonic stands for "Number
54                   Of Group Identifiers (of edges in the area map)", which
55                   determines the required dimension of IAAI and IAGI.
56
57       ULPR        is the name of the user-supplied line-processing routine.
58                   It must be declared EXTERNAL in the routine that calls
59                   MAPBLM, so that the compiler and loader will know that it
60                   is the name of a routine to be called instead of a
61                   variable. The user routine ULPR will be called once for
62                   each piece of a boundary line resulting from the masking
63                   process; it may decide to draw (or to not draw) each such
64                   piece. ULPR will be called using a FORTRAN statement like
65
66                        CALL ULPR (XCRA,YCRA,NCRA,IAAI,IAGI,NGPS)
67
68                   where XCRA and YCRA are real arrays holding the normalized
69                   device coordinates of NCRA points defining a polyline which
70                   is part of some boundary line and IAAI and IAGI are integer
71                   arrays holding NGPS area-identifier/group-identifier pairs
72                   for the area within which that piece of the line lies. In
73                   writing ULPR, the user may rely upon a SET call's having
74                   been done which makes it possible to use normalized device
75                   coordinates in calls to routines like CURVE, CURVED, GPL,
76                   etc. For more details, see the reference document for the
77                   package named AREAS and, in particular, the description of
78                   the subroutine ARDRLN.
79

C-BINDING DESCRIPTION

81       The C-binding argument descriptions are the same as the FORTRAN
82       argument descriptions.
83

USAGE

85       The statement
86
87            CALL MAPBLM (IAMA,XCRA,YCRA,MCRA,IAAI,IAGI,MNOG,ULPR)
88
89       does the same thing as the statement
90
91            CALL MAPLOT
92
93       except that the boundary lines are drawn using calls to MAPITM and
94       MAPIQM, which does the masking of the lines against the area map
95       defined by the arguments in the call and passes the pieces resulting
96       from the masking process to a user-provided line-drawing routine.
97

EXAMPLES

99       Use the ncargex command to see the following relevant example: cpex10.
100

ACCESS

102       To use MAPBLM or c_mapblm, load the NCAR Graphics libraries ncarg,
103       ncarg_gks, and ncarg_c, preferably in that order.
104

SEE ALSO

106       Online: ezmap, ezmap_params, mapaci, mapbla, mapdrw, mapeod, mapfst,
107       mapgci, mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint, mapiq,
108       mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl, maplmb,
109       maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc, mapsti,
110       mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln, mpfnme,
111       mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb, mpiola,
112       mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri,
113       mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon,
114       ncarg_cbind
115
116       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
117
119       Copyright (C) 1987-2009
120       University Corporation for Atmospheric Research
121       The use of this Software is governed by a License Agreement.
122
123
124
125UNIX                              March 1993                    MAPBLM(3NCARG)
Impressum