GINQ_COLR_REP(3NCARG)

✨ GINQ_COLR_REP 💅 (NCAR GRAPHICS, section 3NCARG)

okay bestie, gather round 🫶 this is a page from the NCAR Graphics manual, and today we're learning about ginq_colr_rep — Inquire color representation — which retrieves the color value associated with a color index on a particular workstation. like, you ask it "hey what color is this index on this machine" and it tells you. iconic behaviour honestly 💖

---

🌸 NAME 🌸

ginq_colr_rep (Inquire color representation) — retrieves the color value associated with a color index on a particular workstation. no cap, that's literally the whole job 👑

---

🎀 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);

copy it exactly bestie, don't get creative with the signature 😭

---

🦋 DESCRIPTION 🦋

okay so here's the cast of characters, one by one:

• ws_id (Input) — gives a workstation identifier, the same one you set in a previous call to gopen_ws. like, the workstation has to already exist, we're not manifesting it out of thin air ✨
• colr_ind (Input) — a color index. that's the lil number you're asking about 💅
• type (Input) — this one is the vibe check 👀 it specifies whether the returned color values are the ones that were specified by a call to gset_colr_rep, or whether they're the color values that are actually being used on the specified workstation. and fr fr, a workstation frequently will not be able to represent a requested color value precisely — she's doing her best, but she's got limits 😭
  • GINQ_SET — returns the color value set for index colr_ind, either by default or by a call to gset_colr_rep. the ✨intended✨ look.
  • GINQ_REALIZED — returns the color value actually used by the workstation to represent the requested color. the "what you got, not what you asked for" option, no cap.
• err_ind (Output) — if the inquired values can't be returned correctly, a non-zero error indicator lands in err_ind; otherwise you get a zero. a zero is the slay outcome, a non-zero is the "something's off" outcome 🙈 and if you need the full lore on what each error indicator means, consult "User's Guide for NCAR GKS-0A Graphics".
• colr_rep.rgb.red (Gfloat, Output) — returns an intensity value for red, in the range 0. to 1. inclusive. 🌹
• colr_rep.rgb.green (Gfloat, Output) — returns an intensity value for green, in the range 0. to 1. inclusive. 🍀
• colr_rep.rgb.blue (Gfloat, Output) — returns an intensity value for blue, in the range 0. to 1. inclusive. 🦋

so like, three floats walk into a struct and together they're your whole color. cute right?? 💜

---

🌈 USAGE 🌈

for details on setting and using color indices, go read the man page for gset_colr_rep. that's where the index-setting lore lives, iykyk 🧚

---

👑 ACCESS 👑

to use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries. that's the entry fee bestie, pay it 💳

---

🔥 SEE ALSO 🔥

Online: gset_colr_rep(3NCARG), gset_line_colr_ind(3NCARG), gset_marker_size(3NCARG), gset_text_colr_ind(3NCARG), gset_fill_colr_ind(3NCARG), gks(3NCARG), ncarg_gks_cbind(3NCARG)

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

go read the friends, they're all part of the same friend group 💖

---

💜 COPYRIGHT 💜

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

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

bestie, it's a License Agreement, not a vibe suggestion — respect it 🫡

---

and that's the whole page, no crumbs left 🌸 this one came out of the UNIX corner of the manual, dated March 1993, and it lives under GINQ_COLR_REP(3NCARG) — periodt 💅✨