summaryrefslogtreecommitdiff
path: root/Build/source/texk/dviout-util/chkdvifont.man
blob: bce20aba582493fbc6a1ef59df26d043d0f83938 (plain)
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
.TH CHKDVIFONT 1
\"=====================================================================
.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
.if n .ds TX TeX
.\" LX definition must follow TX so LX can use TX
.if t .ds LX \fRL\\h'-0.36m'\\v'-0.15v'\s-2A\s0\\h'-0.15m'\\v'0.15v'\fP\*(TX
.if n .ds LX LaTeX
\"=====================================================================
.SH NAME
chkdvifont \- CHecK DVI/tfm/font file and tell informations of FONTs
.SH SYNOPSIS
.B chkdvifont
[\fB\-s\fR] [\fB\-c\fR] [\fB-{f|F}\fI<font_data_file>\fR]
[\fB\-d\fR]
\fIdvi_file_name\fR
.PP
.B chkdvifont
[\fB\-s\fR] [\fB\-c\fR] [\fB-{f|F}\fI<font_data_file>\fR]
[\fB\-t\fR]
\fItfm_file_name\fR
.PP
.B chkdvifont
[\fB\-s\fR] [\fB\-c\fR] [\fB-{f|F}\fI<font_data_file>\fR]
[\fB\-p\fR]
\fIfont_file_name\fR
.SH DESCRIPTION
.B Chkdvifont
is a utility to check DVI and other \*(TX font-related formats
(such as TFM, VF, GF and PK) and print information of those fonts.
There are 3 modes;
.PP
Option \fB\-d\fR: force DVI mode
.PP
Option \fB\-t\fR: force TFM/OFM mode
.PP
Option \fB\-p\fR: force other FONT mode
.PP
By default, the mode is guessed from the file extension.
.SH EXAMPLE
.TP 5
(1) If you want to know what font is used in sample.dvi,

    $ chkdvifont sample.dvi
    dvi file name                   = sample.dvi
    comment                         = TeX output 2007.11.24:0632
    factor converting to 10^{-5}m   = 25400000/473628672
    magnification                   = 1000
    maximum width                   = 26083328 scaled points = 398 points
    maximum height+depth            = 11099063 scaled points = 169 points
    maximum stack depth             = 4
    number of pages                 = 13
    page size                       = 14.0 cm x  6.0 cm
    page size magnificated          = 14.0 cm x  6.0 cm

    Font 14
        checksum                    = 44D3ED74
        design size                 =  1132462 scaled points = 17 points
        space size                  =  1630536 scaled points = 24 points
        magnification               = +magstep2
        font name                   = cmr17

    Font 7
        checksum                    = 4BF16079
        design size                 =   655360 scaled points = 10 points
        space size                  =   655360 scaled points = 10 points
        font name                   = cmr10

.TP 5
(2) If you want to know the brief summary of jis.tfm,

    $ chkdvifont jis.tfm
    "jis" is a jfm file :  0  ->   5
    checksum                = 00000000
    design size             = 10485760 2^{-20} points = 10 points

.TP 5
(3) If you want to know what font is referred to by jis.vf,

    $ chkdvifont jis.vf
    "jis.vf" is in VF format
    checksum                = 00000000
    design size             = 10485760 2^{-20} points = 10 points

    Mapped Font 1
            font dsize      = 10485760 2^{-20} points = 10 points
            font at         =  0.962216
            font name       = rml

.PP
Listing the fonts used in a DVI file (as shown in the first example)
is almost equivalent to
.B dvifontlist
in TeX-Guy package
<http://www-masu.ist.osaka-u.ac.jp/%7Ekakugawa/TeX-Guy/>
and a script
.B dviinfox
<https://ctan.org/pkg/dviinfox>.
I don't know any alternatives for obtaining information about TFM, OFM,
VF and other font formats.
.SH SEE ALSO
pltotf(1), tftopl(1), vptovf(1), vftovp(1)
.SH AUTHOR
The program
.B chkdvifont
(original name "chkfont")
is derived from the DVIOUT package (DVI previewer for Windows)
by Toshio OSHIMA ("SHIMA"), Yoshiki OTOBE, and Kazunori ASAYAMA.
Current version is maintained by Japanese \*(TX Development Community
<https://texjp.org>.
.br
For more information, please refer to
chkdvifont-ja.txt (in Japanese)
on our GitHub repository, <https://github.com/texjporg/tex-jp-build>
(under source/texk/dviout-util directory).