NAME¶
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
COPYRIGHT¶
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.