MPIPAR(3NCARG)

💖 MPIPAR — the NCAR Graphics page (that's the 3NCARG manual, bestie) 💖

okay so listen. this is a whole function from NCAR Graphics and it's lowkey iconic. here's the tea:

✨ NAME ✨

MPIPAR — give it the area identifier of one of the areas defined by whatever database was last read by one of the EZMAPB routines MPLNAM, MPLNDM, MPLNDR, and MPLNRI, and it hands you back the area identifier of that area's containing (parent) area. it's giving "who's your mom" but for map areas. 💅

🌸 SYNOPSIS 🌸

IPAR=MPIPAR(IAIN)

🎀 C-BINDING SYNOPSIS 🎀

#include <ncarg/ncargC.h>

int c_mpipar (int iain)

🦋 DESCRIPTION 🦋

• IAIN — an input expression of type INTEGER, specifying the area identifier of a particular area of interest. that's it, that's the input, she's simple and she knows what she wants. ✨

💜 C-BINDING DESCRIPTION 💜

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

🔥 USAGE 🔥

so the statement "IPAR=MPIPAR(IAIN)" retrieves in IPAR the area identifier of the parent of the area with area identifier IAIN.

for example: if IMAD is the area identifier of the little island in Lake Superior called "Lake Madeline", then MPIPAR(IMAD) is the area identifier of the area called "Wisconsin".

not the island being Wisconsin, the island's parent being Wisconsin. the island is inside Wisconsin's area. that's the whole bit. i'm obsessed with this example actually, it's so specific and so real. 🏝️

🌈 EXAMPLES 🌈

use the ncargex command to see the following relevant example: mpex12. go look at it, it's right there, main character energy. 👑

💀 ACCESS 💀

to use MPIPAR or c_mpipar, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. don't be chaotic about the order, bestie, just do it the way they said. 🎀

⭐ SEE ALSO ⭐

Online: ezmap, ezmap_params, mapaci, 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, mpisci, mplnam, mplndm, mplndr, mplnri, mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon, ncarg_cbind

like yeah it's a lot of friends. they're all invited to the function. 🫶✨

👑 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, you read the whole thing, i'm so proud of you. this was the NCAR Graphics MPIPAR page, from the UNIX manual, dated April 1998, and the header was MPIPAR(3NCARG) in case you were wondering what page you were even on. now go parent some map areas. 💖🌸🎀🦋💅