PWRZS(3NCARG)

💖 PWRZS — bestie edition 💖

okay so you're over here in NCAR Graphics land and you want to write some little characters into three-space while you're doing SRFACE stuff? that's literally what PWRZS is for. it's a character-plotting routine, and it's giving "i put letters inside a 3D surface and it slays." no cap. 🦋

---

✨ NAME ✨

PWRZS — a character-plotting routine for plotting characters in three-space when you're using SRFACE. 💅

---

✨ SYNOPSIS ✨

CALL PWRZS (X,Y,Z,ID,N,ISIZE,LINE,ITOP,ICNT)

🫶 C-BINDING SYNOPSIS

#include <ncarg/ncargC.h>

void c_pwrzs (float x, float y, float z, char *id,
int n, int isize, int line, int itop, int icnt)

---

✨ DESCRIPTION ✨

okay here come the args, bestie, and there are a lot of them so stay with me 🎀

• X,Y,Z — the positioning coordinates for the characters you're about to draw. these are floating point numbers living in the same three-space as the one you used in SRFACE. same vibe, same world. 🌈
• ID — the character string you want drawn. ID is of type CHARACTER. it's the actual text, the moment, the content. ✨
• N — how many characters are in ID. that's it, that's the whole job. 🔢
• ISIZE — the size of the character, and it's lowkey a two-mode situation:
  • if it's between 0 and 3, ISIZE is 1., 1.5, 2., or 3. times a standard width equal to 1/128th of the screen width.
  • if it's greater than 3, ISIZE is the character width in plotter address units. (real ones know. iykyk.)
• LINE — the direction the characters get written in. pick your lane:

     1 = +X -1 = -X
     2 = +Y -2 = -Y
     3 = +Z -3 = -Z

• ITOP — the direction from the center of the first character to the top of the first character. the potential values for ITOP are the same as the ones for LINE up above, so go look at those again. 👀

⚠️ heads up bestie: LINE cannot equal ITOP, not even in absolute value. so like, 1 and -1? not a thing. don't do it. 💀

• ICNT — the centering option. where's (X,Y,Z) actually pointing, spiritually? 🧚
  • -1 — (X,Y,Z) is the center of the left edge of the first character.
  • 0 — (X,Y,Z) is the center of the entire string.
  • 1 — (X,Y,Z) is the center of the right edge of the last character.

also note: the hidden character problem is solved correctly for characters near, but not inside, the three-space object. so like, near is fine, inside is not, okay? 🫶

---

✨ C-BINDING DESCRIPTION ✨

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same facts, different wrapper. periodt. 💜

---

✨ USAGE ✨

call PWRZS after calling SRFACE and before calling FRAME. that's the order, don't fight it. 🔥

---

✨ EXAMPLES ✨

use the ncargex command to see the following relevant examples: fsrpwrzs, tpwrzs. go look, they're iconic. 👑

---

✨ ACCESS ✨

to use PWRZS or c_pwrzs, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. ✨

---

✨ SEE ALSO ✨

Online: surface, surface_params, ezsrfc, setr, srface. ncarg_cbind.

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

---

✨ COPYRIGHT ✨

Copyright (C) 1987-2009 University Corporation for Atmospheric Research The use of this Software is governed by a License Agreement.

---

okay that's the whole page bestie, you're so ready 💖 this was NCAR GRAPHICS energy, page PWRZS(3NCARG), and it's dated March 1993 — yeah, vintage, but she still ate. mwah. 🎀🌸💅