1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45
|
.TH FONT 5G
.SH NAME
font, subfont \- external format for fonts and subfonts
.SH SYNOPSIS
.nf
.B
#include <libc.h>
.B
#include <libg.h>
.fi
.SH DESCRIPTION
Fonts and subfonts are described in
.IR cachechars (3g).
.PP
External fonts are described by a plain text file that can be read using
.I rdfontfile.
The format of the file is a header followed by any number of
subfont range specifications.
The header contains two numbers: the height and the ascent.
The height is the inter-line spacing and the ascent is the distance
from the top of the line to the baseline. These numbers are chosen
to display consistently all the subfonts of the font.
A subfont range specification contains two numbers and a font name.
The numbers are the inclusive range of characters covered by the subfont,
and name specifies the name of an X font suitable for
.IR getsubfont .
The minimum number of a covered range is mapped to the first defined
character of the corresponding subfont.
Each field must be followed by some white space.
Each numeric field may be C-format decimal, octal, or hexadecimal.
.PP
Subfonts may be loaded using
.IR getsubfont ,
see
.IR graphics (3g).
.SH BUGS
Some X font names contain spaces which will terminate the field.
For some fonts this can be worked around by replacing the spaces
with
.L `*'
characters in an attempt to fool the X font name pattern matching mechanism.
.SH "SEE ALSO"
.IR graphics (3g),
.IR bitblt (3g),
.IR cachechars (3g).
|