.BG
.FN vu
.TL
Create Vu-graphs (Slides)
.CS
vu(text, indent=3, width=7, height=7,
   line=.015, csize, font)
.AG text
character string vector, the elements of which are either
lines of text to plot, or else commands to the `vu' function
(see below).  The text will be plotted, with character size
as large as possible to fill the page.
.PP
For many purposes, the function `quickvu' will generate a dataset
easily which `vu' can plot.
.AG indent
number of spaces to indent lists.
.AG width
width of the page in inches.
.AG height
height of the paper in inches.
.AG line
thickness of lines in inches (needed for bold face
and for drawing bullets - see below).  Default is .015
inches (the thickness of the thick pens for Hewlett-Packard plotters).
Thin pens on the hp7221 are .01 inches.
.AG 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.
Default is continuously variable sizes.
.AG font
optional 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.
.PP
.NF
.ta 2i
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
.fi
.SH SOURCE
Norman M. Wolcott and Joseph Hilsenrath,
.ul
A Contribution to Computer Typesetting Techniques,
"Tables of Coordinates for Hershey's Repertory of
Occidental Type Fonts and Graphics Symbols",
National Bureau of Standards Special Publication 424,
April 1976.
.PP
The following are the commands recognized by `vu'.  They are similar
to commands in several `troff' macro systems, and they begin with a period (.) and
one or two capital letters:
.IP .C
Choose a color.  This command takes an argument which is the color number,
i.e., ".C 3" for color 3, etc.
.IP .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.
(To force use of the hardware font, give a nonexistent font name.)
Note that fonts currently cannot be changed in the middle of a line.
See also argument `font'.
.IP .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 initial size 1, thus ".L 2" would be double the
initial size, and ".L 1" would return to initial size.
The argument to this command is
.ul
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.
.IP .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".
.IP .B
Embolden the text (done by replotting one line width to the
right).  The argument tells how many overstrikes to use, default 1.
.IP .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.
.IP .R
Remove the emboldening.
.IP .CE
The argument gives the number of following lines of text which are to be centered, default 1.
.PP
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.
.IP .BL
Start a bullet list.
.IP .DL
Start a diamond list.
.IP .GL
Start a general list with each item preceded by the character string
given after the command.
For long strings, the value of argument `indent' may need to be increased.
.IP .NL
Start a numbered list, each item preceded by a sequential number
and trailing dash.
.IP .LI
List item. This command must precede **each** item in the
list.
.IP .LE
End of the list (causes the indenting of the list to be
cancelled).
.PP
The following text illustrates four of the fonts described above.
.EX
 .CE 4
 .C 1
 .F ro
 .B
 Slides Made With VU are
 .R
 .C 2
 .S 1.5
 .F ge
 VERY SEXY
 .S 1
 .F cs
 .C 3
 And Also Simple To Make
 .C 4
 .F tr
 QUICK and INEXPENSIVE
.PI
.KW hplot
.WR
