NAME¶

STITLE - Creates scrolled movie or video titles. It receives all input through the argument list.

UTILITY¶

This routine is part of the Scrolled_title utility in NCAR Graphics. To see the overview man page for this utility, type "man scrolled_title".

SYNOPSIS¶

CALL STITLE (CRDS,NCDS,IYST,IYND,TMST,TMMV,TMND,MTST)

C-BINDING SYNOPSIS¶

#include <ncarg/ncargC.h>

void c_stitle (char *crds[], int ncds, int iyst,
int iynd, float tmst, float tmmv, float tmnd, int mtst)

DESCRIPTION¶

CRDS

(an input array, dimensioned NCDS, of type CHARACTER*n, where "n" is greater than or equal to 21) is the "card input buffer". This array must be filled, prior to calling STITLE, either by internal manipulations or by reading n-character "cards". Each element of the array CRDS represents one line on the scroll (or, sometimes, a continuation of a previous line) and contains the following:

NCDS

(an input expression of type INTEGER) is the dimension of the array CRDS (i.e., the number of card images in it).

IYST

(an input expression of type INTEGER) is the Y coordinate that will be at the center of the screen when the text is first displayed.

IYND

(an input expression of type INTEGER) is the Y coordinate that will be at the center of the screen when the text is last displayed.

TMST

(an input expression of type REAL) is the time in seconds that the scroll will be stationary at IYST. One second is recommended.

TMMV

(an input expression of type REAL) is the time to move the scroll from IYST to IYND. This should be the time required to read the text aloud at slow to normal speed.

TMND

(an input expression of type REAL) is the time that the scroll will be stationary at IYND. One second is recommended.

MTST

(an input expression of type INTEGER) is a switch to indicate whether this is a "real" run or a "practice" run.

During real runs, frames are created for the fade-in sequence (if the user has turned on fade-in by setting the internal parameter ´FIN´ non-zero), the stationary sequence at the start (if TMST is non-zero), the scrolling time (if TMMV is non-zero), the stationary sequence at the end (if TMND is non-zero), and the fade-out sequence (if the user has turned on fade-out by setting the internal parameter ´FOU´ non-zero).

During practice runs, only selected frames are created: a frame for the fade-in sequence (if fade-in is turned on), a frame for the stationary time at the start, a set of frames representing the scrolling sequence, a frame for the stationary time at the end, and a frame for the fade-out sequence (if fade-out is turned on). Each has a legend indicating either for how many seconds the frame will be shown or, if it is part of a scroll sequence, how many seconds into the scroll time it occurs; during real runs, these legends are omitted, of course.

Fade-in and fade-out are also affected by the values of the internal parameters ´BGF´, which selects the type of fade-in/fade-out to be used for the background color, and ´FGF´, which serves the same function for the foreground color. (The older parameters ´SBK´ and ´SFG´ may still be referenced, but their use is no longer recommended; setting ´SBK´ has the effect of giving ´BGF´ an appropriate value and setting ´SFG´ has the effect of giving ´FGF´ an apprpriate value.)

C-BINDING DESCRIPTION¶

The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

USAGE¶

STITLE takes input through its argument list and generates graphic output that moves a body of text up through the viewing window. This is done by outputting the appropriate number of frames required to generate a movie sequence of a duration specified by you.

At each frame STITLE skips plotting lines of text that are completely outside of the viewing window and clips those that are partially outside the window.

EXAMPLES¶

Use the ncargex command to see the following relevant examples: fslfont, slex01, slex02, tstitl.

ACCESS¶

To use STITLE or c_stitle, load the NCAR Graphics libraries ncarg, ncarg_gks, ncarg_c, and ncarg_c, preferably in that order.

MESSAGES¶

See the scrolled_title man page for a description of all Scrolled_title error messages and/or informational messages.

SEE ALSO¶

Online: ftitle, scrolled_title, scrolled_title_params, slgeti, slgetr, slogap, slrset, slseti, slsetr, ncarg_cbind.

Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

COPYRIGHT¶

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