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-2007
75       University Corporation for Atmospheric Research
76
77       This documentation is free software; you can redistribute it and/or
78       modify it under the terms of the GNU General Public License as
79       published by the Free Software Foundation; either version 2 of the
80       License, or (at your option) any later version.
81
82       This software is distributed in the hope that it will be useful, but
83       WITHOUT ANY WARRANTY; without even the implied warranty of
84       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
85       General Public License for more details.
86
87       You should have received a copy of the GNU General Public License along
88       with this software; if not, write to the Free Software Foundation,
89       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
90
91
92
93UNIX                             October 1996                   NGMFTC(3NCARG)
Impressum