PLENV0(3plplot)

📦
version 5.15.0 · 12 versions
, in ubuntu stonking

💖 PLENV0 💖

okay bestie so you're looking at PLENV0 from the PLplot API — she's the chill twin of plenv(3plplot), and the whole plot setup party is gonna happen right here. let me walk you through it 🫶

✨ SYNOPSIS ✨

plenv0(xmin, xmax, ymin, ymax, just, axis)

🌸 DESCRIPTION 🌸

So plenv0 sets up the whole plotter environment for your cute little simple graphs. It does that by calling pladv(3plplot) and then hooking you up with a viewport and window at sensible default values. no cap, it just works 💅

Now here's the one thing that makes her different from plenv(3plplot): she's literally the same, except that if you're in multiplot mode she does not advance the subpage — instead she clears it. periodt. that's the whole flex. 👑

When she sets things up, plenv0(3plplot) leaves a standard margin around most graphs for axis labels and a title: a left-hand margin of eight character heights, plus a margin around the other three sides of five character heights. 🌈

But bestie, when those defaults aren't it for you? use the individual routines instead:

Redacted form: plenv0(xmin, xmax, ymin, ymax, just, axis)

This function is used in example 21. ✨ (iconic behaviour tbh)

🎀 ARGUMENTS 🎀

  • xmin (PLFLT(3plplot), input) — value of x at the left-hand edge of the window, in world coordinates. 💖
  • xmax (PLFLT(3plplot), input) — value of x at the right-hand edge of the window, in world coordinates. 💖
  • ymin (PLFLT(3plplot), input) — value of y at the bottom edge of the window, in world coordinates. 💖
  • ymax (PLFLT(3plplot), input) — value of y at the top edge of the window, in world coordinates. 💖
  • just (PLINT(3plplot), input) — controls how the axes get scaled, and it's giving ✨choice✨:
    • -1: the scales will not be set — you, yes you, have to set up the scale before calling plenv0(3plplot), using plsvpa(3plplot), plvasp(3plplot) or other.
    • 0: the x and y axes are scaled independently so you use as much of the screen as possible.
    • 1: the scales of the x and y axes are made equal.
    • 2: the axis of the x and y axes are made equal, and the plot box will be square. 🔲
  • axis (PLINT(3plplot), input) — controls drawing of the box around the plot. this one has SO many options and honestly? she ate. 🍓
    • -2: draw no box, no tick marks, no numeric tick labels, no axes.
    • -1: draw box only.
    • 0: draw box, ticks, and numeric tick labels.
    • 1: also draw coordinate axes at x=0 and y=0.
    • 2: also draw a grid at major tick positions in both coordinates.
    • 3: also draw a grid at minor tick positions in both coordinates.
    • 10: same as 0 except logarithmic x tick marks. (The x data have to be converted to logarithms separately.)
    • 11: same as 1 except logarithmic x tick marks. (The x data have to be converted to logarithms separately.)
    • 12: same as 2 except logarithmic x tick marks. (The x data have to be converted to logarithms separately.)
    • 13: same as 3 except logarithmic x tick marks. (The x data have to be converted to logarithms separately.)
    • 20: same as 0 except logarithmic y tick marks. (The y data have to be converted to logarithms separately.)
    • 21: same as 1 except logarithmic y tick marks. (The y data have to be converted to logarithms separately.)
    • 22: same as 2 except logarithmic y tick marks. (The y data have to be converted to logarithms separately.)
    • 23: same as 3 except logarithmic y tick marks. (The y data have to be converted to logarithms separately.)
    • 30: same as 0 except logarithmic x and y tick marks. (The x and y data have to be converted to logarithms separately.)
    • 31: same as 1 except logarithmic x and y tick marks. (The x and y data have to be converted to logarithms separately.)
    • 32: same as 2 except logarithmic x and y tick marks. (The x and y data have to be converted to logarithms separately.)
    • 33: same as 3 except logarithmic x and y tick marks. (The x and y data have to be converted to logarithms separately.)
    • 40: same as 0 except date / time x labels.
    • 41: same as 1 except date / time x labels.
    • 42: same as 2 except date / time x labels.
    • 43: same as 3 except date / time x labels.
    • 50: same as 0 except date / time y labels.
    • 51: same as 1 except date / time y labels.
    • 52: same as 2 except date / time y labels.
    • 53: same as 3 except date / time y labels.
    • 60: same as 0 except date / time x and y labels.
    • 61: same as 1 except date / time x and y labels.
    • 62: same as 2 except date / time x and y labels.
    • 63: same as 3 except date / time x and y labels.
    • 70: same as 0 except custom x and y labels.
    • 71: same as 1 except custom x and y labels.
    • 72: same as 2 except custom x and y labels.
    • 73: same as 3 except custom x and y labels.
lowkey important reminder bestie: for every single logarithmic option up there, the data do NOT get log-converted for you. you have to convert the x data, the y data, or both to logarithms separately. don't come for me when your plot looks cursed 💀

🧚 AUTHORS 🧚

Many developers — who are credited at http://plplot.sourceforge.net/credits.php — have contributed to PLplot over its long history. honestly? legends only. 👑💜

🦋 SEE ALSO 🦋

PLplot documentation at http://plplot.sourceforge.net/documentation.php. go read it, iykyk 📚

and that's the whole page, bestie! this one's from the PLplot API, dated August, 2026, and it's PLENV0(3plplot) — go forth and set up your viewport like the main character you are 💅✨🎀

📦 where this page comes from