NAME¶
gclear_ws - clears a workstation.
SYNOPSIS¶
#include <ncarg/gks.h>
void gclear_ws(Gint ws_id, Gctrl_flag ctrl_flag);
DESCRIPTION¶
- ws_id
- (Input) - A number identifying the workstation to be cleared. ws_id must
be the same as that used in some previous gopen_ws call.
- ctrl_flag
- (Input) - Clear the workstation display surface. Options are:
- GFLAG_COND
- Check to see if the display surface is empty. If so, do not issue a clear
surface command.
- GFLAG_ALWAYS
- Issue a clear surface command whether the surface has been written to or
not.
USAGE¶
For workstations of type "1" (CGM), gclear_ws is interpreted as a
picture termination in CGM generation. If ctrl_flag = GFLAG_COND and no output
primitives have been written in the current picture, then a call to gclear_ws
is a "do nothing"; otherwise, it generates an END PICTURE element
(as well as other picture initializing elements). If ctrl_flag = GFLAG_ALWAYS,
then a call to gclear_ws generates an END PICTURE.
For workstations of types "7" or "8" (see the man page for
gopen_ws 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 the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries.
SEE ALSO¶
Online:
gopen_ws(3NCARG), gactivate_ws(3NCARG),
gdeactivate_ws(3NCARG), gclose_ws(3NCARG), gks(3NCARG),
ncarg_gks_cbind(3NCARG)
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.