Create Vu-Graphs (Slides)
DESCRIPTION:
Generates a vu-graph on the current graphics device.
USAGE: 
vu(text, indent=3, width=7, height=7, line=.015,
     csize=<<see below>>, font=<<see below>>)
REQUIRED ARGUMENTS:
text:
vector of character strings, the elements of which are either lines of text to plot, or else commands to the vu function.
OPTIONAL ARGUMENTS:
indent:
number of spaces to indent lists.
width:
width of the page in inches. The width of the figure (the first element of the graphics parameter fin) will be used if smaller than width.
height:
height of the page in inches. The height of the figure (the second element of the graphics parameter fin) will be used if smaller than height.
line:
thickness of lines in inches (needed for bold face and for drawing bullets - see below). The default is .015 inches (the thickness of the thick pens for Hewlett-Packard plotters). Thin pens on the hp7221 are .01 inches.
csize:
vector of allowable character sizes for the plot, i.e., the values of graphical parameter cex that the device supports. This argument is important only for devices with a limited set of hardware-drawn character sizes when font is omitted. If csize is given as a scalar, any integer multiple of that size is allowed, otherwise csize is the vector of allowable sizes. The default is continuously variable sizes.
font:
character name of a font to be used in plotting the vugraph. If font is not specified, the hardware generated font of the plotting device will be used. Fonts can also be specified within text by the .F command.
SIDE EFFECTS:
a vu-graph is produced on the current graphics device. The text will be plotted, with the character size as large as possible to fill the page.
DETAILS:
The following are the commands recognized by vu. They are similar to commands in several troff macro systems; they begin with a period (.) and one or two capital letters:

.C Choose a color. This command takes an argument which is the color number, i.e., .C 3 for color 3, etc.

.F Choose a font. This command takes an argument which is the two-letter font name to be used for subsequent lines of text. If no font name is given, the font specified by the font argument is used. Note that fonts currently cannot be changed in the middle of a line. See also the font argument.

Abbreviation Font Name

sr Simplex Roman cr Complex Roman dr Duplex Roman tr Triplex Roman ro Roman (Constant Width)

ci Complex Italic ti Triplex Italic

ss Simplex Script cs Complex Script

sg Simplex Greek cg Complex Greek

ge Gothic English gg Gothic German gi Gothic Italian

cc Complex Cyrillic sp Special Symbols

.L Make the text larger. Each time this command appears, the size is increased by 25%. This command may also take an argument, which is the desired character size relative to the initial size 1, thus .L 2 would be double the initial size, and .L 1 would return to the initial size. The argument to this command is not the same as the graphical parameter cex: vu always adjusts the final value of cex so that all of the lines will fit on the final display. An argument to .L simply gives the size of the following text relative to the size of preceding text.

.S Make the text size smaller, by the same amount that .L makes it larger. Thus, any number of .S commands cancel the same number of .L commands. This command may take an argument, in which case it behaves exactly as .L; for example, .S 2 makes the font bigger.

.B Embolden the text (done by replotting one line width to the right). The argument tells how many overstrikes to use, the default is 1.

.H Highlight the text by plotting first in a highlighting color (given by the argument) and then plotting the text in the current color. With no argument, highlighting is turned off.

.R Remove the emboldening.

.CE The argument gives the number of following lines of text which are to be centered, default 1.

The next commands all create lists of items. The items in the list can be preceded by bullets, diamonds, numbers, or any character string (for example, "--"). Lists may be nested, but general or numbered lists may only appear once.

.BL Start a bullet list.

.DL Start a diamond list.

.GL Start a general list with each item preceded by the character string given after the command. For long strings, the value of the indent argument may need to be increased.

.NL Start a numbered list, each item preceded by a sequential number and trailing dash.

.LI List item. This command must precede **each** item in the list.

.LE End of the list (causes the indenting of the list to be cancelled).

REFERENCE:
Wolcott, N. M. and Hilsenrath, J. (1976). Tables of Coordinates for Hershey's Repertory of Occidental Type Fonts and Graphics Symbols. A Contribution to Computer Typesetting Techniques. National Bureau of Standards Special Publication 424.
SEE ALSO:
For many purposes, the function quickvu will generate a dataset easily which vu can plot.
EXAMPLES: 
 vu(unix("cat  vufile",
output=T),  font="cr")  
  vu(c(".CE 4", ".C 1", ".F ro", ".B",
"Slides Made With VU are", ".R",  ".C  2",  ".S  1.5",  ".F  ge",
"Attractive", ".S 1", ".F cs", ".C 3", "And Also Simple To Make",
".C 4", ".F tr", "QUICK and  INEXPENSIVE",))