PWRITY(3NCARG)

✨ PWRITY ✨

okay bestie, sit down, we're talking about PWRITY from NCAR GRAPHICS 💖 this is a 3NCARG man page and it's lowkey a fossil but we're gonna love her anyway

---

💅 NAME 💅

PWRITY — draws text and other characters using polylines. no cap, that's the whole gig 🎀

---

🧚 UTILITY 🧚

This routine is part of the Pwrite_family utility in NCAR Graphics. Wanna see the big-picture overview man page for the whole utility? Just type:

man pwrite_family

that's it, that's the vibe 🦋

---

💀 STATUS 💀

PWRITY is obsolete. Not "vintage", not "retro-chic" — obsolete. 😭

It has been replaced by the PLCHHQ, PLCHMQ, and PLCHLQ entries of the Plotchar utility.

PWRITY continues to be provided for compatibility of early NCAR Graphics codes. So like, she's still here for her old friends 🫶 but if you're writing new code, we suggest that you use Plotchar. Periodt. 👑

---

✨ SYNOPSIS ✨

CALL PWRITY (X,Y,IDPC,NCHAR,JSIZE,JOR,JCTR)

that's seven arguments bestie, count 'em 💅

---

🌸 DESCRIPTION 🌸

• X — an input parameter of type REAL, defining the X world coordinate of the text string to be drawn using polylines.
• Y — an input parameter of type REAL, defining the Y world coordinate of the text string to be drawn using polylines.
• IDPC — an input string of type CHARACTER, which are the characters to be drawn. yes, the actual letters, iconic ✨
• NCHAR — an input parameter of type INTEGER, giving the number of characters in the IDPC string.
• JSIZE — an input parameter of type INTEGER, giving the width of the characters to be drawn. here's the menu 🍓:
  • 0 — 8./1023. NDCs
  • 1 — 12./1023. NDCs
  • 2 — 16./1023. NDCs
  • 3 — 24./1023. NDCs

If greater than 3:

FLOAT(JSIZE)/1023. NDCs

One can relate these sizes to a viewport in normalized device coordinates (each axis runs 0. to 1.) by dividing by 1023.. That is a character of width .05 would take up 5% of the possible picture width — meaning that less than 20 characters could fit on a line. math is math, iykyk 😌

Note that there is an important difference in how text sizes are handled in GKS versus PWRITY. In GKS, text size is given in terms of character heights. In PWRITY, text size (JSIZE) is given in character width. don't get it twisted, bestie 🚨

• JOR — an input parameter of type INTEGER, giving the orientation at which the IDPC string is to be drawn. JOR is measured counter-clockwise from the positive X axis. spin it, rotate it, slay 💫
• JCTR — an input parameter of type INTEGER, giving the centering option for the IDPC character string.
  • 0 — (X,Y) is the center of the entire IDPC string.
  • -1 — (X,Y) is the center of the left edge of the first character.
  • 1 — (X,Y) is the center of the right edge of the last character.

---

🔥 ACCESS 🔥

To use PWRITY, load the NCAR Graphics libraries ncarg, ncarg_gks, ncarg_c, and ncarg_c — preferably in that order. (yes, ncarg_c shows up twice in the list, that's not me being chaotic, that's literally what it says 🙈)

---

🌈 SEE ALSO 🌈

Online: pwrite_family, pwritx, plotchar, plchhq, plchmq, plchlq

Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

---

👑 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 back in March 1993 under the UNIX manual, from the NCAR GRAPHICS crew — copyright held down by the University Corporation for Atmospheric Research from 1987 to 2009. go forth and draw your little polylines, legend 💖✨