summaryrefslogtreecommitdiff
path: root/Build/source/texk/ttfdump/docs/ttfdump.1
blob: f0d5e4cd4d8e8a3419602397251452fb749b470c (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
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
.TH TTFDUMP 1 "14 November 2011" "ILX Project" 
.SH NAME
ttfdump \- Dumping the contents of a TrueType Font file
.SH SYNOPSIS
.B ttfdump
.RB [ \-h ]
.RB [ \-t
.IR tablename ]
.RB [ \-g
.IR glyphnumber ]
.RB [ \-c
.IR collection ]
.RB [ \-o
.IR dumpfile ]
.RB [ \-i ]
.I ttfile
.SH DESCRIPTION
\fBttfdump\fP dumps the contents of a TrueType font file in ASCII form. 
A TrueType font file is consist of various tables. Those table are divided into
two categories - \fIRequired Tables\fP and \fIOptional Tables\fP. Mulitiple 
TrueType fonts can be merged to a TrueType Collection.
.SS Options
.TP
\fB-h\fP
Print a help message on standard output and exit.
.TP
\fB-t\fI tablename\fR
If this option is specified then dump the table \fI"tablename"\fP, otherwise 
dump every tables in \fIttfile\fP.
\fITablename\fP can be one of the following:
.RS
.TP
\fBRequired Tables\fR
.TP
\fIcmap\fP 
character to glyph mapping table
.TP
\fIglyf\fP
glyph data
.TP
\fIhead\fP
font header
.TP
\fIhhea\fP
horizontal header
.TP
\fIhmtx\fP
horizontal metrics
.TP
\fIloca\fP
index to location
.TP
\fImaxp\fP
maximum profile
.TP
\fIname\fP
naming table
.TP
\fIpost\fP
PostScript information
.TP
\fIOS/2\fP
OS/2 and windows specific metrics
.TP
\fBOptional Tables\fR
.TP
\fIcvt\fP
control value table
.TP
\fIfpgm\fP
font program; \fInot implemented yet.\fP
.TP
\fIgasp\fP
grid-fitting and scan conversion procedure (grayscale)
.TP
\fIhdmx\fP
horizontal device metrics
.TP
\fIkern\fP
kerning table
.TP
\fILTSH\fP
Linear threshold table
.TP
\fIprep\fP
CVT program; \fInot implemented yet\fP
.TP
\fIPCLT\fP
PCL5 table
.TP
\fIVDMX\fP
Vertical Device Metrics table
.TP
\fIvhea\fP
vertical metrics header
.TP
\fIvmtx\fP
vertical metrics
.TP
\fBAdditional OpenType Tables\fR
.TP
\fIGPOS\fP
glyph positioning table
.TP
\fIGSUB\fP
glyph substitution table
.RE
.TP
\fB-g\fI glyphnumber\fR
If this option is specified then dump the glyph with index \fIglyphnumber\fP, 
otherwise dump all glyphs in \fIttfile\fP.
.TP
\fB-c\fI collection\fR
Select a TrueType font in a TrueType Collection.
.TP
\fB-o\fI dumpfile\fR
Output of the dump. If this option is not specified, dump to stdout.
.TP
\fB-i\fI ttfile\fR
TrueType font file to be dumped.
.RE
.SH EXAMPLE
To dump all information in the TrueType font file times.ttf:
.RS
ttfdump times.ttf
.RE

To dump the required table \fIcmap\fP in the file:
.RS
ttfdump -t cmap times.ttf
.RE

To dump a single glyph with index 50:
.RS
ttfdump -g 50 times.ttf
.RE

.SH SEE ALSO
TrueType 1.0 Font Files, \fI Technical Specification Revision 1.66 November 1995\fR
.SH NOTE
Instruction disassembler in not implemented.
.SH AUTHOR
Li-Da Lho, ollie@ms1.hinet.net