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

NAME

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

SYNOPSIS

9       CALL GCLRWK (WKID, COFL)
10

C-BINDING SYNOPSIS

12       #include <ncarg/gks.h>
13
14       void gclear_ws(Gint ws_id, Gctrl_flag  ctrl_flag);
15

DESCRIPTION

17       WKID        (Integer,  Input) - A number identifying the workstation to
18                   be cleared.  WKID must be the same as  that  used  in  some
19                   previous GOPWK call.
20
21       COFL        (Integer,  Input)  - Clear the workstation display surface.
22                   Options are:
23
24                   0      Check to see if the display surface is empty. If so,
25                          do not issue a clear surface command.
26
27                   1      Issue  a  clear  surface command whether the surface
28                          has been written to or not.
29

USAGE

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

ACCESS

46       To use GKS routines, load the NCAR GKS-0A library ncarg_gks.
47

SEE ALSO

49       Online: gopwk, gacwk, gdawk, gclwk, gclear_ws
50
51       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR  Graphics  Funda‐
52       mentals, UNIX Version
53

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