NAME

       gopen_ws - opens a GKS workstation

SYNOPSIS

       #include <ncarg/gks.h>

       void gopen_ws(Gint ws_id, const char *conn_id, Gint ws_type);

DESCRIPTION

       ws_id       (Input)  -  A  number  assigned  to  a workstation as an identifier that is to be used in all
                   subsequent calls to GKS functions that require a workstation identifier.  In NCAR GKS,  ws_id
                   can be any non-negative integer.

       conn_id     (Input) - A connection identifier that has different meanings for different workstation types
                   (see the USAGE section below).

       ws_type     (Input)  -  An  identifier  specifying the specific type of output device targeted.  Each GKS
                   package has an implementation-dependent set of workstation types that the  package  supports.
                   The legal workstation types in NCAR GKS are:

                    1    -  NCGM

                    3    -  WISS

                    7    -  pre-existing X11 window.

                    8    -  non-existing X11 window.

                   10    -  text dump of graphics output.

                   11    -  PDF in portrait mode.

                   12    -  PDF in landscape mode.

                   20    -  color PostScript in portrait mode.

                   21    -  color Encapsulated PostScript (EPS) in portrait mode.

                   22    -  color Encapsulated PostScript Interchange format (EPSI) in portrait mode.

                   23    -  monochrome PostScript in portrait mode.

                   24    -  monochrome Encapsulated PostScript (EPS) in portrait mode.

                   25    -  monochrome Encapsulated PostScript Interchange format (EPSI) in portrait mode.

                   26    -  color PostScript in landscape mode.

                   27    -  color Encapsulated PostScript (EPS) in landscape mode.

                   28    -  color Encapsulated PostScript Interchange format (EPSI) in landscape mode.

                   29    -  monochrome PostScript in landscape mode.

                   30    -  monochrome Encapsulated PostScript (EPS) in landscape mode.

                   31    -  monochrome Encapsulated PostScript Interchange format (EPSI) in landscape mode.

USAGE

       For workstation types of 1 (CGM) the connection ID is the name of the CGM file.  One can have at most one
       workstation of type 1 open at a time.

       For  workstations of type 3 (WISS) the connection ID is irrelevant.  One can have at most one workstation
       of type 3 open.  One can have workstations of types 1 and  3  open  simultaneously  and  they  must  have
       distinct connection IDs.  To use the GFLASH package or any GKS segmentation functions WISS must be opened
       first.

       For  workstations  of type 7 the connection ID is the X11 window ID for the existing window.  This number
       should be passed as a string; for example, "3" for an X11 window ID of 3.

       For workstations of type 8 an X11 window will be created at open workstation time.  The connection ID  is
       irrelevant for workstations of type 8.

       For  workstations  of  type  10,  the  ASCII  text is written to standard output and the connection ID is
       irrelevant.

       There can be a maximum of fifteen simultaneously open workstations of all types.

ACCESS

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

SEE ALSO

       Online:    gopen_gks(3NCARG),    gactivate_ws(3NCARG),     gdeactivate_ws(3NCARG),     gclose_ws(3NCARG),
       gclose_gks(3NCARG), opngks(3NCARG), clsgks(3NCARG), gks(3NCARG), ncarg_gks_cbind(3NCARG)

       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.

UNIX                                               March 1993                                   GOPEN_WS(3NCARG)