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-2009
65       University Corporation for Atmospheric Research
66       The use of this Software is governed by a License Agreement.
67
68
69
70UNIX                              March 1993                   GSET_VP(3NCARG)
Impressum