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

NAME

6       GOPWK (Open workstation) - opens a GKS workstation.
7

SYNOPSIS

9       CALL GOPWK (WKID, CONID, WKTYPE)
10

C-BINDING SYNOPSIS

12       #include <ncarg/gks.h>
13
14       void gopen_ws(Gint ws_id, const char *conn_id, Gint ws_type);
15

DESCRIPTION

17       WKID        (Integer, Input) - A number assigned to a workstation as an
18                   identifier that is to be used in all  subsequent  calls  to
19                   GKS  functions  that  require a workstation identifier.  In
20                   NCAR GKS, WKID can be any non-negative integer.
21
22       CONID       (Integer, Input) - A connection identifier that has differ‐
23                   ent meanings for different workstation types (see the USAGE
24                   section below).
25
26       WKTYPE      (Integer, Input) - An identifier  specifying  the  specific
27                   type  of  output  device targeted.  Each GKS package has an
28                   implementation-dependent set of workstation types that  the
29                   package  supports.  The legal workstation types in NCAR GKS
30                   are:
31
32                    1    -  NCGM
33
34                    3    -  WISS
35
36                    7    -  pre-existing X11 window.
37
38                    8    -  non-existing X11 window.
39
40                   10    -  text dump of graphics output.
41
42                   11    -  PDF in portrait mode.
43
44                   12    -  PDF in landscape mode.
45
46                   20    -  color PostScript in portrait mode.
47
48                   21    -  color Encapsulated PostScript  (EPS)  in  portrait
49                         mode.
50
51                   22    -   color  Encapsulated PostScript Interchange format
52                         (EPSI) in portrait mode.
53
54                   23    -  monochrome PostScript in portrait mode.
55
56                   24    -  monochrome Encapsulated PostScript (EPS)  in  por‐
57                         trait mode.
58
59                   25    -   monochrome  Encapsulated  PostScript  Interchange
60                         format (EPSI) in portrait mode.
61
62                   26    -  color PostScript in landscape mode.
63
64                   27    -  color Encapsulated PostScript (EPS)  in  landscape
65                         mode.
66
67                   28    -   color  Encapsulated PostScript Interchange format
68                         (EPSI) in landscape mode.
69
70                   29    -  monochrome PostScript in landscape mode.
71
72                   30    -  monochrome Encapsulated PostScript (EPS) in  land‐
73                         scape mode.
74
75                   31    -   monochrome  Encapsulated  PostScript  Interchange
76                         format (EPSI) in landscape mode.
77

USAGE

79       For workstation types of 1 (CGM) or 3 (WISS) the connection ID is  used
80       as a Fortran logical unit number.  One can have at most one workstation
81       of type 1 open at a time and this also applies to workstations of  type
82       3.   One can have workstations of types 1 and 3 open simultaneously and
83       they must have distinct connection IDs.  To use the GFLASH  package  or
84       any GKS segmentation functions WISS must be opened first.
85
86       For  workstations  of type 7 the connection ID is the X11 window ID for
87       the existing window (obtained from xwininfo for example).
88
89       For workstations of type 8 an X11 window will be created at open  work‐
90       station time.  The connection ID is irrelevant for workstations of type
91       8.
92
93       For workstations of type 10, the ASCII text is written to standard out‐
94       put and the connection ID is irrelevant.
95
96       There  can  be a maximum of fifteen simultaneously open workstations of
97       all types.
98

ACCESS

100       To use GKS routines, load the NCAR GKS-0A library ncarg_gks.
101

SEE ALSO

103       Online: gopks, gacwk, gdawk, gclwk, gclks, opngks, clsgks, gopen_ws
104
105       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR  Graphics  Funda‐
106       mentals, UNIX Version
107

109       Copyright (C) 1987-2007
110       University Corporation for Atmospheric Research
111
112       This  documentation  is  free  software; you can redistribute it and/or
113       modify it under the terms of the GNU General  Public  License  as  pub‐
114       lished  by  the  Free  Software  Foundation;  either  version  2 of the
115       License, or (at your option) any later version.
116
117       This software is distributed in the hope that it will  be  useful,  but
118       WITHOUT  ANY  WARRANTY;  without  even  the  implied  warranty  of MER‐
119       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU  General
120       Public License for more details.
121
122       You should have received a copy of the GNU General Public License along
123       with this software; if not, write  to  the  Free  Software  Foundation,
124       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
125
126
127
128UNIX                              March 1993                     GOPWK(3NCARG)
Impressum