NGMFTC(3NCARG)

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.