1MAPBLA(3NCARG) NCAR GRAPHICS MAPBLA(3NCARG)
2
6 MAPBLA - Adds to the area map in the array IAMA the set of boundary
7 lines, of projected geographical entities, determined by the current
8 state of the internal parameters of EZMAP. Note that this routine uses
9 whichever old outline dataset is selected by the value of the internal
10 parameter 'OU'; to access the new map database "Earth..1", which was
11 created in 1998, one must call instead the EZMAPB routine MPLNAM.
12
14 CALL MAPBLA (IAMA)
15
17 #include <ncarg/ncargC.h>
18 void c_mapbla (int *iama)
20
22 IAMA (an input/output array of type INTEGER) is the area map
23 array to which boundary lines are to be added.
24
26 The C-binding argument description is the same as the FORTRAN argument
27 description.
28
30 One or two groups of boundary lines are added to the area map by a call
31 to MAPBLA. The first group has the group identifier 'G1', which has a
32 default value of 1. The group 'G1' consists of a perimeter (either
33 rectangular or elliptical, depending on the value of the EZMAP
34 parameter 'EL') and the set of projected boundary lines implied by your
35 selection of an EZMAP dataset (some combination of continental, U.S.
36 state, and international political outlines). For certain projections
37 a limb line may also be included. (The limb is the boundary between a
38 projectable region and an unprojectable one.)
39 If the EZMAP parameter 'VS' has a value greater than zero, a second
41 group, with the group identifier 'G2', is added to the area map. (The
42 default value of 'VS' is 1; the default value of 'G2' is 2.) The
43 purpose of the group 'G2' is to split up areas and thus reduce the
44 number of points required to define a typical area. This may be
45 necessary because some hardware devices fail if the number of points
46 defining an area is too large. The group 'G2' consists of a copy of the
47 perimeter and the limb line (if any), plus a set of vertical lines that
48 split the area inside the perimeter into 'VS' vertical strips.
49 The perimeter and the limb in the groups 'G1' and 'G2' have the
51 following left and right area identifiers:
52 0 Identifies the area inside the perimeter or limb.
54 -1 Identifies the area outside the perimeter or limb.
56 The vertical lines in the group 'G2' have left and right area
58 identifiers of 0.
59 To set the values of 'G1', 'G2', and 'VS', call the EZMAP routine
61 MAPSTI. To get the current values of 'G1', 'G2', and 'VS', call the
62 EZMAP routine MAPGTI. See the man pages for MAPSTI and MAPGTI.
63
65 Use the ncargex command to see the following relevant examples:
66 ccppole, colcon, cmpfil, cmpgrp, cmpita, cmpitm, cmplab, cmpmsk,
67 cmptit, cpex08, eezmpa, tezmpa, fcover, ffex00.
68
70 To use MAPBLA or c_mapbla, load the NCAR Graphics libraries ncarg,
71 ncarg_gks, and ncarg_c, preferably in that order.
72
74 Online: ezmap, ezmap_params, mapaci, mapblm, mapdrw, mapeod, 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 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
85
87 Copyright (C) 1987-2009
88 University Corporation for Atmospheric Research
89 The use of this Software is governed by a License Agreement.
90UNIX March 1993 MAPBLA(3NCARG)