| 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 |