NAME

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

SYNOPSIS

       CALL NGMFTC(WKID)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_ngmftc(int wkid)

DESCRIPTION

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

C-BINDING DESCRIPTION

       The C binding argument descriptions are the same as the FORTRAN argument descriptions.

USAGE

       Use NGMFTC to close a metafile temporarily for reopening with NGREOP.  The temporary close
       can be done at any time after a metafile workstation has been opened, even in the middle
       of drawing a picture.  The primary use of NGMFTC is to allow for writing to more than one
       metafile in a single job execution.  Since NCAR GKS does not allow for having more than a
       single NCGM workstation open at a time, you can use NGMFTC to stop output to one metafile
       while you write to another metafile and then resume output to the initial metafile.

       If you simply want to suspend output to a metafile workstation, but do not need to write
       to another metafile workstation, simply use the GKS entry GDAWK to deactivate the
       workstation and GOPWK to reactivate it when you want to resume output.

       For saving the state of all primitive attribute values of an NCGM workstation at the time
       of the temporary close and restoring them at the time of the reopen with NGREOP, see the
       documenation for NGSRAT.

       If NGMFTC is used and NGREOP is not subsequently invoked to reopen the file so that it can
       be terminated normally in the same job step, then an improperly terminated metafile will
       result from the temporary close.

EXAMPLES

       Assuming that an NCGM workstation, with workstation identifier 1, is open, then

               CALL NGMFTC(1)

       would temporarily close the workstation.

       Use the ncargex command to see the following relevant example: pgkex27.

ACCESS

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

MESSAGES

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

SEE ALSO

       Online: ngsrat(3NCARG), ngreop(3NCARG),

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

       Hardcopy:

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.