1GCLEAR_WS(3NCARG)                NCAR GRAPHICS               GCLEAR_WS(3NCARG)
2
3
4

NAME

6       gclear_ws (Clear workstation) - clears a workstation.
7

SYNOPSIS

9       #include <ncarg/gks.h>
10
11       void gclear_ws(Gint ws_id, Gctrl_flag  ctrl_flag);
12

DESCRIPTION

14       ws_id       (Input)  -  A  number  identifying  the  workstation  to be
15                   cleared.  ws_id must be the same as that used in some  pre‐
16                   vious gopen_ws call.
17
18       ctrl_flag   (Input)  -  Clear  the workstation display surface. Options
19                   are:
20
21                   GFLAG_COND
22                          Check to see if the display surface is empty. If so,
23                          do not issue a clear surface command.
24
25                   GFLAG_ALWAYS
26                          Issue  a  clear  surface command whether the surface
27                          has been written to or not.
28

USAGE

30       For workstations of type "1" (CGM), gclear_ws is interpreted as a  pic‐
31       ture  termination  in  CGM generation. If ctrl_flag = GFLAG_COND and no
32       output primitives have been written in the current picture, then a call
33       to  gclear_ws is a "do nothing"; otherwise, it generates an END PICTURE
34       element (as well as other picture initializing elements). If  ctrl_flag
35       = GFLAG_ALWAYS, then a call to gclear_ws generates an END PICTURE.
36
37       For workstations of types "7" or "8" (see the man page for gopen_ws for
38       a description of workstation types) clear workstations erases all prim‐
39       itives that appear on the screen.
40
41       For  all  other workstation types, clear workstation simply updates the
42       workstation.
43

ACCESS

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

SEE ALSO

49       Online: gopen_ws(3NCARG), gactivate_ws(3NCARG), gdeactivate_ws(3NCARG),
50       gclose_ws(3NCARG), gks(3NCARG), ncarg_gks_cbind(3NCARG)
51
52       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR  Graphics  Funda‐
53       mentals, UNIX Version
54

56       Copyright (C) 1987-2009
57       University Corporation for Atmospheric Research
58       The use of this Software is governed by a License Agreement.
59
60
61
62UNIX                              March 1993                 GCLEAR_WS(3NCARG)
Impressum