ncl_gset_vp man page

gset_vp (Set viewport) — establishes a rectangular subspace of normalized device coordinates space. 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.

Synopsis

#include <ncarg/gks.h>

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

Description

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.
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.
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.
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.

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

Info

March 1993 UNIX NCAR GRAPHICS