PCLOQU(3NCARG)

PCLOQU 💖 (it's in the NCAR Graphics manual, section 3NCARG bestie)

okay so hi 🫶 this one is PCLOQU and it's literally the "low quality" character drawer — it does its thing by calling the GKS character-drawing routines. No function codes allowed, periodt. If you use PCLOQU to draw a string of characters you get a smaller metafile than if you'd used PCHIQU or PCMEQU, and ngl the actual results depend on what your translator can do. 🙈

also!! PLCHLQ is an alternate name for the routine PCLOQU — same icon, different name, we love a stage name 💅

---

✨ SYNOPSIS ✨

CALL PCLOQU (XPOS,YPOS,CHRS,SIZE,ANGD,CNTR)

🌸 C-BINDING SYNOPSIS 🌸

#include <ncarg/ncargC.h>

void c_pcloqu (float xpos, float ypos, char *chrs,
float size, float angd, float cntr)

---

💜 DESCRIPTION 💜

okay bestie, here come the arguments, one by one, no skips 🎀

• XPOS,YPOS — (input expressions of type REAL) these are the positioning coordinates for the characters you're about to draw. Here's the vibe check: if the internal parameter 'MA' has the value 0, these are given in the current user coordinate system. Otherwise? They're given in an arbitrary X/Y coordinate system, implied by the value of 'MA' and the nature of the routine CPMPXY. (for example ✨ if 'MA' has the value 1 and the default version of CPMPXY is being used, then XPOS is a longitude, in degrees, and YPOS is a latitude, in degrees.) and the argument CNTR (described below, keep scrolling) specifies how the characters are positioned relative to the point (XPOS,YPOS).
• CHRS — (an input constant or variable of type CHARACTER) it contains the character string to be drawn. The number of characters in CHRS is taken to be LEN(CHRS). Want characters "m" through "n" from a character variable CHRS? use the FORTRAN-77 substring notation "CHRS(m:n)". slay.

the string may include any of these 95 characters, and I'm listing every single one because we do NOT skip: space, exclamation point, double quote, pound sign, dollar sign, percent sign, ampersand, apostrophe, left parenthesis, right parenthesis, asterisk, plus sign, comma, minus sign, period, slash, 0-9, colon, semi-colon, less than sign, equals sign, greater than sign, question mark, at sign, A-Z, left square bracket, backslash, right square bracket, hat, underscore, backwards quote, a-z, left curly bracket, vertical bar, right curly bracket, and tilde.

Function codes, like those in calls to PCHIQU, may not be used. 😭 do not try it.

• SIZE — (an input expression of type REAL) this is the desired character size. If the internal parameter 'MA' is zero, then the following comments apply:
  • If SIZE is less than or equal to zero, its absolute value specifies the size as a multiple of a default digitized size on a 1024x1024 grid, on which blanks are 16 units wide.
  • If SIZE is greater than zero, but less than one, it specifies the desired width of a blank as a fraction of the distance across the plotter frame. this is the recommended scheme ✨
  • If SIZE is greater than or equal to one, it specifies the desired width of a blank in plotter coordinates, as defined by default or by a user's call to the SPPS routine SETI. heads up though: use of the routine SETI is now discouraged. 💀

If 'MA' is nonzero, then SIZE is the desired width of a blank as a value in the X/Y coordinate system in which XPOS and YPOS are given.

and fyi, SIZE is defined in such a way as to be consistent with PCHIQU. 👑

• ANGD — (an input expression of type REAL) the angle, in degrees counterclockwise from the positive X axis, at which the character string is to be written. 🦋
• CNTR — (an input expression of type REAL) the centering option, as follows:
  • CNTR < 0. means that (XPOS,YPOS) is the center of the left edge of the first character.
  • CNTR > 0. means that (XPOS,YPOS) is the center of the right edge of the last character.
  • CNTR = 0. means that (XPOS,YPOS) is the midpoint of the string.

note that this argument is not quite the same as that for PCHIQU (though it does include the three most useful cases). 🙈

and upon return from PCLOQU, all arguments are unchanged 💖 iconic behaviour honestly.

🧚 C-BINDING DESCRIPTION 🧚

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. copy-paste energy but make it official ✨

---

🌈 EXAMPLES 🌈

Use the ncargex command to see the following relevant examples, and yes I'm listing all of them, bestie: arex01, tcnqck, tcnsmt, tcnsup, tconre, tezmap, tgflas, tgrida, thafto, thstgr, tisohr, tisosr, tlblba, tpltch, tpwrzi, tpwrzs, tsoftf, tstrml, tthree, tvelvc, fstream. 🍓

---

👑 ACCESS 👑

To use PCLOQU or c_pcloqu, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. order matters, no cap.

---

🎀 SEE ALSO 🎀

Online: plotchar, pcdlsc, pcgetc, pcgeti, pcgetr, pchiqu, pcmequ, pcmpxy, pcpnwi, pcrset, pcsetc, pcseti, pcsetr, 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, go forth and draw some lowkey characters 💅✨

this has been PCLOQU(3NCARG) from the UNIX manual — that version dropped in March 1993 and it lives in NCAR GRAPHICS. mwah, bye! 🫶🌸