MAPACI(3NCARG)

💖 MAPACI — it's giving "pick a color for your map areas" (3NCARG, NCAR GRAPHICS bestie) 🎀

okay so listen. this is the MAPACI page from the NCAR GRAPHICS manual and it's literally about picking colors for the areas made by boundary lines, so let's get into it 💅

---

✨ NAME ✨

MAPACI — normally used to pick colors for the areas created by the boundary lines added to an area map by a call to MAPBLA. 🎨

NOT ME USING THIS FOR THE WRONG DATABASE 💀 bestie, real talk: this function should not be used to select color indices for areas defined by the new map database "Earth..1", which was created in 1998. for that purpose, use EZMAPB functions instead (in particular, MPISCI). iykyk 🫶

---

🌸 SYNOPSIS 🌸

ICIR=MAPACI(IAID)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

int c_mapaci (int iaid)

---

💜 DESCRIPTION 💜

• IAID — (an input expression of type INTEGER) is an area identifier for one of the areas defined by the set of boundary lines added to an area map by a call to MAPBLA. no cap, that's the whole vibe check on this arg ✨

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument description is the same as the FORTRAN argument description. literally identical, same energy, no notes 💖

---

🎀 USAGE 🎀

executing the statement "ICIR=MAPACI(IAID)" gives ICIR a value between 1 and 7, inclusive, that may be used to select a color index for the area whose area identifier is IAID. 🍓

and here's the iconic part: it is guaranteed that MAPACI will not return the same value for adjacent areas. 👑 this fact can be used to ensure that adjacent areas will have different colors. slay, honestly.

heads up bestie 🙈 note that it is the responsibility of the user to define the colors associated with color indices used; this is done by calling the GKS routine GSCR. so like, MAPACI hands you the index, but the actual color drip is on you 💅

---

⭐ EXAMPLES ⭐

use the ncargex command to see the following relevant example: eezmpa. go look at it, it's right there 🌸

---

🔥 ACCESS 🔥

to use MAPACI or c_mapaci, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters, don't be chaotic about it 🫶

---

🌟 SEE ALSO 🌟

online: ezmap, ezmap_params, mapbla, 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. ⚖️

---

okay that's the whole page, you ate it, go pick some colors bestie 💖✨

mwah 💋 — this was the MAPACI(3NCARG) page, straight out of the UNIX manual, dated March 1993. periodt. 🎀