GSET_VP(3NCARG)

💖 GSET_VP 💖 — the gset_vp page from NCAR Graphics (3NCARG), bestie edition

okay so you found the gset_vp manpage, welcome, sit down, we're doing this 🫶

---

✨ NAME ✨

gset_vp (aka Set viewport) — it establishes a rectangular subspace of normalized device coordinates space. 💅

real talk though: calls to gset_vp are discouraged with NCAR Graphics. Instead, use the c_set routine, because c_set also supports mirror imaging and log scaling of axes. like, it just does more, okay? 👑

---

🎀 SYNOPSIS 🎀

#include <ncarg/gks.h>

void gset_vp(Gint tran_num, const Glimit *vp_limits);

look at her. iconic signature. no notes. ✨

---

🌸 DESCRIPTION 🌸

okay so here's the whole vibe check on the arguments:

• tran_num — (Input) a normalization transformation number. The number of available transformations is implementation specific. In the case of NCAR GKS-0A, two normalization transformations are provided:
  • 0 — selects the identity transformation, in which both the window and viewport have the range of 0. to 1. in both coordinate directions. This is the default normalization transformation for GKS. It is also fixed within GKS; that is, it is illegal to call gset_vp with tran_num = 0. 🚫 like do not do it. it will not slay.
  • 1 — a normalization transformation in which the viewport is defined by vp_limits.x_min to vp_limits.x_max and vp_limits.y_min to vp_limits.y_max. this is the one you actually want, bestie 💖
• vp_limits.x_min — (Real, Input) the left horizontal coordinate of the viewport. 👈
• vp_limits.x_max — (Real, Input) the right horizontal coordinate of the viewport. 👉

0. ≤ vp_limits.x_min < vp_limits.x_max ≤ 1.

• vp_limits.y_min — (Real, Input) the bottom vertical coordinate of the viewport. 👇
• vp_limits.y_max — (Real, Input) the top vertical coordinate of the viewport. 👆

0. ≤ vp_limits.y_min < vp_limits.y_max ≤ 1.

and the defaults, because of course we need the defaults, the defaults are giving "we didn't touch anything and it still works":

Defaults: tran_num = 0, vp_limits.x_min = 0.0, vp_limits.x_max = 1.0, vp_limits.y_min = 0.0, vp_limits.y_max = 1.0 🌈

---

🦋 ACCESS 🦋

to use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries. both. not one. both. 🧚

---

💜 SEE ALSO 💜

Online:

• set(3NCARG)
• gset_win(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

go read them, fr fr, they're the group chat you wanna be in 📚✨

---

👑 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 page, bestie 💅 this one shipped on UNIX, dated March 1993, and it lives in the GSET_VP(3NCARG) manual — so if you ever forget any of it, that's exactly where to find her again. mwah 🎀💖