ncl_gsvp man page

GSVP (Set viewport) — establishes a rectangular subspace of normalized device coordinates space. Calls to GSVP are discouraged with NCAR Graphics. Instead, use the SET subroutine because SET also supports mirror imaging and log scaling of axes.

Synopsis

CALL GSVP (TRNUM, XMIN, XMAX, YMIN, YMAX)

C-Binding Synopsis

#include <ncarg/gks.h>

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

Description

TRNUM

(Integer, 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 GSVP with TRNUM = 0.
1
A normalization transformation in which the viewport is defined by XMIN to XMAX and YMIN to YMAX.
XMIN
(Real, Input) - The left horizontal coordinate of the viewport.
XMAX
(Real, Input) - The right horizontal coordinate of the viewport. 0. ≤ XMIN < XMAX ≤ 1.
YMIN
(Real, Input) - The bottom vertical coordinate of the viewport.
YMAX
(Real, Input) - The top vertical coordinate of the viewport. 0. ≤ YMIN < YMAX ≤ 1.
Defaults:
TRNUM = 0, XMIN = 0.0, XMAX = 1.0, YMIN = 0.0, YMAX = 1.0

Access

To use GKS routines, load the NCAR GKS-0A library ncarg_gks.

See Also

Online: set, gswn, gselnt, gqclip, gset_vp

Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

Info

14 January 1992 UNIX NCAR GRAPHICS