PWRZI(3NCARG)

✨ PWRZI ✨ (aka the NCAR GRAPHICS bestie, PWRZI(3NCARG))

okay so 💖 listen up — PWRZI is a character-plotting routine, and it's the one you call when you wanna plot characters in three-space while you're using Isosurface. and the gag is: for a large class of possible positions, the hidden character problem is just... solved. no cap. 👑

🌸 NAME 🌸

PWRZI — a character-plotting routine for plotting characters in three-space when using Isosurface. For a large class of possible positions, the hidden character problem is solved. ✨

🎀 SYNOPSIS 🎀

SUBROUTINE PWRZI (X,Y,Z,ID,N,ISIZE,LINE,ITOP,ICNT)

💅 C-BINDING SYNOPSIS

#include <ncarg/ncargC.h>

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

🦋 DESCRIPTION 🦋

like, here's the whole vibe check on every argument, bestie. no skipping, we're doing all of them 💜

• X,Y,Z — (input expressions of type REAL) these are the positioning coordinates for the characters to be drawn. they're floating point numbers living in the same three-space coordinate system that Isosurface uses. so like, same map, same lore. 🗺️
• ID — (an input expression of type CHARACTER) the character string to be drawn. literally the text itself, the main character. 💖
• N — (an input expression of type INTEGER) the number of characters in ID. count 'em. 🔢
• ISIZE — (an input expression of type INTEGER) specifies the size of the characters to be used, and it's giving two modes:
  • 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 plotter address units (by default, 1/1024th of the screen width).
• LINE — (an input expression of type INTEGER) specifies the direction in which the characters are to be written. pick your axis, pick your sign 🧭:
  • +1 = +X
  • -1 = -X
  • +2 = +Y
  • -2 = -Y
  • +3 = +Z
  • -3 = -Z
• ITOP — (an input expression of type INTEGER) specifies 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 those for LINE as given above 👆. note that LINE cannot equal ITOP even in absolute value. so like, don't even try it, they cannot be twins. 🙅‍♀️
• ICNT — (an input expression of type INTEGER) is the centering option, and this is where your string gets to decide where its center of gravity lives:
  • -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.

🌈 C-BINDING DESCRIPTION

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same energy, different syntax, periodt. 🫶

💫 USAGE 💫

Call PWRZI after calling ISOSRF and before calling FRAME. that's the order, bestie, the sequence is sacred 🕯️

🔥 EXAMPLES 🔥

Use the ncargex command to see the following relevant examples: tpwrzi, fsrpwrzs.

👑 ACCESS 👑

To use PWRZI or c_pwrzi, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. yes, order matters. we stan a consistent load order 💅

🌟 SEE ALSO 🌟

Online: isosurface, isosurface_params, ezisos, isgeti, isgetr, isosrf, isseti, issetr, 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, you ate it, go plot some three-space characters 🦋✨

source/version vibes: this is from the UNIX manual, dated March 1993, page PWRZI(3NCARG) — yeah she's vintage but she's iconic, and honestly? still slaying. 💖 mwah, bye bestie 🎀