[unix-history] / usr / man / man5 / vfont.5

.TH VFONT 5 2/26/79 5
.UC
.SH NAME
vfont \- font formats for the Versatec
.SH SYNOPSIS
.B /usr/lib/vfont/*
.SH DESCRIPTION
The fonts for the Versatec have the following format.
Each file contains a header, an array of 256 character description
structures, and then the bit maps for the characters themselves.
The header has the following format:
.in +5
'nf
.sp
\fBstruct\fR header {
	\fBshort\fR		magic;
	\fBunsigned\fR	\fBshort\fR size;
	\fBshort\fR		maxx;
	\fBshort\fR		maxy;
	\fBshort\fR		xtnd;
} header;
.fi
.in -5
.PP
The
.I magic
number is 0436 (octal).
The
.I maxx,
.I maxy,
and
.I xtnd
fields are not used.
The
.I size
is the size of the
bit maps for the characters.
Before the maps for the characters is an array of 256 structures for
each of the possible characters in the font.
Each element of the array has the form:
.in +5
'nf
.sp
\fBstruct\fR dispatch {
	\fBunsigned\fR	\fBshort\fR addr;
	\fBshort\fR		nbytes;
	\fBchar\fR		up;
	\fBchar\fR		down;
	\fBchar\fR		left;
	\fBchar\fR		right;
	\fBshort\fR		width;
};
.fi
.in -5
.PP
The
.I nbytes
field is nonzero for characters which actually exist.
For such characters, the
.I addr
field is an offset into the rest of the file where the data for
that character begins.
There are
.I up+down
rows of data for each character,
each of which has
.I left+right
bits, rounded up to a number of bytes.
The
.I width
field is not used.
.SH FILES
/usr/lib/vfont/*
.SH SEE ALSO
troff(1), pti(1), vpr(1), vtroff(1)
.SH BUGS
This description was made by looking at the source for
.I vcat,
a utility of
.IR vpr (1),
hence it is incomplete and quite likely inaccurate.
If you want to be sure of the details, look at the source for
.I vcat.
.PP
The standard fonts have many problems in them; in particular, not
all sizes are available, the 3/4 em dash is the same as the hyphen
in appearance (we are currently using math minus as a replacement),
the three character ligatures don't work,
and there are a number of problems with the special font (e.g. no hands
as well as more serious problems).
Commit	Line	Data
56bebdcf BJ	1	.TH VFONT 5 2/26/79 5
	2	.UC
	3	.SH NAME
	4	vfont \- font formats for the Versatec
	5	.SH SYNOPSIS
	6	.B /usr/lib/vfont/*
	7	.SH DESCRIPTION
	8	The fonts for the Versatec have the following format.
	9	Each file contains a header, an array of 256 character description
	10	structures, and then the bit maps for the characters themselves.
	11	The header has the following format:
	12	.in +5
	13	'nf
	14	.sp
	15	\fBstruct\fR header {
	16	\fBshort\fR magic;
	17	\fBunsigned\fR \fBshort\fR size;
	18	\fBshort\fR maxx;
	19	\fBshort\fR maxy;
	20	\fBshort\fR xtnd;
	21	} header;
	22	.fi
	23	.in -5
	24	.PP
	25	The
	26	.I magic
	27	number is 0436 (octal).
	28	The
	29	.I maxx,
	30	.I maxy,
	31	and
	32	.I xtnd
	33	fields are not used.
	34	The
	35	.I size
	36	is the size of the
	37	bit maps for the characters.
	38	Before the maps for the characters is an array of 256 structures for
	39	each of the possible characters in the font.
	40	Each element of the array has the form:
	41	.in +5
	42	'nf
	43	.sp
	44	\fBstruct\fR dispatch {
	45	\fBunsigned\fR \fBshort\fR addr;
	46	\fBshort\fR nbytes;
	47	\fBchar\fR up;
	48	\fBchar\fR down;
	49	\fBchar\fR left;
	50	\fBchar\fR right;
	51	\fBshort\fR width;
	52	};
	53	.fi
	54	.in -5
	55	.PP
	56	The
	57	.I nbytes
	58	field is nonzero for characters which actually exist.
	59	For such characters, the
	60	.I addr
	61	field is an offset into the rest of the file where the data for
	62	that character begins.
	63	There are
	64	.I up+down
65	rows of data for each character,
66	each of which has
67	.I left+right
68	bits, rounded up to a number of bytes.
69	The
70	.I width
71	field is not used.
72	.SH FILES
73	/usr/lib/vfont/*
74	.SH SEE ALSO
75	troff(1), pti(1), vpr(1), vtroff(1)
76	.SH BUGS
77	This description was made by looking at the source for
78	.I vcat,
79	a utility of
80	.IR vpr (1),
81	hence it is incomplete and quite likely inaccurate.
82	If you want to be sure of the details, look at the source for
83	.I vcat.
84	.PP
85	The standard fonts have many problems in them; in particular, not
86	all sizes are available, the 3/4 em dash is the same as the hyphen
87	in appearance (we are currently using math minus as a replacement),
88	the three character ligatures don't work,
89	and there are a number of problems with the special font (e.g. no hands
90	as well as more serious problems).