1MAPBLM(3NCARG) NCAR GRAPHICS MAPBLM(3NCARG)
2
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
13 CALL MAPBLM (IAMA,XCRA,YCRA,MCRA,IAAI,IAGI,MNOG,ULPR)
14
16 #include <ncarg/ncargC.h>
17 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
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 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 MCRA (an input expression of type INTEGER) is the dimension of
42 the arrays XCRA and YCRA.
43 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 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 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 CALL ULPR (XCRA,YCRA,NCRA,IAAI,IAGI,NGPS)
67 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
81 The C-binding argument descriptions are the same as the FORTRAN
82 argument descriptions.
83
85 The statement
86 CALL MAPBLM (IAMA,XCRA,YCRA,MCRA,IAAI,IAGI,MNOG,ULPR)
88 does the same thing as the statement
90 CALL MAPLOT
92 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
99 Use the ncargex command to see the following relevant example: cpex10.
100
102 To use MAPBLM or c_mapblm, load the NCAR Graphics libraries ncarg,
103 ncarg_gks, and ncarg_c, preferably in that order.
104
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 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
117
119 Copyright (C) 1987-2007
120 University Corporation for Atmospheric Research
121 This documentation is free software; you can redistribute it and/or
123 modify it under the terms of the GNU General Public License as
124 published by the Free Software Foundation; either version 2 of the
125 License, or (at your option) any later version.
126 This software is distributed in the hope that it will be useful, but
128 WITHOUT ANY WARRANTY; without even the implied warranty of
129 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
130 General Public License for more details.
131 You should have received a copy of the GNU General Public License along
133 with this software; if not, write to the Free Software Foundation,
134 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
135UNIX March 1993 MAPBLM(3NCARG)