CURVED(3NCARG)

✨ CURVED — the NCAR Graphics glow-up ✨

okay bestie, so this is CURVED from the NCAR Graphics manual (that's the 3NCARG section, iykyk). Sit down, grab a strawberry 🍓, because this one's actually so simple and so cute.

---

💖 NAME 💖

CURVED — draws a curve through a sequence of points. that's it. that's the whole job. she's a one-trick pony and she ate. 🎀

---

🦋 SYNOPSIS 🦋

CALL CURVED (X,Y,N)

---

🌈 C-BINDING SYNOPSIS 🌈

#include <ncarg/ncargC.h>

void c_curved (float *x, float *y, int n)

---

🌸 DESCRIPTION 🌸

so there's three things you gotta hand her, and here's the vibe check on each:

• X — an input array of type REAL, and it's the X user coordinates of the curve. Array X is of length N. literally just where the points live horizontally, bestie.
• Y — an input array of type REAL, and it's the Y user coordinates of the curve. Array Y is of length N. the vertical besties. same length, no exceptions. 💅
• N — an input expression of type INTEGER that specifies the number of points in the curve. how many points are we serving tonight? that's N. periodt.

---

🎀 C-BINDING DESCRIPTION 🎀

the C-binding argument descriptions are the same as the FORTRAN argument description. no notes, no changes, she's consistent. 👑

---

💅 USAGE 💅

okay so the statement

CALL CURVED (X,Y,N)

is equivalent to these statements:

CALL FRSTD (X(1),Y(1))
CALL VECTD (X(2),Y(2))
CALL VECTD (X(3),Y(3))
...(et cetera)...
CALL VECTD (X(N),Y(N))
CALL LASTD

the basic difference is that CURVED requires you to have all of the coordinates defining the curve available at once. sometimes this is convenient and sometimes it is not — she's honest about it, okay? 🙈

now the tea ☕:

if three or more distinct points are given, and if one of the smoothing versions of Dashline is being used, and if the internal parameter that suppresses smoothing is not set — then splines under tension are used to generate a smooth curve ✨ and the number of points actually used to draw the curve will depend on its length. lowkey magical.

in all other cases, the "curve" will be approximated by just connecting the given points in the specified order. like a connect-the-dots situation. no smoothing, no drama, just lines. 💀

---

🔥 EXAMPLES 🔥

use the ncargex command to see the following relevant examples: carline, colcon, cmpfil, cmpgrp, cmpitm, cmplab, cmpmsk, cmptit, cpex01, cpex02, cpex03, cpex04, cpex06, vvex01, tdashc, tdashl, tdashp, tdashs, carline, fcover, ffex03, ffex05, fdlcurvd, fdldashd, fdlsmth, fpcloqu.

(and yes, carline is in there twice. that's not a typo, that's just how the list is. she said double the carline, double the fun 🫶)

---

👑 ACCESS 👑

to use CURVED or c_curved, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c — preferably in that order. order matters, bestie, don't be chaotic about it. ⭐

see the man page for dashline to see how to access the quick, normal, smooth, and super line draw options. yes, "super." she's iconic like that. 💖

---

🧚 SEE ALSO 🧚

Online: dashline, dashline_params, dashdb, dashdc, frstd, lastd, lined, reset, vectd, ncarg_cbind

Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; 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.

heads up bestie: the use of this Software is governed by a License Agreement. it's not a free-for-all, it's a whole licensed situation. read the agreement, be a good citizen. 🎀

---

okay that's the whole page!! UNIX, dated March 1993, filed under CURVED(3NCARG) — she's been serving smooth curves since before we were born and honestly? respect. go draw something pretty. bye bestie!! 💅✨🦋