NAME¶
MAPBLA - Adds to the area map in the array IAMA the set of boundary lines, of
projected geographical entities, determined by the current state of the
internal parameters of EZMAP. Note that this routine uses whichever old
outline dataset is selected by the value of the internal parameter 'OU'; to
access the new map database "Earth..1", which was created in 1998,
one must call instead the EZMAPB routine MPLNAM.
SYNOPSIS¶
CALL MAPBLA (IAMA)
C-BINDING SYNOPSIS¶
#include <ncarg/ncargC.h>
void c_mapbla (int *iama)
DESCRIPTION¶
- IAMA
- (an input/output array of type INTEGER) is the area map array to which
boundary lines are to be added.
C-BINDING DESCRIPTION¶
The C-binding argument description is the same as the FORTRAN argument
description.
USAGE¶
One or two groups of boundary lines are added to the area map by a call to
MAPBLA. The first group has the group identifier 'G1', which has a default
value of 1. The group 'G1' consists of a perimeter (either rectangular or
elliptical, depending on the value of the EZMAP parameter 'EL') and the set of
projected boundary lines implied by your selection of an EZMAP dataset (some
combination of continental, U.S. state, and international political outlines).
For certain projections a limb line may also be included. (The limb is the
boundary between a projectable region and an unprojectable one.)
If the EZMAP parameter 'VS' has a value greater than zero, a second group, with
the group identifier 'G2', is added to the area map. (The default value of
'VS' is 1; the default value of 'G2' is 2.) The purpose of the group 'G2' is
to split up areas and thus reduce the number of points required to define a
typical area. This may be necessary because some hardware devices fail if the
number of points defining an area is too large. The group 'G2' consists of a
copy of the perimeter and the limb line (if any), plus a set of vertical lines
that split the area inside the perimeter into 'VS' vertical strips.
The perimeter and the limb in the groups 'G1' and 'G2' have the following left
and right area identifiers:
- 0
- Identifies the area inside the perimeter or limb.
- -1
- Identifies the area outside the perimeter or limb.
The vertical lines in the group 'G2' have left and right area identifiers of 0.
To set the values of 'G1', 'G2', and 'VS', call the EZMAP routine MAPSTI. To get
the current values of 'G1', 'G2', and 'VS', call the EZMAP routine MAPGTI. See
the man pages for MAPSTI and MAPGTI.
EXAMPLES¶
Use the ncargex command to see the following relevant examples: ccppole, colcon,
cmpfil, cmpgrp, cmpita, cmpitm, cmplab, cmpmsk, cmptit, cpex08, eezmpa,
tezmpa, fcover, ffex00.
ACCESS¶
To use MAPBLA or c_mapbla, load the NCAR Graphics libraries ncarg, ncarg_gks,
and ncarg_c, preferably in that order.
SEE ALSO¶
Online: ezmap, ezmap_params, mapaci, mapblm, mapdrw, mapeod, mapfst, mapgci,
mapgrd, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint, mapiq, mapiqa, mapiqd,
mapiqm, mapit, mapita, mapitd, mapitm, maplbl, maplmb, maplot, mappos, maproj,
maprs, maprst, mapsav, mapset, mapstc, mapsti, mapstl, mapstr, maptra, maptri,
maptrn, mapusr, mapvec, mpchln, mpfnme, mpgetc, mpgeti, mpgetl, mpgetr,
mpglty, mpiaty, mpifnb, mpilnb, mpiola, mpiosa, mpipai, mpipan, mpipar,
mpisci, mplnam, mplndm, mplndr, mplnri, mpname, mprset, mpsetc, mpseti,
mpsetl, mpsetr, supmap, supcon, ncarg_cbind
Hardcopy: NCAR Graphics Contouring and Mapping Tutorial
COPYRIGHT¶
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.