POINTS(3NCARG)

✨ POINTS(3NCARG) — the NCAR Graphics glow-up ✨

okay bestie, gather round 💖 this is POINTS, one of the NCAR Graphics girlies, and she's here to draw markers at a whole series of positions in your user coordinate system. and if you're feeling extra? she can connect those markers with lines too. it's giving connect-the-dots but make it ✨graphics✨

---

🌸 SYNOPSIS 🌸

CALL POINTS (PX,PY,NP,IC,IL)

💅 C-BINDING SYNOPSIS 💅

#include <ncarg/ncargC.h>

void c_points (float *px, float *py, int np, int ic, int il)

---

🎀 DESCRIPTION 🎀

• PX — an input array of type REAL, and it's literally the X user coordinates of where your NP markers are gonna live 🦋
• PY — an input array of type REAL, same energy, but the Y user coordinates for those same NP markers 💜
• NP — an input expression of type INTEGER that says how many markers we're drawing. the headcount, the guest list, the NP 💅
• IC — an input expression of type INTEGER describing what kind of marker you want. she has RANGE, so pay attention:
  • IC < 0 — draw a GKS polymarker of type -IC, like so:
    • -1 — requests a dot (.)
    • -2 — requests a plus (+)
    • -3 — requests an asterisk (*)
    • -4 — requests a circle (o), and
    • -5 — requests a cross (x)

and listen 👑 — the polymarker size and color can be set by calling the GKS routines GSMKSC, GSCR, and GSPMCI before you call POINTS. set the vibe first, draw second, no cap.

• IC = 0 — draw a dot (.). effect is the same as IC = -1. twin behavior fr fr 💀
• IC > 0 — draw the FORTRAN77 character CHAR(IC). yes bestie, you can just... ask for a character. main character energy.

in this case, the GKS routine GTX is used to draw the specified character CHAR(IC) at each of the NP points. each character is drawn with the horizontal and vertical text alignment centered at the specified point with a call to the GKS routine GSTXAL. the horizontal and vertical text alignment parameters are then restored to their previous values — she puts the settings back where she found them, respectful queen 🫶 other text attributes such as character orientation, character height, and color, can be set by calling GKS text attribute setting routines before the call to the routine POINTS.

• IL — a input expression of type INTEGER that decides whether the markers get connected with line segments. the friendship bracelet setting 🌈
  • IL = 0 — do not connect the markers with line segments. everyone stands alone, independent icons ✨
  • IL .NE. 0 — connect the markers with line segments. now they're linked, it's a whole storyline 💖

---

🦋 C-BINDING DESCRIPTION 🦋

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same facts, different outfit 💅

---

🔥 USAGE 🔥

here's the tea ☕ if the routine SET has not been called, or if the last call to SET specified linear mappings in X and Y, and the value of IC specifies a GKS polymarker, then the GKS routine GPM is called to draw the polymarkers. and if, in addition, IL is non-zero, the GKS routine GPL is called to draw the line segments. in all other cases, NCAR Graphics routines are used to draw the more complicated set of graphical objects. she switches lanes when she has to 😌

since a call to POINTS can result in subsequent calls to the GKS routines GPM or GPL, various polymarker and polyline attributes may need to be set before the routine POINTS is called. polymarker attributes which can be set are listed above in the DESCRIPTION Section. polyline attributes which can be set include polyline type (call GSLN), polyline line width (call GSLWSC), and color (call GSCR and GSPLCI). pregame your attributes, bestie 🎀

⚠️ heads up: a call to the routine POINTS causes the SPPS polyline buffer to be flushed. refer to the man page for the routine PLOTIF. she empties the buffer. no leftovers. periodt 💅

---

🌈 EXAMPLES 🌈

use the ncargex command to see the following relevant examples: agex11, cmptra. go look, they're lowkey iconic 👑

---

💜 ACCESS 💜

to use POINTS or c_points, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. the order matters, don't do your own thing 🙈

---

⭐ SEE ALSO ⭐

Online: gpl, gsln, gslwsc, gpm, gsmk, gsmksc, gtx, gstxal, gstxp, gstxfp, gschh, gschsp, gschup, gschxp, gscr, gstxci, gsplci, gspmci, spps, spps_params, plotif, ngdots, point, ncarg_cbind

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 was the POINTS(3NCARG) man page from NCAR Graphics, UNIX era, dated March 1993 — yeah she's a vintage icon, an elder stateswoman of plotting, and she still ate 💖✨ no notes.