SYNOPSIS
GFLAS1 - Starts storage of plotting instructions.GFLAS2 - Stops storage of plotting instructions.
GFLAS3 - Inserts saved plotting instructions into the output stream.
GFLAS4 - Associates the filename of a previously generated picture segment with an id suitable for use with GFLAS3.
C-BINDING SYNOPSIS
#include <ncarg/ncargC.h>
c_gflas1
c_gflas2
c_gflas3
c_gflas4
ACCESS
To use Gflash C or Fortran routines, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.MESSAGES
When error conditions are detected, the support routine SETER is called in such a way that it writes a message to the standard error file (as defined by I1MACH(4)) and then terminates execution. The possible error messages are as follows:- GFLAS1 CALLED CONSECUTIVELY WITHOUT AN INTERVENING GFLAS2 CALL
- You must terminate the usage of one FLASH buffer before reusing it.
- THE NON-NCAR GKS PACKAGE IS NOT LEVEL 2
- Gflash requires GKS level 2A or higher in order to function in a non-NCAR GKS environment.
- WISS MUST BE OPEN BEFORE CALL TO GFLAS1
- Gflash entries must have access to the appropriate GKS segmentation functions in order to work. This is accomplished by making a call to the GKS entry GOPWK to open WISS.
- MAXIMUM NUMBER OF OPEN WORKSTATIONS ALLOWED IS 100
- You have called GFLAS1 with more than 100 different identifiers.
- BUFFER IDENTIFIER .LT. 0, OR .GT. 99
- The argument to Gflash is out of the described range.
- GKS MUST BE OPEN BEFORE A CALL TO GFLAS1
- You have tried calling GFLAS1 without opening GKS. A call to the GKS entry GOPWK is required before calling any Gflash entry.
- GFLAS2 CALLED WITHOUT CALLING GFLAS1
- GFLAS2 terminates the GFLAS1 job of writing plotting instructions to disk. GFLAS2 has no functionality if not called in the legal sequence.
- WISS NOT OPEN AT GFLAS2 TIME
- Gflash entries must have access to the appropriate GKS segmentation functions in order to work. This is accomplished by making a call to the GKS entry GOPWK to open WISS.
- GFLAS3 CALLED WITHOUT CALLING GFLAS2 OR GFLAS4
- GFLAS3 has no access to the plotting instructions that it is to insert into the output metafile unless a call to either GFLAS2 or GFLAS4 is made first.
- THE NON-NCAR GKS PACKAGE IS NOT LEVEL 2
- Gflash requires GKS level 2A or higher in order to function in a non-NCAR GKS environment.
- WISS MUST BE OPEN BEFORE A CALL TO GFLAS4
- Gflash entries must have access to the appropriate GKS segmentation functions in order to work. This is accomplished by making a call to the GKS entry GOPWK to open WISS.
- MAXIMUM NUMBER OF WORKSTATIONS ALLOWED IS 100
- You have called GFLAS1 with more than 100 different identifiers.
- GKS MUST BE OPEN BEFORE A CALL TO GFLAS4
- You have tried calling GFLAS4 without opening the NCAR GKS package. (The GFLAS4 subroutine is an option only if you are using the NCAR GKS package.)
- CANNOT BE CALLED WHILE GFLAS1 IS STILL OPEN
- Call GFLAS2 to complete the GFLAS1/GFLAS2 sequence before attempting to call GFLAS4.
COPYRIGHT
Copyright (C) 1987-2009University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.