C-BINDING SYNOPSIS#include <ncarg/ncargC.h>
void c_ngpict(int wkid, int action)
- (an input parameter of type INTEGER) which designates the workstation identifier of a workstation as it was specified in a GOPWK call.
(an input parameter of type INTEGER) the value of which specifies the
action to be taken on the workstation WKID.
Legal values are:
- Execute an UPDATE WORKSTATION on WKID.
- Execute an UPDATE WORKSTATION followed by a CLEAR WORKSTATION.
- Execute an UPDATE WORKSTATION followed by a pause waiting for a mouse click or a key click.
- Execute an UPDATE WORKSTATION followed by a pause followed by a CLEAR WORKSTATION after the pause has been terminated by a mouse click or a key click.
- Same as 3 except a "<READY>" prompt is issued in the lower left corner of the window after the UPDATE WORKSTATION.
C-BINDING DESCRIPTIONThe C binding argument descriptions are the same as the FORTRAN argument descriptions.
USAGEIf WKID designates a metafile, then a CLEAR WORKSTATION is done which inserts an END PICTURE into the metafile. The result produced in this case would be the same as that resulting from a call to FRAME. The only valid actions for a metafile workstation are 0 and 1.
NGPICT is designed to be used when more precise control over individual workstations is desired than that offered by FRAME. This might be desirable, for example, when an application is controlling several simultaneously active workstations. To use NGPICT one should be opening GKS workstations with GOPWK rather than with OPNGKS.
EXAMPLESIf WKID=2 designates a metafile workstation, then
CALL NGPICT(2,1)would duplicate the action of a FRAME call.
If WKID=2 designates an X11 workstation, then
CALL NGPICT(2,4)would cause a pause in the X11 window and wait for a key click or a mouse click. A "<READY>" prompt, indicating that the window is waiting for a mouse click or a key click, would appear at the lower left of the X11 window after the window has been updated. After a mouse click in the X11 window, that window will be cleared before program execution continues.
ACCESSTo use NGPICT or c_ngpict, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.
MESSAGESNon-fatal errors are reported for values of ACTION out of range and for values of ACTION inappropriately applied to a metafile. Also, a non-fatal error is reported if NGPICT is called while a segment is open.
COPYRIGHTCopyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.