PWRZT(3NCARG)

✨ PWRZT ✨

okay bestie, welcome to the NCAR Graphics corner of the universe 💖 this one's from the 3NCARG manual and it's literally all about yeeting a character string into 3-D space and drawing its projection. no cap.

---

🌸 NAME 🌸

PWRZT — draws the projections of character strings that are positioned in a plane parallel to one of the three coordinate planes. it's giving "text but make it 3-D" ✨

⚠️ NOTE: bestie, at one time there was a Threed routine called PWRZ and it was supported. but PWRZ has been superseded by PWRZT and is therefore considered obsolete. if you call PWRZ, you will get an error message telling you to use PWRZT instead and execution will be terminated. 💀 so like… don't. it's not the vibe.

---

🎀 SYNOPSIS 🎀

CALL PWRZT (U,V,W,CHRS,LCHRS,ISIZE,IDIR,ITOP,ICEN)

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_pwrzt (float u, float v, float w, char *chrs, int lchrs,
int isize, int idir, int itop, int icen)

---

💅 DESCRIPTION 💅

okay so here's the tea on every single argument, and yes we're doing all of them 🫶

• U,V,W — these are input expressions of type REAL, and they're the U, V, and W coordinates of a point, in the user's 3-space, relative to which the character string is to be positioned. it's the anchor, the main character, the spot everything's measured from. 👑
• CHRS — this is an input constant or variable of type CHARACTER, and it's the character string to be drawn. bestie, it may contain uppercase alphabetic characters, the digits 0 through 9, and a small set of "special" characters (plus, minus, asterisk, slash, left and right parentheses, equals sign, blank, comma, and period). other characters are treated as blanks. and note especially that lowercase alphabetic characters are not available 😭 so no soft lowercase energy here, it's uppercase only, periodt.
• LCHRS — an input expression of type INTEGER, and it's simply the number of characters in CHRS. count them, bestie 🔢
• ISIZE — an input expression of type INTEGER that specifies the character width to be used, defined in terms of the width of the plotter frame. now here's the ✨lore✨: because projected characters vary in width depending on just where they are placed within the box being viewed and the position from which that box is viewed, ISIZE is interpreted as specifying the width of a character when that character is positioned and viewed in such a way as to make it as large as it could possibly be — when the character is on the near side of the box and in a plane perpendicular to the line of sight. specifically:
  • if 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 greater than 3, ISIZE is the character width in units of 1/1024th of the plotter frame.

one third of the "width" referred to here is white space. what ISIZE really specifies is the distance between the centers of adjacent characters in a string. characters are digitized to be 7/6 * ISIZE units high and 4/6 * ISIZE units wide, excluding white space. math girlies rise 🌈

• IDIR — an input expression of type INTEGER, the direction in which the character string is to be written, as follows:
  • 1 = +U      -1 = -U
  • 2 = +V      -2 = -V
  • 3 = +W      -3 = -W
• ITOP — an input expression of type INTEGER, the direction from the center of the first character to the top of the first character; possible values of ITOP are the same as those of IDIR, above. and ⚠️ ABS(ITOP) must not be equal to ABS(IDIR). like they cannot match, that's the rule, no exceptions 💀
• ICEN — an input expression of type INTEGER, the centering option, specifying where (U,V,W) is relative to the string written, as follows:
  • -1 — (U,V,W) is the center of the left edge of the first character.
  • 0 — (U,V,W) is the center of the entire string.
  • 1 — (U,V,W) is the center of the right edge of the last character.

also, since characters drawn by PWRZT are stroked using the GKS polyline primitive (so that they can be projected from 3-D to 2-D, iconic behavior honestly), they are drawn in the current polyline color, as determined by the last call to the GKS routine GSPLCI; by default, color index 1 is used. line width is determined by the last call to the GKS routine GSLWSC; by default, the line width scale factor is 1. slay 🎀

---

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. fr fr, same energy, different language 💜

---

⭐ EXAMPLES ⭐

use the ncargex command to see the following relevant example: tpwrzt. go look, it's cute, i promise 🦋

---

👑 ACCESS 👑

to use PWRZT or c_pwrzt, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters bestie, don't do it wrong 💅

---

🍓 SEE ALSO 🍓

online: threed, curve3, fence3, frst3, line3, perim3, point3, psym3, pwrz, set3, threed, tick3, tick43, vect3, ncarg_cbind.

(yes threed is listed twice and yes i'm keeping it twice because that's what the original says, we don't erase history in this house 💖)

---

💜 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, mwah 💋 this was PWRZT(3NCARG) from the NCAR GRAPHICS manual, in the UNIX manual set, dated March 1993 — vintage but make it serve ✨ go forth and project those strings, you've got this 🫶