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.