1PLOTFONT(1)                 GNU Plotting Utilities                 PLOTFONT(1)
2
3
4

NAME

6       plotfont  -  produce  character maps of fonts supported by the plotting
7       utilities
8

SYNOPSIS

10       plotfont [ options ] fonts
11

DESCRIPTION

13       plotfont produces a character map for any font that is supported by the
14       plotting  utilities,  which  include  graph(1),  plot(1),  pic2plot(1),
15       tek2plot(1), and the GNU  libplot  2-D  graphics  export  library  (see
16       plot(3)).   Which  fonts  are  supported  depends on the output format,
17       which is specified by the -T option.  A listing of the fonts  available
18       in  any  specified  output format may be obtained with the --help-fonts
19       option (see below).
20
21       The character map, or maps, will be written to standard output  in  the
22       specified  format.  For example, the Times-Roman font is available when
23       producing Postscript output.  The command plotfont -T ps Times-Roman  >
24       charmap.ps  will  yield  a  character map of the Times-Roman font, in a
25       Postscript format that can be viewed or edited with the idraw(1)  draw‐
26       ing  editor.  The Times-Roman font is also available when producing Fig
27       output, which can be viewed or edited with the xfig(1) drawing  editor.
28       The  command  plotfont  -T fig Times-Roman > charmap.fig will yield the
29       same character map, but in Fig format rather than in Postscript format.
30
31       As another example, the Univers font is available when producing PCL  5
32       output.  The command plotfont -T pcl Univers > charmap.pcl will produce
33       a character map of the Univers font, in PCL 5 format.
34
35       When producing output for the X Window System, i.e.,  for  a  popped-up
36       window,  any  scalable  X  Window System font that has an XLFD (i.e., X
37       Logical Font Description) name is supported.  For example, the  command
38       plotfont  -T  X utopia-medium-r-normal will pop up a window, and draw a
39       character map of the Utopia-Regular font.  "utopia-medium-r-normal"  is
40       a  truncated  version  of  the  Utopia-Regular  font's  XLFD name.  The
41       Utopia-Regular font is available on most X Window System displays.
42

OPTIONS

