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.