LINE(3NCARG)

💖 LINE — bestie, it's giving "draw a line" 💖

okay so this is LINE(3NCARG) from the NCAR GRAPHICS manual, and it does exactly what it says on the tin, no cap.

---

✨ NAME ✨

LINE — draws a line from the point (X1,Y1) to the point (X2,Y2). the "pen" (for subsequent calls to FRSTPT, VECTOR, PLOTIF, and PLOTIT) is left at (X2,Y2). 🖊️✨

like... the pen literally does not go home. it stays exactly where you left it. main character pen behavior, honestly.

---

🌸 SYNOPSIS 🌸

CALL LINE (X1,Y1,X2,Y2)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_line (float x1, float y1, float x2, float y2)

---

💜 DESCRIPTION 💜

• X1 — an input expression of type REAL that defines the X user coordinate of the starting point of a line segment. 📍
• Y1 — an input expression of type REAL that defines the Y user coordinate of the starting point of a line segment. 📍
• X2 — an input expression of type REAL that defines the X user coordinate of the ending point of a line segment. 🏁
• Y2 — an input expression of type REAL that defines the Y user coordinate of the ending point of a line segment. 🏁

so yeah, two points, four REALs, one line. the math is mathing. 💅

---

🎀 C-BINDING DESCRIPTION 🎀

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. periodt. same energy, different language, we love a bilingual icon. 🌈

---

👑 USAGE 👑

polyline type, line width, and color can be set by calling the GKS routines GSLN, GSLWSC, GSCR, and GSPLCI before calling LINE. so like, set the vibe first, then draw. 🎨

🚨 this routine flushes the SPPS polyline buffer at each line draw. which means polyline attributes can be safely changed between successive calls. so go off, change those attributes, it's fine, she's not holding onto anything. 💖

---

🔥 EXAMPLES 🔥

use the ncargex command to see the following relevant examples: mpex07, mpex09, cbex01, coex01, coex03, epltch, srex01, and tgflas. go look, they ate. 👑

---

🌟 ACCESS 🌟

to use LINE or c_line, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. bestie please do not shuffle the order, it's not a playlist. 🙈

---

🧚 SEE ALSO 🧚

• Online: gpl, gsln, gslwsc, gscr, gsplci, spps, spps_params, frstpt, vector, plotif, curve, ncarg_cbind
• Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

iykyk, that whole squad is iconic. 🫶

---

💀 COPYRIGHT 💀

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

---

okay so that's the whole page, and ngl the legal girlies deserve their moment too. this was UNIX, March 1993, LINE(3NCARG) — and yes the source/version and date really did just get a whole send-off because they earned it. slay, stay drawing lines, mwah 💅💖✨