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

NAME

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

SYNOPSIS

14       CALL MAPBLA (IAMA)
15

C-BINDING SYNOPSIS

17       #include <ncarg/ncargC.h>
18
19       void c_mapbla (int *iama)
20

DESCRIPTION

22       IAMA        (an input/output array of type INTEGER) is the area map
23                   array to which boundary lines are to be added.
24

C-BINDING DESCRIPTION

26       The C-binding argument description is the same as the FORTRAN argument
27       description.
28

USAGE

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
40       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
50       The perimeter and the limb in the groups 'G1' and 'G2' have the
51       following left and right area identifiers:
52
53           0   Identifies the area inside the perimeter or limb.
54
55           -1  Identifies the area outside the perimeter or limb.
56
57       The vertical lines in the group 'G2' have left and right area
58       identifiers of 0.
59
60       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

EXAMPLES

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

ACCESS

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

SEE ALSO

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
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                    MAPBLA(3NCARG)
Impressum