44   General Options
45       -T type
46       --output-format type
47              Select type as the output format.  It may be "X", "png",  "pnm",
48              "gif",  "svg", "ai", "ps", "cgm", "fig", "pcl", "hpgl", "regis",
49              "tek", or "meta" (the default).  These refer respectively to the
50              X  Window System, PNG (Portable Network Graphics) format, porta‐
51              ble anymap format (PBM/PGM/PPM), a pseudo-GIF format  that  does
52              not use LZW encoding, the new XML-based Scalable Vector Graphics
53              format, the format used  by  Adobe  Illustrator,  Postscript  or
54              Encapsulated  Postscript (EPS) that can be edited with idraw(1),
55              CGM format (by default, confirming to the WebCGM  profile),  the
56              format  used  by the xfig(1) drawing editor, the Hewlett-Packard
57              PCL 5 printer language, the Hewlett-Packard  Graphics  Language,
58              ReGIS  graphics  format (which can be displayed by the dxterm(1)
59              terminal emulator or by a VT330 or  VT340  terminal),  Tektronix
60              format  (which  can be displayed by the xterm(1) terminal emula‐
61              tor), and device-independent GNU metafile format itself.  Unless
62              type  is "X", an output file is produced and written to standard
63              output.
64
65              Files in PNG, PNM, pseudo-GIF, AI, or Fig format contain only  a
66              single  page  of  graphics.  So if the -T png option, the -T pnm
67              option, the -T gif option, the -T  ai  option,  or  the  -T  fig
68              option is used, the output file will contain a character map for
69              only the first-specified font.
70
71              A listing of the fonts available in any specified output  format
72              may  be obtained with the --help-fonts option (see below).  If a
73              requested font is unavailable, a default font  will  be  substi‐
74              tuted.   The  default  font is "Helvetica" for "X", "svg", "ai",
75              "ps", "cgm", and "fig", "Univers" for "pcl", and  "HersheySerif"
76              for "png", "pnm", "gif", "hpgl", "regis", "tek", and "meta".
77
78       -1
79       --lower-half
80              Generate  a  character  map for the lower half of each specified
81              font.  This is the default.
82
83       -2
84       --upper-half
85              Generate a character map for the upper half  of  each  specified
86              font.
87
88       -o
89       --octal
90              Number  the  characters  in  octal  rather  than in decimal (the
91              default).
92
93       -x
94       --hexadecimal
95              Number the characters in hexadecimal rather than in decimal (the
96              default).
97
98       --box  Surround  each  character with a box, showing its extent to left
99              and right.  The default is not to do this.
100
101       -j row
102       --jis-row row
103              Generate a character map for row row of a Japanese font arranged
104              according to JIS [Japanese Industrial Standard] X0208.  The only
105              such font currently available is the HersheyEUC  [Extended  Unix
106              Code]  font.   If  used,  this  option  overrides  the -1 and -2
107              options.  The valid rows are 1...94.  In the JIS X0208 standard,
108              Roman  characters  are  located  in row 3, and Japanese syllabic
109              characters (Hiragana and Katakana) are located in rows 4 and  5.
110              Greek  and Cyrillic characters are located in rows 6 and 7.  Ja‐
111              panese  ideographic  characters  (Kanji)  are  located  in  rows
112              16...84.
113
114       --bg-color name
115              Set the color used for the background to be name.  This is rele‐
116              vant only to plotfont -T X, plotfont -T png,  plotfont  -T  pnm,
117              plotfont  -T gif, plotfont -T svg, plotfont -T cgm, and plotfont
118              -T regis.  An unrecognized name sets the color to  the  default,
119              which is "white".  The environment variable BG_COLOR can equally
120              well be used to specify the background color.
121
122              If the -T png or -T gif option is used, a transparent  PNG  file
123              or  a  transparent  pseudo-GIF, respectively, may be produced by
124              setting the TRANSPARENT_COLOR environment variable to  the  name
125              of  the  background  color.   If  the -T svg or -T cgm option is
126              used, an output file without a background  may  be  produced  by
127              setting the background color to "none".
128
129       --bitmap-size bitmap_size
130              Set  the  size  of  the  graphics display in which the character
131              map(s) will be drawn, in terms of  pixels,  to  be  bitmap_size.
132              The  default is "570x570".  This is relevant only to plotfont -T
133              X, plotfont -T png, plotfont -T pnm, and plotfont -T gif, all of
134              which produce bitmaps.  If you choose a rectangular (non-square)
135              window size, the fonts in the character map(s)  will  be  scaled
136              anisotropically,  i.e.,  by  different factors in the horizontal
137              and vertical directions.  For plotfont -T X,  this  requires  an
138              X11R6  display.  Any font that cannot be scaled in this way will
139              be replaced by a default scalable font, such as the vector  font
140              "HersheySerif".
141
142              The  environment variable BITMAPSIZE can equally well be used to
143              specify the window size.   For  backward  compatibility,  the  X
144              resource Xplot.geometry may be used instead.
145
146       --emulate-color option
147              If  option is yes, replace each color in the output by an appro‐
148              priate shade of gray.  This is seldom useful, except when  using
149              plotfont  -T  pcl  to  prepare output for a PCL 5 device.  (Many
150              monochrome PCL 5 devices, such as  monochrome  LaserJets,  do  a
151              poor job of emulating color on their own.)  You may equally well
152              request color emulation by setting the environment variable EMU‐
153              LATE_COLOR to "yes".
154
155       --numbering-font name
156              Set  the  font  used  for the numbering of the characters in the
157              character map(s) to be name, rather than the default.
158
159       --page-size pagesize
160              Set the size of size of the page on which the  character  map(s)
161              will  be  positioned.  This is relevant only to plotfont -T svg,
162              plotfont -T ai, plotfont -T ps, plotfont  -T  cgm,  plotfont  -T
163              fig,  plotfont  -T  pcl,  and  plotfont -T hpgl.  The default is
164              "letter", which means an 8.5 inch by 11 inch page.  Any ISO page
165              size  in  the  range  "a0"..."a4" or ANSI page size in the range
166              "a"..."e" may be specified ("letter" is an  alias  for  "a"  and
167              "tabloid" is an alias for "b").  "legal" and "ledger" are recog‐
168              nized page sizes also.  The environment  variable  PAGESIZE  can
169              equally well be used to specify the page size.
170
171              The  graphics  display in which each character map is drawn will
172              be a square region that would occupy nearly the  full  width  of
173              the  specified  page.  An alternative size for the graphics dis‐
174              play can be specified.  For example,  the  page  size  could  be
175              specified        as       "letter,xsize=4in,ysize=6in",       or
176              "a4,xsize=5.0cm,ysize=100mm".  For all of the above except plot‐
177              font -T hpgl, the graphics display will, by default, be centered
178              on the page.  For all of the above except plotfont  -T  svg  and
179              plotfont  -T cgm, the graphics display may be repositioned manu‐
180              ally, by specifying the location of its lower left corner, rela‐
181              tive  to  the  lower  left corner of the page.  For example, the
182              page  size  could  be  specified  as   "letter,xorigin=2in,yori‐
183              gin=3in",  or "a4,xorigin=0.5cm,yorigin=0.5cm".  It is also pos‐
184              sible to specify an offset vector.  For example, the  page  size
185              could  be  specified  as  "letter,xoffset=1in", or "letter,xoff‐
186              set=1in,yoffset=1.2in", or "a4,yoffset=-1cm".  In SVG format and
187              WebCGM format it is possible to specify the size of the graphics
188              display, but not its position.
189
190       --rotation angle
191              Rotate the graphics display by angle degrees.  Recognized values
192              are  "0", "90", "180", and "270".  "no" and "yes" are equivalent
193              to "0" and "90", respectively.  The environment  variable  ROTA‐
194              TION can also be used to specify a rotation angle.
195
196       --pen-color name
197              Set the pen color to be name.  An unrecognized name sets the pen
198              color to the default, which is "black".
199
200   Options for Metafile Output
201       The following option is relevant only if the -T option is omitted or if
202       -T  meta  is  used.  In this case the output of plotfont will be in GNU
203       graphics metafile format.  It may be translated  to  other  formats  by
204       invoking plot(1).
205
206       -O
207       --portable-output
208              Output  the  portable  (human-readable)  version of GNU metafile
209              format, rather than the binary version (the default).  The  for‐
210              mat of the binary version is machine-dependent.
211
212   Informational Options
213       --help Print a list of command-line options, and exit.
214
215       --help-fonts
216              Print  a  table  of  available  fonts, and exit.  The table will
217              depend on which output format is specified with the  -T  option.
218              plotfont  -T X, plotfont -T svg, plotfont -T ai, plotfont -T ps,
219              plotfont -T cgm, and plotfont -T fig each support the  35  stan‐
220              dard  Postscript  fonts.   plotfont -T svg, plotfont -T pcl, and
221              plotfont -T hpgl support the 45 standard PCL 5  fonts,  and  the
222              latter  two  support  a  number of Hewlett-Packard vector fonts.
223              All seven support a set of 22 Hershey vector fonts, as do  plot‐
224              font  -T  png,  plotfont  -T  pnm,  plotfont -T gif, plotfont -T
225              regis, and plotfont -T tek.  plotfont without  a  -T  option  in
226              principle  supports any of these fonts, since its output must be
227              translated to other formats by invoking plot(1).
228
229       --list-fonts
230              Like --help-fonts, but lists the fonts in  a  single  column  to
231              facilitate  piping  to  other  programs.  If no output format is
232              specified with the -T option, the full set of supported fonts is
233              listed.
234
235       --version
236              Print  the version number of plotfont and the plotting utilities
237              package, and exit.
238

