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-2009
113       University Corporation for Atmospheric Research
114       The use of this Software is governed by a License Agreement.
115
116
117
118UNIX                              March 1993                  GOPEN_WS(3NCARG)
Impressum