GSET_WIN(3NCARG)

✨ GSET_WIN ✨ (a.k.a. Set window, from the 3NCARG girlies 💖)

okay bestie, so this is gset_win — it's the NCAR GRAPHICS routine that establishes a window, aka a rectangular subspace, of world coordinates that's gonna get plotted. cute, right? 🎀

but before you get too attached: calls to gset_win are discouraged with NCAR Graphics. like, the docs are literally side-eyeing you. instead, use the c_set routine, because c_set also supports mirror imaging and log scaling of axes. c_set is the main character here, fr fr. 👑

🌈 SYNOPSIS 🌈

#include <ncarg/gks.h>

void gset_win(Gint tran_num, const Glimit *win_limits);

💅 DESCRIPTION 💅

• tran_num — (Input) a normalization transformation number. how many transformations you even get is implementation specific, so don't come for me, that's just what the manpage says. in the case of NCAR GKS-0A, you get exactly two normalization transformations:
  • 0 — selects the identity transformation, where both the window and the viewport have the range of 0. to 1. in both coordinate directions. this is the default normalization transformation for GKS. it's also fixed within GKS, which means it is illegal to call gset_win with tran_num = 0. 🚫 like literally illegal, do not do it, the vibes will be off.
  • 1 — a normalization transformation where the window is defined by win_limits.x_min to win_limits.x_max and win_limits.y_min to win_limits.y_max. this is the one you actually want, bestie.
• win_limits.x_min — (Gfloat, Input) the left horizontal coordinate of the window. and hey, x_min < x_max, okay? that's the rule. 📏
• win_limits.x_max — (Gfloat, Input) the right horizontal coordinate of the window.
• win_limits.y_min — (Gfloat, Input) the bottom vertical coordinate of the window. also y_min < y_max, obviously, we stay consistent. ✨
• win_limits.y_max — (Gfloat, Input) the top vertical coordinate of the window.

🔑 ACCESS 🔑

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

🫶 SEE ALSO 🫶

Online: set(3NCARG), gset_vp(3NCARG), gsel_norm_tran(3NCARG), ginq_clip(3NCARG), gks(3NCARG) ncarg_gks_cbind(3NCARG)

Hardcopy: 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, bestie 🦋 this 3NCARG manual page is dated March 1993 and comes to you from UNIX, GSET_WIN(3NCARG) — slay, stay hydrated, and go use c_set instead 💜