GSPMCI(3NCARG)

💖 GSPMCI — set polymarker color index 💖

okay bestie, welcome to the NCAR GRAPHICS corner of the manual, this one's a 3NCARG page and it's genuinely so simple it's iconic. no cap.

---

✨ NAME ✨

GSPMCI — (that's "Set Polymarker Color Index" if you're being formal) — sets the polymarker color index. that's it. that's the whole job. she's a one-task queen and she ate. 💅

---

🌸 SYNOPSIS 🌸

CALL GSPMCI (COLI)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/gks.h>

void gset_marker_colr_ind(Gint marker_colr_ind);

yes she has a C glow-up too, we love range. ✨

---

🎀 DESCRIPTION 🎀

• COLI — (Integer, Input) — a color index. that's the vibe. you hand her a number, she treats it as a color index, periodt.

---

💜 USAGE 💜

so here's the tea, bestie 🫖: every single polymarker drawn by calls to the GPM output primitive is gonna be drawn in the color tied to index COLI. and it stays that way — like, committed, main character energy — until you call GSPMCI again and assign a new index. so if you set it once and forget it, that color is forever (or at least until you say otherwise 🙈).

ngl the color system is kinda cute once it clicks: for all GKS output primitives, color gets assigned through a color index. those indices run from 0 to 255, and the important lore is:

• index 0 is the background color index
• index 1 is the foreground color index

color values get hooked up to those indices when you call the GKS routine GSCR — that's the matchmaker fr fr. 🫶

⚠️ and here's the plot twist: if you use a color index that has no user-assigned color value set in a GSCR call, then a device-dependent color value gets assigned to that index. meaning you don't control it, the device does. not me leaving my colors up to the hardware 😭

---

🌈 ACCESS 🌈

to use GKS routines, load the NCAR GKS-0A library ncarg_gks. that's the door, walk through it. 🚪✨

---

⭐ SEE ALSO ⭐

Online: gpm, gsmk, gsmksc, gscr, gqmk, gqmksc, gqpmci, point, points, gset_marker_colr_ind

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

like, go read the whole friend group, they all hang out together. 👑

---

👑 COPYRIGHT 👑

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, you understood it, i'm so proud of you, go draw some gorgeous little markers 💖✨

this cutie was documented back in March 1993 under UNIX, and the page is GSPMCI(3NCARG) — yeah she's vintage but she's still slaying, bye bestie 🎀🦋