Debian Codegraph @

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

raw
1 .TH VFTOVP 1 "30 January 2026" "Web2C 2026"
2 .\"=====================================================================
3 .if t .ds TX \fRT\\h'-0.10m'\\v'0.17v'E\\v'-0.17v'\\h'-0.06m'X\fP
4 .if n .ds TX TeX
5 .\"=====================================================================
6 .SH NAME
7 vftovp \- convert TeX virtual font (vf) files to virtual property lists (vpl)
8 .SH SYNOPSIS
9 .B vftovp
10 .RI [ options ]
11 .IR vf_file [ \fB.vf\fP ]
12 .RI [ tfm_file [ \fB.tfm\fP ]
13 .RI [ vpl_file [ \fB.vpl\fP ]]]
14 .\"=====================================================================
15 .SH DESCRIPTION
16 The
17 .B vftovp
18 program translates a (binary) virtual font file and its accompanying
19 \*(TX font metric file to a (plain text) property list file. Thus, the
20 virtual font can be edited, and its exact contents can be displayed
21 mnemonically. It also serves as a vf-file validating program, i.e., if
22 no error messages are given, the input files are correct.
23 .PP
24 The filenames are extended with the appropriate extension if necessary.
25 .PP
26 \*(TX's virtual font format supports composing new characters from
27 characters from any number of existing fonts, and also using rules in
28 characters. This allows, for example, re-encoding with a mixture of
29 characters from different fonts. These vf fonts are entirely unrelated
30 to the variable fonts that can be created with OpenType, which also
31 conventionally use the \fI.vf\fP extension.
32 .\"=====================================================================
33 .SH OPTIONS
34 See
35 .BR tex (1)
36 for details of command-line parsing.
37 .TP
38 .BI -charcode-format= format
39 The argument
40 .I format
41 specifies how character codes are output in the vpl file. By default (the
42 historical behavior), ASCII letters and digits are output using the "C"
43 code (i.e., as themselves), and other characters are output in octal;
44 unless the font's coding scheme starts with "TeX math sy" or "TeX math
45 ex", in which case all character codes are output in octal.
46 .IP
47 If
48 .I format
49 is
50 .BR ascii ,
51 all character codes that correspond to graphic characters, besides the
52 left and right parentheses, are output in ASCII.
53 .IP
54 Finally, if
55 .I format
56 is
57 .BR octal ,
58 all character codes are output in octal. (This option is the same as in
59 \fBtftopl\fP.)
60 .TP
61 .B -verbose
62 By default, the program operates silently. With this option, some
63 reports are written to stdout.
64 .PP
65 The standard
66 .B -help
67 and
68 .B -version
69 options are also supported.
70 .\"=====================================================================
71 .SH ENVIRONMENT
72 The program looks for
73 .I vf_file
74 using the environment variable VFFONTS, and
75 .I tfm_file
76 using the environment variable TFMFONTS. If either is not set, it then
77 checks the variable TEXFONTS. If that is not set, it uses the system
78 default. See the Kpathsea manual at https://tug.org/kpathsea for the
79 details of the searching.
80 .\"=====================================================================
81 .SH "SEE ALSO"
82 .BR pltotf (1),
83 .BR tftopl (1),
84 .BR vptovf (1).
85 .PP
86 Brief description of virtual fonts, and additional references:
87 https://tug.org/texinfohtml/dvips.html#Virtual-fonts
88 .br
89 Knuth's original message introducing virtual fonts:
90 https://mirror.ctan.org/info/virtual-fonts.knuth
91 .br
92 Font utility topic on CTAN: https://ctan.org/topic/font-util
93 .br
94 Package page on CTAN: https://ctan.org/pkg/vftovp
95 .br
96 Section in the Web2c manual:
97 https://tug.org/texinfohtml/web2c.html#vftovp-invocation
98 .br
99 Typeset source code, including the vf file format description:
100 https://ctan.org/pkg/knuth-pdf
101 .\"=====================================================================
102 .SH AUTHORS
103 Donald E. Knuth wrote the program, based in part on an idea of David Fuchs,
104 starting with the code for
105 .BR tftopl (1).
106 Karl Berry adapted it for compilation with
107 .BR web2c .
108 .PP
109 Public discussion list and bug reports: https://lists.tug.org/tex-k