FTITLE(3NCARG)

✨ FTITLE ✨ (the 3NCARG one, from NCAR GRAPHICS 💖)

okay bestie, buckle up — this is the routine for unscrolled movie or video titles. It reads, straight from standard input, literally everything it needs to define the title frames you want, and then it calls STITLE to actually make those frames happen. no cap. 🎬

---

🌸 SYNOPSIS 🌸

CALL FTITLE (MTST)

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

void c_ftitle (int mtst)

---

👑 DESCRIPTION 👑

• MTST — an input expression of type INTEGER, and it's a switch telling us whether this is a "real" run or a "practice" run:
  • 0 — means "real run".
  • 1 — means "practice run".

So during real runs, each title frame gets repeated as many times as it needs to be to display it for a time period that you specify (at NFS frames per second, iykyk). Blank frames get 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). And why the blank frames? Splicing, bestie. It's giving editing-room realness. ✂️

If you've turned on fade-in (by setting the internal parameter FIN to something non-zero), and/or fade-out (by setting the internal parameter FOU to something non-zero), then the required fade-in and fade-out frames get generated too. slay. ✨

During practice runs, each title frame happens anywhere from one to three times (once for fade-in, once for the stationary holding time, and once for fade-out). Each of those frames gets a legend telling you how many seconds the frame represents in a real run. And every sequence of blank frames? It gets replaced by a single frame with a message saying how many seconds worth of blank frames it's standing in for. so helpful fr fr. 🫶

💜 C-BINDING DESCRIPTION 💜

The C-binding argument description is literally the same as the FORTRAN argument description. no notes. 💅

---

🌈 USAGE 🌈

FTITLE reads data from the unit specified by the internal parameter ICU, which defaults to 5 — that's standard input, babe. But you can hand that parameter a different value if you want some other unit read instead. main character energy: choose your own input. 👑

The input data gets read in groups, and each group = one title frame. There can be any number of groups, no limit, go off. FTITLE keeps chewing through groups until it reads a group with NCDS = 0 or it hits an end-of-file. A group is made up of:

• A header line from which the 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). bye bestie 👋
  • TIME is the time, in seconds, that the title frame should be displayed (not counting 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, whose default value 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 of them are described in the "man" page for "scrolled_title_params". go read it, it's a whole vibe. 📖

---

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. iconic. 🎀

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've changed the value of the internal parameter ICO. Vertical spacing is automatically determined using the current value of the internal parameter GSZ.

Want more detailed control over your titles? Use the routine STITLE, which can generate either fixed or scrolled titles. the way that routine does both?? obsessed. 😭

---

🍓 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. (yes bestie, ncarg_c really is listed twice — that's not me being messy, that's the manpage. 😭)

---

🧚 MESSAGES 🧚

See the scrolled_title man page for a description of all Scrolled_title error messages and/or informational messages. it's got the lore. 🔥

---

⭐ 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.

---

and that's the whole page, bestie — this manual page was a UNIX one from July 1995, and it lives in the NCAR GRAPHICS section, FTITLE(3NCARG). periodt. 💅✨🎀