GQCR(3NCARG)

πŸ“¦ version 6.6.2, in epel 9, fedora 43, fedora 44

✨ GQCR (Inquire color representation) ✨

okay bestie, so this is GQCR, from the NCAR GRAPHICS manual (section 3NCARG, we love a legend) πŸ’– and it's literally the "what color is that actually" function. It retrieves the color value associated with a color index on a particular workstation. that's the whole vibe. 🎨✨


🌸 SYNOPSIS 🌸

CALL GQCR (WKID, CI, TYPE, ERRIND, CR, CG, CB)

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

#include <ncarg/gks.h>

void ginq_colr_rep(Gint ws_id, Gint colr_ind, Ginq_type type, Gint
*err_ind, Gcolr_rep  *colr_rep);

πŸ’… DESCRIPTION πŸ’…

okay so here's every single argument, no skips, we're being thorough because that's the energy:

  • WKID (Integer, Input) β€” the workstation identifier, and it has to be the same one you set earlier when you called GOPWK. like, the exact same one. no cap. πŸ–₯️
  • CI (Integer, Input) β€” a color index. just a color index. that's it, that's the whole job. πŸŽ€
  • TYPE (Integer, Input) β€” this one's lowkey important bestie, because it decides which color values come back at you: the ones you asked for with a GSCR call, or the ones the workstation is actually using. and yes, those are often different, because (and this is a direct quote from the lore) frequently a workstation will not be able to represent a requested color value precisely. so it fudges it. it does its best. πŸ™ˆ
    • 0 β€” Returns the color value set for index CI either by default or by a call to GSCR. (the idea of the color, the dream πŸ’­)
    • 1 β€” Returns the color value actually used by the workstation to represent the requested color. (the color you're actually getting, the reality check 🫠)
  • ERRIND (Integer, Output) β€” if the inquired values can't be returned correctly, you get a non-zero error indicator here. otherwise? a zero. very chill of it. go read the "User's Guide for NCAR GKS-0A Graphics" if you wanna know what each error indicator means, because that's where the lore lives. πŸ“–
  • CR (Real, Output) β€” the red intensity value, in the range 0. to 1. inclusive. 🌹
  • CG (Real, Output) β€” the green intensity value, in the range 0. to 1. inclusive. 🌿
  • CB (Real, Output) β€” the blue intensity value, in the range 0. to 1. inclusive. 🫐

so you get three lil reals back and suddenly you know exactly what shade of blue that index turned into. iconic. πŸ’™


🫢 USAGE 🫢

want the details on setting and using color indices? go read the man page for GSCR. that's the one that tells you how to set them. this one just tells you what they became. iykyk. ✨


πŸ‘‘ ACCESS πŸ‘‘

To use GKS routines, load the NCAR GKS-0A library ncarg_gks. that's the tea. πŸ”₯


🌈 SEE ALSO 🌈

Online: gscr, gsplci, gsmkci, gstxci, gsfaci, ginq_colr_rep

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

like literally a whole friend group of man pages, go say hi to all of them πŸ’œ


Copyright (C) 1987-2009 University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement.


okay bestie that's the whole page, every flag, every value, every last detail, all accounted for πŸŽ€ now go forth and inquire about some colors, you absolute main character πŸ’…βœ¨

later babes πŸ’œ this was GQCR(3NCARG) from the UNIX manual, dated March 1993, and it slayed then and it slays now. periodt. πŸŒΈπŸ¦‹β­

πŸ“¦ where this page comes from