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.