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

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

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

       #include <ncarg/ncargC.h>

       void c_ngmftc(int wkid)

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

UNIX                                              October 1996                                    NGMFTC(3NCARG)

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

       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.

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

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

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

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

       Hardcopy:

       CALL NGMFTC(WKID)

       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.