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.