Debian Codegraph @

texmf-dist/doc/man/man1/gftodvi.1

raw
1 .TH GFTODVI 1 "25 January 2026" "Web2C 2026"
2 .\"=====================================================================
3 .if n .ds MF Metafont
4 .if t .ds MF Metafont
5 .if t .ds TX \fRT\\h'-0.10m'\\v'0.17v'E\\v'-0.17v'\\h'-0.06m'X\fP
6 .if n .ds TX TeX
7 .\"=====================================================================
8 .SH NAME
9 gftodvi \- make proof sheets from generic font bitmap files
10 .SH SYNOPSIS
11 .B gftodvi
12 .RB [ -overflow-label-offset=\fI\,real\/\fP ]
13 .RB [ -verbose ]
14 .IR gf_file [gf]
15 .\"=====================================================================
16 .SH DESCRIPTION
17 The
18 .B gftodvi
19 program converts a generic font
20 .RI ( gf )
21 bitmap file output by, typically,
22 .BR mf (1),
23 to a device independent (DVI) file, which can then be typeset using the same
24 software that has already been written for \*(TX. The characters in the
25 .I gf
26 file will appear one per page, with labels, titles, and annotations
27 as specified in Appendix H (Hardcopy Proofs) of
28 .IR "The \*(MFbook" .
29 .PP
30 .B gftodvi
31 uses other fonts in addition to the main
32 .I gf
33 file.
34 A `gray' font is used to typeset the
35 pixels that actually make up the character. (We wouldn't
36 want all the pixels to be simply black, since then labels,
37 key points, and other information would be lost.) A `title' font
38 is used for the information at the top of the page. A `label' font
39 is used for the labels on key points of the figure. A `slant'
40 font is used to typeset diagonal lines, which
41 otherwise have to be simulated using horizontal and vertical rules.
42 The default gray, title, and label fonts are
43 .IR gray ,
44 .IR cmr8 ,
45 and
46 .IR cmtt10 ,
47 respectively; there is no default slant font.
48 .PP
49 To change the default fonts, you can give
50 .B special
51 commands in your
52 \*(MF source file, or you can change the fonts online. An online dialog
53 ensues if you end the
54 .I gf_file
55 with a `/'. For example,
56 .br
57 .ti +2
58 gftodvi cmr10.300gf/
59 .br
60 .ti +2
61 Special font substitution: grayfont black
62 .br
63 .ti +2
64 OK; any more? grayfontarea /home/art/don/
65 .br
66 .ti +2
67 OK; any more? slantfont /home/fonts/slantimagen6
68 .br
69 .ti +2
70 OK; any more? <RET>
71 .br
72 will use
73 .I /home/art/don/black
74 as the `gray' font and
75 .I /home/fonts/slantimagen6
76 as the `slant' font (this name indicates
77 a font for lines with slope 1/6 at the resolution of an Imagen printer).
78 .PP
79 The
80 .I gf_file
81 on the command line must include the resolution, but can omit the suffix
82 "gf". The output dvi file has same base name as
83 .IR gf_file ,
84 and it is placed in the current
85 working directory with the
86 .B dvi
87 suffix replacing
88 .BR gf .
89 For example, the input file
90 .I /some/directory/cmr10.2602gf
91 would become
92 .IR cmr10.dvi .
93 .\"=====================================================================
94 .SH OPTIONS
95 See
96 .BR tex (1)
97 for details of command-line parsing.
98 .PP
99 The argument to
100 .B -overflow-label-offset
101 specifies the distance from the right edge of the character
102 bounding box at which the overflow equations (if any) are typeset.
103 The value is given in \*(TX points. The default is a little over two
104 inches.
105 .PP
106 By default,
107 .B gftodvi
108 operates silently. With the \fB-verbose\fP option, a banner and progress
109 report are printed on stdout.
110 .PP
111 The standard
112 .B -help
113 and
114 .B -version
115 options are also supported.
116 .\"=====================================================================
117 .SH ENVIRONMENT
118 The program looks for
119 .I gf_file
120 using the environment variables GFFONTS, GLYPHFONTS, and TEXFONTS, in
121 that order. If none are set, it uses the system default. See the
122 Kpathsea manual at https://tug.org/kpathsea for the details of the
123 searching.
124 .\"=====================================================================
125 .SH FILES
126 .TP
127 .I {gray.tfm,slant.tfm,black.tfm,.\|.\|.}
128 The default fonts.
129 .TP
130 .I {gray.mf,slant.mf,black.mf,.\|.\|.}
131 The \*(MF sources.
132 .\"=====================================================================
133 .SH "SEE ALSO"
134 .BR tex (1),
135 .BR mf (1).
136 .br
137 Donald E.\& Knuth,
138 .I "The \*(MFbook"
139 (Volume C of
140 .IR "Computers & Typesetting" ).
141 .br
142 Donald E.\& Knuth et al.,
143 .IR \*(MFware .
144 .PP
145 Package page on CTAN: https://ctan.org/pkg/gftodvi
146 .br
147 Section in the Web2c manual:
148 https://tug.org/texinfohtml/web2c.html#gftodvi-invocation
149 .br
150 Typeset source code, including file format descriptions:
151 https://ctan.org/pkg/knuth-pdf
152 .\"=====================================================================
153 .SH AUTHORS
154 Donald E.\& Knuth wrote and still maintains the program. It was
155 published as part of the
156 .I \*(MFware
157 technical report. Paul Richards originally ported it to Unix.
158 .PP
159 Public discussion list and bug reports: https://lists.tug.org/tex-k