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:
ARGUMENTS:
.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
will generate a dataset easily which
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",))