PLCPSTRM(3plplot)

📦
version 5.15.0 · 12 versions
, in ubuntu stonking

💖 PLCPSTRM(3plplot) — the plplot girly pops off 💖

okay bestie, come sit with me, because plcpstrm is genuinely one of those functions that sounds boring and then turns out to be iconic. it's part of the PLplot API and it's the little copy-paste goblin of your plotting dreams. let's get into it 🫶

✨ NAME ✨

plcpstrm — copy state parameters from the reference stream to the current stream. that's it, that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

plcpstrm(iplsr, flags)

look at her. two arguments. no notes. 👑

🦋 DESCRIPTION 🦋

so the way this works is literally so simple: plcpstrm copies state parameters from the reference stream over to the current stream. slay. but there's a lil plot twist — it also tells the driver interface to map device coordinates unless flags == 1. yes, flags == 1 specifically, not just "truthy", we're being precise here. 💀

now, the actual main character use case: this function is how you make save files of selected plots (e.g. from the TK driver). obsessed. 🎀 after initializing, you can get a copy of the current plot to the specified device by switching to this stream and issuing a plcpstrm(3plplot) and a plreplot(3plplot), with calls to plbop(3plplot) and pleop(3plplot) as appropriate. the whole friend group, together. 😭

⚠️ heads up bestie: the plot buffer must have previously been enabled. no buffer, no plot, no cap. (good news though — it's done automatically by some display drivers, such as X, so sometimes the universe just handles it for you ✨)

Redacted form: plcpstrm(iplsr, flags)

she's also a working girl — this function is used in example 1,20. 🔥

💜 ARGUMENTS 💜

  • iplsr (PLINT(3plplot), input) — number of reference stream. which stream are we copying from, bestie? that one. 📍
  • flags (PLBOOL(3plplot), input) — if flags is set to true the device coordinates are not copied from the reference to current stream. so true = no coordinate copying. yes, it's a little bit of a chaos gremlin of a flag, but we respect her. 🙈

👑 AUTHORS 👑

many developers (who are credited at http://plplot.sourceforge.net/credits.php) have contributed to PLplot over its long history. legends, honestly. all of them. 🌈

🧚 SEE ALSO 🧚

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

and that's the whole page, bestie — no crumbs left behind. this fine piece of documentation energy is brought to you by the August, 2026 release, filed under PLCPSTRM(3plplot). periodt. 💅✨🍓
📦 where this page comes from