NAME

       GCLRWK - clears a GKS workstation

SYNOPSIS

       CALL GCLRWK (WKID, COFL)

C-BINDING SYNOPSIS

       #include <ncarg/gks.h>

       void gclear_ws(Gint ws_id, Gctrl_flag  ctrl_flag);

DESCRIPTION

       WKID        (Integer,  Input)  - A number identifying the workstation to be cleared.  WKID
                   must be the same as that used in some previous GOPWK call.

       COFL        (Integer, Input) - Clear the workstation display surface. Options are:

                   0      Check to see if the display surface is empty. If so,  do  not  issue  a
                          clear surface command.

                   1      Issue  a  clear surface command whether the surface has been written to
                          or not.

USAGE

       For workstations of type "1" (CGM), GCLRWK is interpreted as a picture termination in  CGM
       generation. If COFL = 0 and no output primitives have been written in the current picture,
       then a call to GCLRWK is a "do nothing"; otherwise, it generates an  END  PICTURE  element
       (as  well  as  other  picture  initializing  elements). If COFL = 1, then a call to GCLRWK
       generates an END PICTURE.

       For workstations of types "7" or "8" (see the man page for  GOPWK  for  a  description  of
       workstation types) clear workstations erases all primitives that appear on the screen.

       For all other workstation types, clear workstation simply updates the workstation.

ACCESS

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

SEE ALSO

       Online: gopwk, gacwk, gdawk, gclwk, gclear_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.