MPLNDR(3NCARG)

💖 MPLNDR — bestie's guide to drawing map boundary lines 💖

okay so welcome to MPLNDR, a lil routine from the NCAR Graphics manual (that's the 3NCARG section, iykyk) and honestly? it's giving cartographer. it reads a map database and draws boundary lines out of it. that's the whole vibe. 🗺️✨

---

🌸 NAME 🌸

MPLNDR — reads a specified EZMAP database and draws boundary lines from it. literally that's it, that's the job, and she does it gorgeously 💅

---

✨ SYNOPSIS ✨

CALL MPLNDR (FLNM,ILVL)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_mplndr (char *flnm, int ilvl)

---

💜 DESCRIPTION 💜

• FLNM — an input expression of type CHARACTER, and she's the name of the database you wanna use. here's the tea on how MPLNDR goes looking for it: first she checks the current working directory for the files of the database you named. if they're not there? no worries bestie, she then checks the NCAR Graphics database directory. also, the database that got created back in 1998 and shipped as part of Version 4.1 of NCAR Graphics is named "Earth..1" — iconic name, no notes 🫶
• ILVL — an input expression of type INTEGER, and it picks the level at which the database gets used. the lore:
  • 1 → land/water boundaries only, the bare minimum, the clean girl aesthetic
  • 2 → adds continental boundaries (like the one separating Africa from Eurasia, fr fr)
  • 3 → adds the boundaries of countries
  • 4 → adds states
  • and 5? that value will eventually be used to add counties. not yet bestie. someday. 👀

---

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument description is the same as the FORTRAN argument description. same energy, different syntax, we love a consistent queen 👑

---

💅 USAGE 💅

okay so MPLNDR draws the lines defined by the map database whose name is FLNM. and get this — the EZMAP internal parameter 'DO' is the one deciding whether you get solid lines or dotted lines. she's the main character of this decision.

if EZMAP currently needs initialization, MPLNDR does nothing except read some information from the map database — so that subsequent calls to EZMAPB functions will work properly. she's just prepping the vibes for later, okay? respectful.

the outlines get drawn using calls to MAPIT and MAPIQ. by default, MPLNDR forces the value of the internal parameter 'DL' equal to the value of the internal parameter 'DO', and she also hands the dash package a solid-line dash pattern. here's the breakdown:

• when 'DO' is zero, the outlines get drawn using calls to FRSTD and VECTD, in the dash package — and that gives you solid lines ✨
• when 'DO' is non-zero, the outlines get drawn using calls to the SPPS routine POINTS — and that gives you dotted lines 🫧

before returning control to you, MAPLOT restores the original value of 'DL' and the original dash pattern. put it back how you found it, that's just manners.

and if you wanna be extra? you can supply your own user version of the routine MPCHLN to change the way in which the outlines are drawn. customize ur life 💫

---

🎀 EXAMPLES 🎀

use the ncargex command to see the following relevant example: tezmpb. go look, it eats 🔥

---

👑 ACCESS 👑

to use MPLNDR or c_mplndr, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. order matters bestie, don't freestyle it 🙈

---

🌸 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, mpipar, mpisci, mplnam, mplndm, mplnri, mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon, ncarg_cbind

(the whole friend group, honestly. a whole squad of map routines 🫶)

---

💜 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 page bestie!! slay 💖 this was the UNIX manual, April 1998 edition, and the whole thing is filed under MPLNDR(3NCARG). go draw some boundaries, ily, mwah 🎀🦋✨