Provided by: libncarg-dev_6.4.0-9_amd64 bug

NAME

       Gflash - Allows for storing segments of a picture for insertion into any subsequent picture.

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.

SEE ALSO

       Online: gflas1, gflas2, gflas3, gflas4, ncarg_cbind.

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

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