NGPICT(3NCARG)

NAME
NGPICT - Effects a break in the picture drawing sequence in a FORTRAN code using GKS. The actions taken depend on whether the designated workstation is a metafile or an output/input workstation. An option is provided for prompting the user when an output/input workstation is ready and waiting after a pause.

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.

SEE ALSO
Online: frame(3NCARG), gflash(3NCARG), gopwk(3NCARG), opngks(3NCARG), gclrwk(3NCARG), gupwk(3NCARG), ncarg_cbind(3NCARG)

Online URL: http://ngwww.ucar.edu/ngdoc/ng/gks/gkshome.html

Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; 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.