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.