AGPWRT(3NCARG)

✨ AGPWRT ✨ (it's an NCAR Graphics page, bestie 💖)

okay so this is AGPWRT from the NCAR Graphics manual, and honestly? it's giving "glow-up station for your text strings." 🎀

---

🌸 NAME 🌸

AGPWRT — it's literally the way for you to change the style of all the text strings that Autograph draws. every single one. no cap. 💅

---

🦋 SYNOPSIS 🦋

SUBROUTINE AGPWRT (XPOS,YPOS,CHRS,NCHS,ISIZ,IORI,ICEN)

that's the whole vibe right there, seven arguments, slay. ✨

---

💜 DESCRIPTION 💜

okay so here's the tea on every single argument, don't skip, i know it's long but we're doing this together 🫶

• XPOS — an input expression of type REAL, and it's the X coordinate of a point that the text string gets positioned relative to. that's it, that's the whole job.
• YPOS — an input expression of type REAL, the Y coordinate of that same point the text string is positioned relative to. yes it's the partner-in-crime of XPOS. iconic duo fr fr.
• CHRS — an input expression of type CHARACTER, and it's the actual text string that's gonna be drawn. the main character, literally.
• NCHS — an input expression of type INTEGER, and it's the length of CHRS — like, the number of characters in the text string. so bestie, you're telling it how long your string is. 😌
• ISIZ — an input expression of type INTEGER that specifies the size of the characters being used. and here's the cheat sheet:
  • 0 → character width of 8 plotter units
  • 1 → character width of 12 plotter units
  • 2 → character width of 16 plotter units
  • 3 → character width of 24 plotter units

and if you go larger than that? the value specifies the character width directly. so you're not stuck with the presets, you can just say the number. periodt.

• IORI — an input expression of type INTEGER, the orientation angle of the text string, measured in degrees counter-clockwise from a vector that's horizontal and pointing to the right. so like, 0 is normal reading direction, and everything else is you spinning it. 🌀
• ICEN — an input expression of type INTEGER, the centering option, and this one is lowkey the most important one for placement:
  • -1 → the text is written with (XPOS,YPOS) in the center of the left edge of the leftmost character
  • 0 → (XPOS,YPOS) is in the center of the entire string
  • +1 → (XPOS,YPOS) is in the center of the right edge of the rightmost character

so you're basically picking which part of your text the coordinates are pinned to. left, middle, or right. choose wisely 💅

---

🌈 USAGE 🌈

okay important: this routine is not called by your user program. it's called by Autograph itself, to draw a numeric label or an informational label on the graph. so it's the backstage crew, not the opening act. 🎭

the default version just calls the plot-package routine PWRIT. but here's the fun part — the user may supply a replacement version. so you can absolutely take over. main character energy. 👑

⚠️ Note: a user version of AGPWRT should not call any other Autograph routine. seriously. don't do it. that's the rule and we respect the rule. 🙈

---

🍓 ACCESS 🍓

to use AGPWRT, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order, bestie, the order matters. 🧚

---

⭐ SEE ALSO ⭐

Online: autograph, agback, agbnch, agchax, agchcu, agchil, agchnl, agcurv, agdshn, aggetc, aggetf, aggeti, aggetp, aggetr, agrstr, agsave, agsetc, agsetf, agseti, agsetp, agsetr, agstup, agutol, anotat, displa, ezmxy, ezmy, ezxy, ezy

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

(the whole friend group, we love a supportive ensemble cast 🫶)

---

👑 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 whole page, bestie!! 💖 this one came out of the UNIX manual, March 1993, filed under AGPWRT(3NCARG) — go forth and style those text strings, you've got this. ✨🎀🦋