ncl_gsvp (3) - Linux Manuals

ncl_gsvp: establishes a rectangular subspace of

NAME

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.

COPYRIGHT

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