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

NAME

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

SYNOPSIS

9       #include <ncarg/gks.h>
10
11       void gopen_ws(Gint ws_id, const char *conn_id, Gint ws_type);
12

DESCRIPTION

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

USAGE

75       For  workstation  types of 1 (CGM) the connection ID is the name of the
76       CGM file.  One can have at most one workstation of type  1  open  at  a
77       time.
78
79       For workstations of type 3 (WISS) the connection ID is irrelevant.  One
80       can have at most one workstation of type 3 open.  One can have worksta‐
81       tions  of types 1 and 3 open simultaneously and they must have distinct
82       connection IDs.  To use the GFLASH  package  or  any  GKS  segmentation
83       functions WISS must be opened first.
84
85       For  workstations  of type 7 the connection ID is the X11 window ID for
86       the existing window.  This number should be passed  as  a  string;  for
87       example, "3" for an X11 window ID of 3.
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  the  GKS  C-binding  routines,  load the ncarg_gks and ncarg_c
101       libraries.
102

SEE ALSO

104       Online:     gopen_gks(3NCARG),      gactivate_ws(3NCARG),      gdeacti‐
105       vate_ws(3NCARG), gclose_ws(3NCARG), gclose_gks(3NCARG), opngks(3NCARG),
106       clsgks(3NCARG), gks(3NCARG), ncarg_gks_cbind(3NCARG)
107
108       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR  Graphics  Funda‐
109       mentals, UNIX Version
110

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