ENVIRONMENT

240       The  environment  variables  BITMAPSIZE,   PAGESIZE,   BG_COLOR,   EMU‐
241       LATE_COLOR,  and  ROTATION  serve  as  backups  for  the options --bit‐
242       map-size, --page-size,  --bg-color,  --emulate-color,  and  --rotation,
243       respectively.   The  remaining  environment  variables  are specific to
244       individual output formats.
245
246       plotfont -T X, which pops up a window on an X Window System display for
247       each character map, checks the DISPLAY environment variable.  Its value
248       determines the display that will be used.
249
250       plotfont -T png and plotfont -T gif, which produce output in PNG format
251       and pseudo-GIF format respectively, are affected by the INTERLACE envi‐
252       ronment variable.  If its value is "yes", the  output  will  be  inter‐
253       laced.   Also,  if the TRANSPARENT_COLOR environment variable is set to
254       the name of a color, that color will be treated as transparent  in  the
255       output.
256
257       plotfont -T pnm, which produces output in portable anymap (PBM/PGM/PPM)
258       format, is affected by the PNM_PORTABLE environment variable.   If  its
259       value  is  "yes",  the output will be in a human-readable format rather
260       than binary (the default).
261
262       plotfont -T cgm,  which  produces  output  in  CGM  (Computer  Graphics
263       Metafile)  format,  is affected by the CGM_MAX_VERSION and CGM_ENCODING
264       environment variables.  By default, it produces a  binary-encoded  ver‐
265       sion  of CGM version 3 format.  For backward compatibility, the version
266       number may be reduced by setting CGM_MAX_VERSION to "2" or "1".   Irre‐
267       spective  of  version,  the output CGM file will use the human-readable
268       clear text encoding if CGM_ENCODING is set to  "clear_text".   However,
269       only binary-encoded CGM files conform to the WebCGM profile.
270
271       plotfont -T pcl, which produces PCL 5 output for Hewlett-Packard print‐
272       ers  and  plotters,   is   affected   by   the   environment   variable
273       PCL_ASSIGN_COLORS.  It should be set to "yes" when producing PCL 5 out‐
274       put for a color printer or other color device.  This will ensure  accu‐
275       rate color reproduction by giving the output device complete freedom in
276       assigning colors, internally, to its "logical pens".   If  it  is  "no"
277       then  the device will use a fixed set of colored pens, and will emulate
278       other colors by shading.  The default is "no" because monochrome PCL  5
279       devices, which are much more common than colored ones, must use shading
280       to emulate color.
281
282       plotfont -T hpgl, which produces Hewlett-Packard Graphics Language out‐
283       put,  is affected by several environment variables.  The most important
284       is HPGL_VERSION, which may be set to "1", "1.5", or "2" (the  default).
285       "1" means that the output should be generic HP-GL, "1.5" means that the
286       output should be suitable for the  HP7550A  graphics  plotter  and  the
287       HP758x,  HP7595A and HP7596A drafting plotters (HP-GL with some HP-GL/2
288       extensions), and "2" means that the output should  be  modern  HP-GL/2.
289       If  the  version  is "1" or "1.5" then the only available fonts will be
290       vector fonts, and all lines will be drawn with a default width.   Addi‐
291       tionally,  if  the  version is "1" then the filling of arbitrary curves
292       with solid color will not be supported (circles and rectangles  aligned
293       with the coordinate axes may be filled, though).
294
295       The  position  of the plotfont -T hpgl graphics display on the page can
296       be rotated 90 degrees counterclockwise by setting the HPGL_ROTATE envi‐
297       ronment  variable  to  "yes".   This  is  not  the same as the rotation
298       obtained with the --rotation option, since it both rotates the graphics
299       display  and repositions its lower left corner toward another corner of
300       the page.  Besides "no" and "yes", recognized  values  for  HPGL_ROTATE
301       are  "0", "90", "180", and "270".  "no" and "yes" are equivalent to "0"
302       and  "90",  respectively.   "180"  and  "270"  are  supported  only  if
303       HPGL_VERSION is "2" (the default).
304
305       By default, plotfont -T hpgl will draw with a fixed set of pens.  Which
306       pens are present may be specified by setting the HPGL_PENS  environment
307       variable.   If  HPGL_VERSION  is "1", the default value of HPGL_PENS is
308       "1=black"; if HPGL_VERSION is  "1.5"  or  "2",  the  default  value  of
309       HPGL_PENS  is "1=black:2=red:3=green:4=yellow:5=blue:6=magenta:7=cyan".
310       The format should be self-explanatory.  By setting  HPGL_PENS  you  may
311       specify  a  color  for  any pen in the range #1...#31.  All color names
312       recognized by the X Window System may be used.  Pen #1 must  always  be
313       present,  though  it  need  not  be  black.  Any other pen in the range
314       #1...#31 may be omitted.
315
316       If HPGL_VERSION is "2" then plotfont -T hpgl will also be  affected  by
317       the  environment  variable  HPGL_ASSIGN_COLORS.  If its value is "yes",
318       then plotfont -T hpgl will not be restricted to the  palette  specified
319       in  HPGL_PENS:  it  will  assign  colors to "logical pens" in the range
320       #1...#31, as needed.  The default value  is  "no"  because  other  than
321       color  LaserJet  printers  and  DesignJet  plotters,  not  many HP-GL/2
322       devices allow the assignment of colors to logical pens.
323
324       Opaque filling and the drawing of visible  white  lines  are  supported
325       only   if   HPGL_VERSION   is   "2"   and   the   environment  variable
326       HPGL_OPAQUE_MODE is "yes" (the default).  If its  value  is  "no"  then
327       white lines (if any), which are normally drawn with pen #0, will not be
328       drawn.  This feature is to accommodate older HP-GL/2 devices.   HP-GL/2
329       pen  plotters, for example, do not support opacity or the use of pen #0
330       to draw visible white lines.  Some older HP-GL/2 devices may, in  fact,
331       malfunction if asked to draw opaque objects.
332
333       plotfont -T tek, which produces output for a Tektronix terminal or emu‐
334       lator, checks the TERM environment variable.  If the value of TERM is a
335       string  beginning  with "xterm", "nxterm", or "kterm", it is taken as a
336       sign that plotfont is running in an X Window System VT100 terminal emu‐
337       lator:  a  copy  of  xterm(1),  nxterm(1), or kterm(1).  Before drawing
338       graphics, plotfont -T tek will emit an escape sequence that causes  the
339       terminal  emulator's auxiliary Tektronix window, which is normally hid‐
340       den, to pop up.  After the graphics are drawn, an escape sequence  that
341       returns control to the original VT100 window will be emitted.  The Tek‐
342       tronix window will remain on the screen.
343
344       If the value of TERM is a string beginning with  "kermit",  "ansi.sys",
345       or  "nansi.sys",  it is taken as a sign that plotfont is running in the
346       VT100 terminal emulator provided by the MS-DOS  version  of  kermit(1).
347       Before  drawing  graphics, plotfont -T tek will emit an escape sequence
348       that switches the terminal emulator to Tektronix mode.  Also,  some  of
349       the  Tektronix control codes emitted by plotfont -T tek will be kermit-
350       specific.  There will be a limited amount of color  support,  which  is
351       not  normally  the  case  (the 16 `ansi.sys' colors will be supported).
352       After drawing graphics, plotfont -T tek will emit  an  escape  sequence
353       that  returns the emulator to VT100 mode.  The key sequence `ALT minus'
354       can be employed manually within kermit to switch between the two modes.
355

SEE ALSO

357       graph(1), pic2plot(1), tek2plot(1),  plot(1),  plot(3),  and  "The  GNU
358       Plotting Utilities Manual".
359

AUTHORS

361       plotfont was written by Robert S. Maier (rsm@math.arizona.edu).
362

BUGS

364       Email bug reports to bug-gnu-utils@gnu.org.
365
366
367
368FSF                                Jun 2000                        PLOTFONT(1)
Impressum