1Gflash(3NCARG)                   NCAR GRAPHICS                  Gflash(3NCARG)
2
3
4

NAME

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

SYNOPSIS

10       GFLAS1 - Starts storage of plotting instructions.
11
12       GFLAS2 - Stops storage of plotting instructions.
13
14       GFLAS3 - Inserts saved plotting instructions into the output stream.
15
16       GFLAS4 - Associates the filename of a previously generated picture
17       segment with an id suitable for use with GFLAS3.
18

C-BINDING SYNOPSIS

20       #include <ncarg/ncargC.h>
21
22       c_gflas1
23       c_gflas2
24       c_gflas3
25       c_gflas4
26

ACCESS

28       To use Gflash C or Fortran routines, load the NCAR Graphics libraries
29       ncarg, ncarg_gks, and ncarg_c, preferably in that order.
30

MESSAGES

32       When error conditions are detected, the support routine SETER is called
33       in such a way that it writes a message to the standard error file (as
34       defined by I1MACH(4)) and then terminates execution. The possible error
35       messages are as follows:
36
37       GFLAS1 CALLED CONSECUTIVELY WITHOUT AN INTERVENING GFLAS2 CALL
38              You must terminate the usage of one FLASH buffer before reusing
39              it.
40
41       THE NON-NCAR GKS PACKAGE IS NOT LEVEL 2
42              Gflash requires GKS level 2A or higher in order to function in a
43              non-NCAR GKS environment.
44
45       WISS MUST BE OPEN BEFORE CALL TO GFLAS1
46              Gflash entries must have access to the appropriate GKS
47              segmentation functions in order to work.  This is accomplished
48              by making a call to the GKS entry GOPWK to open WISS.
49
50       MAXIMUM NUMBER OF OPEN WORKSTATIONS ALLOWED IS 100
51              You have called GFLAS1 with more than 100 different identifiers.
52
53       BUFFER IDENTIFIER .LT. 0, OR .GT. 99
54              The argument to Gflash is out of the described range.
55
56       GKS MUST BE OPEN BEFORE A CALL TO GFLAS1
57              You have tried calling GFLAS1 without opening GKS.  A call to
58              the GKS entry GOPWK is required before calling any Gflash entry.
59
60       GFLAS2 CALLED WITHOUT CALLING GFLAS1
61              GFLAS2 terminates the GFLAS1 job of writing plotting
62              instructions to disk.  GFLAS2 has no functionality if not called
63              in the legal sequence.
64
65       WISS NOT OPEN AT GFLAS2 TIME
66              Gflash entries must have access to the appropriate GKS
67              segmentation functions in order to work.  This is accomplished
68              by making a call to the GKS entry GOPWK to open WISS.
69
70       GFLAS3 CALLED WITHOUT CALLING GFLAS2 OR GFLAS4
71              GFLAS3 has no access to the plotting instructions that it is to
72              insert into the output metafile unless a call to either GFLAS2
73              or GFLAS4 is made first.
74
75       THE NON-NCAR GKS PACKAGE IS NOT LEVEL 2
76              Gflash requires GKS level 2A or higher in order to function in a
77              non-NCAR GKS environment.
78
79       WISS MUST BE OPEN BEFORE A CALL TO GFLAS4
80              Gflash entries must have access to the appropriate GKS
81              segmentation functions in order to work.  This is accomplished
82              by making a call to the GKS entry GOPWK to open WISS.
83
84       MAXIMUM NUMBER OF WORKSTATIONS ALLOWED IS 100
85              You have called GFLAS1 with more than 100 different identifiers.
86
87       GKS MUST BE OPEN BEFORE A CALL TO GFLAS4
88              You have tried calling GFLAS4 without opening the NCAR GKS
89              package.  (The GFLAS4 subroutine is an option only if you are
90              using the NCAR GKS package.)
91
92       CANNOT BE CALLED WHILE GFLAS1 IS STILL OPEN
93              Call GFLAS2 to complete the GFLAS1/GFLAS2 sequence before
94              attempting to call GFLAS4.
95

SEE ALSO

97       Online: gflas1, gflas2, gflas3, gflas4, ncarg_cbind.
98
99       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
100

102       Copyright (C) 1987-2007
103       University Corporation for Atmospheric Research
104
105       This documentation is free software; you can redistribute it and/or
106       modify it under the terms of the GNU General Public License as
107       published by the Free Software Foundation; either version 2 of the
108       License, or (at your option) any later version.
109
110       This software is distributed in the hope that it will be useful, but
111       WITHOUT ANY WARRANTY; without even the implied warranty of
112       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
113       General Public License for more details.
114
115       You should have received a copy of the GNU General Public License along
116       with this software; if not, write to the Free Software Foundation,
117       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
118
119
120
121UNIX                              March 1993                    Gflash(3NCARG)
Impressum