1NGPICT(3NCARG)                   NCAR GRAPHICS                  NGPICT(3NCARG)
2
3
4

NAME

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

SYNOPSIS

13       CALL NGPICT(WKID,ACTION)
14

C-BINDING SYNOPSIS

16       #include <ncarg/ncargC.h>
17
18       void c_ngpict(int wkid, int action)
19

DESCRIPTION

21       WKID        (an input parameter of type INTEGER) which designates the
22                   workstation identifier of a workstation as it was specified
23                   in a GOPWK call.
24
25       ACTION      (an input parameter of type INTEGER) the value of which
26                   specifies the action to be taken on the workstation WKID.
27                   Legal values are:
28
29                   0      Execute an UPDATE WORKSTATION on WKID.
30
31                   1      Execute an UPDATE WORKSTATION followed by a CLEAR
32                          WORKSTATION.
33
34                   2      Execute an UPDATE WORKSTATION followed by a pause
35                          waiting for a mouse click or a key click.
36
37                   3      Execute an UPDATE WORKSTATION followed by a pause
38                          followed by a CLEAR WORKSTATION after the pause has
39                          been terminated by a mouse click or a key click.
40
41                   4      Same as 3 except a "<READY>" prompt is issued in the
42                          lower left corner of the window after the UPDATE
43                          WORKSTATION.
44

C-BINDING DESCRIPTION

46       The C binding argument descriptions are the same as the FORTRAN
47       argument descriptions.
48

USAGE

50       If WKID designates a metafile, then a CLEAR WORKSTATION is done which
51       inserts an END PICTURE into the metafile.  The result produced in this
52       case would be the same as that resulting from a call to FRAME.  The
53       only valid actions for a metafile workstation are 0 and 1.
54
55       NGPICT is designed to be used when more precise control over individual
56       workstations is desired than that offered by FRAME.  This might be
57       desirable, for example, when an application is controlling several
58       simultaneously active workstations.  To use NGPICT one should be
59       opening GKS workstations with GOPWK rather than with OPNGKS.
60

EXAMPLES

62       If WKID=2 designates a metafile workstation, then
63
64               CALL NGPICT(2,1)
65
66       would duplicate the action of a FRAME call.
67
68       If WKID=2 designates an X11 workstation, then
69
70               CALL NGPICT(2,4)
71
72       would cause a pause in the X11 window and wait for a key click or a
73       mouse click.  A "<READY>" prompt, indicating that the window is waiting
74       for a mouse click or a key click,  would appear at the lower left of
75       the X11 window after the window has been updated.  After a mouse click
76       in the X11 window, that window will be cleared before program execution
77       continues.
78

ACCESS

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

MESSAGES

84       Non-fatal errors are reported for values of ACTION out of range and for
85       values of ACTION inappropriately applied to a metafile.  Also, a non-
86       fatal error is reported if NGPICT is called while a segment is open.
87

SEE ALSO

89       Online: frame(3NCARG), gflash(3NCARG), gopwk(3NCARG), opngks(3NCARG),
90       gclrwk(3NCARG), gupwk(3NCARG), ncarg_cbind(3NCARG)
91
92       Online URL:  http://ngwww.ucar.edu/ngdoc/ng/gks/gkshome.html
93
94       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
95       Fundamentals, UNIX Version;
96

98       Copyright (C) 1987-2007
99       University Corporation for Atmospheric Research
100
101       This documentation is free software; you can redistribute it and/or
102       modify it under the terms of the GNU General Public License as
103       published by the Free Software Foundation; either version 2 of the
104       License, or (at your option) any later version.
105
106       This software is distributed in the hope that it will be useful, but
107       WITHOUT ANY WARRANTY; without even the implied warranty of
108       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
109       General Public License for more details.
110
111       You should have received a copy of the GNU General Public License along
112       with this software; if not, write to the Free Software Foundation,
113       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
114
115
116
117UNIX                              March 1993                    NGPICT(3NCARG)
Impressum