Scrolled_title(3NCARG)

✨ Scrolled_title — the NCAR GRAPHICS glow-up ✨

okay bestie, gather round 💖 this is Scrolled_title from the NCAR GRAPHICS manual (Scrolled_title(3NCARG), if we're being formal), and it's literally the routine that makes movie titles. The titles can be scrolled, faded in, and/or faded out. Foreground and background colors can be specified. cinema, but make it Fortran 🎬🍿

---

🌸 NAME 🌸

Scrolled_title — Creates movie titles. The titles can be scrolled, faded in, and/or faded out. Foreground and background colors can be specified.

---

🦋 SYNOPSIS 🦋

The package Scrolled_title has eight user entry points, as follows: FTITLE, STITLE, SLGETI, SLGETR, SLOGAP, SLSETI, SLSETR, and SLRSET.

• FTITLE — stands for "fixed titles" and is used when the following conditions are met:
  • Each group of text lines is to fit on one frame (no scrolling).
  • All test lines in a group are to be written in the same color.
  • Vertical spacing of text lines is to be done automatically.
  • Text lines are to be centered horizontally.
  • There are to be no more than 80 characters per text line (including Plotchar "function codes").
  • In production mode, blank frames are to be generated before and after each group of title frames.
  • No more than 120 text lines are to be displayed on a single frame.
• STITLE — stands for "scrolled titles" and is used when the above conditions are not met. it's the "we do a little scrolling" one 💫
• SLOGAP — is used to generate blank-frame gaps in a manner consistent with FTITLE.
• SLSETI and SLSETR — are used to set the values of "internal parameters" whose values affect the behavior of FTITLE and/or STITLE.
• SLGETI and SLGETR — are used to retrieve the current values of internal parameters.
• SLRSET — is used to reset the values of all internal parameters of STITLE to the original defaults. factory reset but for title vibes 🔄

---

🎀 C-BINDING SYNOPSIS 🎀

#include <ncarg/ncargC.h>

c_ftitle
c_stitle
c_slogap
c_slseti
c_slsetr
c_slgeti
c_slgetr
c_slrset

---

💅 ACCESS 💅

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

ngl, that list says ncarg_c twice — that's exactly what the page says, so that's what we're telling you. don't @ me, @ the manual 🙈

---

💀 MESSAGES 💀

The error messages described can be written to the output unit by routines in the package Scrolled_title. Unless otherwise indicated, these errors are fatal and cause the user's program to terminate execution. so like, no cap, these ones will end you 😭

• FTITLE - PREMATURE EOF ON CARD INPUT UNIT — FTITLE has encountered an end-of-file on the card input in a place where one should not have been.
• FTITLE - READ ERROR ON CARD INPUT UNIT — FTITLE has executed a FORTRAN READ statement and the ERR=... exit has been taken.
• FTITLE - TOO MANY INPUT CARDS IN GROUP — The first card of a title group contains a value of NCDS greater than 120. FTITLE can't handle that many lines.
• FTITLE - UNCLEARED PRIOR ERROR — When FTITLE was called, there was an unrecovered outstanding error. The routine does not continue; it forces the error message to be printed and then substitutes this one for it.
• SLBKGD - ERROR RETURN FROM GQFACI: i SLBKGD - ERROR RETURN FROM GQFAIS: I — A GKS routine has returned a non-zero error flag with value "i". This most likely means that GKS is in the wrong state.
• SLGCLR - TOO MANY COLORS DEFINED — More than 256 colors have been made known to STITLE. It has no room in which to maintain information about them all.
• SLGETI - UNCLEARED PRIOR ERROR — When SLGETI was called, there was an unrecovered outstanding error. The routine does not continue; it forces the error message to be printed and then substitutes this one for it.
• SLGETR -- INVALID KEYWORD: xxx — The first argument in a call to SLGETR is not the name of one of the known internal parameters of STITLE. This error message can occur as the result of a call to SLGETI.
• SLGETR - UNCLEARED PRIOR ERROR — When SLGETR was called, there was an unrecovered outstanding error. The routine does not continue; it forces the error message to be printed and then substitutes this one for it.
• SLGWID - ERROR RETURN FROM GQACWK: i — A GKS routine has returned a non-zero error flag with value "i". This most likely means that GKS is in the wrong state.
• SLGWID - NO ACTIVE WORKSTATIONS — STITLE uses the routine SLGWID to determine the ID of the first active workstation (to use in calls dealing with color) and it has found that there are currently no active workstations at all. ghost town energy 👻
• SLOGAP - ERROR RETURN FROM GQTXCI: i — A GKS routine has returned a non-zero error flag with value "i". This most likely means that GKS is in the wrong state.
• SLOGAP - UNCLEARED PRIOR ERROR — When SLOGAP was called, there was an unrecovered outstanding error. The routine does not continue; it forces the error message to be printed and then substitutes this one for it.
• SLRSET - UNCLEARED PRIOR ERROR — When SLOGAP was called, there was an unrecovered outstanding error. The routine does not continue; it forces the error message to be printed and then substitutes this one for it.

yes bestie, this one about SLRSET says "When SLOGAP was called" — that's the original text, we are simply the messenger 🫶

• SLSCLR - TOO MANY COLORS DEFINED — More than 256 colors have been made known to STITLE. It has no room in which to maintain information about them all.
• SLSETI - UNCLEARED PRIOR ERROR — When SLSETI was called, there was an unrecovered outstanding error. The routine does not continue; it forces the error message to be printed and then substitutes this one for it.
• SLSETR -- INVALID KEYWORD: xxx — The first argument in a call to SLSETR is not the name of one of the known internal parameters of STITLE. This error message can occur as the result of a call to SLSETI.
• SLSETR - UNCLEARED PRIOR ERROR — When SLSETR was called, there was an unrecovered outstanding error. The routine does not continue; it forces the error message to be printed and then substitutes this one for it.
• STITLE - ERROR RETURN FROM GQCLIP: i STITLE - ERROR RETURN FROM GQCNTN: i STITLE - ERROR RETURN FROM GQPLCI: i STITLE - ERROR RETURN FROM GQPMCI: i STITLE - ERROR RETURN FROM GQTXCI: i — A GKS routine has returned a non-zero error flag with value "i". This most likely means that GKS is in the wrong state.
• STITLE - UNCLEARED PRIOR ERROR — When STITLE was called, there was an unrecovered outstanding error. The routine does not continue; it forces the error message to be printed and then substitutes this one for it.

---

🌈 SEE ALSO 🌈

Online: ftitle, scrolled_title_params.m 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, you ate that 🍓✨ this was the UNIX version from July 1995 — Scrolled_title(3NCARG), signing off 💖 no cap, go scroll some titles 🎬💅