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.

COPYRIGHT

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.