ncl_ngmftc - Man Page

CALL NGMFTC(WKID)

#include <ncarg/ncargC.h>

void c_ngmftc(int wkid)

WKID

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

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

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.

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.

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

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

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

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

Hardcopy:

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