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