NAME

       FTITLE - Used for unscrolled movie or video titles. It reads, from standard input, the information
       necessary to define the desired title frames, and then calls STITLE to create those frames.

SYNOPSIS

       CALL FTITLE (MTST)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_ftitle (int mtst)

DESCRIPTION

       MTST        (an  input expression of type INTEGER) is a switch indicating whether this is a "real" run or
                   a "practice" run:

                   0      means "real run".

                   1      means "practice run".

                   During real runs, each title frame is repeated as many times as necessary to display it for a
                   user-specified time period (at ´NFS´ frames per second). Blank frames are placed  before  the
                   first  title  frame  (´TM1´  seconds  worth of them), between consecutive title frames (´TM2´
                   seconds worth of them), and after the last title frame (´TM2´ + ´TM3´ seconds worth of them).
                   Blank frames are to allow for splicing.

                   If the user has turned on fade-in (by setting the internal parameter ´FIN´ non-zero),  and/or
                   fade-out  (by  setting the internal parameter ´FOU´ non-zero), the required fade-in and fade-
                   out frames will be generated, as well.

                   During practice runs, each title frame will occur from one to three times (once for  fade-in,
                   once  for the stationary holding time, and once for fade-out); each of these frames will have
                   a legend indicating how many seconds the frame represents in a real  run.  Each  sequence  of
                   blank  frames  will  be replaced by a single frame with a message indicating how many seconds
                   worth of blank frames it represents.

C-BINDING DESCRIPTION

       The C-binding argument description is the same as the FORTRAN argument description.

USAGE

       FTITLE reads data from the unit specified by the internal parameter ´ICU´, which has the default value 5,
       to specify standard input; this parameter can be given a different value to  specify  that  another  unit
       should be read instead.

       The  input  data  are read in groups.  Each group represents one title frame.  There can be any number of
       groups.  FTITLE keeps processing groups until a group with  NCDS  =  0  is  read  or  an  end-of-file  is
       encountered.  A group consists of the following:

       •   A  header  line  from  which  variables  NCDS,  TIME,  and  SIZE  are  read, using the FORTRAN format
           "(I5,2F5.1)".

           NCDS is the number of text lines that follow.  If NCDS = 0, FTITLE  quits  (returns  to  the  calling
           routine without doing anything else).

           TIME  is  the  time,  in seconds, that the title frame should be displayed (not including fade-in and
           fade-out, if any).

           SIZE is the desired character size, given as a multiplier of the  default  height  specified  by  the
           value  of  the  internal  parameter ´PSZ´, the default value of which is 21 (out of 1023).  Values of
           SIZE from .75 to 2.5 are recommended.

       •   Text lines, each containing one line of the title frame.  PLOTCHAR function  codes  may  be  used  as
           specified in the documentation for that package.  Characters should not appear beyond column 80.

       The  internal  parameters  'ALN',  'BGB',  'BGC', 'BGF', 'BGG', 'BGR', 'FGB', 'FGC', 'FGF', 'FGG', 'FGR',
       'FIN', 'FOU', 'GSZ', 'ICO', 'ICU', 'LOG', 'LX1', 'LX2', 'LY1', 'LY2', 'MAP', 'NFS', 'NXE', 'NXS',  'ORV',
       'PSZ',  'SBK',  'SFG', 'TM1', 'TM2', 'TM3', 'VPB', 'VPL', 'VPR', 'VPT', and 'WID' all affect the behavior
       of FTITLE in one way or another.  Some of these have been mentioned above; all are described in the "man"
       page for "scrolled_title_params".

       Example: Suppose the input file contains the following three lines

           3   3.  1.5
       A
       Frame
       of Titles

       The resulting title frame has three lines of text.  It is displayed for three seconds.  Characters have a
       size of 1.5 times the default character size.

       FTITLE allows a maximum of 80 characters per line of text including Plotchar  function  codes.   No  more
       than  120  lines of text can be displayed on a single frame.  Titles are centered horizontally unless you
       have changed the value of the internal parameter 'ICO'.  Vertical  spacing  is  automatically  determined
       using the current value of the internal parameter 'GSZ'.

       For  more  detailed control of titles, use the routine STITLE, which can be used to generate either fixed
       or scrolled titles.

EXAMPLES

       Use the ncargex command to see the following relevant example: slex02.

ACCESS

       To use FTITLE or c_ftitle, 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: plotchar, scrolled_title, scrolled_title_params, slgeti, slgetr, slogap, slrset, slseti,  slsetr,
       stitle, 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.

UNIX                                                July 1995                                     FTITLE(3NCARG)