DPLINE(3NCARG)

✨ DPLINE 💖 — aka DPLINE(3NCARG), from the NCAR GRAPHICS era 🌈

ok so bestie. welcome to DPLINE, a little legend from the NCAR GRAPHICS manual set, and she does exactly one thing and she does it gorgeously: draws a straight line segment between two points in the user coordinate system. that's it. that's the whole vibe. and honestly? iconic. 💅

---

🌸 NAME 🌸

DPLINE — Draws a straight-line segment between two points in the user coordinate system.

like. literally just a line. but make it graphics. ✨

---

🎀 SYNOPSIS 🎀

FORTRAN bestie, say it with me:

CALL DPLINE (XCP1,YCP1,XCP2,YCP2)

four args. two points. one line. no cap. 🫶

---

💜 C-BINDING SYNOPSIS 💜

for the C girlies (gender neutral, you get it):

#include <ncarg/ncargC.h>

void c_dpline (float xcp1, float ycp1, float xcp2, float ycp2);

she's the same function, just in a different font. slay. ✨

---

🦋 DESCRIPTION 🦋

okay so here's what each of those four little arguments actually is, and yes, every single one of them is an input expression of type REAL:

• XCP1 — an input expression of type REAL, specifies the X coordinate of a point at the beginning of the straight-line segment. 📍
• YCP1 — an input expression of type REAL, specifies the Y coordinate of a point at the beginning of the straight-line segment. 📍
• XCP2 — an input expression of type REAL, specifies the X coordinate of a point at the end of the straight-line segment. 🏁
• YCP2 — an input expression of type REAL, specifies the Y coordinate of a point at the end of the straight-line segment. 🏁

so like, (XCP1,YCP1) is your starting point, (XCP2,YCP2) is your ending point, and DPLINE connects them. main character energy from start to finish. 💖

---

🌈 C-BINDING DESCRIPTION 🌈

ngl this part is refreshingly short: the C-binding argument descriptions are the same as the FORTRAN argument descriptions. same four REALs, same meaning, no plot twist. 🧚

---

🔥 USAGE 🔥

here's the tea, bestie, and it's important:

• DPLINE maps the input coordinates to the fractional system and then passes them on to DPDRAW.
• and this next bit? read it twice: even if smoothing is turned on, no smoothing is done by a call to DPLINE. like, she simply does not smooth. don't ask her to. she won't. 🚫✨

so if you were sitting there expecting a nice soft curvy moment from DPLINE — no ma'am. that's a different function's job. DPLINE draws the segment, hands it off to DPDRAW, and that's the whole story. 💀

---

⭐ EXAMPLES ⭐

want to see her in the wild? use the ncargex command to see the following relevant examples:

• tdshpk

go look, it's cute, it'll make sense immediately. 👑

---

👑 ACCESS 👑

to use DPLINE or c_dpline, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. order matters bestie, don't freestyle it. 🎀

---

🌸 SEE ALSO 🌸

Online: dashpack, dashpack_params, dpcurv, dpdraw, dpfrst, dpgetc, dpgeti, dpgetr, dplast, dpsetc, dpseti, dpsetr, dpsmth, dpvect, ncarg_cbind.

Hardcopy: None.

like, go read the whole dashpack family, they're all connected, iykyk. 🦋

---

💖 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 page, bestie!! 🥳 this was DPLINE(3NCARG) from the NCAR GRAPHICS manuals — the version we're vibing with here is the UNIX one, dated March 1995, and the footer said DPLINE(3NCARG) right back at us, so we're full circle. go draw a line. you got this. 💅✨🫶