#set TITLE = "Fonts
#include top

.SH What fonts are available?
.LP
This depends on what output format you are producing, since
Ploticus does not include its own internal fonts.

#include space

.SH PNG, GIF, etc.
If the default built-in GD code is used, a basic ascii font is
available in 5 sizes (you can specify any point size in ploticus; the nearest
available size will be used).
You can't set the font from ploticus; \fC-font\fR (etc.) will have no effect.
Vertical rendering is available.
Availability of symbols and nonroman characters is limited to those in ASCII
128-255.

#include space

.SH PNG, JPEG, WBMP with FreeType2 support
If your ploticus build uses GD with FreeType2
support, you can use TrueType fonts.
The basic GD ascii font is also available in 5 sizes, and is the default
(its name is \fCascii\fR should you need to use it explicitly).
You can set the font from ploticus using \fC-font\fR, 
#set FILE = "page.html"
#set TAG = "proc page"
#include link
\fCfont\fR attribute,
or \fCfont\fR in any 
#set FILE = "textdetails.html"
#set TAG = "textdetails"
#include link
attribute.
TrueType font names should be given without the .ttf extension, 
e.g. if you have a font file called times.ttf you would use 
.IP
\fC-font times \fR
.LP
You will need to have some TrueType .ttf font files stored in a directory somewhere.  
The environment variable \fBGDFONTPATH\fR must be 
set to contain the pathname of this directory.
TrueType font files may be found on NT machines in 
\fCc:/winnt/fonts\fR or they may be downloaded on the web.  
.LP
Vertical rendering is available.  
Availability of symbols and nonroman characters:
UTF-8 sequences such as \fC&#192\fR may be used.
.LP
#set FILE = "../gallery/stock.jpeg"
#set TAG = "Here is an example rendered using TTF sans serif font."
#include link
For more information on building ploticus to use FreeType2, see ./src/FreeType2 
and ./src/Makefile.  

#include space

.SH PostScript, EPS
Uses PostScript fonts.  The default font is \fC/Helvetica\fR.
You can set the font from ploticus using \fC-font\fR, 
#set FILE = "page.html"
#set TAG = "proc page"
#include link
\fCfont\fR attribute,
or \fCfont\fR in any 
#set FILE = "textdetails.html"
#set TAG = "textdetails"
#include link
attribute, for example:
.IP
\fC-font /Helvetica-Oblique\fR
.LP
Usually these fonts are available: \fC/Helvetica /Helvica-Oblique /Helvetica-Bold
/Helvetica-BoldOblique /Times-Roman /Times-Bold\fR; many others are
usually available as well.
Vertical rendering is available.
Availability of symbols and nonroman characters:
you can use the troff-like
#set FILE = specialchars.html
#set TAG = "special characters"
#include link
feature that uses the /Symbols font;
otherwise it depends on what is available
in the upper range of the PostScript font you are using.

#include space

.SH X11
Always uses the same fixed width font.  
You can't set the font from ploticus; \fC-font\fR (etc.) will have no effect.
Depending on availablility, this will be
either \fC-adobe-courier-bold-r-normal\fR, \fC-misc-fixed-medium-r-normal\fR, 
or as a last resort, \fC9x15\fR.  Proper vertical rendering is not available.
Availability of symbols and nonroman characters is limited to those in ASCII
128-255.

#include bottom
