DPSMTH(3NCARG)

πŸ’– DPSMTH πŸ’– β€” it's giving NCAR GRAPHICS, bestie ✨

okay so you found the DPSMTH page in the NCAR Graphics manual and you're like "what is this" β€” don't worry, I got you 🫢. Short version: it draws a curve when you've got your points in fractional coordinates and you want the thing smoothed. That's it. That's the vibe.


✨ NAME ✨

DPSMTH β€” used to draw a curve when fractional coordinates are available and smoothing is to be done. πŸŽ€


🌸 SYNOPSIS 🌸

CALL DPSMTH (XCPF,YCPF,IFVL)

πŸ¦‹ C-BINDING SYNOPSIS πŸ¦‹

#include <ncarg/ncargC.h>

void c_dpsmth (float xcpf, float ycpf, int ifvl);

πŸ’œ DESCRIPTION πŸ’œ

okay so here are the three lil arguments, no cap:

  • XCPF β€” an input expression of type REAL that specifies the X coordinate of a point in the fractional coordinate system. It gets ignored when IFVL = 2. πŸ’€
  • YCPF β€” an input expression of type REAL that specifies the Y coordinate of a point in the fractional coordinate system. Also ignored when IFVL = 2.
  • IFVL β€” an input expression of type INTEGER that tells you what kind of call this is: "0" implies a "first-point" call, "1" implies a "vector" call, and "2" implies a "last-point" or "buffer-flush" call. periodt. πŸ’…

πŸŽ€ C-BINDING DESCRIPTION πŸŽ€

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. literally identical, bestie, no notes. ✨


🌈 USAGE 🌈

Use "CALL DPSMTH(XCPF,YCPF,0)" to do a "pen-up" move to the first point in a sequence of points defining a curve.

Use "CALL DPSMTH(XCPF,YCPF,1)" to do "pen-down" moves to the second and following points in a sequence of points defining a curve. πŸ–ŠοΈ

Use "CALL DPSMTH(0.,0.,2) to terminate a sequence of calls, finish drawing the curve, and flush internal buffers. (yes bestie, that quote is doing its own thing in the source, we move on πŸ’…)

DPSMTH accumulates points until it has an internal buffer-load or until the last one has been received. Then it does the main character move: it creates a smooth curve passing through all the points, interpolates points along that smooth curve, and passes those points along to the routine DPDRAW. iconic behaviour, honestly.

And here's the tea on the smoothing 🍡 β€” if the internal parameter 'TCS' has a value less than or equal to zero, the smoothing is done using simple cubic splines; if 'TCS' has a value greater than zero, the smoothing is done using cubic splines under tension, and 'TCS' specifies the desired tension. 🫢


🌟 EXAMPLES 🌟

Use the ncargex command to see the following relevant examples: tdshpk.

go look at tdshpk, bestie, it's right there, it's free ✨

πŸ‘‘ ACCESS πŸ‘‘

To use DPSMTH or c_dpsmth, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters, don't be chaotic πŸ™ˆ


πŸ’– SEE ALSO πŸ’–

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

Hardcopy: None. (the hardcopy said "not me" πŸ’€)


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 DPSMTH(3NCARG) from the UNIX manual, dated March 1995 β€” yes she's vintage, yes she still ate, we love a classic πŸ‘‘πŸ’œ