Provided by: libncarg-dev_6.6.2.dfsg.1-10build2_amd64 
NAME
NGREOP - reopen an existing NCAR Graphics metafile for appending.
SYNOPSIS
CALL NGREOP(WKID, CONID, ITYPE, FNAME, IOPT, IAT, RAT,
NCOLRS, NSTART, CTAB)
C-BINDING SYNOPSIS
#include <ncarg/ncargC.h>
#include <ncarg/gks.h>
void c_ngsrat(int wkid, int conid, int itype, char *fname,
int iopt, int *iat, float *rat, int ncolrs,
int nstart, Gcolr_rep *ctab)
DESCRIPTION
WKID (an input variable of type INTEGER) specifying the workstation identifier that the reopened
metafile will subsequently be known by. This does not have to be the same as the worksttion
identifier used to create the original metafile.
CONID (an input variable of type INTEGER) specifying the connection identifier.
ITYPE (an input variable of type INTEGER) specifying the workstation type. Currently the only
valid value is "1". This subroutine may be augmented to accommodate PostScript files in the
future.
FNAME (an input variable of type CHARACTER) specifying the filename of the metafile being opened
for appending.
IOPT (an input variable of type INTEGER) specifying the desired action:
= 0 reestablish the color table only (using the color table in argument CTAB described
below). The attributes of the reopened workstation will be set to default values and
may well be out of sync with the current GKS attributes.
= 1 reestablish the color table and GKS state (the GKS state as supplied in arguments IAT
and RAT described below). The state values will not be flushed to the metafile.
= 2 reestablish the color table and GKS state and flush the GKS state values to the
metafile.
= 3 reestablish the color table and flush the current GKS state values to the metafile
(not the values in IAT and RAT). values to the metafile.
If IOPT equals 1 or 2, then IAT and RAT must be supplied, otherwise not.
IAT (an input array of type INTEGER dimensioned for 14) that contains GKS integer state variables
as follows:
IAT( 1) = Clip indicator
IAT( 2) = Line type
IAT( 3) = Polyline color index
IAT( 4) = Marker type
IAT( 5) = Polymarker color index
IAT( 6) = Text font
IAT( 7) = Text precision
IAT( 8) = Text color index
IAT( 9) = Text path
IAT(10) = Text horizontal alignment
IAT(11) = Text vertical alignment
IAT(12) = Fill area interior style
IAT(13) = Fill are style index
IAT(14) = Fill area color index
RAT (an input array of type REAL dimensioned for 7) that contains REAL GKS attribute settings as
follows:
RAT( 1) = Linewidth scale factor
RAT( 2) = Marker scale factor
RAT( 3) = Character expansion factor
RAT( 4) = Character spacing
RAT( 5) = Character height in world coordinates
RAT( 6) = Character up vector, X component in world coordinates
RAT( 7) = Character up vector, Y component in world coordinates
NCOLRS (an input variable of type INTEGER) that specifies the number of colors in the color table
supplied in argument CTAB, described below. NCOLRS can be 0 .
NSTART (an input variable of type INTEGER) that specifies the color index associated with the first
color in the color table CTAB (all other color indices are filled in in sequence). For
example, if NCOLRS = 3 and NSTART = 4, then the color values defined in CTAB would be used to
define color indices 4, 5, and 6.
CTAB (in the FORTRAN version of this routine, a two-dimensional input array of type REAL
dimensioned CTAB(3,NCOLRS); in the C version of this routine, a one-dimensional input array
of type Gcolr_rep dimensioned ctab[ncolrs]) that specifies a color table used to initialize
the reopened metafile. This color table does not necessarily have to agree with the color
table in effect when the original metafile was created.
USAGE
The most common usage of NGREOP would be in conjunction with usage of NGSRAT and NGMFTC. NGMFTC would be
used to temporarily close a metafile and NGSRAT used to save the state of the GKS primitive attributes at
the time of the close. To reopen the temporarily closed metafile you would call NGREOP with the
attribute settings previously saved and a setting of IOPT of 2. NGMFTC can be used to temporarily close
a metafile any time after it has been opened, even in the middle of a picture.
NGREOP only reopens the metafile and does not activate it. It will be necessary to call GACWK before
sending graphics primitives to the reopened metafile.
NGREOP can also be used to reopen a previously created metafile - either created in an independent job
step, or in the same job step.
EXAMPLES
The following sequence:
CALL NGMFTC(1)
CALL NGSRAT(2, IAT, RAT)
... do stuff
CALL NGREOP(CALL NGREOP(1, 2, 1, 'gmeta1', 2, IAT, RAT,
NCOLS, 0, CTAB)
would temporarily close the metafile with workstation ID of 1 (in this case a metafile with name
"gmeta1") and save the GKS state variables at the time of the close. Then the call to NGREOP would
reopen the metafile for appending.
Use the ncargex command to see the following relevant example: pgkex27.
ACCESS
To use NGREOP or c_ngreop, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in
that order.
MESSAGES
NGREOP issues the same messages as those issued by GOPWK.
SEE ALSO
Online: ngmftc(3NCARG), ngsrat(3NCARG),
Online URL: http://ngwww.ucar.edu/ngdoc/ng/gks/gkshome.html
COPYRIGHT
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.
UNIX October 1996 NGREOP(3NCARG)