SYNOPSIS

CALL NGPICT(WKID,ACTION)

C-BINDING SYNOPSIS

#include <ncarg/ncargC.h>

void c_ngpict(int wkid, int action)

DESCRIPTION

WKID

(an input parameter of type INTEGER) which designates the workstation identifier of a workstation as it was specified in a GOPWK call.

ACTION

(an input parameter of type INTEGER) the value of which specifies the action to be taken on the workstation WKID. Legal values are:

0

Execute an UPDATE WORKSTATION on WKID.

1

Execute an UPDATE WORKSTATION followed by a CLEAR WORKSTATION.

2

Execute an UPDATE WORKSTATION followed by a pause waiting for a mouse click or a key click.

3

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.

4

Same as 3 except a "<READY>" prompt is issued in the lower left corner of the window after the UPDATE WORKSTATION.

C-BINDING DESCRIPTION

The C binding argument descriptions are the same as the FORTRAN argument descriptions.

USAGE

If 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.

EXAMPLES

If 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.

ACCESS

To use NGPICT or c_ngpict, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

MESSAGES

Non-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.

COPYRIGHT

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.