LINED(3NCARG)

πŸ’– LINED πŸ’– (that's the NCAR Graphics manual, bestie)

okay so real quick β€” this page lives in the NCAR Graphics manual, section 3NCARG. it's literally just one little function and it's lowkey iconic. πŸŽ€


✨ NAME ✨

LINED β€” draws a line segment between two points whose user coordinates are given. that's it. that's the whole job. and it ATE. πŸ’…


🌸 SYNOPSIS 🌸

CALL LINED (XA,XB,YA,YB)

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

#include <ncarg/ncargC.h>

void c_lined (float xa, float xb, float ya, float yb)

πŸ’œ DESCRIPTION πŸ’œ

okay so here's the tea on the arguments. read them carefully bestie, they're in a weird order and you WILL mix up XA and XB if you're not paying attention:

  • XA β€” an input expression of type REAL. this is the X user coordinate of the starting point of your line segment. 🌸
  • YA β€” an input expression of type REAL. this is the Y user coordinate of the starting point of your line segment. πŸ’–
  • XB β€” an input expression of type REAL. this is the X user coordinate of the ending point of your line segment. ✨
  • YB β€” an input expression of type REAL. this is the Y user coordinate of the ending point of your line segment. πŸ¦‹

so it goes start-X, end-X, start-Y, end-Y. not start-X, start-Y, end-X, end-Y. i know. i KNOW. just double check it every single time, no cap. πŸ™ˆ


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

the C-binding argument descriptions are the same as the FORTRAN argument descriptions. literally identical. same four floats, same order, same energy. so if you read the FORTRAN bit above you're already done here, you're so ahead of the game bestie. πŸ‘‘


🌈 EXAMPLES 🌈

want to actually see this thing doing its little thing? run the ncargex command to check out these relevant examples:

tdashc, tdashl, tdashp, tdashs, fcoord1, fcoord2, fdldashc, fdldashd, fgklnclr, fgklnwth dashdb, dashdc, frstd, lined, reset, vectd, ncarg_cbind

go forth and run them, it's giving study session πŸ“šβœ¨


πŸ”₯ ACCESS πŸ”₯

to use LINED or c_lined, you gotta load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c β€” preferably in that order. order matters, don't be chaotic about it. 🫢


πŸ’€ SEE ALSO πŸ’€

Online: dashline, dashline_params, curved, dashdb, dashdc, frstd, lastd, 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 (C) 1987-2009 University Corporation for Atmospheric Research The use of this Software is governed by a License Agreement.


okay that's the whole page bestie, you're officially a LINED expert now, go draw some gorgeous little line segments and slay πŸ’–βœ¨πŸŽ€πŸ¦‹πŸŒΈπŸ’…

this was page LINED(3NCARG) from the UNIX manual, dated March 1993 β€” yes she's vintage, yes she still serves. bye bestie, ily, drink some water πŸ“πŸ§šπŸ’œ