HVECTEXT(1gv)
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.