MAPVEC(3NCARG)

✨ MAPVEC ✨ (a.k.a. MAPVEC(3NCARG) from the NCAR GRAPHICS fam πŸ’–)

okay bestie, sit down, hydrate, and let me tell you about the little map-drawing icon that could πŸŽ€


🌸 NAME 🌸

MAPVEC β€” draws lines on a map. that's it, that's the vibe. it's used in conjunction with MAPFST, they're a package deal, you never see one without the other fr fr πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

CALL MAPVEC (RLAT,RLON)

✨ C-BINDING SYNOPSIS ✨

#include <ncarg/ncargC.h>

void c_mapvec (float rlat, float rlon)

πŸ’œ DESCRIPTION πŸ’œ

  • RLAT and RLON β€” these are input expressions, type REAL, and they say where the "pen" should get moved to. both are in degrees. πŸ–ŠοΈβœ¨
    • RLAT has to be between -90. and +90., inclusive. no cap, those are the walls.
    • RLON has to be between -540. and +540., inclusive. yes, that's a whole extra lap and a half of longitude, they really said "go around as many times as you want bestie" 😭

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument descriptions are literally the same as the FORTRAN argument descriptions. same energy, different language, we love a bilingual king πŸ‘‘


πŸŽ€ USAGE πŸŽ€

so here's the tea β˜• β€” this statement:

CALL MAPVEC (RLAT, RLON)

is equivalent to:

CALL MAPIT (RLAT, RLON, 1)

it moves the "pen" (and the pen is in the "down" position, so it's actually drawing, not just hovering) to the next point in a series of points. so like, it's the connective-tissue function, it's the "and then" of your map line πŸ’«

go read the man page for MAPIT if you want the full lore, bestie, it's all there 🫢

πŸ”₯ ACCESS πŸ”₯

to use MAPVEC or c_mapvec, you gotta load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c β€” preferably in that exact order. the order matters, don't be chaotic πŸ™ˆ


πŸ‘‘ SEE ALSO πŸ‘‘

Online, aka the whole friend group πŸ«‚:

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, 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


Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.

sign-off szn 🌸 this whole thing lived in the UNIX manual, dated March 1993, and it goes by MAPVEC(3NCARG). iconic, timeless, a legend honestly. periodt πŸ’…βœ¨πŸ¦‹