PLOTFONT(1) GNU Plotting Utilities PLOTFONT(1)NAMEplotfont - produce character maps of fonts supported by the plotting
utilities
SYNOPSISplotfont [ options ] fonts
DESCRIPTIONplotfont produces a character map for any font that is supported by the
plotting utilities, which include graph(1), plot(1), pic2plot(1),
tek2plot(1), and the GNU libplot 2-D graphics export library (see
plot(3)). Which fonts are supported depends on the output format,
which is specified by the -T option. A listing of the fonts available
in any specified output format may be obtained with the --help-fonts
option (see below).
The character map, or maps, will be written to standard output in the
specified format. For example, the Times-Roman font is available when
producing Postscript output. The command plotfont-T ps Times-Roman >
charmap.ps will yield a character map of the Times-Roman font, in a
Postscript format that can be viewed or edited with the idraw(1) draw‐
ing editor. The Times-Roman font is also available when producing Fig
output, which can be viewed or edited with the xfig(1) drawing editor.
The command plotfont-T fig Times-Roman > charmap.fig will yield the
same character map, but in Fig format rather than in Postscript format.
As another example, the Univers font is available when producing PCL 5
output. The command plotfont-T pcl Univers > charmap.pcl will produce
a character map of the Univers font, in PCL 5 format.
When producing output for the X Window System, i.e., for a popped-up
window, any scalable X Window System font that has an XLFD (i.e., X
Logical Font Description) name is supported. For example, the command
plotfont-T X utopia-medium-r-normal will pop up a window, and draw a
character map of the Utopia-Regular font. "utopia-medium-r-normal" is
a truncated version of the Utopia-Regular font's XLFD name. The
Utopia-Regular font is available on most X Window System displays.
OPTIONS
General Options
-T type
--output-format type
Select type as the output format. It may be "X", "png", "pnm",
"gif", "svg", "ai", "ps", "cgm", "fig", "pcl", "hpgl", "regis",
"tek", or "meta" (the default). These refer respectively to the
X Window System, PNG (Portable Network Graphics) format, porta‐
ble anymap format (PBM/PGM/PPM), a pseudo-GIF format that does
not use LZW encoding, the new XML-based Scalable Vector Graphics
format, the format used by Adobe Illustrator, Postscript or
Encapsulated Postscript (EPS) that can be edited with idraw(1),
CGM format (by default, confirming to the WebCGM profile), the
format used by the xfig(1) drawing editor, the Hewlett-Packard
PCL 5 printer language, the Hewlett-Packard Graphics Language,
ReGIS graphics format (which can be displayed by the dxterm(1)
terminal emulator or by a VT330 or VT340 terminal), Tektronix
format (which can be displayed by the xterm(1) terminal emula‐
tor), and device-independent GNU metafile format itself. Unless
type is "X", an output file is produced and written to standard
output.
Files in PNG, PNM, pseudo-GIF, AI, or Fig format contain only a
single page of graphics. So if the -T png option, the -T pnm
option, the -T gif option, the -T ai option, or the -T fig
option is used, the output file will contain a character map for
only the first-specified font.
A listing of the fonts available in any specified output format
may be obtained with the --help-fonts option (see below). If a
requested font is unavailable, a default font will be substi‐
tuted. The default font is "Helvetica" for "X", "svg", "ai",
"ps", "cgm", and "fig", "Univers" for "pcl", and "HersheySerif"
for "png", "pnm", "gif", "hpgl", "regis", "tek", and "meta".
-1
--lower-half
Generate a character map for the lower half of each specified
font. This is the default.
-2
--upper-half
Generate a character map for the upper half of each specified
font.
-o
--octal
Number the characters in octal rather than in decimal (the
default).
-x
--hexadecimal
Number the characters in hexadecimal rather than in decimal (the
default).
--box Surround each character with a box, showing its extent to left
and right. The default is not to do this.
-j row
--jis-row row
Generate a character map for row row of a Japanese font arranged
according to JIS [Japanese Industrial Standard] X0208. The only
such font currently available is the HersheyEUC [Extended Unix
Code] font. If used, this option overrides the -1 and -2
options. The valid rows are 1...94. In the JIS X0208 standard,
Roman characters are located in row 3, and Japanese syllabic
characters (Hiragana and Katakana) are located in rows 4 and 5.
Greek and Cyrillic characters are located in rows 6 and 7. Ja‐
panese ideographic characters (Kanji) are located in rows
16...84.
--bg-color name
Set the color used for the background to be name. This is rele‐
vant only to plotfont-T X, plotfont-T png, plotfont-T pnm,
plotfont-T gif, plotfont-T svg, plotfont-T cgm, and plotfont-T regis. An unrecognized name sets the color to the default,
which is "white". The environment variable BG_COLOR can equally
well be used to specify the background color.
If the -T png or -T gif option is used, a transparent PNG file
or a transparent pseudo-GIF, respectively, may be produced by
setting the TRANSPARENT_COLOR environment variable to the name
of the background color. If the -T svg or -T cgm option is
used, an output file without a background may be produced by
setting the background color to "none".
--bitmap-size bitmap_size
Set the size of the graphics display in which the character
map(s) will be drawn, in terms of pixels, to be bitmap_size.
The default is "570x570". This is relevant only to plotfont-T
X, plotfont-T png, plotfont-T pnm, and plotfont-T gif, all of
which produce bitmaps. If you choose a rectangular (non-square)
window size, the fonts in the character map(s) will be scaled
anisotropically, i.e., by different factors in the horizontal
and vertical directions. For plotfont-T X, this requires an
X11R6 display. Any font that cannot be scaled in this way will
be replaced by a default scalable font, such as the vector font
"HersheySerif".
The environment variable BITMAPSIZE can equally well be used to
specify the window size. For backward compatibility, the X
resource Xplot.geometry may be used instead.
--emulate-color option
If option is yes, replace each color in the output by an appro‐
priate shade of gray. This is seldom useful, except when using
plotfont-T pcl to prepare output for a PCL 5 device. (Many
monochrome PCL 5 devices, such as monochrome LaserJets, do a
poor job of emulating color on their own.) You may equally well
request color emulation by setting the environment variable EMU‐
LATE_COLOR to "yes".
--numbering-font name
Set the font used for the numbering of the characters in the
character map(s) to be name, rather than the default.
--page-size pagesize
Set the size of size of the page on which the character map(s)
will be positioned. This is relevant only to plotfont-T svg,
plotfont-T ai, plotfont-T ps, plotfont-T cgm, plotfont-T
fig, plotfont-T pcl, and plotfont-T hpgl. The default is
"letter", which means an 8.5 inch by 11 inch page. Any ISO page
size in the range "a0"..."a4" or ANSI page size in the range
"a"..."e" may be specified ("letter" is an alias for "a" and
"tabloid" is an alias for "b"). "legal" and "ledger" are recog‐
nized page sizes also. The environment variable PAGESIZE can
equally well be used to specify the page size.
The graphics display in which each character map is drawn will
be a square region that would occupy nearly the full width of
the specified page. An alternative size for the graphics dis‐
play can be specified. For example, the page size could be
specified as "letter,xsize=4in,ysize=6in", or
"a4,xsize=5.0cm,ysize=100mm". For all of the above except plot‐
font -T hpgl, the graphics display will, by default, be centered
on the page. For all of the above except plotfont-T svg and
plotfont-T cgm, the graphics display may be repositioned manu‐
ally, by specifying the location of its lower left corner, rela‐
tive to the lower left corner of the page. For example, the
page size could be specified as "letter,xorigin=2in,yori‐
gin=3in", or "a4,xorigin=0.5cm,yorigin=0.5cm". It is also pos‐
sible to specify an offset vector. For example, the page size
could be specified as "letter,xoffset=1in", or "letter,xoff‐
set=1in,yoffset=1.2in", or "a4,yoffset=-1cm". In SVG format and
WebCGM format it is possible to specify the size of the graphics
display, but not its position.
--rotation angle
Rotate the graphics display by angle degrees. Recognized values
are "0", "90", "180", and "270". "no" and "yes" are equivalent
to "0" and "90", respectively. The environment variable ROTA‐
TION can also be used to specify a rotation angle.
--pen-color name
Set the pen color to be name. An unrecognized name sets the pen
color to the default, which is "black".
Options for Metafile Output
The following option is relevant only if the -T option is omitted or if
-T meta is used. In this case the output of plotfont will be in GNU
graphics metafile format. It may be translated to other formats by
invoking plot(1).
-O
--portable-output
Output the portable (human-readable) version of GNU metafile
format, rather than the binary version (the default). The for‐
mat of the binary version is machine-dependent.
Informational Options
--help Print a list of command-line options, and exit.
--help-fonts
Print a table of available fonts, and exit. The table will
depend on which output format is specified with the -T option.
plotfont-T X, plotfont-T svg, plotfont-T ai, plotfont-T ps,
plotfont-T cgm, and plotfont-T fig each support the 35 stan‐
dard Postscript fonts. plotfont-T svg, plotfont-T pcl, and
plotfont-T hpgl support the 45 standard PCL 5 fonts, and the
latter two support a number of Hewlett-Packard vector fonts.
All seven support a set of 22 Hershey vector fonts, as do plot‐
font -T png, plotfont-T pnm, plotfont-T gif, plotfont-T
regis, and plotfont-T tek. plotfont without a -T option in
principle supports any of these fonts, since its output must be
translated to other formats by invoking plot(1).
--list-fonts
Like --help-fonts, but lists the fonts in a single column to
facilitate piping to other programs. If no output format is
specified with the -T option, the full set of supported fonts is
listed.
--version
Print the version number of plotfont and the plotting utilities
package, and exit.
ENVIRONMENT
The environment variables BITMAPSIZE, PAGESIZE, BG_COLOR, EMU‐
LATE_COLOR, and ROTATION serve as backups for the options --bit‐
map-size, --page-size, --bg-color, --emulate-color, and --rotation,
respectively. The remaining environment variables are specific to
individual output formats.
plotfont-T X, which pops up a window on an X Window System display for
each character map, checks the DISPLAY environment variable. Its value
determines the display that will be used.
plotfont-T png and plotfont-T gif, which produce output in PNG format
and pseudo-GIF format respectively, are affected by the INTERLACE envi‐
ronment variable. If its value is "yes", the output will be inter‐
laced. Also, if the TRANSPARENT_COLOR environment variable is set to
the name of a color, that color will be treated as transparent in the
output.
plotfont-T pnm, which produces output in portable anymap (PBM/PGM/PPM)
format, is affected by the PNM_PORTABLE environment variable. If its
value is "yes", the output will be in a human-readable format rather
than binary (the default).
plotfont-T cgm, which produces output in CGM (Computer Graphics
Metafile) format, is affected by the CGM_MAX_VERSION and CGM_ENCODING
environment variables. By default, it produces a binary-encoded ver‐
sion of CGM version 3 format. For backward compatibility, the version
number may be reduced by setting CGM_MAX_VERSION to "2" or "1". Irre‐
spective of version, the output CGM file will use the human-readable
clear text encoding if CGM_ENCODING is set to "clear_text". However,
only binary-encoded CGM files conform to the WebCGM profile.
plotfont-T pcl, which produces PCL 5 output for Hewlett-Packard print‐
ers and plotters, is affected by the environment variable
PCL_ASSIGN_COLORS. It should be set to "yes" when producing PCL 5 out‐
put for a color printer or other color device. This will ensure accu‐
rate color reproduction by giving the output device complete freedom in
assigning colors, internally, to its "logical pens". If it is "no"
then the device will use a fixed set of colored pens, and will emulate
other colors by shading. The default is "no" because monochrome PCL 5
devices, which are much more common than colored ones, must use shading
to emulate color.
plotfont-T hpgl, which produces Hewlett-Packard Graphics Language out‐
put, is affected by several environment variables. The most important
is HPGL_VERSION, which may be set to "1", "1.5", or "2" (the default).
"1" means that the output should be generic HP-GL, "1.5" means that the
output should be suitable for the HP7550A graphics plotter and the
HP758x, HP7595A and HP7596A drafting plotters (HP-GL with some HP-GL/2
extensions), and "2" means that the output should be modern HP-GL/2.
If the version is "1" or "1.5" then the only available fonts will be
vector fonts, and all lines will be drawn with a default width. Addi‐
tionally, if the version is "1" then the filling of arbitrary curves
with solid color will not be supported (circles and rectangles aligned
with the coordinate axes may be filled, though).
The position of the plotfont-T hpgl graphics display on the page can
be rotated 90 degrees counterclockwise by setting the HPGL_ROTATE envi‐
ronment variable to "yes". This is not the same as the rotation
obtained with the --rotation option, since it both rotates the graphics
display and repositions its lower left corner toward another corner of
the page. Besides "no" and "yes", recognized values for HPGL_ROTATE
are "0", "90", "180", and "270". "no" and "yes" are equivalent to "0"
and "90", respectively. "180" and "270" are supported only if
HPGL_VERSION is "2" (the default).
By default, plotfont-T hpgl will draw with a fixed set of pens. Which
pens are present may be specified by setting the HPGL_PENS environment
variable. If HPGL_VERSION is "1", the default value of HPGL_PENS is
"1=black"; if HPGL_VERSION is "1.5" or "2", the default value of
HPGL_PENS is "1=black:2=red:3=green:4=yellow:5=blue:6=magenta:7=cyan".
The format should be self-explanatory. By setting HPGL_PENS you may
specify a color for any pen in the range #1...#31. All color names
recognized by the X Window System may be used. Pen #1 must always be
present, though it need not be black. Any other pen in the range
#1...#31 may be omitted.
If HPGL_VERSION is "2" then plotfont-T hpgl will also be affected by
the environment variable HPGL_ASSIGN_COLORS. If its value is "yes",
then plotfont-T hpgl will not be restricted to the palette specified
in HPGL_PENS: it will assign colors to "logical pens" in the range
#1...#31, as needed. The default value is "no" because other than
color LaserJet printers and DesignJet plotters, not many HP-GL/2
devices allow the assignment of colors to logical pens.
Opaque filling and the drawing of visible white lines are supported
only if HPGL_VERSION is "2" and the environment variable
HPGL_OPAQUE_MODE is "yes" (the default). If its value is "no" then
white lines (if any), which are normally drawn with pen #0, will not be
drawn. This feature is to accommodate older HP-GL/2 devices. HP-GL/2
pen plotters, for example, do not support opacity or the use of pen #0
to draw visible white lines. Some older HP-GL/2 devices may, in fact,
malfunction if asked to draw opaque objects.
plotfont-T tek, which produces output for a Tektronix terminal or emu‐
lator, checks the TERM environment variable. If the value of TERM is a
string beginning with "xterm", "nxterm", or "kterm", it is taken as a
sign that plotfont is running in an X Window System VT100 terminal emu‐
lator: a copy of xterm(1), nxterm(1), or kterm(1). Before drawing
graphics, plotfont-T tek will emit an escape sequence that causes the
terminal emulator's auxiliary Tektronix window, which is normally hid‐
den, to pop up. After the graphics are drawn, an escape sequence that
returns control to the original VT100 window will be emitted. The Tek‐
tronix window will remain on the screen.
If the value of TERM is a string beginning with "kermit", "ansi.sys",
or "nansi.sys", it is taken as a sign that plotfont is running in the
VT100 terminal emulator provided by the MS-DOS version of kermit(1).
Before drawing graphics, plotfont-T tek will emit an escape sequence
that switches the terminal emulator to Tektronix mode. Also, some of
the Tektronix control codes emitted by plotfont-T tek will be kermit-
specific. There will be a limited amount of color support, which is
not normally the case (the 16 `ansi.sys' colors will be supported).
After drawing graphics, plotfont-T tek will emit an escape sequence
that returns the emulator to VT100 mode. The key sequence `ALT minus'
can be employed manually within kermit to switch between the two modes.
SEE ALSOgraph(1), pic2plot(1), tek2plot(1), plot(1), plot(3), and "The GNU
Plotting Utilities Manual".
AUTHORSplotfont was written by Robert S. Maier (rsm@math.arizona.edu).
BUGS
Email bug reports to bug-gnu-utils@gnu.org.
FSF Jun 2000 PLOTFONT(1)
