1GSET_VP(3NCARG)                  NCAR GRAPHICS                 GSET_VP(3NCARG)
2
3
4

NAME

6       gset_vp  (Set viewport) - establishes a rectangular subspace of normal‐
7       ized device coordinates space. Calls to gset_vp  are  discouraged  with
8       NCAR  Graphics.  Instead, use the c_set routine because c_set also sup‐
9       ports mirror imaging and log scaling of axes.
10

SYNOPSIS

12       #include <ncarg/gks.h>
13
14       void gset_vp(Gint tran_num, const Glimit *vp_limits);
15

DESCRIPTION

17       tran_num    (Input) A normalization transformation number.  The  number
18                   of available transformations is implementation specific. In
19                   the case of NCAR GKS-0A, two normalization  transformations
20                   are provided:
21
22                   0      Selects  the  identity  transformation in which both
23                          the window and viewport have the range of 0.  to  1.
24                          in  both coordinate directions.  This is the default
25                          normalization transformation for  GKS.  It  is  also
26                          fixed  within  GKS;  that  is, it is illegal to call
27                          gset_vp with tran_num = 0.
28
29                   1      A normalization transformation in which the viewport
30                          is defined by vp_limits.x_min to vp_limits.x_max and
31                          vp_limits.y_min to vp_limits.y_max.
32
33       vp_limits.x_min
34                   (Real, Input) - The left horizontal coordinate of the view‐
35                   port.
36
37       vp_limits.x_max
38                   (Real,  Input)  -  The  right  horizontal coordinate of the
39                   viewport.  0. ≤ vp_limits.x_min < vp_limits.x_max ≤ 1.
40
41       vp_limits.y_min
42                   (Real, Input) - The bottom vertical coordinate of the view‐
43                   port.
44
45       vp_limits.y_max
46                   (Real,  Input)  -  The top vertical coordinate of the view‐
47                   port.  0. ≤ vp_limits.y_min < vp_limits.y_max ≤ 1.
48
49       Defaults:   tran_num = 0, vp_limits.x_min = 0.0, vp_limits.x_max = 1.0,
50                   vp_limits.y_min = 0.0, vp_limits.y_max = 1.0
51

ACCESS

53       To  use  the  GKS  C-binding  routines,  load the ncarg_gks and ncarg_c
54       libraries.
55

SEE ALSO

57       Online:    set(3NCARG),    gset_win(3NCARG),    gsel_norm_tran(3NCARG),
58       ginq_clip(3NCARG), gks(3NCARG), ncarg_gks_cbind(3NCARG)
59
60       Hardcopy:  User's  Guide for NCAR GKS-0A Graphics; NCAR Graphics Funda‐
61       mentals, UNIX Version
62

64       Copyright (C) 1987-2007
65       University Corporation for Atmospheric Research
66
67       This documentation is free software; you  can  redistribute  it  and/or
68       modify  it  under  the  terms of the GNU General Public License as pub‐
69       lished by the  Free  Software  Foundation;  either  version  2  of  the
70       License, or (at your option) any later version.
71
72       This  software  is  distributed in the hope that it will be useful, but
73       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
74       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
75       Public License for more details.
76
77       You should have received a copy of the GNU General Public License along
78       with  this  software;  if  not,  write to the Free Software Foundation,
79       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
80
81
82
83UNIX                              March 1993                   GSET_VP(3NCARG)
Impressum