POINT(3NCARG)

✨ POINT β€” bestie we're drawing A DOT ✨

okay so this is the NCAR GRAPHICS manual page for POINT, and honestly? it does exactly what it says on the tin. it draws a point. one (1) single point. at a position you pick in the user coordinate system. it's giving minimalism, it's giving "the dot is the moment." πŸ’…


🌸 NAME 🌸

POINT β€” draws a point at a specified position in the user coordinate system.

no cap. that's the whole job. πŸŽ€


✨ SYNOPSIS ✨

CALL POINT (PX,PY)

that's it. that's the call. two args, one dot, iconic behavior. πŸ¦‹


🫢 C-BINDING SYNOPSIS 🫢

for my C girlies (and honestly, same):

#include <ncarg/ncargC.h>

void c_point (float px, float py)

πŸ’– DESCRIPTION πŸ’–

here's the tea on the arguments, bestie β€” there are exactly two and they're both REAL:

  • PX β€” an input expression of type REAL that defines the X user coordinate where the dot is gonna be drawn. yes, that X. the horizontal one. πŸ“
  • PY β€” an input expression of type REAL that defines the Y user coordinate where the dot is gonna be drawn. the vertical one. together they vibe-check your dot into existence. πŸ’«

🌈 C-BINDING DESCRIPTION 🌈

the C-binding argument descriptions are literally the same as the FORTRAN argument descriptions. same px, same py, same energy. no extra lore, no secret third argument. periodt. πŸ’€


πŸ‘‘ USAGE πŸ‘‘

okay so here's where it gets spicy. some important context:

  • if you want a filled dot of arbitrary size, that is not this routine. go see the routine NGDOTS instead β€” she does the big dots. πŸ“
  • you can also use the GKS routine GPM to draw a dot in world coordinates, however β€” and this is the key part β€” NCAR Graphics user coordinates allow for mirror imaging of axes and logarithmic axes, which GKS does not. so like, if you need that axis glow-up, you know where to be. πŸ”₯
  • for a full description of these coordinate systems, see the SCD User Doc "NCAR Graphics Fundamentals, UNIX Version". it's the lore document. iykyk. πŸ“š

πŸŽ€ EXAMPLES πŸŽ€

use the ncargex command to see the following relevant examples: tareas.

that's the one. tareas. go run it, bestie, live a little. 🌸

πŸ’œ ACCESS πŸ’œ

to use POINT or c_point, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c β€” preferably in that order. order matters here, don't fight it. πŸ™ˆ


πŸ¦‹ SEE ALSO πŸ¦‹

Online: gpm, gsmk, gsmksc, gscr, gspmci, spps, spps_params, plotif, ngdots, points, ncarg_cbind

Hardcopy: 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.


and that's the whole page, bestie!! πŸ’– this was the UNIX version, dated March 1993 (yes, she's vintage, she's a classic, we respect her), and it came to you straight from the POINT(3NCARG) page itself. go forth and draw ur dot. slay. ✨🫢🌟