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-2007
57       University Corporation for Atmospheric Research
58
59       This  documentation  is  free  software; you can redistribute it and/or
60       modify it under the terms of the GNU General  Public  License  as  pub‐
61       lished  by  the  Free  Software  Foundation;  either  version  2 of the
62       License, or (at your option) any later version.
63
64       This software is distributed in the hope that it will  be  useful,  but
65       WITHOUT  ANY  WARRANTY;  without  even  the  implied  warranty  of MER‐
66       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU  General
67       Public License for more details.
68
69       You should have received a copy of the GNU General Public License along
70       with this software; if not, write  to  the  Free  Software  Foundation,
71       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
72
73
74
75UNIX                              March 1993                 GCLEAR_WS(3NCARG)
Impressum