MAPBLA(3NCARG)

✨ MAPBLA ✨ (that's MAPBLA(3NCARG), from the NCAR GRAPHICS fam, bestie)

Okay so listen. 💖 This one is a classic, it's giving old-school NCAR Graphics energy, and it does exactly one job but it does it so well.

🌸 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.

⚠️ Real talk though: 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, you have to call the EZMAPB routine MPLNAM instead. Don't come for me, that's just the lore. 🙈

---

🎀 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, and it's the area map array to which boundary lines are to be added. That's the whole vibe. 🫶

🌈 C-BINDING DESCRIPTION 🌈

The C-binding argument description is the same as the FORTRAN argument description. No notes. Periodt. 💅

---

👑 USAGE 👑

One or two groups of boundary lines get added to the area map by a call to MAPBLA. Not three. Not zero. One or two. 😌

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. Very main character, very niche. 🦋)

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. 💀 Like, they just give up. So we split.

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. Go read them, they're cute. 📚

---

🔥 EXAMPLES 🔥

Use the ncargex command to see the following relevant examples: ccppole, colcon, cmpfil, cmpgrp, cmpita, cpmitm... wait no, cpmitm isn't real bestie, it's cpmitm—okay it's literally cpmitm. Let me just give you the whole list, verbatim, no edits, I promise:

ccppole, colcon, cmpfil, cmpgrp, cmpita, cpmitm, cmplab, cmpmsk, cmptit, cpex08, eezmpa, tezmpa, fcover, ffex00.

💀 okay I messed up the spelling in my little tangent, the actual names are the ones in the backticks above. Slay responsibly.

---

🧚 ACCESS 🧚

To use MAPBLA or c_mapbla, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. In that order, bestie. I said what I said. 💅

---

🌈 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. Yes, actual paper. Iconic behavior. 📖✨

---

💜 COPYRIGHT 💜

Copyright (C) 1987-2009 University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement.

---

And that's the whole page, no cap. 🫶 This one's from the UNIX manual, March 1993, and it lives under MAPBLA(3NCARG). Byeee bestie, go draw some boundary lines. 🎀💖✨