HVECTEXT(1) Geometry Center (1 Nov 1996) HVECTEXT(1)
NAME
hvectext - construct Geomview VECT text object from Hershey
fonts
SYNOPSIS
hvectext [-w totallength] [-s textheight] [-plane xy|xz|yz]
[-at X Y Z] [-align n|s|e|w|ne|nw|se|sw|c]
[-hershey fontfile.gsf] [--] text string ...
DESCRIPTION
Hvectext generates a Geomview/OOGL vector-text object, of
given height or total length (default -s .25). It aligns
the given 3-D point (default -at 0 0 0) with the given
corner of the text (default -align c). Alignment specs are
like geographic directions; -align sw puts the ``at'' point
at the ``southwest'' corner of the text, so that its lower
left corner is at that coordinate.
The corresponding VECT object is written to standard output.
If no non-blank text characters are given, hvectext produces
a null geom object ("{ }") as output.
The special option -- marks the end of options; it's useful
in case the text itself begins with a hyphen.
Hvectext accepts Ghostscript Hershey fonts; the built-in
default is Hershey-Plain-Simplex a.k.a. hrpl_s.gsf. Others
of interest: hrsy_r.gsf (Symbol), hrpl_t.gsf (Triplex).
For a complete list, see all the Ghostscript font files of
nontrivial size whose names begin with "hr".
Although there's no way to switch fonts within the string,
the first line of output from hvectext is an OOGL comment
resembling:
# Continue with: -align sw -plane xy -s 0.25 -at 1.24378 0 0
giving options for hvectext to continue the string where it
left off.
ENVIRONMENT
GS_FONTPATH, if present, is a colon-separated list of
directories in which Hershey font files are sought.
FILES
perl (either version 4 or 5) must be installed.
/usr/local/lib/ghostscript/fonts is searched if -hershey is
given and GS_FONTPATH isn't set.
Page 1 (printed 12/22/98)