FRSTPT(3NCARG)

✨ FRSTPT ✨ — it's giving "pen up, bestie" 🖊️💅

NCAR GRAPHICS manual page, third section of the NCAR Graphics docs (3NCARG). Yes bestie, we're in the C/FORTRAN graphics lore today. Sit down, hydrate, let's go. 🫶

---

💖 NAME 💖

FRSTPT — ok so what this does is generate a "pen-up" move to a specified point in the user coordinate system. That's the whole vibe. 🎀

And like, FRSTPT does not work alone, no ma'am, it's a duo. It's used in conjunction with the routine VECTOR to actually draw lines. They're a package deal, fr fr. 👑

---

🌸 SYNOPSIS 🌸

CALL FRSTPT (PX,PY)

That's it. That's the call. Iconic behaviour honestly.

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_frstpt (float px, float py)

Look at her, bilingual. 💜

---

✨ DESCRIPTION ✨

• PX — an input expression of type REAL that defines the X user coordinate. 💫
• PY — an input expression of type REAL that defines the Y user coordinate. 💫

Two reals, one dream. No cap.

---

🎀 C-BINDING DESCRIPTION 🎀

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. Literally the same. The C version woke up and chose to be a copy of the FORTRAN one and honestly? Respect. 😌

---

🔥 USAGE 🔥

Okay so here's the tea. 🍓

Polyline type, line width, and color can all be set by calling the GKS routines GSLN, GSLWSC, GSCR, and GSPLCI before calling FRSTPT. Set your aesthetic first, then draw. Main character energy only. 👑

⚠️ IMPORTANT BESTIE, DO NOT SKIP THIS ⚠️ Note that, for the sake of efficiency, the routines FRSTPT and VECTOR buffer the polylines resulting from pen moves. So you must be sure to flush the SPPS polyline buffer before changing polyline attributes. She is holding onto your strokes in memory and she will not let go until you tell her to. 😭 And how do you flush it? A CALL PLOTIF (0.,0.,2) will flush the buffer. That's the magic incantation. Write it down. Tattoo it. 💅

---

🌈 EXAMPLES 🌈

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

That's the one, bestie. Go run ncargex and see her in action. ✨

---

💜 ACCESS 💜

To use FRSTPT or c_frstpt, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

Order matters, okay?? ncarg, then ncarg_gks, then ncarg_c. Do not shuffle them like a playlist. 🙈

---

🌟 SEE ALSO 🌟

Online: gpl, gsln, gslwsc, gscr, gsplci, spps, spps_params, vector, line, curve, ncarg_cbind

Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

Go read the girlies too, 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 whole page, bestie. 💖 This one comes from the UNIX flavour of the manual, dated March 1993, and lives at FRSTPT(3NCARG). Now go flush that buffer before you change your polyline attributes. I'm literally begging. 😭🌸💅