1Scrolled_title(3NCARG) NCAR GRAPHICS Scrolled_title(3NCARG)
2
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
11 The package Scrolled_title has eight user entry points, as follows:
12 FTITLE, STITLE, SLGETI, SLGETR, SLOGAP, SLSETI, SLSETR, and SLRSET.
13 FTITLE stands for "fixed titles" and is used when the following
15 conditions are met:
16 · Each group of text lines is to fit on one frame (no
18 scrolling).
19 · All test lines in a group are to be written in the
21 same color.
22 · Vertical spacing of text lines is to be done
24 automatically.
25 · Text lines are to be centered horizontally.
27 · There are to be no more than 80 characters per text
29 line (including Plotchar "function codes").
30 · In production mode, blank frames are to be generated
32 before and after each group of title frames.
33 · No more than 120 text lines are to be displayed on a
35 single frame.
36 STITLE stands for "scrolled titles" and is used when the above
38 conditions are not met.
39 SLOGAP is used to generate blank-frame gaps in a manner consistent
41 with FTITLE.
42 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 SLGETI and SLGETR
48 are used to retrieve the current values of internal
49 parameters.
50 SLRSET is ued to reset the values of all internal parameters of
52 STITLE to the original defaults.
53
55 #include <ncarg/ncargC.h>
56 c_ftitle
58 c_stitle
59 c_slogap
60 c_slseti
61 c_slsetr
62 c_slgeti
63 c_slgetr
64 c_slrset
65
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
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 FTITLE - PREMATURE EOF ON CARD INPUT UNIT
77 FTITLE has encountered an end-of-file on the card input in a
79 place where one should not have been.
80 FTITLE - READ ERROR ON CARD INPUT UNIT
82 FTITLE has executed a FORTRAN READ statement and the
84 "ERR=..." exit has been taken.
85 FTITLE - TOO MANY INPUT CARDS IN GROUP
87 The first card of a title group contains a value of NCDS
89 greater than 120. FTITLE can't handle that many lines.
90 FTITLE - UNCLEARED PRIOR ERROR
92 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 SLBKGD - ERROR RETURN FROM GQFACI: i
98 SLBKGD - ERROR RETURN FROM GQFAIS: I
99 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 SLGCLR - TOO MANY COLORS DEFINED
104 More than 256 colors have been made known to STITLE. It has
106 no room in which to maintain information about them all.
107 SLGETI - UNCLEARED PRIOR ERROR
109 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 SLGETR -- INVALID KEYWORD: xxx
115 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 SLGETR - UNCLEARED PRIOR ERROR
121 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 SLGWID - ERROR RETURN FROM GQACWK: i
127 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 SLGWID - NO ACTIVE WORKSTATIONS
132 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 SLOGAP - ERROR RETURN FROM GQTXCI: i
139 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 SLOGAP - UNCLEARED PRIOR ERROR
144 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 SLRSET - UNCLEARED PRIOR ERROR
150 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 SLSCLR - TOO MANY COLORS DEFINED
156 More than 256 colors have been made known to STITLE. It has
158 no room in which to maintain information about them all.
159 SLSETI - UNCLEARED PRIOR ERROR
161 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 SLSETR -- INVALID KEYWORD: xxx
167 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 SLSETR - UNCLEARED PRIOR ERROR
173 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 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 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 STITLE - UNCLEARED PRIOR ERROR
188 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
194 Online: ftitle, scrolled_title_params.m slgeti, slgetr, slogap, slrset,
195 slseti, slsetr, stitle, ncarg_cbind.
196 Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
198 NCAR GKS-0A Graphics
199
201 Copyright (C) 1987-2007
202 University Corporation for Atmospheric Research
203 This documentation is free software; you can redistribute it and/or
205 modify it under the terms of the GNU General Public License as
206 published by the Free Software Foundation; either version 2 of the
207 License, or (at your option) any later version.
208 This software is distributed in the hope that it will be useful, but
210 WITHOUT ANY WARRANTY; without even the implied warranty of
211 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
212 General Public License for more details.
213 You should have received a copy of the GNU General Public License along
215 with this software; if not, write to the Free Software Foundation,
216 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
217UNIX July 1995 Scrolled_title(3NCARG)