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.