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¶
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.