GINQ_ASFS(3NCARG)

💖 GINQ_ASFS 💖

okay bestie, welcome to the NCAR GRAPHICS corner of the man pages 🎀 this one is ginq_asfs, and the "asfs" is giving aspect source flags — like, it's the function that inquires (asks nicely) what your aspect source flags are set to. and those flags are literally the whole vibe check for whether your primitive attributes get picked from their own individual settings or from the "bundle tables" 👑

✨ SYNOPSIS ✨

#include <ncarg/gks.h>

void ginq_asfs(Gint *err_ind, Gasfs *list_asf);

🌸 DESCRIPTION 🌸

• err_ind — (Output) — if the value you're inquiring about can't be returned correctly, you get a non-zero error indicator dropped into err_ind. otherwise? zero, as it should be 💅. if you need the lore on what the error indicators actually mean, go read the User's Guide for NCAR GKS-0A Graphics, no cap.
• list_asf — (Output) — a whole structure of settings for the thirteen attributes. yes, thirteen. a full baker's dozen. let's meet them 🥐:
  • list_asfs.linetype — Linetype
  • list_asfs.linewidth — Linewidth scale factor
  • list_asfs.line_colr_ind — Polyline color index
  • list_asfs.marker_type — Marker type
  • list_asfs.marker_size — Marker size scale factor
  • list_asfs.marker_colr_ind — Polymarker color index
  • list_asfs.text_font_prec — Text font and precision
  • list_asfs.char_expan — Character expansion factor
  • list_asfs.char_space — Character spacing
  • list_asfs.text_colr_ind — Text color index
  • list_asfs.fill_int_style — Fill area interior style
  • list_asfs.fill_style_ind — Fill area style index
  • list_asfs.fill_colr_ind — Fill area color index

and every single value in list_asf is either GASF_BUNDLED (for "bundled", iykyk) or GASF_INDIV (for "individual", the solo era) ✨

🦋 USAGE 🦋

so in NCAR Graphics, all attribute aspect source flags are defaulted to "individual" — meaning every value in list_asf is GASF_INDIV. and honestly? the advice is to keep them there if you want dependable results when you're using NCAR Graphics. do not touch. let them cook. 🙏

some other GKS packages default these values to "bundled" though — not our fault, different household, different rules 😭. so that's exactly why ginq_asfs exists: call it to find out the values of all aspect source flags, no guessing, no assumptions, just facts 💯

🔥 ACCESS 🔥

to use the GKS C-binding routines, you gotta load the ncarg_gks and ncarg_c libraries. load them. both. periodt 💅

🌈 SEE ALSO 🌈

Online, bestie — go read these:

• gset_asfs(3NCARG), gset_linetype(3NCARG), gset_linewidth(3NCARG), gset_line_colr_ind(3NCARG), gset_marker_type(3NCARG), gset_marker_size(3NCARG), gset_marker_colr_ind(3NCARG), gset_text_font_prec(3NCARG), gset_char_expan(3NCARG), gset_text_font_prec(3NCARG), gset_text_colr_ind(3NCARG), gset_fill_int_style(3NCARG), gset_fill_style_ind(3NCARG), gset_fill_colr_ind(3NCARG)
• ginq_linetype(3NCARG), ginq_linewidth(3NCARG), ginq_line_colr_ind(3NCARG), ginq_marker_type(3NCARG), ginq_marker_size(3NCARG), ginq_marker_colr_ind(3NCARG), ginq_text_font_prec(3NCARG), ginq_char_expan(3NCARG), ginq_text_font_prec(3NCARG), ginq_text_colr_ind(3NCARG), ginq_fill_int_style(3NCARG), ginq_fill_style_ind(3NCARG), ginq_fill_colr_ind(3NCARG), gks(3NCARG), ncarg_gks_cbind(3NCARG)

Hardcopy (yes, paper, the vintage experience 📜): User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version

👑 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, babe 🫶 this one's from the UNIX manual, dated March 1993 — an absolute icon, honestly, still serving after all these years 💖✨🎀