PLMAPFILL(3plplot)

📦
version 5.15.0 · 12 versions
, in ubuntu stonking

💖 NAME 💖

plmapfill — okay so this one plots all or a subset of your Shapefile data, and it fills the polygons 💅✨

✨ SYNOPSIS ✨

plmapfill(mapform, name, minx, maxx, miny, maxy, plotentries, nplotentries)

🦋 DESCRIPTION 🦋

Welcome to the PLplot API page for plmapfill, bestie 🫶 — this is the glow-up version of plmapline(3plplot), literally the same energy, except the items get filled in exactly the same way as plfill(3plplot) does it. No cap. 🎨

Redacted form, for when you're being lazy (affectionate):

plmapfill(mapform, name, minx, maxx, miny, maxy, plotentries)

And real talk — this function is used in example 19. Iconic behavior, honestly. 👑

🎀 ARGUMENTS 🎀

  • mapform (PLMAPFORM_callback(3plplot), input) — a user-supplied function that transforms the coordinates from the shapefile into your plot coordinate system. Using this transform is how you go from a longitude/latitude situation to, say, a polar stereographic project. At the start, x[0]..[n-1] are the longitudes and y[0]..y[n-1] are the corresponding latitudes. After the call to mapform(), x[] and y[] should be replaced by the corresponding plot coordinates. And if you're not feeling a transform at all? mapform can just be replaced by NULL and you're chilling. 🧚
  • name (PLCHAR_VECTOR(3plplot), input) — an ascii character string giving the file name of a set of Shapefile files, without the file extension. Periodt. 📄
  • minx (PLFLT(3plplot), input) — the minimum x value to be plotted. This has to be in the same units as your Shapefile uses. You could throw in a very large negative number to plot everything, but ngl you can improve performance by limiting the area drawn. The units must match those of the Shapefile projection, which may be longitude or distance or whatever. Oh and PSA: the value of minx must be less than the value of maxx. 🚨
  • maxx (PLFLT(3plplot), input) — the maximum x value to be plotted. Same deal: a very large number plots everything, but limiting the area drawn lowkey improves performance. 💫
  • miny (PLFLT(3plplot), input) — the minimum y value to be plotted. Must be in the same units as the Shapefile uses. Very large negative number = plot everything, but you can improve performance by limiting the area drawn. The units have to match the Shapefile projection, which may be latitude or distance, for example. And the value of miny must be less than the value of maxy. 🌸
  • maxy (PLFLT(3plplot), input) — the maximum y value to be plotted. You could use a very large number to plot everything, but you can improve performance by limiting the area drawn. 🦋
  • plotentries (PLINT_VECTOR(3plplot), input) — a vector with the zero-based indices of the Shapefile elements that will be drawn. Set plotentries to NULL and it'll plot all the elements of the Shapefile. Easy. 💜
  • nplotentries (PLINT(3plplot), input) — the number of items in plotentries. Ignored if plotentries is NULL, so don't stress about it. 🙈

👑 AUTHORS 👑

Many developers — who are credited at http://plplot.sourceforge.net/credits.php — have contributed to PLplot over its long history. Genuine main character energy from the whole squad, fr fr. 🫶

🌈 SEE ALSO 🌈

PLplot documentation at http://plplot.sourceforge.net/documentation.php. Go read it, iykyk 💖

That's the whole vibe check, bestie — this page was living under the PLPLOT manual, dated August, 2026, filed under PLMAPFILL(3plplot). Slay. 🎀✨

📦 where this page comes from