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

NAME

6       NGMFTC - Temporarily closes a metafile output unit allowing for
7       subsequent reopening.
8

SYNOPSIS

10       CALL NGMFTC(WKID)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_ngmftc(int wkid)
16

DESCRIPTION

18       WKID        (an input variable of type INTEGER) that specifies the GKS
19                   workstation ID to be temporarily closed.
20

C-BINDING DESCRIPTION

22       The C binding argument descriptions are the same as the FORTRAN
23       argument descriptions.
24

USAGE

26       Use NGMFTC to close a metafile temporarily for reopening with NGREOP.
27       The temporary close can be done at any time after a metafile
28       workstation has been opened, even in the middle of drawing a picture.
29       The primary use of NGMFTC is to allow for writing to more than one
30       metafile in a single job execution.  Since NCAR GKS does not allow for
31       having more than a single NCGM workstation open at a time, you can use
32       NGMFTC to stop output to one metafile while you write to another
33       metafile and then resume output to the initial metafile.
34
35       If you simply want to suspend output to a metafile workstation, but do
36       not need to write to another metafile workstation, simply use the GKS
37       entry GDAWK to deactivate the workstation and GOPWK to reactivate it
38       when you want to resume output.
39
40       For saving the state of all primitive attribute values of an NCGM
41       workstation at the time of the temporary close and restoring them at
42       the time of the reopen with NGREOP, see the documenation for NGSRAT.
43
44       If NGMFTC is used and NGREOP is not subsequently invoked to reopen the
45       file so that it can be terminated normally in the same job step, then
46       an improperly terminated metafile will result from the temporary close.
47

EXAMPLES

49       Assuming that an NCGM workstation, with workstation identifier 1, is
50       open, then
51
52               CALL NGMFTC(1)
53
54       would temporarily close the workstation.
55
56       Use the ncargex command to see the following relevant example: pgkex27.
57

ACCESS

59       To use NGMFTC or c_ngmftc, load the NCAR Graphics libraries ncarg,
60       ncarg_gks, and ncarg_c, preferably in that order.
61

MESSAGES

63       The argument to NGMFTC must be an NCGM workstation that is open but not
64       active.
65

SEE ALSO

67       Online: ngsrat(3NCARG), ngreop(3NCARG),
68
69       Online URL:  http://ngwww.ucar.edu/ngdoc/ng/gks/gkshome.html
70
71       Hardcopy:
72

74       Copyright (C) 1987-2009
75       University Corporation for Atmospheric Research
76       The use of this Software is governed by a License Agreement.
77
78
79
80UNIX                             October 1996                   NGMFTC(3NCARG)
Impressum