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

NAME

6       Scrolled_title - Creates movie titles. The titles can be scrolled,
7       faded in, and/or faded out.  Foreground and background colors can be
8       specified.
9

SYNOPSIS

11       The package Scrolled_title has eight user entry points, as follows:
12       FTITLE, STITLE, SLGETI, SLGETR, SLOGAP, SLSETI, SLSETR, and SLRSET.
13
14       FTITLE      stands for "fixed titles" and is used when the following
15                   conditions are met:
16
17                   ·      Each group of text lines is to fit on one frame (no
18                          scrolling).
19
20                   ·      All test lines in a group are to be written in the
21                          same color.
22
23                   ·      Vertical spacing of text lines is to be done
24                          automatically.
25
26                   ·      Text lines are to be centered horizontally.
27
28                   ·      There are to be no more than 80 characters per text
29                          line (including Plotchar "function codes").
30
31                   ·      In production mode, blank frames are to be generated
32                          before and after each group of title frames.
33
34                   ·      No more than 120 text lines are to be displayed on a
35                          single frame.
36
37       STITLE      stands for "scrolled titles" and is used when the above
38                   conditions are not met.
39
40       SLOGAP      is used to generate blank-frame gaps in a manner consistent
41                   with FTITLE.
42
43       SLSETI and SLSETR
44                   are used to set the values of "internal parameters" whose
45                   values affect the behavior of FTITLE and/or STITLE.
46
47       SLGETI and SLGETR
48                   are used to retrieve the current values of internal
49                   parameters.
50
51       SLRSET      is ued to reset the values of all internal parameters of
52                   STITLE to the original defaults.
53

C-BINDING SYNOPSIS

55       #include <ncarg/ncargC.h>
56
57       c_ftitle
58       c_stitle
59       c_slogap
60       c_slseti
61       c_slsetr
62       c_slgeti
63       c_slgetr
64       c_slrset
65

ACCESS

67       To use Scrolled_title routines, load the NCAR Graphics libraries ncarg,
68       ncarg_gks, ncarg_c, and ncarg_c, preferably in that order.
69

MESSAGES

71       The error messages described can be written to the output unit by
72       routines in the package Scrolled_title. Unless otherwise indicated,
73       these errors are fatal and cause the user´s program to terminate
74       execution.
75
76            FTITLE - PREMATURE EOF ON CARD INPUT UNIT
77
78                 FTITLE has encountered an end-of-file on the card input in a
79                 place where one should not have been.
80
81            FTITLE - READ ERROR ON CARD INPUT UNIT
82
83                 FTITLE has executed a FORTRAN READ statement and the
84                 "ERR=..." exit has been taken.
85
86            FTITLE - TOO MANY INPUT CARDS IN GROUP
87
88                 The first card of a title group contains a value of NCDS
89                 greater than 120.  FTITLE can't handle that many lines.
90
91            FTITLE - UNCLEARED PRIOR ERROR
92
93                 When FTITLE was called, there was an unrecovered outstanding
94                 error.  The routine does not continue; it forces the error
95                 message to be printed and then substitutes this one for it.
96
97            SLBKGD - ERROR RETURN FROM GQFACI: i
98            SLBKGD - ERROR RETURN FROM GQFAIS: I
99
100                 A GKS routine has returned a non-zero error flag with value
101                 "i".  This most likely means that GKS is in the wrong state.
102
103            SLGCLR - TOO MANY COLORS DEFINED
104
105                 More than 256 colors have been made known to STITLE.  It has
106                 no room in which to maintain information about them all.
107
108            SLGETI - UNCLEARED PRIOR ERROR
109
110                 When SLGETI was called, there was an unrecovered outstanding
111                 error.  The routine does not continue; it forces the error
112                 message to be printed and then substitutes this one for it.
113
114            SLGETR -- INVALID KEYWORD: xxx
115
116                 The first argument in a call to SLGETR is not the name of one
117                 of the known internal parameters of STITLE.  This error
118                 message can occur as the result of a call to SLGETI.
119
120            SLGETR - UNCLEARED PRIOR ERROR
121
122                 When SLGETR was called, there was an unrecovered outstanding
123                 error.  The routine does not continue; it forces the error
124                 message to be printed and then substitutes this one for it.
125
126            SLGWID - ERROR RETURN FROM GQACWK: i
127
128                 A GKS routine has returned a non-zero error flag with value
129                 "i".  This most likely means that GKS is in the wrong state.
130
131            SLGWID - NO ACTIVE WORKSTATIONS
132
133                 STITLE uses the routine SLGWID to determine the ID of the
134                 first active workstation (to use in calls dealing with color)
135                 and it has found that there are currently no active
136                 workstations at all.
137
138            SLOGAP - ERROR RETURN FROM GQTXCI: i
139
140                 A GKS routine has returned a non-zero error flag with value
141                 "i".  This most likely means that GKS is in the wrong state.
142
143            SLOGAP - UNCLEARED PRIOR ERROR
144
145                 When SLOGAP was called, there was an unrecovered outstanding
146                 error.  The routine does not continue; it forces the error
147                 message to be printed and then substitutes this one for it.
148
149            SLRSET - UNCLEARED PRIOR ERROR
150
151                 When SLOGAP was called, there was an unrecovered outstanding
152                 error.  The routine does not continue; it forces the error
153                 message to be printed and then substitutes this one for it.
154
155            SLSCLR - TOO MANY COLORS DEFINED
156
157                 More than 256 colors have been made known to STITLE.  It has
158                 no room in which to maintain information about them all.
159
160            SLSETI - UNCLEARED PRIOR ERROR
161
162                 When SLSETI was called, there was an unrecovered outstanding
163                 error.  The routine does not continue; it forces the error
164                 message to be printed and then substitutes this one for it.
165
166            SLSETR -- INVALID KEYWORD: xxx
167
168                 The first argument in a call to SLSETR is not the name of one
169                 of the known internal parameters of STITLE.  This error
170                 message can occur as the result of a call to SLSETI.
171
172            SLSETR - UNCLEARED PRIOR ERROR
173
174                 When SLSETR was called, there was an unrecovered outstanding
175                 error.  The routine does not continue; it forces the error
176                 message to be printed and then substitutes this one for it.
177
178            STITLE - ERROR RETURN FROM GQCLIP: i
179            STITLE - ERROR RETURN FROM GQCNTN: i
180            STITLE - ERROR RETURN FROM GQPLCI: i
181            STITLE - ERROR RETURN FROM GQPMCI: i
182            STITLE - ERROR RETURN FROM GQTXCI: i
183
184                 A GKS routine has returned a non-zero error flag with value
185                 "i".  This most likely means that GKS is in the wrong state.
186
187            STITLE - UNCLEARED PRIOR ERROR
188
189                 When STITLE was called, there was an unrecovered outstanding
190                 error.  The routine does not continue; it forces the error
191                 message to be printed and then substitutes this one for it.
192

SEE ALSO

194       Online: ftitle, scrolled_title_params.m slgeti, slgetr, slogap, slrset,
195       slseti, slsetr, stitle, ncarg_cbind.
196
197       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
198       NCAR GKS-0A Graphics
199
201       Copyright (C) 1987-2009
202       University Corporation for Atmospheric Research
203       The use of this Software is governed by a License Agreement.
204
205
206
207UNIX                               July 1995            Scrolled_title(3NCARG)
Impressum