bionic (3) gopwk.3NCARG.gz

Provided by: libncarg-dev_6.4.0-9_amd64 bug

NAME
       gopwk - opens a GKS workstation


SYNOPSIS
       CALL GOPWK (WKID, CONID, WKTYPE)


C-BINDING SYNOPSIS
       #include <ncarg/gks.h>

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


DESCRIPTION
       WKID        (Integer,  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,
                   WKID can be any non-negative integer.

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

       WKTYPE      (Integer, 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) or 3 (WISS) the connection ID is used as a Fortran logical unit  number.
       One  can  have  at most one workstation of type 1 open at a time and this also applies to workstations of
       type 3.  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 (obtained from
       xwininfo for example).

       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 GKS routines, load the NCAR GKS-0A library ncarg_gks.


SEE ALSO
       Online: gopks, gacwk, gdawk, gclwk, gclks, opngks, clsgks, gopen_ws

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


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